SYNOPSIS

        use File::Policy;
        use File::Policy qw/check_safe/;   # to import a specific subroutine
        use File::Policy qw/:all/;         # to import all subroutines

#Checking I/O policy check_safe($filename, 'r'); check_safe($filename, 'w');

#Portable directory locations $logdir = get_log_dir(); $tmpdir = get_temp_dir();

DESCRIPTION

This defines the default (unrestricted) policy for file I/O with modules such as File::Slurp::WithinPolicy. You may replace this default policy with one for your organisation.

FUNCTIONS

check_safe

check_safe( FILENAME , MODE ); Checks a filename is safe - dies if not. \s-1MODE\s0 is r (read) or w (write). Default is no restrictions on file I/O.

get_temp_dir

$temporary_directory = get_temp_dir(); Returns the path to temporary directory from the \s-1TEMP\s0 environment variable or File::Spec::Functions::tmpdir(). Note that any return value will have been cleared of a trailing slash.

get_log_dir

$log_directory = get_log_dir(); Returns the path to log directory from the \s-1LOGDIR\s0 environment variable or the current directory. Note that any return value will have been cleared of a trailing slash.

VERSION

$Revision: 1.6 $ on $Date: 2005/05/18 15:57:28 $ by $Author: johna $

AUTHOR

John Alden <cpan _at_ bbc _dot_ co _dot_ uk>

COPYRIGHT

(c) \s-1BBC\s0 2005. This program is free software; you can redistribute it and/or modify it under the \s-1GNU\s0 \s-1GPL\s0.

See the file \s-1COPYING\s0 in this distribution, or http://www.gnu.org/licenses/gpl.txt