4.3BSD-Reno/share/man/cat3/endttyent.0

GETTTYENT(3)		      1990		     GETTTYENT(3)



NNAAMMEE
     getttyent, getttynam, setttyent, endttyent - get ttys file
     entry

SSYYNNOOPPSSIISS
     ##iinncclluuddee <<ttttyyeenntt..hh>>

     ssttrruucctt ttttyyeenntt **ggeettttttyyeenntt(())

     ssttrruucctt ttttyyeenntt **ggeettttttyynnaamm((nnaammee))
     cchhaarr **nnaammee;;

     sseettttttyyeenntt(())

     eennddttttyyeenntt(())

DDEESSCCRRIIPPTTIIOONN
     _G_e_t_t_t_y_e_n_t, and _g_e_t_t_t_y_n_a_m each return a pointer to an object,
     with the following structure, containing the broken-out
     fields of a line from the tty description file.

     struct ttyent {
	  char *ty_name;	   /* terminal device name */
	  char *ty_getty;	   /* command to execute */
	  char *ty_type;	   /* terminal type */
     #define   TTY_ON	      0x01 /* enable logins */
     #define   TTY_SECURE     0x02 /* allow uid of 0 to login */
	  int  ty_status;	   /* flag values */
	  char *ty_window;	   /* command for window manager */
	  char *ty_comment;	   /* comment field */
     };

     The fields are as follows:

     ty_name
	  The name of the character-special file.

     ty_getty
	  The name of the command invoked by _i_n_i_t(8) to initial-
	  ize tty line characteristics.

     ty_type
	  The name of the default terminal type connected to this
	  tty line.

     ty_status
	  A mask of bit fields which indicate various actions
	  allowed on this tty line.  The possible flags are as
	  follows:

	  TTY_ON




Printed 7/27/90               June				1






GETTTYENT(3)		      1990		     GETTTYENT(3)



	  Enables logins (i.e., _i_n_i_t(8) will start the command
	  referenced by _t_y__g_e_t_t_y on this entry).

	  TTY_SECURE

	  Allow users with a uid of 0 to login on this terminal.

     ty_window
	  The command to execute for a window system associated
	  with the line.

     ty_comment
	  Any trailing comment field, with any leading hash marks
	  (``#'') or whitespace removed.

     If any of the fields pointing to character strings are
     unspecified, they are returned as null pointers.  The field
     _t_y__s_t_a_t_u_s will be zero if no flag values are specified.

     See _t_t_y_s(5) for a more complete discussion of the meaning
     and usage of the fields.

     _G_e_t_t_t_y_e_n_t reads the next line from the ttys file, opening
     the file if necessary.  _S_e_t_t_t_y_e_n_t rewinds the file if open,
     or opens the file if it is unopened.  _E_n_d_t_t_y_e_n_t closes any
     open files.

     _G_e_t_t_t_y_n_a_m searches from the beginning of the file until a
     matching _n_a_m_e is found (or until EOF is encountered).

FFIILLEESS
     /etc/ttys

SSEEEE AALLSSOO
     login(1), ttyslot(3), gettytab(5), termcap(5), ttys(5),
     getty(8), init(8)

DDIIAAGGNNOOSSTTIICCSS
     The routines _g_e_t_t_t_y_e_n_t and _g_e_t_t_t_y_n_a_m return a null pointer
     on EOF or error.  _S_e_t_t_t_y_e_n_t and _e_n_d_t_t_y_e_n_t return 0 on
     failure and 1 on success.

BBUUGGSS
     All information is contained in a static area so it must be
     copied if it is to be saved.










Printed 7/27/90               June				2