Man Linux: Main Page and Category List

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.