GETPWNAM(3)

NOME
getpwnam, getpwuid - obtêm entrada do arquivo de senhas

SINÓPSE
#include <pwd.h>
#include <sys/types.h>

struct passwd *getpwnam(const char * nome);

struct passwd *getpwuid(uid_t uid);

DESCRIÇÃO
A função getpwnam() retorna um ponteiro a uma estrutura contendo os campos de uma linha quebrados do /etc/passwd para a entrada que corresponde ao nome de usuário nome.

A função getpwuid() retorna um ponteiro a uma estrutura contendo os campos de uma linha quebrados do /etc/passwd para a entrada que corresponde à uid do usuário uid.

A estrutura passwd é definida em <pwd.h> conforme abaixo:

    struct passwd {
            char    *pw_name;		/* nome do usuário */
            char    *pw_passwd;		/* senha do usuário */
            uid_t   pw_uid;			/* id do usuário */
            gid_t   pw_gid;			/* id de grupo */
            char    *pw_gecos;      	/* nome real */
            char    *pw_dir;  		/* diretório home */
            char    *pw_shell;      	/* programa shell */
    };

VALORES RETORNADOS
As funções getpwnam() e getpwuid() retornam um ponteiro à estrutura passwd, ou NULO se a entrada correspondente não for encontrada ou se ocorrer algum erro.

ERROS

ENOMEM
    Memória insuficiente para alocar estrutura passwd.

ARQUIVOS

/etc/passwd
    arquivo de banco de dados de senhas

DE ACORDO COM
SVID 3, POSIX, BSD 4.3.

VEJA TAMBÉM
fgetpwent(3), getgrnam(3), getpwent(3), setpwent(3), endpwent(3), getpw(3), putpwent(3), passwd(5).

TRADUZIDO POR LDP-BR em 10/07/2001.

  Tradução:
E. A. Tacão <tacao@conectiva.com.br>

  Revisão.:
André Luiz Fassone <lonely_wolf@ig.com.br>