GRID-MAPFILE-DELET(8)

GRID-MAPFILE-DELET(8) 💅

okay bestie, we're doing the Grid Community Toolkit Manual page for grid-mapfile-delete-entry and honestly? it's a lil banger. it's a section 8 system-admin page, it deletes stuff from your gridmap file, and it is so polite about it. let's get into it 🫶

---

✨ NAME ✨

grid-mapfile-delete-entry — bestie, it literally removes entries from a gridmap file. that's the whole job. icon behavior 💖

---

🌸 SYNOPSIS 🌸

grid-mapfile-delete-entry [ -help | -usage | -version | -versions ]

grid-mapfile-delete-entry -dn DISTINGUISHED-NAME -ln LOCAL-NAME... [ -d
| -dryrun ] [ -mapfile MAPFILE | -f MAPFILE ]

like. look at her. two modes: "tell me about yourself" and "actually go delete things." pick your lane 💅

---

🦋 DESCRIPTION 🦋

so grid-mapfile-delete-entry deletes mappings out of a gridmap file. and here's the tea on how it decides what to delete:

• if you give it both -dn and -ln, it removes entries that meet both criteria — so it removes entries mapping DISTINGUISHED-NAME to LOCAL-NAME, and it does that for each LOCAL-NAME you listed. both boxes checked, entry gone, periodt ✨
• if you only give one of -dn or -ln, then all entries for that DISTINGUISHED-NAME or that LOCAL-NAME get removed. no half measures, we're clearing the whole vibe 💀

now, which file does it touch? by default it modifies the gridmap file named by the GRIDMAP environment variable if that's present, or /etc/grid-security/grid-mapfile if it's not. wanna change that? use the -mapfile or -f command-line options. easy. 🎀

and here's the safety girlie part: before it modifies a gridmap file, it saves the current contents to a file with the string .old appended to the original file name. so there's always a lil backup. she's prepared, she's organized, she's that girl 👑

the full set of command-line options to grid-mapfile-delete-entry is:

• -help, -usage — shows you the command-line options for grid-mapfile-delete-entry. a lil tour, no commitment 💖
• -version, -versions — shows you the version number of the grid-mapfile-delete-entry command. the second form gives you more details. the ✨deluxe✨ version, if you will.
• -dn DISTINGUISHED-NAME — the X.509 distinguished name to remove from the gridmap file. if you didn't specify -ln, it removes all entries for this name. if you did, it removes entries that match both this name and the local name. and heads up bestie, the name should be in OpenSSL's oneline format. 🧚
• -ln LOCAL-NAME... — the POSIX user name to remove from the gridmap file. you can stack multiple LOCAL-NAME strings after the -ln command-line option to remove multiple names at once, like a little deletion parade. if you didn't specify -dn, it removes all entries for these names. if you did, it removes entries that match the DISTINGUISHED-NAME and any of the LOCAL-NAME values. 💜
• -d, -dryrun — shows you diagnostics about what would be removed from the gridmap file, but doesn't actually modify the file. it's the "add to cart" button, not the "place order" button. love a rehearsal 🙈
• -mapfile MAPFILE, -f MAPFILE — modifies the gridmap file named by MAPFILE instead of the default. you're the main character, you choose the file 🌈

---

🔥 EXAMPLES 🔥

remove all mappings for a distinguished name:

% grid-mapfile-delete-entry "/DC=org/DC=example/DC=grid/CN=Joe User"
Modifying /etc/grid-security/grid-mapfile ...
Deleting entry: "/DC=org/DC=example/DC=grid/CN=Joe User" juser,juser2
(1) entry deleted

remove the mapping between a distinguished name and a single local username:

% grid-mapfile-delete-entry "/DC=org/DC=example/DC=grid/CN=Joe User" -ln juser2
Modifying /etc/grid-security/grid-mapfile ...
Current entry: "/DC=org/DC=example/DC=grid/CN=Joe User" juser
(1) mapping removed: (juser2), (0) not present and ignored
(0) entries deleted

see how in the second one it's like "yeah i removed the juser2 mapping, and also zero things weren't present, and also zero entries deleted"? she's thorough. she's transparent. we stan a communicative queen 💅✨

---

🌈 ENVIRONMENT 🌈

these environment variables affect how grid-mapfile-delete-entry runs, bestie:

• GRIDMAP — path to the gridmap to modify. that's it, that's the whole variable, and it's doing her best 🎀

---

🎀 FILES 🎀

these files affect how grid-mapfile-delete-entry runs:

• /etc/grid-security/grid-mapfile — path to the default gridmap to modify if the GRIDMAP environment variable is not set. the fallback bestie. the ride-or-die default. 🫶

---

💖 SEE ALSO 💖

• grid-mapfile-add-entry(8)
• grid-mapfile-check-consistency(8)

(the add-entry one is her opposite, they're giving enemies-to-lovers fr fr 😭)

---

👑 AUTHOR 👑

Copyright © 1999-2016 University of Chicago

---

okay so that's the whole page, and honestly? she ate. no cap. go forth and delete those gridmap entries responsibly, and remember: she makes a .old backup so you can always come back home 💜✨

this was the Grid Community Toolkit 6 version, dated 03/31/2018 — mwah, love u, bye bestie 🦋💅