NOMBRE

       getpass - obtiene una contraseña

SINOPSIS

       #include <unistd.h>

       char *getpass( const char * prompt );

DESCRIPCIÓN

       Esta función está obsoleta. No la utilice.

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

       La función puede fallar si

       ENXIO  El proceso no tiene una terminal de control.

OBSERVACIONES

       Para libc4 y libc5, el prompt no se escribe  en  /dev/tty  sino  en  stderr.   Además,  si
       /dev/tty  no  puede abrirse, la contraseña es leída de stdin.  El buffer estático tiene de
       longitud 128 por lo que solamente se devuelven los primeros 127 bytes  de  la  contraseña.
       Mientras  se  lee  la  contraseña,  la  generación  de  señales (SIGINT, SIGQUIT, SIGSTOP,
       SIGTSTOP)  es  desactivada  y  los  carácteres  correspondientes  (normalmente  control-C,
       control-\,  control-Z y control-Y) son transmitidos como parte de la contraseña.  A partir
       de la versión 5.4.19 de libc también se ha deshabilitado la edición de la linea,  así  que
       también el espacio será visto como parte de la contraseña.

       Para  glibc2, si /dev/tty no puede abrirse, el prompt se escribe en stderr y la contraseña
       es leida de stdin.  No hay límite en la longitud de la contraseña.  La edición de la línea
       no está deshabilitada.

       Según el estándar SUSv2, el valor de PASS_MAX debe estar definido en <limits.h> en caso de
       que sea menor que 8, y puede ser obtenido en cualquier caso usando  sysconf(_SC_PASS_MAX).
       Sin  embargo,  retira  las  constantes  PASS_MAX  y _SC_PASS_MAX, y la función getpass ().
       Libc4 y libc5 no han soportado nunca PASS_MAX ni _SC_PASS_MAX.  Glibc2 acepta _SC_PASS_MAX
       y devuelve BUFSIZ (p.e., 8192).

FICHEROS

       /dev/tty

VÉASE TAMBIÉN

       crypt(3)

HISTORIA

       Una función getpass apareció en AT&T UNIX Versión 7.

FALLOS

       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.