NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | EXIT STATUS | FILES | ATTRIBUTES | SEE ALSO
The smnetwork command adds, modifies, deletes, and lists entries in the networks and netmasks databases.
smnetwork subcommands are:
Adds a new entry to the networks database. To add an entry, the administrator must have the solaris.network.host.write
and solaris.network.security.write
authorizations.
Deletes an entry from the networks database. To delete an entry, the administrator must have the solaris.network.host.write
and solaris.network.security.write
authorizations.
Lists all entries in the networks database. To list an entry, the administrator must have the solaris.network.host.read
and solaris.network.security.read
authorizations.
Modifies an entry in the networks database. To modify an entry, the administrator must have the solaris.network.host.write
and solaris.network.security.write
authorizations.
The smnetwork authentication arguments, auth_args, are derived from the smc(1M) arg set and are the same regardless of which subcommand you use. The smnetwork 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 the network may be identified.
Specifies the description of the network.
Specifies the IP address of the network.
Specifies the network mask of the network.
Specifies the name of the network.
One of the following sets of arguments must be specified for subcommand add:
-n network_name -i ipaddress [-m netmask] [-a aliases] [-d description] |
-h
One of the following sets of arguments must be specified for subcommand modify:
-n network_name -i ipaddress [-m netmask] [-a aliases] [-d description] |
-h
One of the following sets of arguments must be specified for subcommand delete:
-n network_name |
-h
The following argument may be specified for subcommand list:
-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 network, aves, with an IP address of 129.150.0.0, netmask of 255.255.255.0, and description of Aviation network. The administrator is prompted for the admin password.
$ /usr/sadm/bin/smnetwork add -D nis:/birds/aves.Sun.COM -H aviary:898 -- \ -n aves -i 129.150 -m 255.255.255.0 -d "Aviation network" |
The admin role modifies the network, aves, changing its IP address to 129.160.0.0, and description to New aviation network. 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/smnetwork modify -- -n aves -i 129.160 \ -d "New aviation network" |
The admin role connects to the nis:/birds/aves.Sun.COM domain and deletes the aves entry. 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/smnetwork delete -D nis:/birds/aves.Sun.COM -- -n aves |
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.
The following files are used by the smnetwork command:
Network mask database. See netmasks(4).
Network name database. See networks(4)
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