grid-mapfile-delete-entry(8)

1GRID-MAPFILE-DELET(8)    Grid Community Toolkit Manual   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... [ -d
12       | -dryrun ] [ -mapfile MAPFILE | -f MAPFILE ]
13

DESCRIPTION

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

EXAMPLES

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

ENVIRONMENT

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

FILES

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

AUTHOR

96       Copyright © 1999-2016 University of Chicago
97
98
99
100Grid Community Toolkit 6          03/31/2018             GRID-MAPFILE-DELET(8)