| .\" Copyright 2002 walter harms (walter.harms@informatik.uni-oldenburg.de) |
| .\" Distributed under GPL |
| .\" |
| .TH GETTTYENT 3 2002-07-18 "glibc" |
| .SH NAME |
| getttyent, getttynam, setttyent, endttyent \- get ttys file entry |
| .SH SYNOPSIS |
| .sp |
| .B "#include <ttyent.h>" |
| .sp |
| .B "struct ttyent *getttyent(void);" |
| .sp |
| .BI "struct ttyent *getttynam(const char *" name ); |
| .sp |
| .B "int setttyent(void);" |
| .sp |
| .B "int endttyent(void);" |
| .SH DESCRIPTION |
| These functions provide an interface to the file |
| .B _PATH_TTYS |
| (e.g., |
| .IR /etc/ttys ). |
| |
| The function |
| .BR setttyent () |
| opens the file or rewinds it if already open. |
| |
| The function |
| .BR endttyent () |
| closes the file. |
| |
| The function |
| .BR getttynam () |
| searches for a given ttyname in the file. It returns a pointer to a |
| struct ttyent (description below). |
| |
| The function |
| .BR getttyent () |
| opens the file _PATH_TTYS (if necessary) and returns the first entry. |
| If the file is already open, the next entry. |
| |
| .SS "The ttyent structure" |
| .nf |
| struct ttyent { |
| char *ty_name; /* terminal device name */ |
| char *ty_getty; /* command to execute, usually getty */ |
| char *ty_type; /* terminal type for termcap */ |
| int ty_status; /* status flags */ |
| char *ty_window; /* command to start up window manager */ |
| char *ty_comment; /* comment field */ |
| }; |
| .fi |
| |
| .I ty_status |
| can be |
| .br |
| .nf |
| #define TTY_ON 0x01 /* enable logins (start ty_getty program) */ |
| #define TTY_SECURE 0x02 /* allow UID 0 to login */ |
| .fi |
| .SH NOTES |
| Under Linux the file |
| .IR /etc/ttys , |
| and the functions described above, are not used. |
| .SH "SEE ALSO" |
| .BR ttyname (3), |
| .BR ttyslot (3) |