ROLLSET(1)

📦 version 2.2.3, in arch rolling

✨ ROLLSET(1) ✨

okay so bestie, this is rollset from the User Contributed Perl Documentation section of the manual, and it is literally the little tool that goes in and edits entries inside a DNSSEC-Tools rollrec file 🎀

💅 NAME

rollset — modifies entries in a DNSSEC-Tools rollrec file. that's it, that's the whole job, and she does it slayfully 👑

🌸 SYNOPSIS

rollset [options] rollrec-file

🦋 DESCRIPTION

so rollset modifies fields in the rollrec file you point it at with rollrec-file. you can stack multiple options together in a single rollset execution — it's giving "one trip, many changes" 💖 and she operates quietly unless you hand her the -verbose option, in which case she will tell you everything.

every single record in the rollrec file you specify gets modified, unless you give the -name option. in that case only the named zone gets touched. no cap. 🙈

✨ OPTIONS ✨

  • -admin addr — sets the zone administrator's email address to addr.
  • -check — if you give this one, the rollchk command gets run on the modified rollrec file. quality control icon behavior 🔥
  • -del-admin — deletes the administrator line. the -admin and -del-admin options are mutually exclusive — pick one, babe, you can't have both 💀
  • -del-directory — deletes the directory line. the -directory and -del-directory options are mutually exclusive.
  • -del-loglevel — deletes the loglevel line. the -loglevel and -del-loglevel options are mutually exclusive.
  • -del-zg — deletes the zonegroup line. the -zg and -del-zg options are mutually exclusive.
  • -del-zsargs — deletes the zsargs line. the -zsargs and -delzsargs options are mutually exclusive.
  • -directory dir — sets the directory that holds the zone's files to dir.
  • -display — turns on the GUI display of the zones in the selected rollrecs. this option is mutually exclusive of the -nodisplay option.
  • -file zone-file — modifies the zone file in the selected rollrec records to be zone-file.
  • -keyrec keyrec-file — modifies the keyrec file in the selected rollrec records to be keyrec-file.
  • -loglevel logging-level — sets the logging level of the selected rollrec records to logging-level. the valid logging levels are defined in rollmgr.pm(3).
  • -name rollrec-name — the rollrec whose name matches zonename is selected as the only rollrec that will be modified. if this name isn't given, then all rollrec records get modified. main character selection energy 👑
  • -nodisplay — turns off the GUI display of the zones in the selected rollrecs. this option is mutually exclusive of the -display option.
  • -rename — changes the rollrec's name to match the specified name. the new name cannot be the name of an existing rollrec in the file. this option must be used in conjunction with the -name option. (fr fr, they're a package deal 🫶)
  • -reset-zonename — sets the zonename field to match the name of the rollrec record. this option is mutually exclusive of the -zonename option.
  • -roll — converts the selected rollrecs into active ("roll") records. this option is mutually exclusive of the -skip option.
  • -skip — converts the selected rollrecs into inactive ("skip") records. this option is mutually exclusive of the -roll option.
  • -zg zonegroup-name — modifies the zonegroup in the selected rollrec records to be zonegroup-name. this field may contain a single zonegroup name or a comma-separated list of names. if a list is given, there may be whitespace before or after each name, but that whitespace is not recognized as being part of the zonegroup name itself. whitespace within the name is considered part of the name. zonegroup names are considered case insensitive — the names may be given with whatever case you desire, but names whose only differences are the case of the letters are considered to be the same name. lowkey picky about spaces, highkey chill about caps 💅
  • -zonename zone-name — modifies the zone name in the selected rollrec records to be zone-name.
  • -zsargs arglist — provides additional zonesigner arguments. these arguments will override the arguments in the DNSSEC-Tools defaults file, the DNSSEC-Tools configuration file, and the zones' keyrec files. the zonesigner argument list is given in arglist. if more than one argument is given, the set of arguments should be enclosed in quotes.
🚨 okay this next bit is the part everyone gets wrong, so listen up bestie: given the way rollset processes arguments, the new arguments for zonesigner cannot be specified as you'd expect. instead, give them like this — the leading dash gets replaced with an equals sign, and if the option takes an argument, the space that would separate the option from its argument also gets replaced by an equals sign. rollset then translates these arguments into the appropriate format for zonesigner. these examples should make the argument modifications crystal clear:
    normal zonesigner option            -zsargs options
    ------------------------            ---------------
        -nokrfile                          =nokrfile
        -zskcount 5                        =zskcount=5

the following are valid uses of -zsargs:

# rollset -zsargs =ksklength=2048 example.rollrec
# rollset -zsargs "=ksklen=2048 =zsklen=2048" example.rollrec

the -zsargs and -delzsargs options are mutually exclusive.

  • -verbose — displays information about every modification made to the rollrec file. she's a yapper and we love her for it 🌈
  • -Version — displays the version information for rollset and the DNSSEC-Tools package.
  • -help — displays a usage message.

Copyright 2006-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

  • lsroll(8), rollchk(8), rollerd(8), rollinit(8)
  • Net::DNS::SEC::Tools::rollmgr.pm(3), Net::DNS::SEC::Tools::rollrec.pm(3)
  • file-rollrec(5)

and that's the whole page, bestie — go forth and modify those rollrecs responsibly 🍓💜

mwah 💋 — this has been perl v5.44.0, dated 2026-10-17, signing off as ROLLSET(1) 🫶✨

📦 where this page comes from