NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | EXIT STATUS | FILES | ATTRIBUTES | SEE ALSO
The smhost command adds, modifies, deletes, and lists entries in the hosts, ethers, and tnrhdb databases.
smhost subcommands are:
Adds a new entry to the hosts database. To add an entry, the administrator must have the solaris.network.host.write
and solaris.network.security.write
authorizations.
Modifies an entry in the hosts database. To modify an entry, the administrator must have the solaris.network.host.write
and solaris.network.security.write
authorizations.
Deletes an entry from the hosts database. To delete an entry, the administrator must have the solaris.network.host.write
and solaris.network.security.write
authorizations.
Lists entries in the specified database. To list an entry, the administrator must have the solaris.network.host.read
and solaris.network.security.read
authorizations.
The smhost authentication arguments, auth_args, are derived from the smc(1M) arg set and are the same regardless of which subcommand you use. The smhost command requires the SMC to be initialized for the command to succeed (see smc(1M)). After rebooting the SMC server, the first smc connection may time out, so you may need to retry the command.
The subcommand-specific options, subcommand_args, must be preceded by the - - option.
The valid auth_args are -D, -H, -l, -p, -r, and -u; they are all optional. If no auth_args are specified, certain defaults will be assumed and the user may be prompted for additional information, such as a password for authentication purposes. These letter options can also be specified by their equivalent option words preceded by a double dash. For example, you can use either -D or - -domain.
Specifies the default domain that you want to manage. The syntax of domain=type:/host_name/domain_name, where type is nis, nisplus, dns, ldap, or file; host_name is the name of the machine that serves the domain; and domain_name is the name of the domain you want to manage. (Note: Do not use nis+ for nisplus.)
If you do not specify this option, the SMC assumes the file default domain on whatever server you choose to manage, meaning that changes are local to the server. Toolboxes can change the domain on a tool-by-tool basis; this option specifies the domain for all other tools.
Specifies the host_name and port to which you want to connect. If you do not specify a port, the system connects to the default port, 898. If you do not specify host_name:port, the SMC connects to the local host on port 898.
Specifies the password for the role_name. If you specify a role_name but do not specify a role_password, the system prompts you to supply a role_password. Passwords specified on the command line can be seen by any user on the system, hence this option is considered insecure.
Specifies the password for the user_name. If you do not specify a password, the system prompts you for one. Passwords specified on the command line can be seen by any user on the system, hence this option is considered insecure.
Specifies a role name for authentication. If you do not specify this option, no role is assumed.
Specifies the user name for authentication. If you do not specify this option, the user identity running the console process is assumed.
This option is required and must always follow the preceding options. If you do not enter the preceding options, you must still enter the - - option.
Note: Descriptions and other arg options that contain white spaces must be enclosed in double quotes.
Specifies the aliases by which this hostname may be identified.
Specifies the description for this host entry.
Specifies the Ethernet address of the host. For the list subcommand, the ethernetaddress argument is not specified, and the ethers database is listed.
Specifies the name of the host. For the list subcommand, the hostname argument is not specified, and the hosts database is listed.
Displays the command's usage statement.
Specifies the IP address of the host.
Specifies the template name. For the list subcommand, the templatename argument is not specified, and the tnrhdb database is listed.
Specifies the prefix length (in bits) of a wildcard representation of the IP address. The prefix is the left-most portion of the IP address.
Specifies the IP address of the subnet using a wildcard.
One of the following sets of arguments must be specified for subcommand add:
-H hostname -i ipaddress [-a aliases] [-d description] [-e ethernetaddress] [-n templatename] |
-H hostname -n templatename |
-i ipaddress -n templatename |
-w ipaddress_wildcard -n templatename [-p prefixlen] |
-h
One of the following sets of arguments must be specified for subcommand modify:
-H hostname { [-i ipaddress] [-a aliases] [-d description] [-e ethernetaddress] [-n templatename] } |
-H hostname -n templatename |
-w ipaddress_wildcard { [-n templatename] [-p prefixlen] } |
-h
One of the following sets of arguments must be specified for subcommand delete:
-H hostname |
-i ipaddress |
-w ipaddress_wildcard [-p prefixlen] |
-h
One of the following sets of arguments must be specified for subcommand list:
-H |
-n |
-e |
-h
The admin role connects to port 898 (which happens to be the default) of the aviary server on the nis:/birds/aves.Sun.COM domain, and creates a new host, eagle, with an IP address of 129.150.11.7. The new host is assigned to the tsol template. The administrator is prompted for the admin password.
$ /usr/sadm/bin/smhost add -D nis:/birds/aves.Sun.COM -H aviary:898 -- \ -H eagle -i 129.150.11.7 -n tsol |
The admin role specifies the template name, tsol, for series of hosts using the IP address wildcard 129.150.11.0 on the local file system. Since no authorization arguments were specified, the administrator connects to port 898 of the local host on the local server with the file domain type, which are the defaults. The administrator is prompted for the admin password.
$ /usr/sadm/bin/smhost add -- -w 129.150.11.0 -n tsol |
The admin role connects to the nis:/birds/aves.Sun.COM domain and modifies the eagle entry in the hosts database, changing its IP address to 129.150.11.8 and its alias to falcon. Since the host and port were not specified, the local host and port 898 are used by default. The administrator is prompted for the admin password.
$ /usr/sadm/bin/smhost modify -D nis:/birds/aves.Sun.COM -- \ -H eagle -i 129.150.11.8 -a falcon |
The admin role connects to port 898 (which happens to be the default) of the aviary server and deletes the eagle entry in the hosts database by specifying its IP address, 129.150.11.8. Since the domain was not specified, the file domain type and local server are used by default. The administrator is prompted for the admin password.
$ /usr/sadm/bin/smhost delete -H aviary:898 -- -i 129.150.11.8 |
The admin role connects to the aviary server on the nis:/birds/aves.Sun.COM domain and lists the entries in thetnrhdb database. Since the port was not specified, port 898 is used by default. The administrator is prompted for the admin password.
$ /usr/sadm/bin/smhost list -D nis:/birds/aves.Sun.COM -H aviary -- \ -n |
The following exit values are returned:
Successful completion.
Invalid command syntax. A usage message displays.
An error occurred while executing the command. An error message displays.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
Availability | SUNWmgapp |
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | EXIT STATUS | FILES | ATTRIBUTES | SEE ALSO