summaryrefslogtreecommitdiff
path: root/usr/src/man/man3c
diff options
context:
space:
mode:
Diffstat (limited to 'usr/src/man/man3c')
-rw-r--r--usr/src/man/man3c/epoll_create.3c10
-rw-r--r--usr/src/man/man3c/epoll_ctl.3c8
-rw-r--r--usr/src/man/man3c/epoll_wait.3c14
-rw-r--r--usr/src/man/man3c/getlogin.3c18
-rw-r--r--usr/src/man/man3c/nanosleep.3c7
-rw-r--r--usr/src/man/man3c/pfmt.3c22
6 files changed, 4 insertions, 75 deletions
diff --git a/usr/src/man/man3c/epoll_create.3c b/usr/src/man/man3c/epoll_create.3c
index 83ea81e204..624e0f3a16 100644
--- a/usr/src/man/man3c/epoll_create.3c
+++ b/usr/src/man/man3c/epoll_create.3c
@@ -4,7 +4,7 @@
.\" Common Development and Distribution License ("CDDL"), version 1.0.
.\" You may only use this file in accordance with the terms of version
.\" 1.0 of the CDDL.
-.\"
+.\"
.\" A full copy of the text of the CDDL should have accompanied this
.\" source. A copy of the CDDL is also available via the Internet at
.\" http://www.illumos.org/license/CDDL.
@@ -12,8 +12,6 @@
.SH NAME
epoll_create, epoll_create1 \- create an epoll instance
.SH SYNOPSIS
-
-.LP
.nf
#include <sys/epoll.h>
@@ -26,7 +24,6 @@ epoll_create, epoll_create1 \- create an epoll instance
.fi
.SH DESCRIPTION
-.LP
The \fBepoll_create()\fR and \fBepoll_create1()\fR functions both create an
\fBepoll\fR(5) instance that can be operated upon via \fBepoll_ctl\fR(3C),
\fBepoll_wait\fR(3C) and \fBepoll_pwait\fR(3C). \fBepoll\fR instances are
@@ -49,11 +46,9 @@ Instance should be closed upon an
.RE
.SH RETURN VALUES
-.LP
Upon successful completion, 0 is returned. Otherwise, -1 is returned and errno
is set to indicate the error.
.SH ERRORS
-.LP
The \fBepoll_create()\fR and \fBepoll_create1()\fR functions will fail if:
.sp
.ne 2
@@ -86,8 +81,6 @@ The maximum allowable number of files is currently open in the system.
.sp
.SH NOTES
-.LP
-
The \fBepoll\fR(5) facility is implemented for purposes of offering
compatibility for Linux-borne applications; native
applications should continue to prefer using event ports via the
@@ -95,5 +88,4 @@ applications should continue to prefer using event ports via the
interfaces. See \fBepoll\fR(5) for compatibility details and restrictions.
.SH SEE ALSO
-.LP
\fBepoll_ctl\fR(3C), \fBepoll_wait\fR(3C), \fBepoll\fR(5)
diff --git a/usr/src/man/man3c/epoll_ctl.3c b/usr/src/man/man3c/epoll_ctl.3c
index 4d63d084f9..3b3dfabcba 100644
--- a/usr/src/man/man3c/epoll_ctl.3c
+++ b/usr/src/man/man3c/epoll_ctl.3c
@@ -12,8 +12,6 @@
.SH NAME
epoll_ctl \- control an epoll instance
.SH SYNOPSIS
-
-.LP
.nf
#include <sys/epoll.h>
@@ -21,7 +19,6 @@ epoll_ctl \- control an epoll instance
.fi
.SH DESCRIPTION
-.LP
The \fBepoll_ctl()\fR function executes the operation specified by
\fIop\fR (as parameterized by \fIevent\fR) on the \fIepfd\fR epoll instance.
Valid values for \fIop\fR:
@@ -244,13 +241,11 @@ with caution.
.RE
.SH RETURN VALUES
-.LP
Upon successful completion, \fBepoll_ctl()\fR returns 0.
If an error occurs, -1 is returned and errno is set to indicate
the error.
.SH ERRORS
-.LP
\fBepoll_ctl()\fR will fail if:
.sp
.ne 2
@@ -294,8 +289,6 @@ specified \fBepoll\fR(5) instance.
.sp
.SH NOTES
-.LP
-
The \fBepoll\fR(5) facility is implemented for purposes of offering
compatibility for Linux-borne applications; native
applications should continue to prefer using event ports via the
@@ -303,7 +296,6 @@ applications should continue to prefer using event ports via the
interfaces. See \fBepoll\fR(5) for compatibility details and restrictions.
.SH SEE ALSO
-.LP
\fBepoll_create\fR(3C), \fBepoll_wait\fR(3C),
\fBport_create\fR(3C), \fBport_associate\fR(3C), \fBport_get\fR(3C),
\fBepoll\fR(5)
diff --git a/usr/src/man/man3c/epoll_wait.3c b/usr/src/man/man3c/epoll_wait.3c
index 6ae9e0f9c4..7808661238 100644
--- a/usr/src/man/man3c/epoll_wait.3c
+++ b/usr/src/man/man3c/epoll_wait.3c
@@ -4,7 +4,7 @@
.\" Common Development and Distribution License ("CDDL"), version 1.0.
.\" You may only use this file in accordance with the terms of version
.\" 1.0 of the CDDL.
-.\"
+.\"
.\" A full copy of the text of the CDDL should have accompanied this
.\" source. A copy of the CDDL is also available via the Internet at
.\" http://www.illumos.org/license/CDDL.
@@ -12,24 +12,21 @@
.SH NAME
epoll_wait, epoll_pwait \- wait for epoll events
.SH SYNOPSIS
-
-.LP
.nf
#include <sys/epoll.h>
-\fBint\fR \fBepoll_wait\fR(\fBint\fR \fIepfd\fR, \fBstruct epoll_event *\fR\fIevents\fR,
+\fBint\fR \fBepoll_wait\fR(\fBint\fR \fIepfd\fR, \fBstruct epoll_event *\fR\fIevents\fR,
\fBint\fR \fImaxevents\fR, \fBint\fR \fItimeout\fR);
.fi
.LP
.nf
-\fBint\fR \fBepoll_pwait\fR(\fBint\fR \fIepfd\fR, \fBstruct epoll_event *\fR\fIevents\fR,
+\fBint\fR \fBepoll_pwait\fR(\fBint\fR \fIepfd\fR, \fBstruct epoll_event *\fR\fIevents\fR,
\fBint\fR \fImaxevents\fR, \fBint\fR \fItimeout\fR,
\fBconst sigset_t *\fR\fIsigmask\fR);
.fi
.SH DESCRIPTION
-.LP
The \fBepoll_wait()\fR function waits for events on the \fBepoll\fR(5)
instance specified by \fIepfd\fR. The \fIevents\fR parameter must point to
an array of \fImaxevents\fR \fIepoll_event\fR structures to be
@@ -45,14 +42,12 @@ signal mask upon return, and is therefore similar to the relationship
between \fBselect\fR(3C) and \fBpselect\fR(3C).
.SH RETURN VALUES
-.LP
Upon successful completion, \fBepoll_wait()\fR and \fBepoll_pwait()\fR return
the number of events, or 0 if none was pending and \fItimeout\fR milliseconds
elapsed. If an error occurs, -1 is returned and errno is set to indicate
the error.
.SH ERRORS
-.LP
The \fBepoll_wait()\fR and \fBepoll_pwait()\fR functions will fail if:
.sp
.ne 2
@@ -93,8 +88,6 @@ is not greater than zero.
.sp
.SH NOTES
-.LP
-
The \fBepoll\fR(5) facility is implemented for purposes of offering
compatibility for Linux-borne applications; native
applications should continue to prefer using event ports via the
@@ -102,7 +95,6 @@ applications should continue to prefer using event ports via the
interfaces. See \fBepoll\fR(5) for compatibility details and restrictions.
.SH SEE ALSO
-.LP
\fBepoll_create\fR(3C), \fBepoll_ctl\fR(3C),
\fBport_create\fR(3C), \fBport_associate\fR(3C), \fBport_get\fR(3C),
\fBpselect\fR(3C), \fBepoll\fR(5)
diff --git a/usr/src/man/man3c/getlogin.3c b/usr/src/man/man3c/getlogin.3c
index 7b1cdd165f..41211c78c7 100644
--- a/usr/src/man/man3c/getlogin.3c
+++ b/usr/src/man/man3c/getlogin.3c
@@ -49,7 +49,6 @@
.SH NAME
getlogin, getlogin_r \- get login name
.SH SYNOPSIS
-.LP
.nf
#include <unistd.h>
@@ -62,7 +61,6 @@ getlogin, getlogin_r \- get login name
.fi
.SS "Standard conforming"
-.LP
.nf
cc [ \fIflag \fR... ] \fIfile\fR... \fB-D_POSIX_PTHREAD_SEMANTICS\fR [ \fIlibrary \fR... ]
@@ -70,8 +68,6 @@ cc [ \fIflag \fR... ] \fIfile\fR... \fB-D_POSIX_PTHREAD_SEMANTICS\fR [ \fIlibrar
.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
@@ -106,7 +102,6 @@ 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
@@ -118,8 +113,6 @@ 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.
@@ -128,8 +121,6 @@ returns a null pointer and sets \fBerrno\fR to indicate the error.
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
@@ -193,8 +184,6 @@ 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
@@ -205,7 +194,6 @@ 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
@@ -233,8 +221,6 @@ 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
@@ -251,14 +237,10 @@ 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
diff --git a/usr/src/man/man3c/nanosleep.3c b/usr/src/man/man3c/nanosleep.3c
index e29808e560..ba1e275bb0 100644
--- a/usr/src/man/man3c/nanosleep.3c
+++ b/usr/src/man/man3c/nanosleep.3c
@@ -49,7 +49,6 @@
.SH NAME
nanosleep, thrd_sleep \- high resolution sleep
.SH SYNOPSIS
-.LP
.nf
#include <time.h>
@@ -64,7 +63,6 @@ nanosleep, thrd_sleep \- high resolution sleep
\fBstruct timespec *\fR\fIrmtp\fR);
.SH DESCRIPTION
-.LP
The \fBnanosleep()\fR and \fBthrd_sleep()\fR functions cause the current thread
to be suspended from execution until either the time interval specified by the
\fIrqtp\fR argument has elapsed or a signal is delivered to the calling thread
@@ -80,7 +78,6 @@ time specified by \fIrqtp\fR, as measured by the system clock,
The use of the \fBnanosleep()\fR and \fBthrd_sleep()\fR functions has no effect
on the action or blockage of any signal.
.SH RETURN VALUES
-.LP
If the \fBnanosleep()\fR or \fBthrd_sleep()\fR function returns because the
requested time has elapsed, its return value is \fB0\fR.
.sp
@@ -98,7 +95,6 @@ If \fBnanosleep()\fR fails, it returns \fB\(mi1\fR and sets \fBerrno\fR to
indicate the error.
.sp
.LP
-
The
.B thrd_sleep()
function may fail for identical reasons as the
@@ -111,7 +107,6 @@ being set or staying the same across a call to
.B thrd_sleep() .
.SH ERRORS
-.LP
The \fBnanosleep()\fR function will fail if:
.sp
.ne 2
@@ -142,7 +137,6 @@ The \fBnanosleep()\fR function is not supported by this implementation.
.RE
.SH ATTRIBUTES
-.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp
@@ -161,5 +155,4 @@ Standard See \fBstandards\fR(5).
.TE
.SH SEE ALSO
-.LP
\fBsleep\fR(3C), \fBtime.h\fR(3HEAD), \fBattributes\fR(5), \fBstandards\fR(5)
diff --git a/usr/src/man/man3c/pfmt.3c b/usr/src/man/man3c/pfmt.3c
index b88e451266..907e32c981 100644
--- a/usr/src/man/man3c/pfmt.3c
+++ b/usr/src/man/man3c/pfmt.3c
@@ -7,7 +7,6 @@
.SH NAME
pfmt \- display error message in standard format
.SH SYNOPSIS
-.LP
.nf
#include <pfmt.h>
@@ -15,8 +14,6 @@ pfmt \- display error message in standard format
.fi
.SH DESCRIPTION
-.sp
-.LP
The \fBpfmt()\fR retrieves a format string from a locale-specific message
database (unless \fBMM_NOGET\fR is specified) and uses it for \fBprintf\fR(3C)
style formatting of \fIargs\fR. The output is displayed on \fIstream\fR.
@@ -191,8 +188,6 @@ localized version of \fBTO FIX\fR.
.RE
.SH STANDARD ERROR MESSAGE FORMAT
-.sp
-.LP
The \fBpfmt()\fR function displays error messages in the following format:
.sp
.in +2
@@ -223,17 +218,7 @@ If \fBpfmt()\fR is called twice to display an error message and a helpful
.fi
.in -2
-.br
-.in +2
-
-.in -2
-.br
-.in +2
-
-.in -2
.SH RETURN VALUES
-.sp
-.LP
Upon success, \fBpfmt()\fR returns the number of bytes transmitted. Upon
failure, it returns a negative value:
.sp
@@ -246,7 +231,6 @@ Write error to \fIstream\fR.
.RE
.SH EXAMPLES
-.LP
\fBExample 1 \fRExample of \fBpfmt()\fR function.
.sp
.LP
@@ -292,12 +276,8 @@ UX:test: TO FIX: Usage ...
.in -2
.SH USAGE
-.sp
-.LP
Since it uses \fBgettxt\fR(3C), \fBpfmt()\fR should not be used.
.SH ATTRIBUTES
-.sp
-.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp
@@ -312,8 +292,6 @@ MT-Level MT-safe
.TE
.SH SEE ALSO
-.sp
-.LP
\fBaddsev\fR(3C), \fBgettxt\fR(3C), \fBlfmt\fR(3C), \fBprintf\fR(3C),
\fBsetcat\fR(3C), \fBsetlabel\fR(3C), \fBsetlocale\fR(3C), \fBattributes\fR(5),
\fBenviron\fR(5)
generated by cgit v1.2.3 (git 2.39.1) at 2025-04-30 19:47:33 +0000