Print this page
11622 clean up rarer mandoc lint warnings

@@ -47,11 +47,10 @@
 .\"
 .TH GETLOGIN 3C "Mar 15, 2014"
 .SH NAME
 getlogin, getlogin_r \- get login name
 .SH SYNOPSIS
-.LP
 .nf
 #include <unistd.h>
 
 \fBchar *\fR\fBgetlogin\fR(\fBvoid\fR);
 .fi

@@ -60,20 +59,17 @@
 .nf
 \fBchar *\fR\fBgetlogin_r\fR(\fBchar *\fR\fIname\fR, \fBint\fR \fInamelen\fR);
 .fi
 
 .SS "Standard conforming"
-.LP
 .nf
 cc [ \fIflag \fR... ] \fIfile\fR... \fB-D_POSIX_PTHREAD_SEMANTICS\fR [ \fIlibrary \fR... ]
 
 \fBint\fR \fBgetlogin_r\fR(\fBchar *\fR\fIname\fR, \fBsize_t\fR \fInamesize\fR);
 .fi
 
 .SH DESCRIPTION
-.sp
-.LP
 The \fBgetlogin()\fR function returns a pointer to the login name as found in
 \fB/var/adm/utmpx\fR. It can be used in conjunction with \fBgetpwnam\fR(3C) to
 locate the correct password file entry when the same user \fBID\fR is shared by
 several login names.
 .sp

@@ -104,11 +100,10 @@
 terminal, it returns a null pointer. The correct procedure for determining the
 login name is to call \fBcuserid\fR(3C), or to call \fBgetlogin()\fR and if it
 fails to call \fBgetpwuid\fR(3C).
 .sp
 .LP
-
 The \fBgetlogin_r()\fR function has the same functionality as \fBgetlogin()\fR
 except that the caller must supply a buffer \fIname\fR with length \fInamelen\fR
 to store the result.  The \fIname\fR buffer should be at least
 \fBLOGIN_NAME_MAX\fR bytes in size (defined in <\fBlimits.h\fR>). The POSIX
 version (see \fBstandards\fR(5)) of \fBgetlogin_r()\fR takes a \fInamesize\fR

@@ -116,22 +111,18 @@
 the size of \fBLOGIN_NAME_MAX\fR and the name, including the null
 terminator, does not fit inside the buffer, than an error will be generated.
 Otherwise, the buffer \fIname\fR will be updated with the login name.
 
 .SH RETURN VALUES
-.sp
-.LP
 Upon successful completion, \fBgetlogin()\fR returns a pointer to the login
 name or a null pointer if the user's login name cannot be found.  Otherwise it
 returns a null pointer and sets \fBerrno\fR to indicate the error.
 .sp
 .LP
 The standard-conforming \fBgetlogin_r()\fR returns \fB0\fR if successful, or
 the error number upon failure.
 .SH ERRORS
-.sp
-.LP
 The \fBgetlogin_r()\fR function will fail if:
 .sp
 .ne 2
 .na
 \fB\fBERANGE\fR\fR

@@ -191,12 +182,10 @@
 .RS 10n
 The size of the buffer is smaller than the result to be returned.
 .RE
 
 .SH USAGE
-.sp
-.LP
 The return value of \fBgetlogin()\fR points to thread-specific data whose
 content is overwritten on each call by the same thread.
 .sp
 .LP
 Three names associated with the current process can be determined:

@@ -203,11 +192,10 @@
 \fBgetpwuid(\fR\fBgeteuid()\fR\fB)\fR returns the name associated with the
 effective user ID of the process; \fBgetlogin()\fR returns the name associated
 with the current login activity; and \fBgetpwuid(\fR\fBgetuid()\fR\fB)\fR
 returns the name associated with the real user ID of the process.
 .SH FILES
-.sp
 .ne 2
 .na
 \fB\fB/var/adm/utmpx\fR\fR
 .ad
 .RS 18n

@@ -231,12 +219,10 @@
 .RS 18n
 A 64-bit compatibility library to return long login names.
 .RE
 
 .SH ATTRIBUTES
-.sp
-.LP
 See \fBattributes\fR(5) for descriptions of the following attributes:
 .sp
 
 .sp
 .TS

@@ -249,18 +235,14 @@
 _
 MT-Level        See below.
 .TE
 
 .SH SEE ALSO
-.sp
-.LP
 \fBgeteuid\fR(2), \fBgetuid\fR(2), \fBcuserid\fR(3C), \fBgetgrnam\fR(3C),
 \fBgetpwnam\fR(3C), \fBgetpwuid\fR(3C), \fButmpx\fR(4), \fBattributes\fR(5),
 \fBstandards\fR(5)
 .SH NOTES
-.sp
-.LP
 When compiling multithreaded programs, see \fBIntro\fR(3).
 .sp
 .LP
 The \fBgetlogin()\fR function is safe to use in multithreaded applications, but
 is discouraged. The \fBgetlogin_r()\fR function should be used instead.