X-Git-Url: https://git.subgeniuskitty.com/unix-history/.git/blobdiff_plain/8c6b2df90eebacd557b851752a2611dde6ed4a3c..be8ee4f021b43684944d8fe26d3d979714531f2b:/usr/share/man/cat3/setttyent.0 diff --git a/usr/share/man/cat3/setttyent.0 b/usr/share/man/cat3/setttyent.0 index ccc2c9cf06..5013ee00ef 100644 --- a/usr/share/man/cat3/setttyent.0 +++ b/usr/share/man/cat3/setttyent.0 @@ -1,132 +1,98 @@ - - - -GETTTYENT(3) 1990 GETTTYENT(3) - - +GETTTYENT(3) BSD Programmer's Manual GETTTYENT(3) NNAAMMEE - getttyent, getttynam, setttyent, endttyent - get ttys file - entry + ggeettttttyyeenntt, ggeettttttyynnaamm, sseettttttyyeenntt, eennddttttyyeenntt - get ttys file entry SSYYNNOOPPSSIISS ##iinncclluuddee <> - ssttrruucctt ttttyyeenntt **ggeettttttyyeenntt(()) + _s_t_r_u_c_t _t_t_y_e_n_t _* + ggeettttttyyeenntt(); - ssttrruucctt ttttyyeenntt **ggeettttttyynnaamm((nnaammee)) - cchhaarr **nnaammee;; + _s_t_r_u_c_t _t_t_y_e_n_t _* + ggeettttttyynnaamm(_c_h_a_r _*_n_a_m_e); - sseettttttyyeenntt(()) + _i_n_t + sseettttttyyeenntt(_v_o_i_d); - eennddttttyyeenntt(()) + _i_n_t + eennddttttyyeenntt(_v_o_i_d); 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. + The ggeettttttyyeenntt(), and ggeettttttyynnaamm() functions 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 */ + 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 - - - + _t_y___n_a_m_e The name of the character-special file. + _t_y___g_e_t_t_y The name of the command invoked by init(8) to initialize tty + line characteristics. + _t_y___t_y_p_e The name of the default terminal type connected to this tty + line. -GETTTYENT(3) 1990 GETTTYENT(3) + _t_y___s_t_a_t_u_s A mask of bit fields which indicate various actions allowed + on this tty line. The possible flags are as follows: + TTY_ON Enables logins (i.e., init(8) will start the com- + mand 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 ter- + minal. - 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). + _t_y___w_i_n_d_o_w The command to execute for a window system associated with + the line. - TTY_SECURE + _t_y___c_o_m_m_e_n_t Any trailing comment field, with any leading hash marks + (``#'') or whitespace removed. - Allow users with a uid of 0 to login on this terminal. + 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. - 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. + See ttys(5) for a more complete discussion of the meaning and usage of + the fields. - 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. + The ggeettttttyyeenntt() function reads the next line from the ttys file, opening + the file if necessary. The sseettttttyyeenntt() function rewinds the file if + open, or opens the file if it is unopened. The eennddttttyyeenntt() function + closes any open files. - 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 + The ggeettttttyynnaamm() function searches from the beginning of the file until a matching _n_a_m_e is found (or until EOF is encountered). +RREETTUURRNN VVAALLUUEESS + The routines ggeettttttyyeenntt() and ggeettttttyynnaamm() return a null pointer on EOF or + error. The sseettttttyyeenntt() function and eennddttttyyeenntt() return 0 on failure and + 1 on success. + FFIILLEESS /etc/ttys SSEEEE AALLSSOO - login(1), ttyslot(3), gettytab(5), termcap(5), ttys(5), - getty(8), init(8) + 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. +HHIISSTTOORRYY + The ggeettttttyyeenntt(), ggeettttttyynnaamm(), sseettttttyyeenntt(), and eennddttttyyeenntt() functions ap- + peared in 4.3BSD. 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 - - + These functions use static data storage; if the data is needed for future + use, it should be copied before any subsequent calls overwrite it. +4.3 Berkeley Distribution June 4, 1993 2