2004-11-03 13:51:07 +00:00
|
|
|
.\" Copyright 2002 walter harms (walter.harms@informatik.uni-oldenburg.de)
|
|
|
|
|
.\" Distributed under GPL
|
2007-04-12 22:42:49 +00:00
|
|
|
.\"
|
2007-05-18 09:55:10 +00:00
|
|
|
.TH GETTTYENT 3 2002-07-18 "GNU" "Linux Programmer's Manual"
|
2004-11-03 13:51:07 +00:00
|
|
|
.SH NAME
|
2005-07-06 08:00:30 +00:00
|
|
|
getttyent, getttynam, setttyent, endttyent \- get ttys file entry
|
2004-11-03 13:51:07 +00:00
|
|
|
.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 ).
|
|
|
|
|
|
2007-04-12 22:42:49 +00:00
|
|
|
The function
|
2004-11-03 13:51:07 +00:00
|
|
|
.BR setttyent ()
|
|
|
|
|
opens the file or rewinds it if already open.
|
|
|
|
|
|
|
|
|
|
The function
|
2005-10-19 16:30:05 +00:00
|
|
|
.BR endttyent ()
|
2004-11-03 13:51:07 +00:00
|
|
|
closes the file.
|
|
|
|
|
|
2007-04-12 22:42:49 +00:00
|
|
|
The function
|
2004-11-03 13:51:07 +00:00
|
|
|
.BR getttynam ()
|
2007-04-12 22:42:49 +00:00
|
|
|
searches for a given ttyname in the file.
|
|
|
|
|
It returns a pointer to a
|
2004-11-03 13:51:07 +00:00
|
|
|
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) */
|
2005-07-18 15:51:22 +00:00
|
|
|
#define TTY_SECURE 0x02 /* allow UID 0 to login */
|
2004-11-03 13:51:07 +00:00
|
|
|
.fi
|
2007-05-19 04:30:20 +00:00
|
|
|
.SH "CONFORMING TO"
|
|
|
|
|
Not in POSIX.1-2001.
|
|
|
|
|
Present on the BSDs, and perhaps other systems.
|
2004-11-03 13:51:07 +00:00
|
|
|
.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)
|
