/dev/console

device names for Windows console 

Device


SYNOPSIS

/dev/console

/dev/tty

/dev/tty/nnn

CONIN

CONOUT

CON:

CON

struct winsize {
	unsigned short ws_row;
	unsigned short ws_col;
	unsigned short ws_xpixel;
	unsigned short ws_ypixel;
};


DESCRIPTION

All of the above path names are recognized as referring to the Windows console attached to the current process. The /dev/tty/nnn refers to the console for the process group; nnn must be the result of getpgrp(). The last four forms are Windows special device names for the console which are also recognized by the NuTCRACKER Platform.

Consoles can be opened for reading, for writing, or both. If a console is not currently attached to the process (for example, in the case of a daemon/service, or a pure-GUI (Windows-subsystem) application), the open() fails unless O_CREAT is specified in the flags to open(). In this case, a new Windows console is created and attached to the process. This is useful, for example, when debugging a Windows-subsystem (that is, pure GUI) application. You can use freopen() to attach stdin, stdout, and/or stderr to access the new console through stdio.

Supported ioctl() Requests

TCGETS, TCSETS, TCSETSF, TCSETSW  

These ioctl() requests are used to get and set termios parameters, and are documented under struct termios. The argument to the ioctl() request is a pointer to a termios structure.

TCFLSH  

This ioctl() request is used to flush pending input and output, and is documented under struct termios.

TCSBRK  

This ioctl() request is used to send a break, and is documented under struct termios.

TCXONC  

This ioctl() request is used for flow control, and is documented under struct termios.

TIOCGWINSZ, TIOCSWINSZ  

These ioctl() requests are used to get and set the size of the console window. The argument to the ioctl() request is a pointer to a winsize structure. The fields of this structure specify the height and width of the console window, in characters, and in pixels.

TCGETA, TCSETA, TCSETAF, TCSETAW  

These ioctl() requests are deprecated. They support the older form of struct termio terminal parameters. Use struct termios and related requests instead.

TIOCGSIZE, TIOCSSIZE  

These ioctl() requests are deprecated. They support the older form of struct ttysize window-size requests. Use struct winsize and related requests instead.


PORTING ISSUES

Refer to Console Escape Sequences in the PTC MKS Toolkit UNIX to Windows Porting Guide for a listing of the escape sequences recognized on input and output for console devices.

The NuTCRACKER Platform does not currently support the TIOCSWINSZ request, because of limitations in the Win32 console API.


AVAILABILITY

PTC MKS Toolkit for Professional Developers
PTC MKS Toolkit for Professional Developers 64-Bit Edition
PTC MKS Toolkit for Enterprise Developers
PTC MKS Toolkit for Enterprise Developers 64-Bit Edition


SEE ALSO

Miscellaneous:
/dev/com, struct termios


PTC MKS Toolkit 10.3 Documentation Build 39.