RAZOR-ADMIN(1p)

📦
version 2.85 · 6 versions
, in debian trixie, ubuntu questing

💖 RAZOR-ADMIN 💖

okay so bestie, this is razor-admin — the Razor Registering Agent ✨ (and yeah, it's a perl thing, user-contributed, we love her for that)

🌸 SYNOPSIS 🌸

razor-admin [options]  [ -register | -create | -discover ]

🎀 DESCRIPTION 🎀

razor-admin is the Razor Agent that does the administrative stuff — the backstage, main-character, behind-the-scenes work 👑 — and most notably, it registers you (-register). It's giving "manager of the group chat" energy.

🦋 USAGE 🦋

razor-admin must have one of these arguments, no exceptions bestie:

  • -register — Registers a new identity, which is what you use to authenticate with Razor Nomination Servers. An identity is literally just a user + password pair, and it lives at <razorhome>/identity-<user> 🫶. The very first time razor-admin -register exits successfully, a symlink called identity gets created to point at the active identity-<user> file. After that you can make new identities, but to actually use them you have to change the identity symlink to point at them. Realistically? You call this once from the command line. Exits 0 on success 💚, exits 1 on failure with a human-readable output message 😭.

So here's the tea: both razor-report(1) and razor-revoke(1) require user authentication to work, but razor-check(1) does not. Why does that matter? Because it lets the Razor Nomination Server keep track of how many messages a user reports and revokes. The more messages you correctly report and/or correctly revoke, the more trust you earn 📈. And likewise, when messages are incorrectly reported or revoked, the trust goes down for that user 📉. Highly trusted users will have the most affect on the Razor database. slay responsibly.

  • -discover — Force discovery. This will create server.*.lst files in <razorhome>. that's it, that's the whole vibe ✨
  • -create — Explicitly creates the razor-agent.conf file in <razorhome>, and also creates <razorhome> itself if it does not exist. Normally it loads /etc/razor/razor-agent.conf if that file exists, and uses defaults for anything not found. It does not attempt to register with server, but it will do discovery — see -discover above 👀

💅 OPTIONS 💅

razor-admin takes the following optional arguments:

  • -h — Print a usage message and exit. bye 👋
  • -v — Print the version number and exit. ✨
  • -d | --verbose — Print debugging information. the receipts, if you will 🧾
  • -debuglevel=n | -dl=n — Set debug level to 'n'. Default is 3 without the -d option, and 9 with it. dial it up, dial it down 💅
  • -s — Simulate a check. Do everything except talk to the server. practicing your lines, iconic 🎭
  • -conf=filename — Specifies an alternate configuration file. If not specified, it is computed — see razor-agents(1) manpage for details. See razor-agent.conf(5) manpage for the various configuration options. The default is <razorhome>/razor-agent.conf.
  • -home=directory — Specify the razorhome directory. This is where the configuration file, logfiles, identities, and server files live 🏠. If not specified, it is computed — see razor-agents(1) manpage for details.
  • -logfile=file — Specify a file to log to instead of whatever's in the configuration file. The default is <razorhome>/razor-agent.log.
  • -ident=filename — Specify an identity file to use for storing a newly registered identity. If not specified, <razorhome>/identity-<user> is used.
  • -rs=razor.server.com — Use this Razor Nomination Server instead of reading servers.nomination.lst.
  • -user=user@domain.com — Request to be known as this username. Must be less than 64 chars and may contain A-Z, a-z, 0-9, as well as printable chars [ex: - _ @ . + / ]. If not specified, a username will be assigned. Razor users are encouraged to use their email addresses as their username 📧 (iykyk).
  • -pass=password — Request this password. Valid chars are the same as for -user. If not specified, it will be assigned. 🤫
  • -l — The identity created during this razor-admin becomes the default. Normally, the first identity file created by razor-admin is the default one used. the way she said "I'm the main character now" 👑

🌈 EXAMPLES 🌈

  • razor-admin -d -create

With no global razorhome defined (the default) in /etc/razor/razor-agents.conf, this creates a .razor directory in the user's home directory.

With a global razorhome defined in /etc/razor/razor-agents.conf, it will try to use that one — and will fail if it does not have correct permissions 🚨

  • razor-admin -register

Registers a new identity, storing it in <lt>razorhome<gt>. The user and pass will be server generated. An identity is required for razor-report(1) and razor-revoke(1) 🫶

  • razor-admin -register -user me@a.com

Attempts to register a new identity using the user name me\@a.com. Will fail if the user is already taken 💀

  • razor-admin -d -create -home=/home/me/.razor

Creates a .razor directory in the user's home directory, which will then be the default home unless it's specified from the cmd-line. Sends debugging information to stdout, and does not talk to any Razor Servers. so demure ✨

  • razor-admin -d -create -home=/etc/razor

Creates the global razorhome, /etc/razor. This is the magic directory 🪄 that will be consulted if no razorhome is specified on the cmd-line or found in the user's home directory.

👑 AUTHORS 👑

Vipul Ved Prakash <mail@vipul.net>, and Chad Norwood <chad@samo.org>

the OGs, we stan 🫶

🌸 SEE ALSO 🌸

razor-agents(1), razor-agent.conf(5), razor-check(1), razor-report(1), razor-revoke(1), razor-whitelist(5)

💜 LICENSE 💜

This is free software, distributed under the Artistic License 2.0.

and that's the whole page bestie, no cap 💖 go register something, you got this 🦋

mwah 💋 — this was perl v5.40.1, dated 2025-05-24, and it's the RAZOR-ADMIN(1p) page from the user contributed Perl documentation. periodt. 💅✨

📦 where this page comes from