(split) LDP: Update original to LDP v3.65

[linuxjm/LDP_man-pages.git] / original / man3 / login.3

diff --git a/original/man3/login.3 b/original/man3/login.3
index d15d873..1975b7b 100644 (file)
--- a/original/man3/login.3
+++ b/original/man3/login.3
@@ -1,3 +1,7 @@
+.\" Derived from text written by Martin Schulze (or taken from glibc.info)
+.\" and text written by Paul Thompson - both copyright 2002.
+.\"
+.\" %%%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
@@ -14,12 +18,9 @@
 .\" 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, write to the Free
-.\" Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139,
-.\" USA.
-.\"
-.\" Derived from text written by Martin Schulze (or taken from glibc.info)
-.\" and text written by Paul Thompson - both copyright 2002.
+.\" License along with this manual; if not, see
+.\" <http://www.gnu.org/licenses/>.
+.\" %%%LICENSE_END
 .\"
 .TH LOGIN 3 2004-05-06 "GNU" "Linux Programmer's Manual"
 .SH NAME
@@ -40,14 +41,15 @@ See
 .LP
 The function
 .BR login ()
-takes the supplied \fIstruct utmp\fP,
+takes the supplied
+.IR "struct utmp" ,
 .IR ut ,
 and writes it to both the utmp and the wtmp file.
 .LP
 The function
 .BR logout ()
 clears the entry in the utmp file again.
-.SS "GNU Details"
+.SS GNU details
 More precisely,
 .BR login ()
 takes the argument
@@ -61,11 +63,16 @@ and fills the field
 (if there is such a field) with the process ID of the calling process.
 Then it tries to fill the field
 .IR ut\->ut_line .
-It takes the first of \fIstdin\fP, \fIstdout\fP, \fIstderr\fP
-that is a tty, and
-stores the corresponding pathname minus a possible leading \fI/dev/\fP
+It takes the first of
+.IR stdin ,
+.IR stdout ,
+.I stderr
+that is a terminal, and
+stores the corresponding pathname minus a possible leading
+.I /dev/
 into this field, and then writes the struct to the utmp file.
-On the other hand, if no tty name was found, this field is filled with "???"
+On the other hand,
+if no terminal name was found, this field is filled with "???"
 and the struct is not written to the utmp file.
 After this, the struct is written to the wtmp file.
 .LP
@@ -84,7 +91,7 @@ timestamp field and setting
 .I ut_type
 (if there is such a field) to
 .BR DEAD_PROCESS .
-.SH "RETURN VALUE"
+.SH RETURN VALUE
 The
 .BR logout ()
 function returns 1 if the entry was successfully written to the
@@ -102,7 +109,7 @@ user accounting log file, configured through
 .B _PATH_WTMP
 in
 .I <paths.h>
-.SH "CONFORMING TO"
+.SH CONFORMING TO
 Not in POSIX.1-2001.
 Present on the BSDs.
 .SH NOTES
@@ -120,6 +127,14 @@ is defined as an alias for
 .I ut_user
 in
 .IR <utmp.h> .
-.SH "SEE ALSO"
+.SH SEE ALSO
 .BR getutent (3),
 .BR utmp (5)
+.SH COLOPHON
+This page is part of release 3.65 of the Linux
+.I man-pages
+project.
+A description of the project,
+and information about reporting bugs,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.