This document is for an old version of Python that is no longer supported. You should upgrade and read the documentação do Python para versão estável atual.

# 36.2. `pwd` — A senha do banco de dados

Este módulo provê acesso ao banco de dados das contas de usuário do sistema e suas respectivas senhas. Isto está disponível para todas as versões do Unix.

As entradas do banco de dados de senhas são reportadas como um objeto do tipo tupla, cujos atributos correspondem aos membros da estrutura `passwd` (Campos dos atributos abaixo, veja `<pwd.h>`):

Index | Atributo | Significado
--- | --- | ---
0 | `pw_name` | Nome de acesso
1 | `pw_passwd` | Senha encriptada opcional
2 | `pw_uid` | ID numérico do usuário
3 | `pw_gid` | ID numérico do grupo
4 | `pw_gecos` | Nome do usuário ou campor de comentário
5 | `pw_dir` | Diretório home do usuário
6 | `pw_shell` | Interpretador de comandos do usuário

O uid e o gid são números inteiros, e os outros são strings. `KeyError` é levando se o campo requerido não puder ser encontrado.

Nota

Em Unix tradicional, o campo `pw_passwd` geralmente contém uma senha encriptada com um algoritmo derivado de DES (veja o módulo `crypt`). No entanto, a maioria dos Unixes modernos usam o chamado sistema shadow password. Nesses Unixes o campo pw_passwd só contém um asterisco (`'*'`) ou a letra `'x'` e a senha encriptada é guardada no arquivo `/etc/shadow` o qual não é permitido o acesso irrestrito a leitura. Se o campo pw_passwd contém alguma coisa útil dependerá do sistema. Se disponível, o módulo `spwd` deve ser usado para acessar onde a senha for requerida.

Isto define os seguintes itens

`pwd.``getpwuid`(uid)

  Retorna a entrada do banco de dados de senhas para um dado ID de usuário

`pwd.``getpwnam`(name)

  Retorna a entrada do banco de dados de senhas para um dado nome de usuário

`pwd.``getpwall`()

  Retorna uma lista de todos as entradas disponíveis no banco de dados de senhas, em uma ordem arbitrária.

Ver também

Módulo `grp`

  Uma interface para o banco de dados do grupo, similar a essa.

Módulo `spwd`

  Uma interface para o banco de dados de shadow passwords, similar a essa.