.\" -*- coding: UTF-8 -*-
.\" Copyright (c) 2000 Andries Brouwer (aeb@cwi.nl)
.\"
.\" %%%LICENSE_START(GPLv2+_DOC_FULL)
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.
.\"
.\" The GNU General Public License's references to "object code"
.\" and "executables" are to be interpreted as the output of any
.\" document formatting or typesetting system, including
.\" intermediate and printed output.
.\"
.\" This manual is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public
.\" License along with this manual; if not, see
.\" .
.\" %%%LICENSE_END
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH GETPASS 3 "6. März 2019" Linux Linux\-Programmierhandbuch
.SH BEZEICHNUNG
getpass \- ermittelt ein Passwort
.SH ÜBERSICHT
\fB#include \fP
.PP
\fBchar *getpass(const char *\fP\fIprompt\fP\fB);\fP
.PP
.RS -4
Mit Glibc erforderliche Feature\-Test\-Makros (siehe
\fBfeature_test_macros\fP(7)):
.RE
.PP
\fBgetpass\fP():
.ad l
.RS 4
.PD 0
.TP 4
Seit Glibc 2.2.2:
.nf
_XOPEN_SOURCE && ! (_POSIX_C_SOURCE\ >=\ 200112L)
|| /* Glibc seit 2.19: */ _DEFAULT_SOURCE
|| /* Glibc\-Versionen <= 2.19: */ _BSD_SOURCE
.fi
.TP 4
Vor Glibc 2.2.2:
none
.PD
.RE
.ad b
.SH BESCHREIBUNG
Diese Funktion ist veraltet, bitte verwenden Sie sie nicht. Falls Sie die
Terminal\-Eingabe lesen wollen, ohne dass die Wiedergabe der eingegebenen
Zeichen aktiviert ist, lesen Sie bitte die Beschreibung des
\fIECHO\fP\-Schalters in \fBtermios\fP(3).
.PP
Die Funktion \fBgetpass\fP() öffnet \fI/dev/tty\fP (das steuernde Terminal des
Prozesses), zeigt die Zeichenkette \fIprompt\fP an, schaltet die Wiedergabe der
eingebenen Zeichen auf dem Terminal ab, liest die Zeile (das »Passwort«),
stellt den Status des Terminals wieder her und schließt \fI/dev/tty\fP wieder.
.SH RÜCKGABEWERT
Die Funktion \fBgetpass\fP() gibt einen Zeiger auf einen statischen Puffer
zurück, der das Passwort (bzw. die ersten \fBPASS_MAX\fP Bytes davon) ohne das
abschließende Zeilenumbruchzeichen, jedoch mit einem abschließenden Nullbyte
(»\e0«), enthält. Dieser Puffer kann von einem nachfolgenden Aufruf
überschrieben werden. Im Fehlerfall wird der Status des Terminals
wiederhergestellt, \fIerrno\fP entsprechend gesetzt und NULL zurückgegeben.
.SH FEHLER
Die Funktion kann fehlschlagen, falls
.TP
\fBENXIO\fP
der Prozess kein steuerndes Terminal hat.
.SH DATEIEN
.\" .SH HISTORY
.\" A
.\" .BR getpass ()
.\" function appeared in Version 7 AT&T UNIX.
\fI/dev/tty\fP
.SH ATTRIBUTE
Siehe \fBattributes\fP(7) für eine Erläuterung der in diesem Abschnitt
verwandten Ausdrücke.
.TS
allbox;
lb lb lb
l l l.
Schnittstelle Attribut Wert
T{
\fBgetpass\fP()
T} Multithread\-Fähigkeit MT\-Unsafe term
.TE
.SH "KONFORM ZU"
In SUSv2 vorhanden, aber als VERALTET gekennzeichnet. In POSIX.1\-2001
entfernt.
.SH ANMERKUNGEN
.\" For libc4 and libc5, the prompt is not written to
.\" .I /dev/tty
.\" but to
.\" .IR stderr .
.\" Moreover, if
.\" .I /dev/tty
.\" cannot be opened, the password is read from
.\" .IR stdin .
.\" The static buffer has length 128 so that only the first 127
.\" bytes of the password are returned.
.\" While reading the password, signal generation
.\" .RB ( SIGINT ,
.\" .BR SIGQUIT ,
.\" .BR SIGSTOP ,
.\" .BR SIGTSTP )
.\" is disabled and the corresponding characters
.\" (usually control-C, control-\e, control-Z and control-Y)
.\" are transmitted as part of the password.
.\" Since libc 5.4.19 also line editing is disabled, so that also
.\" backspace and the like will be seen as part of the password.
.
Bei Glibc2 wird der Prompt auf \fIstderr\fP geschrieben, falls \fI/dev/tty\fP
nicht geöffnet werden kann und das Passwort wird von \fIstdin\fP gelesen. Es
gibt keine Begrenzung der Länge des Passwortes. Das Editieren der Zeile ist
nicht deaktiviert.
.PP
.\" Libc4 and libc5 have never supported
.\" .B PASS_MAX
.\" or
.\" .BR _SC_PASS_MAX .
Gemäß SUSv2 muss der Wert von \fBPASS_MAX\fP in \fI\fP definiert
sein, falls er kleiner als 8 ist, und kann auf jeden Fall mit
\fIsysconf(_SC_PASS_MAX)\fP in Erfahrung gebracht werden. Allerdings verwirft
POSIX.2 die Konstanten \fBPASS_MAX\fP und \fB_SC_PASS_MAX\fP sowie die Funktion
\fBgetpass\fP(). Libc4 und Libc5 haben niemals \fBPASS_MAX\fP oder \fB_SC_PASS_MAX\fP
unterstützt. Glibc2 akzeptiert \fB_SC_PASS_MAX\fP und gibt \fBBUFSIZ\fP zurück
(z.B. 8192).
.SH FEHLER
Der aufrufende Prozess sollte das Passwort so schnell wie möglich auf Null
setzen, um zu vermeiden, dass das Passwort weiter im Adressraum dieses
Prozesses sichtbar ist.
.SH "SIEHE AUCH"
\fBcrypt\fP(3)
.SH KOLOPHON
Diese Seite ist Teil der Veröffentlichung 5.10 des Projekts
Linux\-\fIman\-pages\fP. Eine Beschreibung des Projekts, Informationen, wie
Fehler gemeldet werden können, sowie die aktuelle Version dieser Seite
finden sich unter \%https://www.kernel.org/doc/man\-pages/.
.PP
.SH ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von
Martin Eberhard Schauer
und
Mario Blättermann
erstellt.
.PP
Diese Übersetzung ist Freie Dokumentation; lesen Sie die
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License Version 3
.UE
oder neuer bezüglich der
Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.
.PP
Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden,
schicken Sie bitte eine E-Mail an die
.MT debian-l10n-german@lists.debian.org
Mailingliste der Übersetzer
.ME .