NAME¶
atUserValid, atScanUser, atUserName, atUserUid - user handling
SYNOPSIS¶
#include <atfs.h>
#include <atfstk.h>
void atScanUser (char *userName; Af_user *resultUser);
char* atUserName (Af_user *user);
Uid_t atUserUid (Af_user *user);
int atUserValid (Af_user *user);
DESCRIPTION¶
atScanUser scans the given string
userName and tries to derive an
AtFS user identification (
resultUser) from it. It does
not
verify the existence of a corresponding UNIX (/etc/passwd) user entry. Use
atUserUid to test that. atScanUser understands the following formats:
- user
- When the string does not contain an at sign, it is considered to be a
plain user name from the current host and domain.
- user@host
- In the case that the part after the at sign doe not contain a period, it
is assumed to be a hostname. Domain is the current domain.
- user@host.domain
- This format can only be recognized, when the given domain is equal to the
current domain, and the hostname remains as rest between the at
sign and domain name.
- user@domain
- An user identification string with a domain name different to the local
domain is treated as user@domain, although this might be wrong.
atUserName returns a string of the form
user@domain generated from
the given
user structure. If no domain name is given in the structure,
it returns
user@host instead. With no host and no domain name, just
user is returned. The result string resides in static memory and will
be overwritten on subsequent calls.
atUserUid tries to map the given
user structure to a UNIX user
identification. It returns the uid on success, -1 otherwise.
atUserValid checks the given
user structure for plausibility. It
returns FALSE on fauilure, a non null value on success.