[a] getpwent / setpwent / endpwent
#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 }
- getpwent 逐条访问并返回下一项的结构体指针
- setpwent 打开并返绕至文件开头
- endpwent 关闭所有打开的相关文件
- 各系统至少支持 struct passwd 中的 7 项，FreeBSD 环境下特权进程可获取加密后的密码，其它系统需要使用 struct spwd
[b] getpwuid / getpwnam
#include <pwd.h> struct passwd *getpwuid(uid_t uid) struct passwd *getpwnam(const char *username) //成功返回指针，出错返回 NULL
- 获取指定 uid 或 username 的全部账户信息
[c] getgrent / setgrent / endgrent
#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; }
[d] getgrgid / getgrnam
#include <grp.h> struct group *getgrgid(gid_t gid) struct group *getgrnam(const char *groupname) //成功返回指针，出错返回 NULL
[e] getspent / setspent / endspent
#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; }
- spwd 结构体条目一一对应于 /etc/shadow 的各字段
- 仅适用于 Linux 平台
- FreeBSD 下使用 /etc/master.passwd 及 其对应的 HASH 副本 /etc/spwd.db，通 getpwent 系统函数访问
[f] getspnam
#include <shadow.h> struct spwd *getspnam(const char *username) //出错返回 NULL
- 仅适用于 Linux 平台
[g] getgroups
#include <unistd.h> int getgroups(int gidsetsize, gid_t grouplist[]) //成功返回附属组 ID 数量，出错返回 -1
- 成功执行后，附属组信息将写入 grouplist[]
- gidsetsize 指定附属组 ID 的最大数量，若指定为 0，函数返回实际的附属组数量，但不将信息写入 grouplist[]
[h] getutxent / setutxent /endutxent
#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 扩展项 }
- 用于提取用户登陆信息，即 last 命令的输出信息
[i] getutxuser
#include <utmpx.h> struct utmpx *getutxuser(const char *user) //成功返回 utmpx 结构体指针，出错或到达文件末尾返回 NULL
- 提取指定用户名称的登陆信息，FreeBSD 的扩展功能
[j] uname / gethostname /sethostname
#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[]; //硬 件信息 }
- 以上 3 个函数，各条目字段最大长度(含末尾的 null 字节)为 64(Linux) / 256(FreeBSD)
- gethostname 用于获取网络主机名称，信息写入 name 缓冲区，len 指定缓冲区大小，以 null 字节结尾
- sethostname 特权进程可设置网络主机名称，不需要添加 字节
[k] time
#include <time.h> time_t time(time_t *calptr) //成功返回时间值，出错返回 -1
- 返回的时间值是自 1970-01-01 00:00:00 以来经过的秒数
- 若参数不为 NULL，时间值同时写入 calptr 所指向的目标
[l] clock_gettime / clock_settime
#include <sys/time.h> int clock_gettime(clockid_t clock_id, struct timespec *tsp) //成功返回 0，出错返回 -1
int clock_settime(clockid_t clock_id, const struct timespec *tsp) //同上
- clock_id 的值取 CLOCK_REALTIME 时，与 time 函数功能类似，但可以获取更高精度时间值，最高可精确到纳秒
[m] gmtime / localtime
#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 }
- struct tm 中，除 tm_mday 外，其余字段均从 0 开始计数，实际的年份数值是 tm_year + 1990
- gmtime 将世界协调时间(UTC)时间信息写入 struct tm，localtime 则写入本地时间信息
[n] mktime
#include <time.h> time_t mktime(struct tm *tmptr) //成功返回时间值，出错返回 -1
- 将 tm 结构转换成 time_t 时间值
[o] strftime
#include <time.h> size_t strftime(char *s, size_t max, const char *format, const struct tm *tm) //成功返回写入的字符数量，否则返回 0
- 常用于将 tm 时间转换成格式化字符串，之后通过 printf 等函数输出
- 写入 tm 结构体的信息，受时区 TZ 环境变量影响
- format 常用的格式有 %Y(四位年份，如 2019) / %y(两位年份，如 19) / %m(月) / %d(日) / %H(小时) / %M(分钟) /%S(秒)