GRID-MAPFILE-CHECK(8)

💖 GRID-MAPFILE-CHECK(8) 💖

okay bestie, gather round, because we're talking about grid-mapfile-check-consistency — a lil program from the Grid Community Toolkit Manual that is literally the vibe-check bouncer for your gridmap file. it does not play. 🫶

---

✨ NAME ✨

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

ok so yes, the official one-liner says "add an entry," and no, it does not add an entry, it checks things. the manpage said it, so I'm saying it. we keep the lore. 💀

---

🎀 SYNOPSIS 🎀

grid-mapfile-check-consistency [ -h | -help | -usage | -version |
-versions ]

grid-mapfile-check-consistency [ -mapfile MAPFILE | -f MAPFILE ]

like… it's giving "either you want the help/version tea, or you want to point me at a file." pick a lane, queen. 👑

---

🌸 DESCRIPTION 🌸

so what does this icon actually do? grid-mapfile-check-consistency runs the basic checks for validity of a gridmap file. and when I say basic checks, I mean:

• checks for existence (does the file even exist, bestie?)
• checks for duplication of entries (we do not do repeats in this house)
• checks for valid local user names (if your user isn't real, that's a problem)

if the gridmap file is valid, grid-mapfile-check-consistency exits with a zero exit code. if it's not valid, it exits with a non-zero exit code. either way — valid or messy — it displays information about its progress as it parses and validates the gridmap file. so you always get the play-by-play, never a silent treatment. 💅

now, the default file it picks? it goes down a lil priority list, and it's very main character about it:

1. by default, grid-mapfile-check-consistency will check the gridmap file named by the GRIDMAP environment variable, if present.
2. if that variable is not set, it will check the file $HOME/.gridmap for non-root users, if present.
3. if that doesn't exist, or grid-mapfile-check-consistency is run as root, it will then check /etc/grid-security/grid-mapfile.

and yes, you can override all of that with the -mapfile or -f command-line options. your file, your rules. 🦋

the full set of command-line options to grid-mapfile-check-consistency are:

• -h, -help, -usage — Display the command-line options to grid-mapfile-check-consistency. (the "help me help you" trio 🥺)
• -version, -versions — Display the version number of the grid-mapfile-check-consistency command. (for when you gotta know which era we're in ⭐)
• -mapfile MAPFILE, -f MAPFILE — Check the gridmap file named by MAPFILE instead of the default. (the glow-up option ✨)

---

🌈 EXAMPLES 🌈

example one: check that the gridmap file in /etc/grid-security is valid:

% grid-mapfile-check-consistency* -f /etc/grid-security/grid-mapfile
Checking /etc/grid-security/grid-mapfile
Verifying grid mapfile existence...OK
Checking for duplicate entries...OK
Checking for valid user names...OK

look at all those OKs. immaculate. no notes. 🔥

---

example two: check a gridmap file that has an invalid local user name:

grid-mapfile-check-consistency -f /etc/grid-security/grid-mapfile
Checking /etc/grid-security/grid-mapfile
Verifying grid mapfile existence...OK
Checking for duplicate entries...OK
ERROR: baduser is not a valid local username
ERROR: Found 1 invalid username(s)

and there it is. baduser got caught lacking. the ERROR: lines are right there, loud and proud, and it still tells you exactly how many invalid usernames it found. transparency queen. 😭

---

🧚 ENVIRONMENT 🧚

the following environment variables affect the execution of grid-mapfile-check-consistency:

• GRIDMAP — Path to the gridmap to check.

---

🍓 FILES 🍓

the following files affect the execution of grid-mapfile-check-consistency:

• $HOME/.gridmap — Path to the default gridmap to check if the GRIDMAP environment variable is not set for non-root users.
• /etc/grid-security/grid-mapfile — Path to the default gridmap to check if GRIDMAP environment variable is not set and the above file does not exist.

---

👑 SEE ALSO 👑

your homework, bestie, go read these too:

• grid-mapfile-add-entry(8)
• grid-mapfile-delete-entry(8)

---

💜 AUTHOR 💜

Copyright © 1999-2016 University of Chicago

---

no cap, if the gridmap file is invalid, you're getting a non-zero exit code. that's not a vibe, that's a warning. handle it. 🙈

---

okay that's the whole page, mwah 💋 — this was Grid Community Toolkit 6, dated 03/31/2018, and it's been an absolute pleasure doing business with you. slay, stay validated, and may all your checks print OK. periodt. 🎀💖✨