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 identification.  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 former 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 current 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)