"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, not Emscripten, not 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 campo 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.
