WAUTODESTROY(3W)
Series 300 and 500 Only
NAME
wautodestroy − autodestroy a window
SYNOPSIS
#include <window.h>
int wautodestroy (fd, value)
int fd;
int value;
DESCRIPTION
fd is an integer file descriptor for a window’s opened device interface.
value is an integer which determines the action of this routine.
DISCUSSION
This call inquires or sets whether the window will automatically be destroyed upon the last close operation on that window. Note that this routine is ineffectual unless wrecover(3W) has been called to make the window recoverable.
If value is set to -1, then the window’s current autodestroy status is returned. A 1 value returned indicates that the window denoted by this file descriptor is currently autodestroy, while a 0 value returned indicates that it is not.
If value is set to 0, then the window will not be destroyed when its device interface is closed by every process that has opened the window. This is the default state at window create time.
Setting value to 1 causes the window to be destroyed upon the last close.
SEE ALSO
DIAGNOSTICS
A value of 0 or 1 is returned unless fd does not refer to a window, in wich case -1 is returned. See errno(2) for further information.
Hewlett-Packard Company — May 11, 2021