X-Git-Url: http://git.osdn.net/view?p=linuxjm%2FLDP_man-pages.git;a=blobdiff_plain;f=original%2Fman3%2Fgetpass.3;h=5405a56dbb62dd128539a318d80eb5910aef7ec5;hp=5821e859384ba18fa7154996a4eec1bc72951a80;hb=4ea6bb24817f6f049d6bbc90ecd77a869876f9b0;hpb=78d692a91a29bb279b5fc6a6294ff3e418a184c8 diff --git a/original/man3/getpass.3 b/original/man3/getpass.3 index 5821e859..5405a56d 100644 --- a/original/man3/getpass.3 +++ b/original/man3/getpass.3 @@ -21,13 +21,13 @@ .\" . .\" %%%LICENSE_END .\" -.TH GETPASS 3 2013-06-21 "Linux" "Linux Programmer's Manual" +.TH GETPASS 3 2014-08-19 "Linux" "Linux Programmer's Manual" .SH NAME getpass \- get a password .SH SYNOPSIS .B #include .sp -.BI "char *getpass( const char *" prompt ); +.BI "char *getpass(const char *" prompt ); .sp .in -4n Feature Test Macro Requirements for glibc (see @@ -102,28 +102,28 @@ function is not thread-safe. Present in SUSv2, but marked LEGACY. Removed in POSIX.1-2001. .SH NOTES -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. +.\" 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. .PP -For glibc2, if +In the GNU C library implementation, if .I /dev/tty cannot be opened, the prompt is written to .I stderr @@ -132,7 +132,7 @@ and the password is read from There is no limit on the length of the password. Line editing is not disabled. .PP -According to the SUSv2, the value of +According to SUSv2, the value of .B PASS_MAX must be defined in .I @@ -144,11 +144,11 @@ and .BR _SC_PASS_MAX , and the function .BR getpass (). -Libc4 and libc5 have never supported -.B PASS_MAX -or -.BR _SC_PASS_MAX . -Glibc2 accepts +.\" Libc4 and libc5 have never supported +.\" .B PASS_MAX +.\" or +.\" .BR _SC_PASS_MAX . +The glibc version accepts .B _SC_PASS_MAX and returns .B BUFSIZ @@ -159,10 +159,11 @@ leaving the cleartext password visible in the process's address space. .SH SEE ALSO .BR crypt (3) .SH COLOPHON -This page is part of release 3.64 of the Linux +This page is part of release 3.79 of the Linux .I man-pages project. A description of the project, -and information about reporting bugs, +information about reporting bugs, +and the latest version of this page, can be found at \%http://www.kernel.org/doc/man\-pages/.