NAME¶

TIOCGWINSZ, TIOCSWINSZ - get and set window size

LIBRARY¶

Standard C library (libc, -lc)

SYNOPSIS¶

#include <asm/termbits.h>  /* Definition of TIOC*WINSZ constants */
#include <sys/ioctl.h>

int ioctl(int fd, TIOCGWINSZ, struct winsize *argp);
int ioctl(int fd, TIOCSWINSZ, const struct winsize *argp);

#include <asm/termios.h>

struct winsize {
    unsigned short ws_row;
    unsigned short ws_col;
    unsigned short ws_xpixel;  /* unused */
    unsigned short ws_ypixel;  /* unused */
};

DESCRIPTION¶

Window sizes are kept in the kernel, but not used by the kernel (except in the case of virtual consoles, where the kernel will update the window size when the size of the virtual console changes, for example, by loading a new font).

TIOCGWINSZ

Get window size.

TIOCSWINSZ

Set window size.

When the window size changes, a SIGWINCH signal is sent to the foreground process group.

RETURN VALUE¶

On success, 0 is returned. On error, -1 is returned, and errno is set to indicate the error.

SEE ALSO¶

ioctl(2), ioctl_tty(2const)