Man Linux: Main Page and Category List

NAME

       grid-mapfile-check-consistency - Add an entry to a grid map file

SYNOPSIS

       grid-mapfile-check-consistency [-h] [-help] [-usage] [-version]

       grid-mapfile-check-consistency [-mapfile MAPFILE] | [-f MAPFILE]

DESCRIPTION

       The grid-mapfile-check-consistency program performs basic checks for
       validity of a gridmap file. These checks include checks for existence,
       duplication of entries, and valid local user names. If the gridmap file
       is valid, grid-mapfile-check-consistency exits with a zero exit code,
       otherwise it exits with a non-zero exit code. In either case, it
       displays information about its progress as it parses and validates the
       gridmap file.

       By default, grid-mapfile-check-consistency will check the gridmap file
       named by the GRIDMAP environment variable if present. If that variable
       is not set, it will check the file $HOME/.gridmap for non-root users if
       present. If that doesn´t exist or grid-mapfile-check-consistency is run
       as root, it will then check /etc/grid-security/grid-mapfile. This can
       be changed by the use of the -mapfile or -f command-line options.

       The full set of command-line options to grid-mapfile-check-consistency
       are:

       -help, -h, -usage
           Display the command-line options to grid-mapfile-check-consistency.

       -version
           Display the version number of the grid-mapfile-check-consistency
           command.

       -mapfile MAPFILE, -f MAPFILE
           Check the gridmap file named by MAPFILE instead of the default.

EXAMPLES

       Check that the gridmap file in /etc/grid-security is valid:

           % grid-mapfile-check-consistency -f /etc/grid-security/grid-mapfile
           Checking /etc/grid-security/grid-mapfile
           Verifying grid mapfile existence...OK
           Checking for duplicate entries...OK
           Checking for valid user names...OK

       Check a gridmap file that has an invalid local user name:

           % grid-mapfile-check-consistency -f /etc/grid-security/grid-mapfile
           Checking /etc/grid-security/grid-mapfile
           Verifying grid mapfile existence...OK
           Checking for duplicate entries...OK
           ERROR: baduser is not a valid local username
           ERROR: Found 1 invalid username(s)

ENVIRONMENT VARIABLES

       The following environment variables affect the execution of
       grid-mapfile-check-consistency:

       GRIDMAP
           Path to the default gridmap to check.

FILES

       The following files affect the execution of
       grid-mapfile-check-consistency:

       $HOME/.gridmap
           Path to the default gridmap to check if the GRIDMAP environment
           variable is not set for non-root users.

       /etc/grid-security/grid-mapfile
           Path to the default gridmap to check if GRIDMAP environment
           variable is not set and the above file does not exist.

SEE ALSO

       grid-mapfile-add-entry(8), grid-mapfile-delete-entry(8)

AUTHOR

       University of Chicago