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)