1REALMSET(1)           User Contributed Perl Documentation          REALMSET(1)
2
3
4

NAME

6       realmset - Modifies entries in a DNSSEC-Tools realm file
7

SYNOPSIS

9         realmset [options] realm-file
10

DESCRIPTION

12       realmset modifies fields in the realm file specified by realm-file.
13       Multiple options may be combined in a single realmset execution.
14       realmset operates quietly unless it is given the -verbose option.
15
16       All records in the specified realm file will be modified, unless the
17       -name option is given.  In that case, only the named zone will be
18       modified.
19

OPTIONS

21       -administrator addr
22           The zone administrator's email address is set to addr.
23
24       -args arglist
25           Provides additional arguments for the realm manager.  These
26           arguments will override the arguments in the DNSSEC-Tools defaults
27           file, the DNSSEC-Tools configuration file, and the realms' rollrec
28           files.  The manager's argument list is given in arglist.  If more
29           than one argument is given, the set of arguments should be enclosed
30           in quotes.
31
32           Given the realmset argument processing, the new arguments cannot be
33           specified as they would from a command line.  Instead, the
34           arguments should be given in the following manner.  The leading
35           dash should be replaced with an equals sign.  If the option takes
36           an argument, the space that would separate the option from the
37           option's argument should also be replaced by an equals sign.
38           realmset translates these arguments to the appropriate format for
39           the realm manager.  These examples should clarify the argument
40           modifications:
41
42               normal rollerd option               -args options
43               ------------------------            ---------------
44                   -display                           =display
45                   -logfile /dt/log.file              =zskcount=/dt/log.file
46
47           The following are valid uses of -args:
48
49               # realmset -args =display example.realm
50               # realmset -args "=loglevel=phase =sleep=3600" example.realm
51
52           The -args and -del-args options are mutually exclusive.
53
54       -configdir configdir
55           The directory to hold the realm's configuration files is set to
56           confdir.
57
58       -del-administrator
59           The administrator line is deleted from the selected realm records.
60           The -administrator and -del-administrator options are mutually
61           exclusive.
62
63       -del-args
64           The args line is deleted from the selected realm records.  The
65           -args and -del-args options are mutually exclusive.
66
67       -del-display
68           The display line is deleted from the selected realm records.  The
69           -display, -nodisplay, and -del-display options are mutually
70           exclusive.
71
72       -del-manager
73           The manager line is deleted from the selected realm records.  The
74           -manager and -del-manager options are mutually exclusive.
75
76       -del-user
77           The user line is deleted from the selected realm records.  The
78           -user and -del-user options are mutually exclusive.
79
80       -display
81           Turn on the GUI display of the selected realms.  The -display,
82           -nodisplay, and -del-display options are mutually exclusive.
83
84       -manager manager-program
85           The manager program for the selected realms is set to manager-
86           program.
87
88       -name realmname
89           The realm whose name matches realmname is selected as the only
90           realm that will be modified.  If this name is not given, then all
91           realm records will be modified.
92
93       -newname new-name
94           The realm's name is changed to new-name.  The new name cannot be
95           the name of an existing realm in the file.  This option must be
96           used in conjunction with the -name option.
97
98       -nocheck
99           If this option is given, the realmchk command will not be run on
100           the modified realm file.
101
102       -nodisplay
103           Turn off the GUI display of the selected realms.  The -display,
104           -nodisplay, and -del-display options are mutually exclusive.
105
106       -realmdir realmdir
107           The directory to hold the realm's files is set to realmdir.
108
109       -rollrec rollrec-file
110           The rollrec file in the selected realm records is modified to be
111           rollrec-file.
112
113       -state newstate
114           The realm's state is set to newstate.  This must be either "active"
115           or "inactive".
116
117       -statedir statedir
118           The directory to hold the realm's state files is set to statedir.
119
120       -user username
121           The user name in the selected realm records is modified to be
122           username.
123
124       -verbose
125           Display information about every modification made to the realm
126           file.
127
128       -Version
129           Displays the version information for realmset and the DNSSEC-Tools
130           package.
131
132       -help
133           Display a usage message.
134

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

AUTHOR

140       Wayne Morrison, tewok@tislabs.com
141

SEE ALSO

143       dtrealms(8), lsrealm(8), realmchk(8), realminit(8)
144
145       Net::DNS::SEC::Tools::realmmgr.pm(3), Net::DNS::SEC::Tools::realm.pm(3)
146
147       file-realm(5)
148
149
150
151perl v5.36.0                      2023-01-19                       REALMSET(1)
Impressum