Series 300 and 500 Only

NAME

wdestroy − destroy one or more windows or set autodestroy attributes

SYNOPSIS

wdestroy window_spec... 
wdestroy [-adn] [window_spec...]

DESCRIPTION

When none of the -a, -d, or -n options are specified, this command destroys (deletes) one or more specified windows.  See windows(1) for an explanation of window_spec. For safety, you must use "−" to refer to the window affiliated with standard input.  Note that "wdestroy ‘wlist‘" works equally well. 

Any processes in the process group whose leader opened the deleted window are sent the SIGHUP signal.  This typically terminates them, unless they are background processes started using nohup(1), or they do something special with that signal.

If a destroyed window was the selected one, then after it is gone the keyboard is attached to the top window, if one exists; otherwise it is not attached to any window.  In the latter case, you can select a new window using a pop-up menu.  Likewise, if the last window is destroyed, you can create a new one using a pop-up menu. 

When called with the -a, -d, or -n options, the specified window is not deleted; rather, the window’s autodestroy and recovered attributes are affected as follows:

-a Causes the window to be automatically deleted when the window’s device interface (special file) is closed by every process that has opened the interface.  Note that this is the default state for windows created through the system pop-up menu, and is also the default state for the wconsole window created by wmstart(1).

-d Causes the window to be deleted when the window’s device interface is closed by every process and a new window is created.  Therefore, to remove windows that are in this state, you must either create a new window (after its device interface is closed by all processes that opened it), or you must explicitly destroy the window via wdestroy (with no options specified) or by using the Destroy option of the pop-up menu. 

-n When this option is used, the specified window won’t be deleted when its device interface is closed by every process; you must explicitly destroy the window via wdestroy (with no options), or you must use the Destroy option of the pop-up menu.  Note that this is the default state for windows created by wcreate(1) or wsh(1) with no options specified. In addition, specifying this option is equivalent in effect to using the Save item of the pop-up menu on a window. 

EXAMPLES

wdestroy −
Delete the window affiliated with standard input.

wdestroy oldwin1 oldwin2
Delete the windows named "oldwin1" and "oldwin2".

wdestroy -a window12
Causes the window named "window12" to be automatically destroyed when its device interface is closed by every process associated with it.  For example, if "window12" contains a shell, then terminating the window’s shell via exit(1) will cause the window to be automatically destroyed.

wdestroy -d pam_win
Automatically delete the window named "pam_win" only when every process that has opened the window’s interface has also closed it; additionally, the window won’t be destroyed until a new window is created.  For example, if the window contains a shell, then terminating the shell via ctl−D or exit(1) won’t cause the window to be deleted, until a new window is created, either by the pop-up menu or the wsh(1) or wcreate(1) commands.

wdestroy -n wconsole
By default the wconsole window, i.e., the first window normally created by wmstart(1), is set to be automatically destroyed (-a) when you exit the shell in that window.  The command shown here reverses the auto-termination status so that wconsole won’t be automatically destroyed. 

SEE ALSO

windows(1),wcreate(1),wlist(1),wsh(1),wautodestroy(3W),wdestroy(3W), wrecover(3W). 

DIAGNOSTICS

This routine returns the following values:

0 If no errors are detected. 

1 Prints a message to standard error and returns 1, with no windows destroyed, in case of an error which prevents destroying any windows.  Also aborts and returns 1 in case of trouble while expanding a window_spec pattern. 

2 If any one window cannot be destroyed for some reason, prints a message to standard error, continues with the next window_spec (if any), and eventually returns 2. 
 
 
 

Hewlett-Packard Company  —  May 11, 2021