| PackageDescription | AFS is a distributed file system allowing cross-platform sharing of files
among multiple computers. It associates client credentials (called AFS
tokens) with a Process Authentication Group, or PAG. AFS::PAG makes
available in Perl the PAG manipulation functions provided by the libkafs or
libkopenafs libraries.
With the functions provided by this module, a Perl program can detect
whether AFS is available on the local system (hasafs()) and whether it is
currently running inside a PAG (haspag()). It can also create a new PAG and
put the current process in it (setpag()) and remove any AFS tokens in the
current PAG (unlog()).
Note that this module doesn't provide a direct way to obtain new AFS
tokens. Programs that need AFS tokens should normally obtain Kerberos
tickets (via whatever means) and then run the program *aklog*, which comes
with most AFS distributions. This program will create AFS tokens from the
current Kerberos ticket cache and store them in the current PAG. To isolate
those credentials from the rest of the system, call setpag() before running
*aklog*. |