GETTTYEN.3
上传用户:datang2001
上传日期:2007-02-01
资源大小:53269k
文件大小:3k
源码类别:

操作系统开发

开发平台:

C/C++

  1. GETTTYENT(3)              Minix Programmer's Manual               GETTTYENT(3)
  2. NAME
  3.      getttyent, getttynam, setttyent, endttyent - interface to /etc/ttytab
  4. SYNOPSIS
  5.      #include <ttyent.h>
  6.      struct ttyent *getttyent(void)
  7.      struct ttyent *getttynam(const char *name)
  8.      int setttyent(void)
  9.      void endttyent(void)
  10. DESCRIPTION
  11.      The getttyent functions provide an interface to  the  /etc/ttytab.   (See
  12.      ttytab(5)).
  13.      To read one of these files one calls getttyent() several  times  to  read
  14.      the entries in the table until NULL is returned for end-of-file.
  15.      Getttyname() searches the ttytab file for the given terminal device.   It
  16.      is  equivalent  to a call to setttyent(), several calls to getttyent() to
  17.      locate the entry, and a final endttyent() to close the file.
  18.      Setttyent() opens or rewinds the ttytab database, and endttyent()  closes
  19.      it.  Getttyent()  opens  the  database  if not already open, but does not
  20.      close it.
  21.      The struct ttyent is defined by <ttyent.h> as follows:
  22.      struct ttyent {
  23.          char  *ty_name;      /* Name of the terminal device. */
  24.          char  *ty_type;      /* Terminal type name (termcap(3)). */
  25.          char  **ty_getty;    /* Program to run, normally getty. */
  26.          char  **ty_init;     /* Initialization command, normally stty. */
  27.      };
  28.      A valid entry has at least two strings, so both ty_name and  ty_type  are
  29.      filled  in.   The  optional  ty_getty  and  ty_init  may  be  NULL (field
  30.      omitted), point to a pointer that is NULL (null lenght field,  i.e.  ""),
  31.      or  an array of strings terminated by a NULL (field present).  For now no
  32.      useful distinction can be made between  a  omitted  field  and  an  empty
  33.      field, so treat both cases as an omission.
  34. FILES
  35.      /etc/ttytab    The terminal device database
  36.                                                                              1
  37. GETTTYENT(3)              Minix Programmer's Manual               GETTTYENT(3)
  38. SEE ALSO
  39.      ttyname(3), ttyslot(3), ttytab(5), init(8).
  40. DIAGNOSTICS
  41.      Setttyent() has the same return value and error codes as the open(2) call
  42.      it  uses  to open the ttytab file.  The getxxx() functions return NULL on
  43.      end of file, entry not found, or error.  You can set errno to zero before
  44.      the call and check it after.
  45. NOTES
  46.      Getttyent() and getttynam() return a pointer to static  storage  that  is
  47.      overwritten in each call.
  48.      The Minix struct ttyent has only the ty_name and ty_type fields in common
  49.      with the BSD implementation.  This does not seem to be a problem, because
  50.      most third party software that need to know about terminals only look  at
  51.      the ty_name field.
  52. AUTHOR
  53.      Kees J. Bot (kjb@cs.vu.nl)
  54.                                                                              2