Open System Services System Calls Reference Manual (G06.25+, H06.03+)

ioctl(2) OSS System Calls Reference Manual
TIOCSWINSZ
Causes the values stored in the winsize structure pointed to by arg to be sent to
the Telserv window identified by the filedes parameter.
When the request parameter specifies either TIOCGWINSZ or TIOCSWINSZ, the third and
only additional parameter is a pointer to:
struct winsize {
unsigned short ws_row;
unsigned short ws_col;
unsigned short ws_xpixel;
unsigned short ws_ypixel;
};
The winsize structure contains these fields:
ws_row The number of rows, in characters, contained in the window
ws_col The number of columns, in characters, contained in the window
ws_xpixel The horizontal size, in pixels, of the window (zero if the size is not known or if
pixel values are not meaningful)
ws_ypixel The vertical size, in pixels, of the window (zero if the size is not known or if
pixel values are not meaningful)
If the function is called with a request value of TIOCSWINSZ and if a value in the winsize
structure has changed since the last call, a SIGWINCH signal is sent to all processes in the fore-
ground group.
Use From the Guardian Environment
A Guardian process cannot receive the SIGWINCH signal.
Use on Guardian Objects
The filedes parameter can specify a terminal file in /G.
RETURN VALUES
If the ioctl() function succeeds, it returns a value different from -1. The value returned depends
on the device-control function. If an error occurs, the value -1 is returned, and errno is set to
indicate the error.
ERRORS
If any of these conditions occurs, the ioctl() function sets errno to the corresponding value:
[EBADF] The filedes parameter is not a valid descriptor.
[EFAULT] The optional parameter is to be used as an address, but it points outside the pro-
cess address space.
[EINTR] A signal was caught during execution of the function.
[EINVAL] The function was called for a device other than a terminal.
[ENETDOWN]
The filedes parameter specifies a file on a remote HP NonStop node (a remote
$ZTNT process), but communication with the remote node has been lost.
3−62 Hewlett-Packard Company 527186-003