1 files changed, 67 insertions, 0 deletions
diff --git a/man3/getttyent.3 b/man3/getttyent.3
new file mode 100644
index 000000000..0c8e74702
--- /dev/null
+++ b/man3/getttyent.3
@@ -0,0 +1,67 @@
+.\"  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)