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.
