REALMSET(1)

📦 version 2.2.3, in arch rolling

💅 REALMSET(1) — the realm file glow-up page 💅

ok so this is a User Contributed Perl Documentation page, and it's about <hotpink>realmset</hotpink> — the utility that edits entries in a DNSSEC-Tools realm file. Consider this your group chat briefing bestie 🫶

✨ NAME ✨

realmset — modifies entries in a DNSSEC-Tools realm file. literally its whole personality 💖

🦋 SYNOPSIS 🦋

  realmset [options] realm-file

🌸 DESCRIPTION 🌸

okay so realmset goes into the realm file you point at with realm-file and changes fields in it. You can stack multiple options in a single realmset run — it's giving multitasking icon 👑

realmset operates quietly unless you hand it the -verbose option. no notes, it's just shy. 🙈

Every single record in that realm file gets modified — unless you pass the -name option. In that case, only the named zone gets the treatment. selective queen behavior ✨

🎀 OPTIONS 🎀

  • -administrator addr — sets the zone administrator's email address to addr.
  • -args arglist — gives the realm manager some extra arguments. These override the arguments 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, bestie.

okay so because of how realmset processes its own arguments, you cannot write these new arguments the way you would on a command line. Instead, give them like this: replace the leading dash with an equals sign. And if the option takes an argument, also replace the space that would separate the option from its argument with an equals sign. realmset then translates these into the proper 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

These are valid uses of -args:

    # realmset -args =display example.realm
    # realmset -args "=loglevel=phase =sleep=3600" example.realm
⚠️ the -args and -del-args options are mutually exclusive — pick one, babe, you can't have both.
  • -configdir configdir — sets the directory that holds the realm's configuration files to confdir.
  • -del-administrator — deletes the administrator line from the selected realm records.
⚠️ -administrator and -del-administrator are mutually exclusive.
  • -del-args — deletes the args line from the selected realm records.
⚠️ -args and -del-args are mutually exclusive.
  • -del-display — deletes the display line from the selected realm records.
⚠️ -display, -nodisplay, and -del-display are mutually exclusive — it's a whole love triangle, don't do it.
  • -del-manager — deletes the manager line from the selected realm records.
⚠️ -manager and -del-manager are mutually exclusive.
  • -del-user — deletes the user line from the selected realm records.
⚠️ -user and -del-user are mutually exclusive.
  • -display — turns on the GUI display of the selected realms.
⚠️ -display, -nodisplay, and -del-display are mutually exclusive.
  • -manager manager-program — sets the manager program for the selected realms to manager-program.
  • -name realmname — selects the realm whose name matches realmname as the only realm that gets modified. If you don't give a name, then every realm record gets modified. main character selection energy 👑
  • -newname new-name — renames the realm to new-name. The new name cannot be the name of an existing realm in the file (no stealing names, that's not slay). This option must be used together with the -name option.
  • -nocheck — if you give this, the realmchk command will not be run on the modified realm file. skipping the vibe check, bold move 🫶
  • -nodisplay — turns off the GUI display of the selected realms.
⚠️ -display, -nodisplay, and -del-display are mutually exclusive.
  • -realmdir realmdir — sets the directory that holds the realm's files to realmdir.
  • -rollrec rollrec-file — modifies the rollrec file in the selected realm records to be rollrec-file.
  • -state newstate — sets the realm's state to newstate. This must be either "active" or "inactive" — no in-between, no "it's complicated". 💀
  • -statedir statedir — sets the directory that holds the realm's state files to statedir.
  • -user username — modifies the user name in the selected realm records to be username.
  • -verbose — displays info about every single modification made to the realm file. she's chatty now 💅
  • -Version — displays the version information for realmset and the DNSSEC-Tools package.
  • -help — displays a usage message.

Copyright 2012-2014 SPARTA, Inc. All rights reserved. See the COPYING file included with the DNSSEC-Tools package for details. (legal besties said what they said 📜)

🌈 AUTHOR 🌈

Wayne Morrison, tewok@tislabs.com — shoutout to the icon who wrote this 🫶

⭐ 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)

okay that's the whole page 🎀 go forth and edit those realms. this gem was brought to you by perl v5.44.0, dated 2026-10-17 — mwah, bye bestie! 💖✨🦋

📦 where this page comes from