admtrustedhost(1M) DG/UX R4.11 admtrustedhost(1M)
NAME
admtrustedhost - manage the trusted hosts database
SYNOPSIS
admtrustedhost -o add [ -u user ] trusted-host
admtrustedhost -o delete [ -u user ] trusted-host
admtrustedhost -o modify [ -U new-user ] [ -h new-trusted-host ] [ -u
user ] trusted-host
admtrustedhost -o list [ -qv ] [ trusted-host ... ]
admtrustedhost -o search [ -u user ] trusted-host
DESCRIPTION
admtrustedhost manages the trusted hosts database. The trusted hosts
database is located in the hosts.equiv(4M) file. Each trusted host
entry consists of a host name, and a user name(with a passwd(4)
entry) or all. The host name may be a fully-qualified name or a
simple name. If both fully-qualified and simple host names are being
used, then the entries must be operated on separately. Each trusted
host entry allows user on trusted-host remote access for rlogin(1C)
and remsh(1C).
add Add a new trusted-host/user pair to the trusted hosts
database.
modify Change a trusted host entry from the trusted hosts
database. The trusted-host and/or user may be changed.
delete Remove a trusted host entry from the trusted hosts
database.
list List one or more trusted-hosts and their users from the
trusted hosts database. Information is listed about each
of the trusted-hosts; if no trusted-hosts are given or
trusted-host is all, information about all trusted hosts is
listed.
search Search for the trusted-host/user pair in the trusted hosts
database. If the pair is found, it is echoed to stdout
with a single space delimiter between each field. If the
pair is not found, the operation exits with an error code.
Options
-u user user is the user on the trusted-host allowed remote access.
If -u is omitted or if user is all, then all users from
trusted-host are allowed remote access. Individual remote
access mechanisms may disallow access via hosts.equiv based
on the identity and/or privilege level of the incoming
user.
-U new-user
new-user is the user that will replace user in the modify
command. Without this option the user is not changed.
-h new-trusted-host
new-trusted-host is the trusted host that will replace
trusted-host in the modify command. Without this option
the trusted-host is not changed.
-q "Quiet." Produce an unformatted listing (i.e. no headers,
fields delimited by a single space).
-v "Verbose." Produce a formatted listing with headers and
aligned columns. This option is enabled by default.
OUTPUT
The list and search operations write their output to stdout.
The verbose form of the list operation outputs information in aligned
columns with column headers.
If -q option is specified with the list operation, headers are
suppressed and each entry is printed on a separate line. The fields
within the entry are delimited by a single space, and are in the
following order:
trusted_host user
This format is also used by the search operation.
FILES
/etc/hosts.equiv
Trusted hosts database file.
DIAGNOSTICS
Warnings
- The delete operation is requested, and trusted-host/user does not
exist.
Errors
- The add operation is requested, and trusted-host/user already
exists.
- The modify operation is requested, and new-trusted-host/new-user
already exists.
- The modify or search operation is requested, and trusted-
host/user does not exist.
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
remsh(1C), rlogin(1C), hosts.equiv(4M).
NOTES
Access to the add, delete, and modify operations is granted based
upon write access to the hosts.equiv file. Generally, only the
system administrator has this access. Access to the list and search
operation is granted based upon read access to the hosts.equiv file.
Generally, all users have this access.
Licensed material--property of copyright holder(s)