GETPWENT
Section: 리눅스 프로그래머 매뉴얼 (3)
Updated: 1996년 5월 27일
Index
Return to Main Contents
이름
getpwent, setpwent, endpwent - 패스워드 파일 엔트리를 가져온다.
사용법
#include <pwd.h>
#include <sys/types.h>
struct passwd *getpwent(void);
void setpwent(void);
void endpwent(void);
설명
getpwent() 함수는 /etc/passwd에서 뽑아낸 라인 필드들을 포함하는
구조체에 대한 포인터를 반환한다. 함수를 처음 호출하면 이 함수는 처음 엔트리를
반환한다;그후, 이 함수는 연속적인 엔트리를 반환한다.
setpwent() 함수는 파일 포인터를 /etc/passwd 파일의 시작으로
되 돌린다.
endpwent() 함수는 /etc/passwd 파일을 감는다.
passwd 구조체는 다음처럼 <pwd.h>에 정의되어 있다:
-
struct passwd {
char *pw_name; /* 유저 이름 */
char *pw_passwd; /* 유저 패스워드 */
uid_t pw_uid; /* 유저 id */
gid_t pw_gid; /* 그룹 id */
char *pw_gecos; /* 실제 이름 */
char *pw_dir; /* 홈 디렉토리 */
char *pw_shell; /* shell 프로그램 */
};
반환값
getpwent() 함수는 passwd 구조체를 반환하거나, 만일 더이상 엔트리가 없거나 에러가 발생한다면 NULL을 반환한다.
에러
- ENOMEM
-
패스워드 구조체를 할당할 메모리가 충분하지 않다.
파일
- /etc/passwd
-
패스워드 데이터 베이스 파일
호환
SVID 3, BSD 4.3
관련 항목
fgetpwent(3), getpwnam(3), getpwuid(3), getpw(3),
putpwent(3),
passwd(5).
역자
정강훈 <skyeyes@soback.kornet.net>, 2001년 4월 30일
Index
- 이름
-
- 사용법
-
- 설명
-
- 반환값
-
- 에러
-
- 파일
-
- 호환
-
- 관련 항목
-
- 역자
-
This document was created by
man2html,
using the manual pages.
Time: 08:07:01 GMT, March 25, 2004