admtarget(1M) DG/UX R4.11MU05 admtarget(1M)
NAME
admtarget - manage administrative targets
SYNOPSIS
admtarget -o add [ -G groups ] [ host ... ]
admtarget -o delete [ -G groups ] [ target ... ]
admtarget -o modify -G group [ -n new-name ] { -a | -m | -r } host
...
admtarget -o check [ -qv ] target ...
admtarget -o list [ -a | -g | -p | -h | -G groups ] [ -qv ] [ -i
include-list ] [ target ... ]
DESCRIPTION
The admtarget command manages the lists of potential administrative
targets. A target is either a host on which administrative actions
can be performed, or is a named collection of such hosts. Such
collections are called target groups.
Target groups share the same name space as target hosts, so a target
group may not have the same name as a target host.
For operations which allow lists of targets, target hosts, or target
groups, separate multiple items with commas.
Operations
add Add one or more target hosts to one or more target groups.
If no hosts are given, the indicated groups are created
with no members. If no groups are given, the indicated
hosts are added to the database as members of no groups. A
warning is given if any new hosts cannot be reached or do
not appear to be properly configured for remote management.
delete Remove one or more targets or target groups. If no targets
are given, the indicated groups are removed. If no groups
are given, the indicated targets are removed from all
groups and from the database of targets.
modify Change the name or group membership of the indicated group.
Target hosts may be added (-a) or removed (-r) from the
group, or the entire membership of the group can be
replaced (-m).
check Verify that the indicated targets are valid, and that each
of the hosts appears to be properly configured for remote
management.
list Display information from the target database in one of
several formats.
Options
-a For -o list, display a list of targets in a format suitable
for use in an idl assign-values list. For -o modify,
append the given hosts to the given group.
-g When invoked with no arguments, this option displays a list
of all target groups, and the members of each. When an
individual target is specified, a list of groups to which
that target belongs will be displayed.
-G groups Operate only on the specified target groups.
-h Display a list of all target hosts, and the groups to which
each belongs. For the add and delete operations, perform
the operation on the comma-separated list of groups. For
the list operation, display only the members of the
indicated groups.
-i include-list
Include the hosts from include-list in the output,
regardless of whether or not they are target hosts.
-m Replace the members of group with the list of members in
hosts.
-n Change the name of the group to new-name.
-p Display a list of targets in a format suitable for use in
an idl possible-values list.
-q Use quiet mode. List headers are not displayed.
-r Remove from group the target hosts listed in hosts.
-v Include headers. This is enabled by default.
EXAMPLES
To add a target host as a member of no groups, use
admtarget -o add lonely
To add a target group with no members, use
admtarget -o add -G empty
To add a target host to several groups, creating any of the groups
that don't exist, use
admtarget -o add -G group1,group2 myhost
To generate a list of all the targets, both hosts and groups, use
admtarget -o list
FILES
/etc/sysadm/targets
Directory where target information is stored.
DIAGNOSTICS
Warnings
- The host or group being deleted does not exist.
Errors
- A target for add is not a valid host name.
- A target or group for add is the name of an existing target or
target group.
Exit Codes
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.
SEE ALSO
sysadm(1), idl(4).
Licensed material--property of copyright holder(s)