table of contents
- bookworm-backports 4.24.0-2~bpo12+1
- testing 4.24.0-2
- unstable 4.24.0-2
getpass(3) | Library Functions Manual | getpass(3) |
NOM¶
getpass - Obtenir un mot de passe
BIBLIOTHÈQUE¶
Bibliothèque C standard (libc, -lc)
SYNOPSIS¶
#include <unistd.h>
[[obsolète]] char *getpass(const char *invite);
getpass() :
Depuis la glibc 2.2.2 :
_XOPEN_SOURCE && ! (_POSIX_C_SOURCE >= 200112L)
|| /* Depuis la glibc 2.19 : */ _DEFAULT_SOURCE
|| /* glibc 2.19 et précédentes : */ _BSD_SOURCE
Avant la glibc 2.2.2 :
aucune
DESCRIPTION¶
Cette fonction est obsolète. Ne l'utilisez pas. Voir les NOTES. Si vous voulez lire une saisie de terminal sans écho local, consultez la description du drapeau ECHO dans termios(3).
La fonction getpass() ouvre /dev/tty (le terminal de contrôle du processus), affiche l'invite, désactive l'écho local, lit une ligne de saisie (le mot de passe), puis restaure l'état du terminal et referme /dev/tty.
VALEUR RENVOYÉE¶
La fonction getpass() renvoie un pointeur sur un tampon alloué statiquement contenant les PASS_MAX premiers caractères du mot de passe sans le retour chariot final et terminé par un caractère NULL (« \0 »). Ce tampon peut être écrasé par un autre appel. En cas d'erreur, l'état du terminal est restauré, errno est renseignée et la fonction renvoie NULL.
ERREURS¶
- ENXIO
- Le processus n'a pas de terminal de contrôle.
FICHIERS¶
/dev/tty
ATTRIBUTS¶
Pour une explication des termes utilisés dans cette section, consulter attributes(7).
Interface | Attribut | Valeur |
getpass() | Sécurité des threads | MT-Unsafe term |
STANDARDS¶
Présente dans SUSv2, mais marquée « LEGACY ». Supprimée de POSIX.1-2001.
NOTES¶
Vous devriez plutôt utiliser la fonction readpassphrase(3bsd) fournie par la bibliothèque libbsd.
Dans l'implémentation de la bibliothèque GNU C, si /dev/tty ne peut pas être ouvert, l'invite est envoyée sur stderr et le mot de passe est lu depuis stdin. Il n'y a pas de limite à la longueur du mot de passe. L'édition de ligne n'est pas désactivée.
D'après SUSv2, la valeur de PASS_MAX doit être définie dans <limits.h> dans le cas où elle est inférieure à 8, et peut toujours être accessible en utilisant sysconf(_SC_PASS_MAX). Quoiqu'il en soit, POSIX.2 retire les constantes PASS_MAX et _SC_PASS_MAX, ainsi que la fonction getpass(). La version de la glibc accepte _SC_PASS_MAX et renvoie BUFSIZ (par exemple, 8192).
BOGUES¶
Le processus appelant doit effacer le mot de passe saisi aussi vite que possible, afin d'éviter d'en conserver une copie en texte clair dans l'espace d'adressage du processus.
VOIR AUSSI¶
TRADUCTION¶
La traduction française de cette page de manuel a été créée par Christophe Blaess <https://www.blaess.fr/christophe/>, Stéphan Rafin <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>, François Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe Guérard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas Huriaux <thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centraliens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prévot <david@tilapin.org> et Lucien Gentis <lucien.gentis@waika9.com>
Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à debian-l10n-french@lists.debian.org.
5 février 2023 | Pages du manuel de Linux 6.03 |