"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 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:

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

  Módulo "spwd"
     Uma interface para o banco de dados de shadow passwords, similar
     a essa.
