## getpwent ## 從密碼文件中取得賬號的數據 ### 相關函數 ### getpw，fgetpwent，getpwnam，getpwuid，setpwent，endpwent ### 表頭文件 ### ``` #include<pwd.h> #include<sys/types.h> ``` ### 定義函數 ### ``` strcut passwd *getpwent(void); ``` ### 函數說明 ### getpwent（）用來從密碼文件（/etc/passwd）中讀取一項用戶數據，該用戶的數據以passwd 結構返回。第一次調用時會取得第一位用戶數據，之后每調用一次就會返回下一項數據，直到已無任何數據時返回NULL。 passwd 結構定義如下 ``` struct passwd{ char * pw_name; /*用戶賬號*/ char * pw_passwd; /*用戶密碼*/ uid_t pw_uid; /*用戶識別碼*/ gid_t pw_gid; /*組識別碼*/ char * pw_gecos; /*用戶全名*/ char * pw_dir; /*家目錄*/ char * pw_shell; /* 所使用的shell路徑*/ }; ``` ### 返回值 ### 返回passwd 結構數據，如果返回NULL 則表示已無數據，或有錯誤發生。 ### 附加說明 ### getpwent()在第一次調用時會打開密碼文件，讀取數據完畢后可使用endpwent()來關閉該密碼文件。錯誤代碼ENOMEM 內存不足，無法配置passwd結構。 ### 范例 ### ``` #include<pwd.h> #include<sys/types.h> main() { struct passwd *user; while((user = getpwent())!=0){ printf(“%s:%d:%d:%s:%s:%s\n”,user->pw_name,user->pw_uid,user->pw_gid, user->pw_gecos,user->pw_dir,user->pw_shell); } endpwent(); } ``` ### 執行 ### ``` root:0:0:root:/root:/bin/bash bin:1:1:bin:/bin: daemon:2:2:daemon:/sbin: adm:3:4:adm:/var/adm: lp:4:7:lp:/var/spool/lpd: sync:5:0:sync:/sbin:/bin/sync shutdown:6:0:shutdown:/sbin:/sbin/shutdown halt:7:0:halt:/sbin:/sbin/halt mail:8:12:mail:/var/spool/mail: news:9:13:news:var/spool/news uucp:10:14:uucp:/var/spool/uucp: operator:11:0:operator :/root: games:12:100:games:/usr/games: gopher:13:30:gopher:/usr/lib/gopher-data: ftp:14:50:FTP User:/home/ftp: nobody:99:99:Nobody:/: xfs:100:101:X Font Server: /etc/Xll/fs:/bin/false gdm:42:42:/home/gdm:/bin/bash kids:500:500: : /home/kids:/bin/bash ```