[0m


GETTTYENT(3)	    UNIX Programmer's Manual	     GETTTYENT(3)



[1mNAME
     [0mgetttyent, getttynam, setttyent, endttyent - get ttys file
     entry

[1mSYNOPSIS
     #include <ttyent.h>

     struct ttyent *getttyent()

     struct ttyent *getttynam(name)
     char *name;

     setttyent()

     endttyent()

DESCRIPTION
     [0m_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.

	  /*
	   * $Header: /smsa/bsd:include/ttyent.h:bsd  1.5  $
	   * $Source: /smsa/bsd:include/ttyent.h: $
	   *
	   * Copyright (c) 1988 Acorn Computers Ltd., Cambridge, England
	   */
	  /*
	   * Copyright (c) 1983 Regents of the University of California.
	   * All rights reserved.  The Berkeley software License Agreement
	   * specifies the terms and conditions for redistribution.
	   *
	   *   @(#)ttyent.h   5.1 (Berkeley) 5/30/85
	   */

	  #ifndef __ttyent_h
	  #define __ttyent_h

	  struct    ttyent { /* see getttyent(3) */
	       char *ty_name; /* terminal device name */
	       char *ty_getty;	   /* command to execute, usually getty */
	       char *ty_type; /* terminal type for termcap (3X) */
	       int  ty_status;	   /* status flags (see below for defines) */
	       char	 *ty_window;	/* command to start up window manager */
	       char *ty_comment;   /* usually the location of the terminal */
	  };

	  #define TTY_ON      0x1  /* enable logins (startup getty) */
	  #define TTY_SECURE  0x2  /* allow root to login */

	  extern struct ttyent *getttyent(void);
	  extern struct ttyent *getttynam(char *);



Printed 31/3/92     Revision 1.2 of 19/10/88			1






GETTTYENT(3)	    UNIX Programmer's Manual	     GETTTYENT(3)



	  #endif/*__ttyent_h*/

	  /* EOF ttyent.h */

     ty_name	  is the name of the  character-special  file  in
		  the directory ``/dev".  For various reasons, it
		  must reside in the directory ``/dev".

     ty_getty	  is the  command  (usually  _g_e_t_t_y(8))	which  is
		  invoked  by _i_n_i_t to initialize tty line charac-
		  teristics.  In fact, any arbitrary command  can
		  be  used; a typical use is to initiate a termi-
		  nal emulator in a window system.

     ty_type	  is the name of the default terminal  type  con-
		  nected  to  this  tty line. This is typically a
		  name	from  the  _t_e_r_m_c_a_p(5)  data  base.    The
		  environment variable `TERM' is initialized with
		  this name by _g_e_t_t_y(8) or _l_o_g_i_n(1).

     ty_status	  is a mask of bit fields which indicate  various
		  actions  to  be  allowed  on this tty line. The
		  following is a description of each flag.

		  TTY_ON       Enables logins (i.e., _i_n_i_t(8) will
			       start  the specified ``getty" com-
			       mand on this entry).

		  TTY_SECURE   Allows root to login on this  ter-
			       minal.  Note that `TTY_ON' must be
			       included for this to be useful.

     ty_window	  is the command to execute for a  window  system
		  associated  with  the  line.	The window system
		  will be started before the command specified in
		  the  _t_y__g_e_t_t_y  entry	is  executed.  If none is
		  specified, this will be null.

     ty_comment   is the trailing comment field, if any; a  lead-
		  ing delimiter and white space will be removed.

     _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; _e_n_d_t_t_y_e_n_t
     closes it.

     _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).

[1mFILES
     [0m/etc/ttys





Printed 31/3/92     Revision 1.2 of 19/10/88			2






GETTTYENT(3)	    UNIX Programmer's Manual	     GETTTYENT(3)



[1mSEE ALSO
     [0mlogin(1),	ttyslot(3),  ttys(5),  gettytab(5),   termcap(5),
     getty(8), init(8)

[1mDIAGNOSTICS
     [0mNull pointer (0) returned on EOF or error.

[1mBUGS
     [0mAll information is contained in a static area so it must  be
     copied if it is to be saved.













































Printed 31/3/92     Revision 1.2 of 19/10/88			3



[0m