Man Linux: Main Page and Category List

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)