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