Series 300 and 500 Only

NAME

wmstop − stop the window system on one display

SYNOPSIS

wmstop

DESCRIPTION

This command stops the window system for one display, normally the one from which it was invoked.  It may be called from any process connected to any window in that window system. 

wmstop actually calls a library routine (wmkill(3W)) to stop the window system whose window manager’s special file is in the directory specified by the environment variable $WMDIR. Calling the library routine causes the window manager to terminate gracefully, destroying all windows and clearing the screen.

After wm terminates, a signal (SIGHUP) propagates to all server processes for windows in the window group, thence to user processes in the group.  This normally causes them to also exit (gracefully or not).  Processes which ignore the signal (such as those started with nohup(1)) may continue to run, but their output is lost or overwrites portions of the screen asynchronously unless it was redirected away from a window. Meanwhile, the internal terminal emulator (ITE) regains control of the keyboard for input. 

SEE ALSO

windows(1), wmstart(1), wmready(1), wmkill(3W). 

DIAGNOSTICS

The following diagnostic values are returned by this routine:

0 If no errors are detected. 

1 Prints a message to standard error and returns 1 if it can’t open the special file (within two seconds), or if the library call fails.  If invoked from a process connected to a window, and if successful, wmstop may get a signal and terminate before returning 0. 

Hewlett-Packard Company  —  May 11, 2021