grid-mapfile-delete-entry(8)

1GRID-MAPFILE-DELET(8)           Globus Commands          GRID-MAPFILE-DELET(8)
2
3
4

NAME

6       grid-mapfile-delete-entry - Remove entries from a gridmap file
7

SYNOPSIS

9       grid-mapfile-delete-entry [-help] [-usage] [-version] [-versions]
10
11       grid-mapfile-delete-entry {-dn DISTINGUISHED-NAME} {-ln LOCAL-NAME...}
12                                 [[-d] | [-dryrun]]
13                                 [[-mapfile MAPFILE] | [-f MAPFILE]]
14

DESCRIPTION

16       The grid-mapfile-delete-entry program deletes mappings from a gridmap
17       file. If both the -dn and -ln> options are specified,
18       grid-mapfile-delete-entry removes entries which meet both criteria
19       (remove entries mapping DISTINGUISHED-NAME to LOCAL-NAME for each
20       LOCAL-NAME specified). If only -dn or -ln is specified all entries for
21       that DISTINGUISHED-NAME or LOCAL-NAME are removed.
22
23       By default, grid-mapfile-delete-entry will modify the gridmap file
24       named by the GRIDMAP environment variable if present, or the file
25       /etc/grid-security/grid-mapfile if not. This can be changed by the use
26       of the -mapfile or -f command-line options.
27
28       Prior to modifying a gridmap file, grid-mapfile-delete-entry saves its
29       current contents to a file with the string .old appended to the
30       original file name.
31
32       The full set of command-line options to grid-mapfile-delete-entry are:
33
34       -help, -usage
35           Display the command-line options to grid-mapfile-delete-entry.
36
37       -version, -versions
38           Display the version number of the grid-mapfile-delete-entry
39           command. The second form includes more details.
40
41       -dn DISTINGUISHED-NAME
42           The X.509 distinguished name to remove from the gridmap file. If
43           the -ln option is not specified, remove all entries for this name;
44           otherwise, remove entries that match both this name and the local
45           name. The name should be in OpenSSL´s oneline format.
46
47       -ln LOCAL-NAME...
48           The POSIX user name to remove from the gridmap file. Include
49           multiple LOCAL-NAME strings after the -ln command-line option to
50           remove multiple names from the gridmap. If the -dn option is not
51           specifeid, remove all entries for these names; otherwise, remove
52           entries that match the DISTINGUISHED-NAME and any of the LOCAL-NAME
53           values.
54
55       -d, -dryrun
56           Display diagnostics about what would be removed from the gridmap
57           file, but don´t actually modify the file.
58
59       -mapfile MAPFILE, -f MAPFILE
60           Modify the gridmap file named by MAPFILE instead of the default.
61

EXAMPLES

63       Remove all mappings for a distinguished name:
64
65           % grid-mapfile-delete-entry "/DC=org/DC=example/DC=grid/CN=Joe User"
66           Modifying /etc/grid-security/grid-mapfile ...
67           Deleting entry: "/DC=org/DC=example/DC=grid/CN=Joe User" juser,juser2
68           (1) entry deleted
69
70       Remove the mapping between a distinguished name and a single local
71       username:
72
73           % grid-mapfile-delete-entry "/DC=org/DC=example/DC=grid/CN=Joe User" -ln juser2
74           Modifying /etc/grid-security/grid-mapfile ...
75           Current entry: "/DC=org/DC=example/DC=grid/CN=Joe User" juser
76           (1) mapping removed: (juser2), (0) not present and ignored
77           (0) entries deleted
78
79

ENVIRONMENT VARIABLES

81       The following environment variables affect the execution of
82       grid-mapfile-delete-entry:
83
84       GRIDMAP
85           Path to the default gridmap to modify.
86

FILES

88       The following files affect the execution of grid-mapfile-delete-entry:
89
90       /etc/grid-security/grid-mapfile
91           Path to the default gridmap to modify if GRIDMAP environment
92           variable is not set.
93

AUTHOR

98       University of Chicago
99
100
101
102Globus Toolkit 5.0.1              03/19/2010             GRID-MAPFILE-DELET(8)