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.