REALMSET(1)

📦
version 2.2.3 · 2 versions
, in fedora 43

✨ REALMSET — the manual page, but make it cute ✨

okay bestie, we're doing realmset, from the User Contributed Perl Documentation corner of the universe, and honestly? it's giving tiny-but-mighty. 💅

💖 NAME 💖

realmset — it modifies entries in a DNSSEC-Tools realm file. that's the whole job. she edits the realm file. periodt. 🎀

🌸 SYNOPSIS 🌸

realmset [options] realm-file

🦋 DESCRIPTION 🦋

so basically, realmset modifies fields in the realm file you point it at with realm-file. and the way that you can just stack multiple options in one single realmset run? iconic. obsessed.

ngl she's a quiet queen — realmset operates quietly unless you hand her the -verbose option. then she spills everything. 💀

here's the tea: every single record in the realm file you specified gets modified… unless you pass the -name option. in that case? only the named zone gets touched. selective. main character energy fr fr. 👑

👑 OPTIONS 👑

  • -administrator addr — the zone administrator's email address gets set to addr. 💌
  • -args arglist — gives extra arguments to the realm manager. these arguments override the ones in the DNSSEC-Tools defaults file, the DNSSEC-Tools configuration file, and the realms' rollrec files. the manager's argument list goes in arglist. if you're giving more than one argument, wrap the whole set in quotes. 🫶

okay so here's the thing, because of how realmset processes its own arguments, you cannot specify the new arguments the way you would on a command line. instead, you do it like this: the leading dash gets replaced with an equals sign. and if the option takes an argument, the space that would normally separate the option from its argument also gets replaced with an equals sign. realmset then translates these into the right format for the realm manager. these examples should clear it up:

    normal rollerd option               -args options
    ------------------------            ---------------
        -display                           =display
        -logfile /dt/log.file              =zskcount=/dt/log.file

(yes that's copied character for character, no notes, i don't make the rules 💅)

these are valid uses of -args:

# realmset -args =display example.realm
# realmset -args "=loglevel=phase =sleep=3600" example.realm
🚨 bestie listen — the -args and -del-args options are mutually exclusive. pick one, you cannot have both.
  • -configdir configdir — the directory that holds the realm's configuration files gets set to confdir. 📁
  • -del-administrator — the administrator line gets deleted from the selected realm records. 🗑️ and heads up: -administrator and -del-administrator are mutually exclusive.
  • -del-args — the args line gets deleted from the selected realm records. -args and -del-args are mutually exclusive, no cap.
  • -del-display — the display line gets deleted from the selected realm records. and the trio -display, -nodisplay, and -del-display? all mutually exclusive. it's giving "choose your fighter". 😭
  • -del-manager — the manager line gets deleted from the selected realm records. -manager and -del-manager are mutually exclusive.
  • -del-user — the user line gets deleted from the selected realm records. -user and -del-user are mutually exclusive.
  • -display — turns on the GUI display of the selected realms. and again: -display, -nodisplay, and -del-display are mutually exclusive. 🖥️✨
  • -manager manager-program — the manager program for the selected realms gets set to manager-program.
  • -name realmname — the realm whose name matches realmname is selected as the only realm that will be modified. if you don't give this name, then literally all realm records get modified. 🎯
  • -newname new-name — the realm's name gets changed to new-name. the new name cannot be the name of an existing realm in the file, okay? and this option must be used together with the -name option. they're a package deal. 🎁
  • -nocheck — if you give this option, the realmchk command will not be run on the modified realm file. skipping the vibe check, bold of you. 🙈
  • -nodisplay — turns off the GUI display of the selected realms. -display, -nodisplay, and -del-display are mutually exclusive.
  • -realmdir realmdir — the directory that holds the realm's files gets set to realmdir. 📂
  • -rollrec rollrec-file — the rollrec file in the selected realm records gets modified to be rollrec-file.
  • -state newstate — the realm's state gets set to newstate. this must be either "active" or "inactive". no in-between, no situationship. ⭐
  • -statedir statedir — the directory that holds the realm's state files gets set to statedir.
  • -user username — the user name in the selected realm records gets modified to be username. 🫶
  • -verbose — displays information about every modification made to the realm file. she's telling you everything, bestie. 📣
  • -Version — displays the version information for realmset and the DNSSEC-Tools package. 🌈
  • -help — displays a usage message. the classic. 🆘

Copyright 2012-2014 SPARTA, Inc. All rights reserved. see the COPYING file included with the DNSSEC-Tools package for details.

🧚 AUTHOR 🧚

Wayne Morrison, tewok@tislabs.com

🌈 SEE ALSO 🌈

  • dtrealms(8), lsrealm(8), realmchk(8), realminit(8)
  • Net::DNS::SEC::Tools::realmmgr.pm(3), Net::DNS::SEC::Tools::realm.pm(3)
  • file-realm(5)

and that's the whole page, bestie 💖 this one's running on perl v5.42.0, dated 2025-07-23, and it's a REALMSET(1) situation. go forth and modify those realm files responsibly, mwah 💅🎀

📦 where this page comes from