getpass(3)

NOMBRE
getpass - obtiene una contraseña

BIBLIOTECA
Biblioteca Estándar C (libc, -lc)

SINOPSIS
#include <unistd.h>

[[a extinguir]] char *getpass(const char *prompt);

    Requisitos de Macros de Prueba de Características para glibc (véase feature_test_macros(7)):

getpass():
    A partir de glibc 2.2.2:
        _XOPEN_SOURCE && ! (_POSIX_C_SOURCE >= 200112L)
            || /* glibc >= 2.19: */ _DEFAULT_SOURCE
            || /* glibc <= 2.19: */ _BSD_SOURCE
    Antes de glibc 2.2.2:
        nada

DESCRIPCIÓN
This function is obsolete. Do not use it. See NOTES. If you want to read input without terminal echoing enabled, see the description of the ECHO flag in termios(3).

La función getpass() abre el fichero /dev/tty (la terminal de control del proceso), escribe la cadena prompt, desactiva el eco, lee una linea (la "contraseña"), restablece el estado de la terminal y cierra /dev/tty de nuevo.

VALOR DEVUELTO
La función getpass() devuelve un puntero a un buffer estático que contiene (los primeros PASS_MAX bytes de) la contraseña sin el carácter nueva línea, terminada en NULL ('\0[aq]). Este buffer puede ser sobreescrito por una llamada posterior. En caso de error, el estado de la terminal se restablece, se pone un valor adecuado en errno, y se devuelve NULL.

ERRORES

ENXIO
    El proceso no tiene una terminal de control.

ARCHIVOS
/dev/tty

ATRIBUTOS
Para obtener una explicación de los términos usados en esta sección, véase attributes(7).
Interfaz | Atributo | Valor
getpass() | Seguridad del hilo | MT-Unsafe term

ESTÁNDARES
Present in SUSv2, but marked LEGACY. Removed in POSIX.1-2001.

NOTAS
You should use instead readpassphrase(3bsd), provided by libbsd.

In the GNU C library implementation, if /dev/tty cannot be opened, the prompt is written to stderr and the password is read from stdin. There is no limit on the length of the password. Line editing is not disabled.

According to SUSv2, the value of PASS_MAX must be defined in <limits.h> in case it is smaller than 8, and can in any case be obtained using sysconf(_SC_PASS_MAX). However, POSIX.2 withdraws the constants PASS_MAX and _SC_PASS_MAX, and the function getpass(). The glibc version accepts _SC_PASS_MAX and returns BUFSIZ (e.g., 8192).

ERRORES
El proceso que llama a esta función debería poner a cero todos los caracteres de la contraseña tan pronto como le fuera posible para evitar dejar la contraseña sin cifrar visible en el espacio de direcciones del proceso.

VÉASE TAMBIÉN
crypt(3)

TRADUCCIÓN
La traducción al español de esta página del manual fue creada por Gerardo Aburruzaga García <gerardo.aburruzaga@uca.es>, Miguel Pérez Ibars <mpi79470@alu.um.es> y Marcos Fouces <marcos@debian.org>

Esta traducción es documentación libre; lea la GNU General Public License Version 3 (https://www.gnu.org/licenses/gpl-3.0.html) o posterior con respecto a las condiciones de copyright. No existe NINGUNA RESPONSABILIDAD.

Si encuentra algún error en la traducción de esta página del manual, envíe un correo electrónico a debian-l10n-spanish@lists.debian.org.