"pwd" --- The password database
*******************************

======================================================================

Este módulo proporciona acceso a la base de datos de cuentas de
usuario y contraseñas de Unix.  Está disponible en todas las versiones
de Unix.

Availability: Unix, not Emscripten, not WASI.

Las entradas de la base de datos de contraseñas se reportan como un
objeto de tipo tupla, cuyos atributos corresponden a los miembros de
la estructura "passwd" (campo Atributo abajo, ver "<pwd.h>"):

+---------+-----------------+-------------------------------+
| Índice  | Atributo        | Significado                   |
|=========|=================|===============================|
| 0       | "pw_name"       | Nombre de usuario             |
+---------+-----------------+-------------------------------+
| 1       | "pw_passwd"     | Contraseña encriptada         |
|         |                 | opcional                      |
+---------+-----------------+-------------------------------+
| 2       | "pw_uid"        | Identificación numérica de    |
|         |                 | usuario                       |
+---------+-----------------+-------------------------------+
| 3       | "pw_gid"        | Identificación del grupo      |
|         |                 | numérico                      |
+---------+-----------------+-------------------------------+
| 4       | "pw_gecos"      | Nombre de usuario o campo de  |
|         |                 | comentarios                   |
+---------+-----------------+-------------------------------+
| 5       | "pw_dir"        | El directorio *home* del      |
|         |                 | usuario                       |
+---------+-----------------+-------------------------------+
| 6       | "pw_shell"      | Intérprete de comandos de     |
|         |                 | usuario                       |
+---------+-----------------+-------------------------------+

Los elementos uid y gid son enteros, todos los demás son cadenas.
"KeyError" se lanza si la entrada pedida no se encuentra.

Nota:

  En Unix tradicional, el campo "pw_passwd" generalmente contiene una
  contraseña cifrada con un algoritmo derivado de DES (ver módulo
  "crypt"). Sin embargo, la mayoría de los sistemas operativos
  modernos utilizan un sistema llamado *shadow password*. En esos
  unices, el campo *pw_passwd* solo contiene un asterisco ("'*'") o la
  letra "'x'" donde la contraseña cifrada se almacena en un archivo
  "/etc/shadow" que no es legible por todo el mundo. Si el campo
  *pw_passwd* contiene algo útil depende del sistema. Si está
  disponible, el módulo "spwd" debe usarse donde se requiera acceso a
  la contraseña encriptada.

Define los siguientes elementos:

pwd.getpwuid(uid)

   Retorna la entrada de la base de datos de contraseñas para el ID de
   usuario numérico dado.

pwd.getpwnam(name)

   Retorna la entrada de la base de datos de contraseñas para el
   nombre de usuario dado.

pwd.getpwall()

   Retorna una lista de todas las entradas de la base de datos de
   contraseñas disponibles, en orden arbitrario.

Ver también:

  Módulo "grp"
     Una interfaz para la base de datos de grupos, similar a esta.

  Módulo "spwd"
     Una interfaz para la base de datos de contraseñas ocultas,
     similar a esta.
