mirror of git://sourceware.org/git/glibc.git
Manual typos: Users and Groups
2016-05-06 Rical Jasan <ricaljasan@pacific.net> * manual/users.texi: Fix typos in the manual.
This commit is contained in:
parent
d72457974d
commit
9e302f97d4
|
@ -1,5 +1,7 @@
|
||||||
2016-10-06 Rical Jasan <ricaljasan@pacific.net>
|
2016-10-06 Rical Jasan <ricaljasan@pacific.net>
|
||||||
|
|
||||||
|
* manual/users.texi: Fix typos in the manual.
|
||||||
|
|
||||||
* manual/job.texi: Fix typos in the manual.
|
* manual/job.texi: Fix typos in the manual.
|
||||||
|
|
||||||
* manual/process.texi: Fix typos in the manual.
|
* manual/process.texi: Fix typos in the manual.
|
||||||
|
|
|
@ -152,7 +152,7 @@ by creating a new user ID and login name (say, @code{games}) to own the
|
||||||
scores file, and make the file writable only by this user. Then, when
|
scores file, and make the file writable only by this user. Then, when
|
||||||
the game program wants to update this file, it can change its effective
|
the game program wants to update this file, it can change its effective
|
||||||
user ID to be that for @code{games}. In effect, the program must
|
user ID to be that for @code{games}. In effect, the program must
|
||||||
adopt the persona of @code{games} so it can write the scores file.
|
adopt the persona of @code{games} so it can write to the scores file.
|
||||||
|
|
||||||
@node How Change Persona
|
@node How Change Persona
|
||||||
@section How an Application Can Change Persona
|
@section How an Application Can Change Persona
|
||||||
|
@ -357,7 +357,7 @@ have this function.
|
||||||
@c setuid @asulock @aculock
|
@c setuid @asulock @aculock
|
||||||
@c INLINE_SETXID_SYSCALL dup @asulock @aculock
|
@c INLINE_SETXID_SYSCALL dup @asulock @aculock
|
||||||
If the calling process is privileged, this function sets both the real
|
If the calling process is privileged, this function sets both the real
|
||||||
and effective user ID of the process to @var{newuid}. It also deletes
|
and effective user IDs of the process to @var{newuid}. It also deletes
|
||||||
the file user ID of the process, if any. @var{newuid} may be any
|
the file user ID of the process, if any. @var{newuid} may be any
|
||||||
legal value. (Once this has been done, there is no way to recover the
|
legal value. (Once this has been done, there is no way to recover the
|
||||||
old effective user ID.)
|
old effective user ID.)
|
||||||
|
@ -1059,7 +1059,7 @@ The Internet address of a remote host.
|
||||||
The @code{ut_type}, @code{ut_pid}, @code{ut_id}, @code{ut_tv}, and
|
The @code{ut_type}, @code{ut_pid}, @code{ut_id}, @code{ut_tv}, and
|
||||||
@code{ut_host} fields are not available on all systems. Portable
|
@code{ut_host} fields are not available on all systems. Portable
|
||||||
applications therefore should be prepared for these situations. To help
|
applications therefore should be prepared for these situations. To help
|
||||||
doing this the @file{utmp.h} header provides macros
|
do this the @file{utmp.h} header provides macros
|
||||||
@code{_HAVE_UT_TYPE}, @code{_HAVE_UT_PID}, @code{_HAVE_UT_ID},
|
@code{_HAVE_UT_TYPE}, @code{_HAVE_UT_PID}, @code{_HAVE_UT_ID},
|
||||||
@code{_HAVE_UT_TV}, and @code{_HAVE_UT_HOST} if the respective field is
|
@code{_HAVE_UT_TV}, and @code{_HAVE_UT_HOST} if the respective field is
|
||||||
available. The programmer can handle the situations by using
|
available. The programmer can handle the situations by using
|
||||||
|
@ -1081,7 +1081,7 @@ accounting information.
|
||||||
@comment SVID
|
@comment SVID
|
||||||
@vindex RUN_LVL
|
@vindex RUN_LVL
|
||||||
@item RUN_LVL
|
@item RUN_LVL
|
||||||
This macro is used to identify the systems runlevel.
|
This macro is used to identify the system's runlevel.
|
||||||
|
|
||||||
@comment utmp.h
|
@comment utmp.h
|
||||||
@comment SVID
|
@comment SVID
|
||||||
|
@ -1099,7 +1099,7 @@ This macro is used to identify the time when the system clock changed.
|
||||||
@comment SVID
|
@comment SVID
|
||||||
@vindex NEW_TIME
|
@vindex NEW_TIME
|
||||||
@item NEW_TIME
|
@item NEW_TIME
|
||||||
This macro is used to identify the time after the system changed.
|
This macro is used to identify the time after the system clock changed.
|
||||||
|
|
||||||
@comment utmp.h
|
@comment utmp.h
|
||||||
@comment SVID
|
@comment SVID
|
||||||
|
@ -1559,7 +1559,7 @@ accounting information.
|
||||||
@comment XPG4.2
|
@comment XPG4.2
|
||||||
@vindex RUN_LVL
|
@vindex RUN_LVL
|
||||||
@item RUN_LVL
|
@item RUN_LVL
|
||||||
This macro is used to identify the systems runlevel.
|
This macro is used to identify the system's runlevel.
|
||||||
|
|
||||||
@comment utmpx.h
|
@comment utmpx.h
|
||||||
@comment XPG4.2
|
@comment XPG4.2
|
||||||
|
@ -1577,7 +1577,7 @@ This macro is used to identify the time when the system clock changed.
|
||||||
@comment XPG4.2
|
@comment XPG4.2
|
||||||
@vindex NEW_TIME
|
@vindex NEW_TIME
|
||||||
@item NEW_TIME
|
@item NEW_TIME
|
||||||
This macro is used to identify the time after the system changed.
|
This macro is used to identify the time after the system clock changed.
|
||||||
|
|
||||||
@comment utmpx.h
|
@comment utmpx.h
|
||||||
@comment XPG4.2
|
@comment XPG4.2
|
||||||
|
@ -2153,7 +2153,7 @@ A null pointer return indicates there is no user named @var{name}.
|
||||||
@c
|
@c
|
||||||
@c _nss_*_getpwnam_r (assumed) @asuinit @asulock @acucorrupt @aculock
|
@c _nss_*_getpwnam_r (assumed) @asuinit @asulock @acucorrupt @aculock
|
||||||
|
|
||||||
This function is similar to @code{getpwnam} in that is returns
|
This function is similar to @code{getpwnam} in that it returns
|
||||||
information about the user whose user name is @var{name}. However, like
|
information about the user whose user name is @var{name}. However, like
|
||||||
@code{getpwuid_r}, it fills the user supplied buffers in
|
@code{getpwuid_r}, it fills the user supplied buffers in
|
||||||
@var{result_buf} and @var{buffer} with the information instead of using
|
@var{result_buf} and @var{buffer} with the information instead of using
|
||||||
|
@ -2466,13 +2466,12 @@ A null pointer indicates there is no group named @var{name}.
|
||||||
@c nss_group_lookup2 dup @mtslocale @ascudlopen @ascuplugin @ascuheap @asulock @acucorrupt @aculock @acsfd @acsmem
|
@c nss_group_lookup2 dup @mtslocale @ascudlopen @ascuplugin @ascuheap @asulock @acucorrupt @aculock @acsfd @acsmem
|
||||||
@c *fct.l @ascuplugin
|
@c *fct.l @ascuplugin
|
||||||
@c nss_next2 dup @ascudlopen @ascuplugin @ascuheap @asulock @acucorrupt @aculock @acsfd @acsmem
|
@c nss_next2 dup @ascudlopen @ascuplugin @ascuheap @asulock @acucorrupt @aculock @acsfd @acsmem
|
||||||
This function is similar to @code{getgrnam} in that is returns
|
This function is similar to @code{getgrnam} in that it returns
|
||||||
information about the group whose group name is @var{name}. Like
|
information about the group whose group name is @var{name}. Like
|
||||||
@code{getgrgid_r}, it uses the user supplied buffers in
|
@code{getgrgid_r}, it uses the user supplied buffers in
|
||||||
@var{result_buf} and @var{buffer}, not a static buffer.
|
@var{result_buf} and @var{buffer}, not a static buffer.
|
||||||
|
|
||||||
The return values are the same as for @code{getgrgid_r}
|
The return values are the same as for @code{getgrgid_r}.
|
||||||
@code{ERANGE}.
|
|
||||||
@end deftypefun
|
@end deftypefun
|
||||||
|
|
||||||
@node Scanning All Groups
|
@node Scanning All Groups
|
||||||
|
@ -2570,7 +2569,7 @@ wish to save the information.
|
||||||
This function is similar to @code{getgrent} in that it returns the next
|
This function is similar to @code{getgrent} in that it returns the next
|
||||||
entry from the stream initialized by @code{setgrent}. Like
|
entry from the stream initialized by @code{setgrent}. Like
|
||||||
@code{fgetgrent_r}, it places the result in user-supplied buffers
|
@code{fgetgrent_r}, it places the result in user-supplied buffers
|
||||||
pointed to @var{result_buf} and @var{buffer}.
|
pointed to by @var{result_buf} and @var{buffer}.
|
||||||
|
|
||||||
If the function returns zero @var{result} contains a pointer to the data
|
If the function returns zero @var{result} contains a pointer to the data
|
||||||
(normally equal to @var{result_buf}). If errors occurred the return
|
(normally equal to @var{result_buf}). If errors occurred the return
|
||||||
|
@ -2630,7 +2629,7 @@ Sometimes it is useful to group users according to other criteria
|
||||||
group of users with a certain machine. On the other hand grouping of
|
group of users with a certain machine. On the other hand grouping of
|
||||||
host names is not supported so far.
|
host names is not supported so far.
|
||||||
|
|
||||||
In Sun Microsystems SunOS appeared a new kind of database, the netgroup
|
In Sun Microsystems' SunOS appeared a new kind of database, the netgroup
|
||||||
database. It allows grouping hosts, users, and domains freely, giving
|
database. It allows grouping hosts, users, and domains freely, giving
|
||||||
them individual names. To be more concrete, a netgroup is a list of triples
|
them individual names. To be more concrete, a netgroup is a list of triples
|
||||||
consisting of a host name, a user name, and a domain name where any of
|
consisting of a host name, a user name, and a domain name where any of
|
||||||
|
@ -2657,7 +2656,7 @@ character @code{-} shall be used.
|
||||||
@node Lookup Netgroup
|
@node Lookup Netgroup
|
||||||
@subsection Looking up one Netgroup
|
@subsection Looking up one Netgroup
|
||||||
|
|
||||||
The lookup functions for netgroups are a bit different to all other
|
The lookup functions for netgroups are a bit different than all other
|
||||||
system database handling functions. Since a single netgroup can contain
|
system database handling functions. Since a single netgroup can contain
|
||||||
many entries a two-step process is needed. First a single netgroup is
|
many entries a two-step process is needed. First a single netgroup is
|
||||||
selected and then one can iterate over all entries in this netgroup.
|
selected and then one can iterate over all entries in this netgroup.
|
||||||
|
@ -2701,7 +2700,7 @@ These functions are declared in @file{netdb.h}.
|
||||||
@c memcpy dup ok
|
@c memcpy dup ok
|
||||||
@c libc_lock_unlock dup @aculock
|
@c libc_lock_unlock dup @aculock
|
||||||
A call to this function initializes the internal state of the library to
|
A call to this function initializes the internal state of the library to
|
||||||
allow following calls of the @code{getnetgrent} to iterate over all entries
|
allow following calls of @code{getnetgrent} to iterate over all entries
|
||||||
in the netgroup with name @var{netgroup}.
|
in the netgroup with name @var{netgroup}.
|
||||||
|
|
||||||
When the call is successful (i.e., when a netgroup with this name exists)
|
When the call is successful (i.e., when a netgroup with this name exists)
|
||||||
|
@ -2831,7 +2830,7 @@ selected netgroup.
|
||||||
@c nss_next2 dup @ascudlopen @ascuplugin @ascuheap @asulock @acucorrupt @aculock @acsfd @acsmem
|
@c nss_next2 dup @ascudlopen @ascuplugin @ascuheap @asulock @acucorrupt @aculock @acsfd @acsmem
|
||||||
@c free_memory dup @ascuheap @acsmem
|
@c free_memory dup @ascuheap @acsmem
|
||||||
This function tests whether the triple specified by the parameters
|
This function tests whether the triple specified by the parameters
|
||||||
@var{hostp}, @var{userp}, and @var{domainp} is part of the netgroup
|
@var{host}, @var{user}, and @var{domain} is part of the netgroup
|
||||||
@var{netgroup}. Using this function has the advantage that
|
@var{netgroup}. Using this function has the advantage that
|
||||||
|
|
||||||
@enumerate
|
@enumerate
|
||||||
|
@ -2843,7 +2842,7 @@ the function is implemented more efficiently than successive calls
|
||||||
to the other @code{set}/@code{get}/@code{endnetgrent} functions.
|
to the other @code{set}/@code{get}/@code{endnetgrent} functions.
|
||||||
@end enumerate
|
@end enumerate
|
||||||
|
|
||||||
Any of the pointers @var{hostp}, @var{userp}, and @var{domainp} can be
|
Any of the pointers @var{host}, @var{user}, or @var{domain} can be
|
||||||
@code{NULL} which means any value is accepted in this position. This is
|
@code{NULL} which means any value is accepted in this position. This is
|
||||||
also true for the name @code{-} which should not match any other string
|
also true for the name @code{-} which should not match any other string
|
||||||
otherwise.
|
otherwise.
|
||||||
|
|
Loading…
Reference in New Issue