OSDN Git Service

LDP: Update original to LDP v3.79
[linuxjm/LDP_man-pages.git] / original / man3 / getpass.3
index 9155b29..5405a56 100644 (file)
 .\" <http://www.gnu.org/licenses/>.
 .\" %%%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 <unistd.h>
 .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 <limits.h>
@@ -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,7 +159,7 @@ 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.68 of the Linux
+This page is part of release 3.79 of the Linux
 .I man-pages
 project.
 A description of the project,