getpwnam

Autres langues

Langue: ko

Version: 1996년 5월 27일 (fedora - 25/11/07)

Section: 3 (Bibliothèques de fonctions)

이름

getpwnam, getpwuid - 패스워드 파일 엔트리를 가져온다.

사용법

 #include <pwd.h>
 #include <sys/types.h>
 
 struct passwd *getpwnam(const char * name);
 
 struct passwd *getpwuid(uid_t uid);
 

설명

getpwnam() 함수는 사용자 이름 name과 일치하는 엔트리를 위해 /etc/passwd 에서 뽑아낸 라인 필드들을 포함하는 구조체에 대한 포인터를 반환한다.

getpwuid() 함수는 사용자 uid와 일치하는 엔트리를 위해 /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 프로그램 */
 };
 
 

반환값

getpwnam()getpwuid() 함수는 패스워드 구조체에 대한 포인터를 반환하거나 일치하는 엔트리가 발견되지 않거나 에러가 발생한다면 NULL을 반환한다.

에러

ENOMEM
패스워드 구조체를 할당할 메모리가 충분하지 않다.

파일

/etc/passwd
패스워드 데이터 베이스 파일

호환

SVID 3, POSIX, BSD 4.3

관련 항목

fgetpwent(3), getgrnam(3), getpwent(3), setpwent(3), endpwent(3), getpw(3), putpwent(3), passwd(5)

역자

정강훈 <skyeyes@soback.kornet.net>, 2001년 4월 30일