| ENDUTXENT(3) | Library Functions Manual | ENDUTXENT(3) | 
endutxent, getutxent,
  getutxid, getutxline,
  pututxline, setutxent —
#include <utmpx.h>
void
  
  endutxent(void);
struct utmpx *
  
  getutxent(void);
struct utmpx *
  
  getutxid(const
    struct utmpx *);
struct utmpx *
  
  getutxline(const
    struct utmpx *);
struct utmpx *
  
  pututxline(const
    struct utmpx *);
void
  
  setutxent(void);
getutxent() reads the next entry from the
    database; if the database was not yet open, it also opens it.
    setutxent() resets the database, so that the next
    getutxent() call will get the first entry.
    endutxent() closes the database.
getutxid() returns the next entry of the
    type specified in its argument's ut_type field, or
    NULL if none is found.
    getutxline() returns the next
    LOGIN_PROCESS or
    USER_PROCESS entry which has the same name as
    specified in the ut_line field, or
    NULL if no match is found.
pututxline() adds the argument
    utmpx(5) entry line to the
    accounting database, replacing a previous entry for the same user if it
    exists.
utmpx structure has the following definition:
struct utmpx {
        char ut_name[_UTX_USERSIZE];    /* login name */
        char ut_id[_UTX_IDSIZE];        /* inittab id */
        char ut_line[_UTX_LINESIZE];    /* tty name */
        char ut_host[_UTX_HOSTSIZE];    /* host name */
        uint16_t ut_session;            /* session id used for windowing */
        uint16_t ut_type;               /* type of this entry */
        pid_t ut_pid;                   /* process id creating the entry */
        struct {
                uint16_t e_termination; /* process termination signal */
                uint16_t e_exit;        /* process exit status */
        } ut_exit;
        struct sockaddr_storage ut_ss;  /* address where entry was made from */
        struct timeval ut_tv;           /* time entry was created */
        uint32_t ut_pad[10];            /* reserved for future use */
};
Valid entries for ut_type are:
BOOT_TIMEDEAD_PROCESSEMPTYINIT_PROCESSLOGIN_PROCESSNEW_TIMEOLD_TIMERUN_LVLUSER_PROCESSgetutxent() returns the next entry, or
  NULL on failure (end of database or problems reading
  from the database). getutxid() and
  getutxline() return the matching structure on success,
  or NULL if no match was found.
  pututxline() returns the structure that was
  successfully written, or NULL.
endutxent(), getutxent(),
  getutxid(), getutxline(),
  pututxline(), setutxent() all
  conform to IEEE Std 1003.1-2001
  (“POSIX.1”) (XSI extension), and previously to
  X/Open Portability Guide Issue 4, Version 2
  (“XPG4.2”). The fields ut_user,
  ut_id, ut_line,
  ut_pid, ut_type, and
  ut_tv conform to IEEE Std 1003.1-2001
  (“POSIX.1”) (XSI extension), and previously to
  X/Open Portability Guide Issue 4, Version 2
  (“XPG4.2”).
| September 26, 2002 | NetBSD 9.3 |