1GRID-MAPFILE-CHECK(8)           Globus Commands          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
11       grid-mapfile-check-consistency [-mapfile MAPFILE] | [-f MAPFILE]
12

DESCRIPTION

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

EXAMPLES

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

ENVIRONMENT VARIABLES

62       The following environment variables affect the execution of
63       grid-mapfile-check-consistency:
64
65       GRIDMAP
66           Path to the default 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       University of Chicago
85
86
87
88Globus Toolkit 5.0.1              03/19/2010             GRID-MAPFILE-CHECK(8)
Impressum