Description

Sub-commands

Configures a serial port's basic settings for a device such as a terminal, modem or no connection.

delete

Deletes a given port. You can disable a port and prevent new services from being spawned for incoming connections, without interfering with existing services.

list

Lists all serial ports.

modify

Modifies a serial port's parameters.

Options

There are two kinds of options: authentication arguments (args) and sub-command arguments (subcommand_args).

Authentication Arguments

The smserialport authentication arguments, args, are derived from the smc(1M) argument set and are the same regardless of which sub-command
you use.

Valid args are -D, -H, -l, -p, -r, and -u; they are all optional. If no args are specified, certain defaults will be assumed and the user may be prompted
for additional information, such as a password for authentication purposes.

The single 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.

Descriptions and other arg options that contain white spaces must be enclosed in double quotes.

The following authentification arguments (args) are supported:

-D | --domaindomain

Specifies the default domain that you want to manage. smserialport accepts only the file value for this option. file
is also the default value.

The file default domain means 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.

-H | --hostnamehost_name:port

Specifies the host 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 a host (host_name:port, the Solaris Management Console connects to the local host on port 898. You may still have to choose a toolbox to load into the console. To override this behavior, use the smc -B option, or set your console preferences to load a home toolbox by default.

-l | --rolepasswordrole_password

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.

-p | --passwordpassword

Specifies the password for the user_name. If you do not specify a password, the system prompts you for one. Because passwords specified on the command
line can be seen by any user on the system, this option is considered insecure.

-r | --rolenamerole_name

Specifies a role name for authentication. If you do not specify this option, no role is assumed.

-u | --usernameuser_name

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.

Sub-command Arguments

The sub-command specific options, subcommand_args, must come after the args and must be separated from them by the -- option. Enclose descriptions and arg options that contain white space in double quotes.

configure

The configure sub-command requires the following sub-command argument:

-nport_name

Specifies the name of the serial port to reconfigure.

The following sub-command arguments are optional for the configure sub-command:

Example 2 Modifying Serial Ports

The following example contains two commands. The first command modifies serial port b for a baud rate of 4800, an xterm as terminal type, a b: for login prompt and a comment. The second command lists the ports.

Environment Variables

See environ(5) for descriptions of the following environment variables that affect the execution of smserialport: JAVA_HOME. If this environment variable is not specified, the /usr/java location is used. See smc(1M).

Exit Status

The following exit values are returned:

0

Successful completion.

1

Invalid command syntax. A usage message displays.

2

An error occurred while executing the command. An error message displays.