atuservalid(3) [debian man page]

atuser(3)						       AtFS Toolkit Library							 atuser(3)

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.

AtFStk-1.12						     Fri Jun 25 16:39:50 1993							 atuser(3)

af_misc(3)						    Attribute Filesystem (AtFS) 						af_misc(3)

NAME

       af_afname, af_afpath, af_aftype, af_afuser, af_setarchpath, af_version - miscellaneous AtFS functions

SYNOPSIS

       #include <atfs.h>

       char  *af_afname (char *path)

       char  *af_afpath (char *path)

       char  *af_aftype (char *path)

       Af_user*af_afuser (uit_t uid)

       char  *af_setarchpath (char *path)

       char  *af_version (void)

DESCRIPTION

       The  functions  af_afname, af_afpath and af_aftype extract name, syspath or type from a given (operating system dependent) file identifica-
       tion.  In an UNIX environment, a given pathname of the form

	      /usr/lib/libatfs.a leads to afname libatfs, afpath /usr/lib and aftype a.

       If no path (eg. otto.c), or no type (eg. /usr/hugo/Makefile) is given, the corresponding routine returns an  empty  string.   A	period	as
       first  character in a filename is always considered to be part of the name (e.g. .cshrc has the name .cshrc and an empty type string).  "."
       and ".." are recognized as names.  Archive file extensions and AtFS specific path extensions are stripped from  the  resulting  name  resp.
       pathname.
       Note:  af_afname, af_afpath and af_aftype use static memory for the returned results.  Subsequent calls of the same function overwrite for-
       mer results.

       af_afuser returns an AtFS user identification which consists of the login name of the user identified by uid, the current host and the cur-
       rent domain. Uid_t is defined according to the return type of getuid (2) on your system. The Af_user type has the following structure

	      typedef struct {
		    charaf_username[MAXUSERNAMELEN];
		    charaf_userhost[MAXHOSTNAMELEN];
		    charaf_userdomain[MAXDOMAIN+1];
		    } Af_user;

       af_setarchpath defines the location of the AtFS archive files. A nil-pointer given as path-argument clears the former setting of the global
       archive path.  af_setarchpath returns the old global archive path.  Initially, no global archive path is set. In  this  case,  all  archive
       files are stored in a subdirectory called AtFS, relative to the directory where corresponding busy version resides.

       af_version returns a string that names the version and the creator of the currently used AtFS library.

SEE ALSO

       getuid(2)

AtFS-1.71						     Fri Jun 25 14:33:12 1993							af_misc(3)