This document is for an old version of Python that is no longer supported. You should upgrade, and read the Python documentation for the current stable release.

# `pwd` — La base de datos de contraseñas

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.

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.