Print this page
9842 man page typos and spelling
*** 62,72 ****
\fBstruct project *\fR\fBfgetprojent\fR(\fBFILE *\fR\fIf\fR, \fBstruct project *\fR\fIproj\fR,
\fBvoid *\fR\fIbuffer\fR, \fBsize_t\fR \fIbufsize\fR);
.fi
.SH DESCRIPTION
- .sp
.LP
These functions are used to obtain entries describing user projects. Entries
can come from any of the sources for a project specified in the
\fB/etc/nsswitch.conf\fR file (see \fBnsswitch.conf\fR(4)).
.sp
--- 62,71 ----
*** 165,175 ****
calls to \fBgetprojent()\fR, the threads will enumerate disjoint subsets of the
project database. The \fBinproj()\fR, \fBgetprojbyname()\fR,
\fBgetprojbyid()\fR, and \fBgetdefaultproj()\fR functions leave the enumeration
position in an indeterminate state.
.SH RETURN VALUES
- .sp
.LP
Project entries are represented by the \fBstruct project\fR structure defined
in <\fBproject.h\fR>.
.sp
.in +2
--- 164,173 ----
*** 197,207 ****
The \fBgetprojent()\fR function returns a pointer to a \fBstruct project\fR if
it successfully enumerates an entry; otherwise it returns \fINULL\fR,
indicating the end of the enumeration.
.sp
.LP
! The \fBgetprojidbyname()\fR function returns the project ID if the requsted
entry is found; otherwise it returns \(mi1 and sets errno to indicate the
error.
.sp
.LP
When the pointer returned by the reentrant functions \fBgetprojbyname()\fR,
--- 195,205 ----
The \fBgetprojent()\fR function returns a pointer to a \fBstruct project\fR if
it successfully enumerates an entry; otherwise it returns \fINULL\fR,
indicating the end of the enumeration.
.sp
.LP
! The \fBgetprojidbyname()\fR function returns the project ID if the requested
entry is found; otherwise it returns \(mi1 and sets errno to indicate the
error.
.sp
.LP
When the pointer returned by the reentrant functions \fBgetprojbyname()\fR,
*** 209,219 ****
the \fIproj\fR pointer that was supplied by the caller.
.sp
.LP
Upon failure, \fBNULL\fR is returned and errno is set to indicate the error.
.SH ERRORS
- .sp
.LP
The \fBgetprojent()\fR, \fBgetprojbyname()\fR, \fBgetprojbyid()\fR,
\fBinproj()\fR, \fBgetprojidbyname()\fR, \fBfgetprojent()\fR, and
\fBgetdefaultproj()\fR functions will fail if:
.sp
--- 207,216 ----
*** 265,281 ****
.sp
.LP
These functions can also fail if the name service switch does not specify valid
\fBproject\fR(4) name service sources. In the case of an incompletely
! configurated name service switch configuration, \fBgetprojbyid()\fR and other
functions can return error values other than those documented above. These
conditions usually occur when the \fBnsswitch.conf\fR file indicates that one
or more name services is providing entries for the project database when that
name service does not actually make a project table available.
.SH USAGE
- .sp
.LP
When compiling multithreaded applications, see \fBIntro\fR(3), Notes On
Multithreaded Applications.
.sp
.LP
--- 262,277 ----
.sp
.LP
These functions can also fail if the name service switch does not specify valid
\fBproject\fR(4) name service sources. In the case of an incompletely
! configured name service switch configuration, \fBgetprojbyid()\fR and other
functions can return error values other than those documented above. These
conditions usually occur when the \fBnsswitch.conf\fR file indicates that one
or more name services is providing entries for the project database when that
name service does not actually make a project table available.
.SH USAGE
.LP
When compiling multithreaded applications, see \fBIntro\fR(3), Notes On
Multithreaded Applications.
.sp
.LP
*** 282,292 ****
Use of the enumeration interface \fBgetprojent()\fR is discouraged. Enumeration
is supported for the project file, NIS, and LDAP but in general is not
efficient. The semantics of enumeration are discussed further in
\fBnsswitch.conf\fR(4).
.SH ATTRIBUTES
- .sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp
.sp
--- 278,287 ----
*** 300,309 ****
_
MT-Level See Description.
.TE
.SH SEE ALSO
- .sp
.LP
\fBIntro\fR(3), \fBlibproject\fR(3LIB), \fBproject_walk\fR(3PROJECT),
\fBsysconf\fR(3C), \fBnsswitch.conf\fR(4), \fBproject\fR(4),
\fBattributes\fR(5)
--- 295,303 ----