NAME

LCFG::Om::Environment::NewAFSPAG - Creates a new AFS PAG before om method invocation

VERSION

This documentation refers to LCFG::Om::Environment::NewAFSPAG version 0.4.11

SYNOPSIS

 my $env_system = LCFG::Om::Environment::NewAFSPAG->new();
 
 $env_system->initialise();

DESCRIPTION

If you are using AFS then as well as the standard environment initialisation which needs to be carried out before om can invoke an LCFG component method a new process authentication group (PAG) needs to be created. If this doesn't happen then any daemons which are started by the method invocation will end up with the AFS access of the user who made the call. This can lead to security issues and weird behaviour, particularly for webservers when the credentials expire.

This module inherits from LCFG::Om::Environment, you should also read the documentation for that module.

SUBROUTINES/METHODS

There are only two methods in this module, the important one being initialise()

• new()

  Creates and returns a new LCFG::Om::Environment::NewAFSPAG object.

• initialise()

  This calls the initialise() method of the parent class, LCFG::Om::Environment, and also does a setpag which creates a new AFS command shell (owned by the issuer of the command) and associates a new process authentication group (PAG) with the shell and the user.

DEPENDENCIES

This module requires the AFS::Utils, LCFG::Om::Environment and Readonly Perl modules.

SEE ALSO

om(1), LCFG::Om::Environment

PLATFORMS

This is the list of platforms on which we have tested this software. We expect this software to work on any Unix-like platform which is supported by Perl.

Darwin, Fedora12, Fedora13, Scientific5

BUGS AND LIMITATIONS

There are no known bugs in this application. Please report any problems to bugs@lcfg.org or via https://bugs.lcfg.org/, feedback and patches are also always very welcome.

AUTHOR

Simon Wilkinson <simon@sxw.org.uk>, Stephen Quinney <squinney@inf.ed.ac.uk>

LICENSE AND COPYRIGHT

Unless otherwise stated all code is copyright (C) 2009-2010 by University of Edinburgh.

This library is free software; you can redistribute it and/or modify it under the terms of the GPL, version 2 or later.

POD ERRORS

Hey! The above document had some coding errors, which are explained below:

Around line 47:

You forgot a '=back' before '=head1'