[06]APUE：系统数据文件和信息

#include <pwd.h>
struct passwd *getpwent(void) //成功返回指针，出错或到过文件末尾返回 NULL
void setpwent(void)
void endpwent(void)

struct passwd {
    char    *pw_name;
    char    *pw_passwd; //口令
    uid_t    pw_uid;
    gid_t    pw_gid;
    char    *pw_geos; //用户信息
    char    *pw_dir; //家目录
    char    *pw_shell;
    char    *pw_class; //用户访问类，仅 BSD
    time_t    pw_change; //下次修改口令时间，仅 BSD
    time_t    pw_expire; //账户有效时间，仅 BSD
} 

#include <pwd.h>
struct passwd *getpwuid(uid_t uid)
struct passwd *getpwnam(const char *username)
//成功返回指针，出错返回 NULL 

#include <grp.h>
struct group *getgrent(void) //成功返回指针，出错或到达文件末尾返回 NULL
void setgrent(void)
void endgrent(void)

struct group {
    char    *gr_name;
    char    *gr_passwd;
    int    gr_gid;
    char    **gr_mem;
}

#include <grp.h>
struct group *getgrgid(gid_t gid)
struct group *getgrnam(const char *groupname)
//成功返回指针，出错返回 NULL 

#include <shadow.h>
struct spwd *getspent(void) //出错返回 NULL
void setspent(void)
void endspent(void)

struct spwd {
    char    *sp_namp;
    char    *sp_pwdp;int    sp_lstchg;
    int    sp_min;
    int    sp_max;
    int    sp_warn;
    int    sp_inact;
    int    sp_expire;
    unsigned int    sp_flag;
} 

#include <shadow.h>
struct spwd *getspnam(const char *username) //出错返回 NULL 

#include <unistd.h>
int getgroups(int gidsetsize, gid_t grouplist[]) //成功返回附属组 ID 数量，出错返回 -1 

#include <utmpx.h>
struct utmpx *getutxent(void) //成功返回指针，出错或到达文件末尾返回 NULL
void setutxent(void)
void endutxent(void) 

struct utmpx {
    short    ut_type;    //条目类别
    struct timeval    ut_tv;    //登陆起始时间
    pid_t    ut_pid;    //进程 id
    char    ut_id[];    //记录标识
    char    ut_user[];    //用户登陆名
    char    ut_line[];    //tty 名称，形如 /dev/ttyN
    char    ut_host[];    //远程主机名称，FreeBSD 扩展项
} 

#include <utmpx.h>
struct utmpx *getutxuser(const char *user) //成功返回 utmpx 结构体指针，出错或到达文件末尾返回 NULL 

#include <sys/utsname.h>
int uname(struct utsname *name) //成功返回非负值，出错返回 -1
#include <unistd.h>
int gethostname(char *name, int len)
int sethostname(const char *name, int len)
//成功返回 0，出错返回 -1

struct utsname {
    char    sysname[]; //系统类别名，如 Linux
    char nodename[]; //节点名称，不可用于网络通信
    char    release[]; //系统主版本号
    char    version[]; //系统次版本号
    char    machine[]; //硬 件信息
} 

#include <time.h>
time_t time(time_t *calptr) //成功返回时间值，出错返回 -1 

#include <sys/time.h>
int clock_gettime(clockid_t clock_id, struct timespec *tsp) //成功返回 0，出错返回 -1 

#include <time.h>
struct tm *gmtime(const time_t *calptr)
struct tm *localtime(const time_t *calptr)
//成功返回指针，出错返回 NULL 

struct tm {
    int    tm_sec; //0-60
    int    tm_min; //0-59
    int    tm_hour; //0-23
    int    tm_mday;  //1-31
    int    tm_mon; //0-11
    int    tm_year; //自 1990 以后的年份计数
    int    tm_wday; //0-6
    int    tm_yday; //0-365
    int    tm_isdst; //夏令时标志：<0, 0, >0
} 

#include <time.h>
time_t mktime(struct tm *tmptr) //成功返回时间值，出错返回 -1 

#include <time.h>
size_t strftime(char *s, size_t max, const char *format, const struct tm *tm) //成功返回写入的字符数量，否则返回 0