cimauth(8)

✨ NAME ✨

cimauth — add, modify, remove, or list CIM namespace authorizations of users.

okay so bestie, this is the cimauth(8) page, and it's genuinely one of the good ones. let's get into it 💖

---

🌸 SYNOPSIS 🌸

cimauth -a -u username -n namespace [ -R ] [ -W ]

cimauth -m -u username -n namespace [ -R ] [ -W ]

cimauth -r -u username [ -n namespace ]

cimauth -l

cimauth -h

cimauth --help

cimauth --version

like, pick a lane, choose your adventure, it's giving very much "one of these is your moment" 💅

---

🦋 DESCRIPTION 🦋

So. The cimauth command manages read and write CIM namespace authorizations of users. The operations are executed on the local host by submitting requests to the CIM Server. Lowkey elegant, no cap.

Here's the tea tho: if the value of the configuration property enableNamespaceAuthorization is True, the CIM Server restricts access to namespaces based on user authorizations configured via cimauth. Iconic behavior fr.

Changes to "Dynamic" authorization parameters do not require the CIM Server to be restarted. "Non Dynamic" configuration properties (E.g. enableNamespaceAuthorization) can only be set as planned configuration and the CIM Server needs to be restarted to realize the change. So don't come crying to me when your config isn't live, bestie, restart the server 🙈

(See cimconfig(8) for information on configuring the CIM Server.)

---

🎀 Options 🎀

The cimauth command recognizes the following options:

• -a — Adds read and/or write authorizations to the specified user on the specified namespace. If neither the -R nor the -W option is specified, adds a read authorization by default. (defaults being generous, we love to see it ✨)
• -h, --help — Display command usage information. your lil helper 🫶
• -l — Lists all the authorizations configured in the CIM Server. the full roster, everyone's here 💖
• -m — Modifies authorizations of the specified user on the specified namespace. If neither the -R nor the -W option is specified, modifies the authorization to be a read authorization by default. glow-up arc, but make it permissions 💅
• -n namespace — Specifies the namespace for the operation.
• -r — Removes authorizations of the specified user on the specified namespace. If no namespaces are specified, removes authorizations on all namespaces for the specified user. it's giving scorched earth 😭
• -R — Specifies read authorization on the namespace.
• -u username — Specifies the user for the operation. The specified username must represent a valid user on the local host. no fake accounts, no imaginary besties, real users only.
• --version — Display CIM Server version number. number drop 👑
• -W — Specifies write authorization on the namespace. with great write access comes great responsibility fr fr

---

💀 EXIT STATUS 💀

When an error occurs, an error message is written to stderr and an error value of 1 is returned. The following return values are returned:

• 0 — Successful completion 🎉
• 1 — Error 😭

---

🫶 USAGE NOTE 🫶

The cimauth command requires that the CIM Server is running.

bestie. if the CIM Server isn't running, none of this is happening. it's not a suggestion, it's the whole premise. vibe check the server first 💖

---

🌈 EXAMPLES 🌈

Add read authorizations to user "guest" on namespace "root/cimv2".

cimauth -a -u guest -n root/cimv2 -R

Add read and write authorizations to user "guest" on namespace "root/system".

cimauth -a -u guest -n root/system -R -W

Modify authorizations of the user "guest" on namespace "root/system" to read only.

cimauth -m -u guest -n root/system -R

Remove the authorizations of the user "guest" on namespace "root/system".

cimauth -r -u guest -n root/system

List all the authorizations configured in the CIM Server.

cimauth -l

look at you go, running commands and everything 🥹 proud of u

---

👑 SEE ALSO 👑

cimserver(8), cimconfig(8).

go read those too, they're the supporting cast and they ate 🌟

---

and that's the whole page, bestie!! you just read cimauth(8) — that's the manual name, the source, the whole entire thing, and no date is listed on it, so consider this timeless 💜 periodt.