[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 特权进程可设置网络主机名称,不需要添加 \0 字节
[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(秒)