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.