admdefault(1M) DG/UX R4.11MU05 admdefault(1M)
NAME
admdefault - provide an interface to named default sets
SYNOPSIS
admdefault -o create -O object -S set-name [ -d directory ]
admdefault -o remove -O object -S set-name [ -d directory ]
admdefault -o select -O object -S set-name [ -d directory ]
admdefault -o get -O object [ -d directory ] [ -f file ] [ -n ] [ -S
set-name ] [ -qv ] [ parameter ... ]
admdefault -o set -O object -S set-name [ -d directory ] [ -f file ]
parameter=value ...
admdefault -o list [ -d directory ] [ -f file ] [ -O object ] [ -S
set-name ] [ -qv ]
DESCRIPTION
The admdefault command manages named default sets.
A default set is a group of several related parameters under a common
name. A default set is identified by the object whose parameters are
grouped and the set-name which identifies a particular set of values
for the object's parameters. Each of the values in a default set is
referenced by its parameter. This command allows you to set or
retrieve the value of a parameter in a default set.
There are two special default sets, system and default. The system
default set contains the system-wide default values. These values
are shipped with the system. The default default set points to the
named default set (either system or one of the user-defined sets)
which is used to retrieve values of parameters when no default set is
explicitly named. Initially, the default set is the same as the
system set. This may be changed with the select operation.
Operations
create Create a new default set for an object. Initially, all
parameters in the new set have the same values as the
special set system. The values of the parameters may be
changed later with the set operation.
remove Remove a named default set from a particular object. Note
that the special default sets system and default cannot be
removed.
select Associate the special default set default with a particular
named default set. The default set is used to retrieve
values when no default set is explicitly named.
get Retrieve the value of some parameter from a particular set-
name of an object. The value is written to the standard
output. If no set-name is given, the special set default
is used. If the -v option is given, the parameter's value
is written in the form parameter=value. If no parameter is
given, all parameters from the set are displayed.
set Set the value of some parameter from a particular set-name
of an object.
list Output all known objects, set names, or parameters
depending on the options given. If no -O object option is
given, the list operation outputs all known objects. If no
-S set-name option is given, the list operation outputs all
named default sets for the given object. If both -O object
and -S set-name are given, the list of parameters for the
indicated set-name of the object is displayed.
Options
-d directory Use the named default sets defined under directory. The
default is /etc/default/sysadm.
-f file Use the default set file named by the pathname file. If
this option is given, -d, -O, and -S are ignored.
-n Get the real name of the indicated default set. This is
useful for learning which set is being used as the
special default default set.
-O object Use the named default sets for object.
-q Use quiet mode. No headers are written for the list
operation.
-S set-name
Use the named default set set-name. For the get operation,
the default is system.
-v Use verbose mode. Headers are written for the list
operation, and output from the get operation is in the form
parameter=value. This mode is enabled by default.
EXAMPLES
To list the named default sets for the "tape" object:
admdefault -o list -O tape
To get the default value of the "drive" parameter of the "tape"
default set:
admdefault -o get -q -O tape -S default drive
FILES
/etc/default/sysadm The default directory.
DIAGNOSTICS
Warnings
None.
Errors
- The directory does not exist.
- The requested default set does not exist.
- The requested parameter does not exist.
Exit Codes
This section lists the possible exit codes and what they mean.
0 The operation was successful.
1 The operation was unsuccessful.
2 The operation failed due to access restrictions.
3 There was an error in the command line.
NOTES
In order to use the create, remove, or set operations, you must have
write permission in the
directory. To have write persmission, you must have appropriate
privilege, which, on a generic DG/UX system, means that you have
superuser privilege or an effective UID of root. See the
appropriate_privilege(5) man page for more information.
On a system that supports the DG/UX Capability option, appropriate
privilege is defined as having one one or more specific capabilities
enabled in the effective capability set of the user. See
cap_defaults(5) for the default capabilities for this command.
Named defaults sets are provided for the client, release, tape, and
xterminal objects.
SEE ALSO
sysadm(1M), cap_defaults(5).
Licensed material--property of copyright holder(s)