view release on metacpan or  search on metacpan

README  view on Meta::CPAN

  AFS::PAG provides the standard PAG and token manipulation functions
  setpag and unlog to Perl programs as a native module.  It also provides
  the hasafs and haspag functions to detect whether AFS is running and
  whether the current process is in a PAG.  Unlike the more general AFS
  module, it will build with any recent OpenAFS, Heimdal's libkafs, or on
  Linux without any AFS libraries at all.

DESCRIPTION

  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 and whether it is currently
  running inside a PAG.  It can also create a new PAG and put the current
  process in it, and remove any AFS tokens in the current PAG.

  This module doesn't provide a direct way to obtain new AFS tokens, only

lib/AFS/PAG.pm  view on Meta::CPAN

        setpag();
        system('aklog') == 0
          or die "cannot get tokens\n";
        do_afs_things();
        unlog();
    }

=head1 DESCRIPTION

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 B<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 B<aklog>.

=head1 FUNCTIONS

This module provides the following functions, none of which are exported
by default:

=over 4

=item hasafs()