Change the caller's identifiers, based on a given string
Synopsis:
#include <login.h>
int set_ids_from_arg( const char *string );
Arguments:
- string
- The formatted string containing the information about the IDs to set; see below.
Library:
liblogin
Use the -l login option to
qcc
to link against this library.
Description:
The set_ids_from_arg() function
changes the caller's user ID, group ID, and supplementary group IDs, based on the given string.
The string can be in one of the following forms:
- uid[:gid[,sup_gid]*]
- All IDs must be numbers.
The user ID and the group ID are separated by a colon, and can be followed by
an arbitrary number of supplementary group IDs separated by commas.
The user ID is mandatory; we recommend that you also specify the group ID.
- user_name[,sup_gid]*
- This form depends on the /etc/passwd and /etc/group files,
so that set_ids_from_arg() can determine the user ID and the group ID from the
user_name.
The name can be followed by an arbitrary number of numeric supplementary group IDs separated by commas.
Returns:
0 on success, or -1 if an error occurred
(errno
is set).
Classification:
QNX Neutrino
Safety: |
|
Cancellation point |
Yes |
Interrupt handler |
No |
Signal handler |
No |
Thread |
No |