WRECOVER(3W)
Series 300 and 500 Only
NAME
wrecover − recover a window
SYNOPSIS
#include <window.h>
int wrecover (fd, value)
int fd;
int value;
DESCRIPTION
fd is an integer file descriptor for an opened window device interface.
value is an integer which determines the action of this routine.
DISCUSSION
This call inquires or sets a window’s recover state.
Setting a window’s state to recovered will cause the window to be automatically destroyed when its device interface is no longer open by any process. The exact time that the window is destroyed is determined by the wautodestroy(3W) routine. If a window is recovered and it is set to be automatically destroyed, then the window will be immediately destroyed when its device interface is closed by every process that had it opened; if a window is recovered and it is not set for auto-destruction, then the window is destroyed when its device interface is closed by every process that had it opened and only when a new window is about to be created.
Setting value to -1 causes this routine to return whether the window is recoverable or not. A 1 value returned indicates that the window denoted by this file descriptor is currently recoverable, while a 0 value returned indicates that it is not.
If value is set to 0, then the window is not recovered upon next creation of a window. This is the default state at window create time.
Setting value to 1 causes the window to be recovered.
SEE ALSO
DIAGNOSTICS
A value of 0 or 1 is returned unless fd does not refer to a window, in which case -1 is returned. See errno(2) for further information.
Hewlett-Packard Company — May 11, 2021