HP-UX Reference (11i v2 07/12) - 3 Library Functions A-M (vol 6)

g
getut(3C) getut(3C)
(TO BE OBSOLETED)
NAME
getutent( ), getutid( ), getutline( ), pututline( ), _pututline( ), setutent( ), endutent( ), utmpname( ) - access
utmp file entry
SYNOPSIS
#include <utmp.h>
struct utmp *getutent(void);
struct utmp *getutid(const struct utmp *id);
struct utmp *getutline(const struct utmp *line);
struct utmp *_pututline(const struct utmp *utmp);
void pututline(const struct utmp *utmp);
void setutent(void);
void endutent(void);
int utmpname(const char *file);
Obsolescent Interfaces
int getutent_r(struct utmp **utmp, struct utmp_data *ud);
int getutid_r(
struct utmp *id,
struct utmp **utmp,
struct utmp_data *ud);
int getutline_r(
struct utmp *line,
struct utmp **utmp,
struct utmp_data *ud);
int pututline_r(const struct utmp *utmp, struct utmp_data *ud);
void setutent_r(struct utmp_data *ud);
void endutent_r(struct utmp_data *ud);
int utmpname_r(const char *file);
DESCRIPTION
getutent() , getutid() , and getutline() each return a pointer to a structure of the following
type:
struct utmp {
char ut_user[8]; /* User login name */
char ut_id[4]; /* /etc/inittab id (usually line #) */
char ut_line[12]; /* device name (console, lnxx) */
pid_t ut_pid; /* process id */
short ut_type; /* type of entry */
struct exit_status {
short e_termination; /* Process termination status */
short e_exit; /* Process exit status */
} ut_exit; /* The exit status of a process */
/* marked as DEAD_PROCESS. */
unsigned short ut_reserved1; /* Reserved for future use */
time_t ut_time; /* time entry was made */
char ut_host[16]; /* host name, if remote;NOTSUPPORTED*/
unsigned long ut_addr; /* Internet addr of host, if remote */
};
getutent()
Reads in the next entry from a utmp-like file. If the file is not already open, getu-
tent()
opens it. If it reaches the end of the file, getutent() fails.
getutid() Searches forward from the current point in the utmp file until it finds an entry with a
ut_type matching id−>ut_type if the type specified is RUN_LVL, BOOT_TIME,
OLD_TIME,orNEW_TIME. If the type specified in id is INIT_PROCESS ,
554 Hewlett-Packard Company − 1 − HP-UX 11i Version 2: December 2007 Update