CERTMONGER(1)

πŸ“¦
version 0.79.21 Β· 2 versions
, in alpine 3.24, centos-stream 10, centos-stream 9, debian trixie, fedora 43, fedora 44, ubuntu questing, ubuntu resolute, ubuntu stonking

πŸ’– CERTMONGER β€” the getcert era πŸ’–

okay bestie, sit down, hydrate, because this one's a whole suite. this is the manual page for getcert, from the certmonger package. she's a command-line queen with like fourteen subcommands and she does NOT do anything halfway. let's get into it πŸŽ€


✨ NAME ✨

getcert β€” that's her. that's the name. periodt.


🌸 SYNOPSIS 🌸

getcert request [options]
getcert start-tracking [options]
getcert stop-tracking [options]
getcert resubmit [options]
getcert rekey [options]
getcert refresh [options]
getcert list [options]
getcert status [options]
getcert add-ca [options]
getcert add-scep-ca [options]
getcert list-cas [options]
getcert modify-ca [options]
getcert refresh-ca [options]
getcert remove-ca [options]

like… pick a lane, bestie. any lane. there's fourteen of them and they all take [options] πŸ’…


πŸ¦‹ DESCRIPTION πŸ¦‹

so here's the vibe: the getcert tool slides into the DMs of a org.fedorahosted.certmonger service on behalf of the user who invoked it. she's not doing the work herself, she's asking the service very nicely. it's giving delegation, it's giving "not my job but i know a girl" πŸ’–

what she can ask the service to do:

  • begin enrollment β€” and optionally generate a key pair to use while she's at it πŸ”‘
  • begin monitoring a certificate in a location you specify, to watch for expiration β€” and optionally refresh it when expiration gets close πŸ‘€
  • list the set of certificates the service is already monitoring
  • list the set of CAs the service is capable of using

and if you run her with no command as the first command-line argument? she'll just print short usage information for each of her functions. she's helpful like that, no cap 🫢

one more thing, and this one's lowkey important: if getcert is invoked by a user with UID 0, and there's no system bus available, she will attempt to launch a temporary copy of the certmonger daemon just to handle her requests. main character energy fr fr πŸ‘‘


πŸ’œ COMMON ARGUMENTS πŸ’œ

these apply across the board, so pay attention bestie:

  • if CERTMONGER_PVT_ADDRESS is set in the environment, getcert contacts the service directly at the specified location. skipping the middleman, iconic πŸ’…
  • all commands can take either the -s or the -S arguments β€” these tell getcert to contact the org.fedorahosted.certmonger service on the session or the system bus, if no value is set.
  • by default (no value set), getcert consults the org.fedorahosted.certmonger service attached to the system bus. that's the default, that's the norm, that's just how she rolls ✨

🌈 EXIT STATUS 🌈

the exit status is 0 on success, and nonzero on error. dramatic? maybe. accurate? absolutely.

  • 0 β€” Success πŸŽ‰
  • 1 β€” Error 😭
  • 2 β€” Duplicate entry πŸ’€

πŸ™ˆ BUGS πŸ™ˆ

found a bug? please file tickets for any that you find at https://fedorahosted.org/certmonger/ β€” the maintainers wanna know, fr fr, don't just suffer in silence 🫢


πŸ‘‘ SEE ALSO πŸ‘‘

your reading list, bestie, go off:


and that's the whole page, babe πŸ’–

this one's from the certmonger Manual, dated November 3, 2009, and it lives under CERTMONGER(1). vintage but still serving looks, we love to see it β­πŸŒΈπŸ¦‹