Open System Services System Calls Reference Manual (G06.29+, H06.08+, J06.03+)

System Functions (f - i) ioctl(2)
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.
NOTES
If your application uses the Cluster I/O Protocols (CIP) subsystem, options for this function
might not be supported or might result in behaviors that are different from those described in this
reference page. For more information about the Cluster I/O Protocols, see the Cluster I/O Proto-
cols (CIP) Configuration and Management Manual.
On systems running H06.24 or later H-series RVUs or J06.13 or later J-series RVUs, you can use
this function with 32-bit or 64-bit OSS applications.
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.
527186-023 Hewlett-Packard Company 3−99