1GRID-MAPFILE-CHECK(8)    Grid Community Toolkit Manual   GRID-MAPFILE-CHECK(8)
2
3
4

NAME

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

SYNOPSIS

9       grid-mapfile-check-consistency [ -h | -help | -usage | -version |
10       -versions ]
11
12       grid-mapfile-check-consistency [ -mapfile MAPFILE | -f MAPFILE ]
13

DESCRIPTION

15       The grid-mapfile-check-consistency program performs basic checks for
16       validity of a gridmap file. These checks include checks for existence,
17       duplication of entries, and valid local user names. If the gridmap file
18       is valid, grid-mapfile-check-consistency exits with a zero exit code,
19       otherwise it exits with a non-zero exit code. In either case, it
20       displays information about its progress as it parses and validates the
21       gridmap file.
22
23       By default, grid-mapfile-check-consistency will check the gridmap file
24       named by the GRIDMAP environment variable if present. If that variable
25       is not set, it will check the file $HOME/.gridmap for non-root users if
26       present. If that doesn’t exist or grid-mapfile-check-consistency is run
27       as root, it will then check /etc/grid-security/grid-mapfile. This can
28       be changed by the use of the -mapfile or -f command-line options.
29
30       The full set of command-line options to grid-mapfile-check-consistency
31       are:
32
33       -h, -help, -usage
34           Display the command-line options to grid-mapfile-check-consistency.
35
36       -version, -versions
37           Display the version number of the grid-mapfile-check-consistency
38           command.
39
40       -mapfile MAPFILE, -f MAPFILE
41           Check the gridmap file named by MAPFILE instead of the default.
42

EXAMPLES

44       Check that the gridmap file in /etc/grid-security is valid:
45
46           % grid-mapfile-check-consistency* -f /etc/grid-security/grid-mapfile
47           Checking /etc/grid-security/grid-mapfile
48           Verifying grid mapfile existence...OK
49           Checking for duplicate entries...OK
50           Checking for valid user names...OK
51
52       Check a gridmap file that has an invalid local user name:
53
54           grid-mapfile-check-consistency -f /etc/grid-security/grid-mapfile
55           Checking /etc/grid-security/grid-mapfile
56           Verifying grid mapfile existence...OK
57           Checking for duplicate entries...OK
58           ERROR: baduser is not a valid local username
59           ERROR: Found 1 invalid username(s)
60

ENVIRONMENT

62       The following environment variables affect the execution of
63       grid-mapfile-check-consistency:
64
65       GRIDMAP
66           Path to the gridmap to check.
67

FILES

69       The following files affect the execution of
70       grid-mapfile-check-consistency:
71
72       $HOME/.gridmap
73           Path to the default gridmap to check if the GRIDMAP environment
74           variable is not set for non-root users.
75
76       /etc/grid-security/grid-mapfile
77           Path to the default gridmap to check if GRIDMAP environment
78           variable is not set and the above file does not exist.
79

SEE ALSO

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

AUTHOR

84       Copyright © 1999-2016 University of Chicago
85
86
87
88Grid Community Toolkit 6          03/31/2018             GRID-MAPFILE-CHECK(8)
Impressum