# `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.

Disponibilidade: Unix, não Emscripten, não WASI.

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>`):

Índice | Atributo | Significado
--- | --- | ---
0 | `pw_name` | Nome de login
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

No Unix tradicional, o campo `pw_passwd` geralmente contém uma senha criptografada com um algoritmo derivado do DES (veja o módulo `crypt`). No entanto, a maioria dos unices modernos usa um sistema chamado de senha shadow. Nesses unices, o campo pw_passwd contém apenas um asterisco (`'*'`) ou a letra `'x'` onde a senha criptografada é armazenada em um arquivo `/etc/shadow` que não é legível para o mundo. Se o campo pw_passwd contém algo útil depende do sistema. Se disponível, o módulo `spwd` deve ser usado onde o acesso à senha criptografada é necessário.

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 esta.

Módulo `spwd`

  Uma interface para o banco de dados de senhas shadow, similar a esta.