tcsetwinsize3

Usage

Library

Standard C Library (libc, -lc)

Overview

The tcgetwinsize() function gets the terminal window size of the terminal of which fd is an open file descriptor and stores it in the winsize structure of which w is a pointer.

The tcsetwinsize() function sets the terminal window size of the terminal of which fd is an open file descriptor from the winsize structure referenced by w. The change occurs immediately. If the terminal window size of the terminal is changed successfully to have a value that is different from the value that it had before the tcsetwinsize() call, then the SIGWINCH signal is sent to all those members of the foreground process group of the terminal that have the terminal as their controlling terminal.

The above declaration of struct winsize may not be literal. It is provided only to list the accessible members. Therefore, before calling tcsetwinsize(), the members of the winsize structure must be initialized by calling tcgetwinsize(). The information in a winsize structure is stored by the kernel in order to provide a consistent interface, but it is not used by the kernel.

Return value

The tcgetwinsize() and tcsetwinsize() functions return the value 0 if successful; otherwise the value -1 is returned and the global variable errno is set to indicate the error. The terminal window size remains unchanged if tcsetwinsize() fails.

Errors

The following are the possible failure conditions:

[EBADF]

The fd argument to tcgetwinsize() or to tcsetwinsize() is not a valid file descriptor.

[ENOTTY]

The fd argument to tcgetwinsize() or to tcsetwinsize() is not associated with a character special device.

[EINVAL]

The w argument to tcsetwinsize() is not valid.

[EFAULT]

The w argument to tcgetwinsize() or to tcsetwinsize() points outside the process's allocated address space.