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.