/ 
HealthCheck-Diagnostic-FilePermissions-v1.4.8
River stage zero No dependents
/ HealthCheck::Diagnostic::FilePermissions

NAME

HealthCheck::Diagnostic::FilePermissions - Check the paths for expected permissions in a HealthCheck

VERSION

version v1.4.8

SYNOPSIS

use HealthCheck::Diagnostic::FilePermissions;

# Just check that a file exists, without instantiating anything.
HealthCheck::Diagnostic::FilePermissions->check(
    files => [ '/tmp', '/other_directory' ],
);

# Check that some files have certain permissions.
my $d = HealthCheck::Diagnostic::FilePermissions->new(
    files => [ '/tmp', '/var/nfs' ],
);
$d->check( permissions => 0777 );

# Check that it has access to the file(s).
$d->check( access => 'x' );    # Can execute files.
$d->check( access => 'rw' );   # Can read and write files.
$d->check( access => 'r!wx' ); # Can read, not write and execute files.
$d->check( access => {         # Can read files.
    read => 1,
} );

# Check the owner and group of the file.
$d->check( owner => 'owner_name', group => 'group_name' );

# Any combination of parameters can be used.
$d->check(
    permissions => 07777,
    access      => 'rwx',
    owner       => 'dveres',
);

DESCRIPTION

This diagnostic allows a process to test file permissions on the system. You can specify a list of files and then the expected permissions code for the group. Additionally, you can specify access permissions for the process that is running the script.

ATTRIBUTES

files

Represents the file names of the files that are checked for the defined permissions.

There are a few forms that this attribute can take up. The first is a string, which can represent one file path to check. The value can also be a list of file paths to check. Finally, this value can also be an anonymous sub and return a list of file paths to check.

files => "$filename"
files => [ $filename1, $filename2 ],
files => sub { $filename1, 'other_file_name' }

access

The access permissions of the process executing the code. This attribute can take two forms, a HASH and SCALAR.

The hash form includes read, write, and execute values, which represent if the process can perform that action on the file. Shortcut keys such as r, w, and x can also be used.

The scalar form is a string that consists of the read/write/execute values in their short form (Ex: r for read, w for write, and x for execute). One exclamation point is used to separate the allowed and denied access on the files.

Any access permissions that are not defined are just ignored.

# Expect that it can read, write, and execute the file(s).
access => 'rwx'
access => { r    => 1, w     => 1, x       => 1 }
access => { read => 1, write => 1, execute => 1 },

# Expect that it cannot read, write, or execute the file(s).
access => '!rwx'
access => { r    => 0, w     => 0, x       => 0 }
access => { read => 0, write => 0, execute => 0 }

# Expect that it can read but not write, nor execute the file(s).
access => 'r!wx'
access => { r    => 1, w     => 0, x       => 0 }
access => { read => 1, write => 0, execute => 0 }

# Expect that it can read, but ignore other access permissions.
access => 'r'
access => { r    => 1 }
access => { read => 1 }

permissions

The octal value of the permissions on the file (or files).

# User can read, write, and execute the file(s).
permissions => 0700

# Nobody can read, write, or execute the file(s).
permissions => 0000

owner

The owner name of the file (or files).

owner => 'bmessine'

group

The group name of the file (or files).

group => 'developers'

collapse_single_result

The default for "collapse_single_result" in HealthCheck::Diagnostic is changed to be truthy.

This only has an effect if checking a single attribute of a single file.

DEPENDENCIES

HealthCheck::Diagnostic

CONFIGURATION AND ENVIRONMENT

None

AUTHOR

Grant Street Group <developers@grantstreet.com>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2018 - 2020 by Grant Street Group.

This is free software, licensed under:

The Artistic License 2.0 (GPL Compatible)