Administration
on what pseudo-try devices you have in your /der directory
This program resides in the /usr/portmaster directory. Simply
use tile command:
Istty
See Appendix A for discussion of device drivers.
Tile syntax for setting port parameters is:
SET port parameter value
Where port is one of: SO - S9 or PO
Parameter and value is one of:
SPEED - The baud rate for the port.
An extra value is entered after the "SPEED" key word to indicate which of the three optional baud rates is being set. Valid values are: 1, 2, or 3. This is followed by the actual baud rate. Valid values are: 19200. 9600, 4800, 2400, 1200, 300
PARITY - The parity checking to be used for the port. Valid values are: EX. EN, ODD, or NONE
DATABITS - The number of databits per byte. Valid values are: 8, 7, 6, or 5
STOPBITS - The number of stop bits in the data frame. Valid values are: I or 2
CD - Whether to use the carrier detect signal. Valid values are: ON or OFF
XON/XOFF - Whether to use Xon/Xoff flow control.
This is a software flow control which is supported by
most devices. By using ASCII control characters DCI and DC3 the PortMaster communicates with the attached device to start and stop the flow of data. Valid values are: ON or OFF,
RTS/CTS - Whether to use RTS/CTS flow control.
This is for devices where hardware flow control is required. When the PortMaster is able to receive data from the attached device, it raises Request to Send (RTS) on pin 4 of the RS-232 connector. Output from the PortMaster will only occur if the Clear to Send (CTS) modem line on pin 5 of the RS-232 connector is raised by the attached device. Valid values are: ON or OFF.
HOST - The Sun host for this specific port.
This option determines which Sun host the port will connect to during an active session. Valid values are:
DEFAULT - In this mode, the port will use the hostnames specified in global configuration values.
PROMPT' - In this mode, tile use is given a host prompt (before the standard login prompt). The user then is required to enter a valid host name or internet address for a Sun host on the network.
Host Name or Internet Address - The port is assigned to a specific Sun Host during an active session, An optional value may be inserted before the internet address to specify alternate hosts. This extra value is a number between I and 4. "1" is the primary host and "2" through "4" are the alternate hosts, Alternate host connections are only attempted of the primary host is unavailable (ie, host is down or
network is unreachable). Alternate host entries are optional.
SERVICE_LOGIN - The port can be configured to use one of four different network services for establishing login sessions. Valid values are:
PORTMASTER - This is the default service and can be used with any host workstation which has had a "Host Installation" performed from either PMinstall or the install window of PMconsole. This is the preferred service because it makes the port operate like tbe serial ports physically installed in the workstation, In addition it is the most efficient and highest performance service available.
RLOGIN - This service is generally supported by a large number of mixed UNIX based computers, Therefore, where it is impractical to utilize the PortMaster service. Rlogin should be selected,
TELNET - This service is generally supported by a most TCP/IP computers, Therefore, in a network where mixed hardware and operating systems will be used by this port, Telnet should be selected. The default TCP port number for telnet is 23, however an alternate port number may be entered following the TELNET parameter.
NETDATA - This service can be used to create a virtual connection between this port and another serial port on a different PortMaster. The default TCP port number for netdata is 6000, however an alternate port number may be entered following the NETDATA parameter. The serial port on the remote PortMaster
must be configured as a Host Device Port using the same service and TCP port number.
SERVICE_DEVICE - The port can be configured to use one of four different network device services, Valid values are:
PORTMASTER - This is the default service and can be used with any host workstation which has had a "Host Installation" performed from either PMinstall] or the install window of PMconsole. This is the preferred service because it makes the port operate like the serial ports physically installed in the workstation. When selected, the port is accessed through a /der/try device on the host workstation.
RLOGIN - This service is generally supported by a large number of mixed UNIX based computers. Therefore, this service can be utilized to allow UNIX based workstations on the network to initiate an Rlogin session to the Portmaster. Once the session is successfully established, the host application will be able to directly read and write data to the serial~ port. II multiple ports on the PortMaster are configured to use this service, it will automatically create a "pool" of ports which can be accessed by other hosts. When all ports are in use, new users will be given a "Connection Refused" indication.
TELNET - This service is generally supported by a most TCP/IP computers, Therefore, this service can be utilized to allow many different types of computers on the network to initiate a telnet session to the PortMaster. Once the session is successfully established, the host application will be able to directly read and write data to the serial port. If multiple
ports on the PortMaster are configured to use this service, it will automatically create a "pool" of ports which can be accessed by other hosts. When all ports are in use, new users will be given a "Connection Refused" indication. The default TCP port number for telnet is 23, however an alternate port number may be entered following the TELNET parameter.
NETDATA - This service can be used for customized application programs that need a TCP connection directly to a serial port on the PortMaster. Programs which use the "socket" interface (or a similar TCP interface) are provided with a direct data link to the PortMaster serial port. Port operating parameters are set with PMconsole. The application can then open the socket connection and immediately begin reading and writing data to the PortMaster. No special option negotiation or protocol is required. The default TCP port number for netdata is 6000, however an alternate port number may be entered following the NETDATA parameter. If multiple ports on the PortMaster are configured to use this service with the same TCP port number, it wilt automatically create a "pool" of ports which can be accessed by other hosts.
TERMTYPE - Sets the terminal type in the users environment. This optional held is used in either Login or Two-Way modes. When a new session is established on the host Sun Workstation, this terminal type will automatically be set in the user's environment. A valid entry from the Sun's /etc/termcap file should be entered. If this field in not entered, the host Sun Workstation will assume a "dumb" terminal.
PROMPT - Customized user login prompt.
This field allows the administrator to cus~timeless the login prompt the user will see, Any valid ASCll characters may be entered. The default is to display the Sun Host Name followed by the word "login:". If the string '$hostname' is included in the login prompt, the active Sun hostname is substituted for the string.
OVERRIDE - Sets which configuration parameters can be overridden by the Sun host. The PortMaster allows overrides to be set for Baud Rate, Parity, Databits, and Flow Control. This feature allows the Sun host to alter the active parameters via software control (ie. system ioctl calls). The default is that the Sun Host can only turn Xon/Xoff flow control on and off. Two values are specified after the OVERRIDE parameter. The first one is the item to set. Valid values are: XON/XOFF, BAUD, DATABITS, or PARITY, The second value is either ON or OFF. "ON" means the host can override the value, "OFF' means the PortMaster configuration value is used and host attempts to change these values are ignored.
EXTENDED- Sets extended mode on or off.
Valid values are: ON or OFF. When Extended mode is "ON" more detailed output will be displayed in the "SHOW" command.
USERNAME or AUTOLOG - Sets the Autolog name.
II this field is entered, the user will not receive tile standard login prompt, Instead, the PortMaster will automatically initiate a session on the Sun Workstation as if the user had typed the Autolog Name in response to the login prompt.
MESSAGE - The login message to be displayed to the user
prior to receiving the login prompt. The value for this
parameter is a string of up to 255 characters. New-lines are designated by using the carat symbol C).
Examples of the SET command are:
set s1 speed 2 4800
sets the second baud rate to use for speed matching to 4800 baud.
set s1 login
sets the Device Type on serial port s1 to User Login.
set s1 twoway /dev/ttyr0
sets serial port S1 to a two-way device using /dev/ttyr0 as the device name on the host Sun Workstation.
set s1 message Welcome to the PortMaster
displays the login message: "Welcome to the PortMaster" on serial port S 1.
Tile SET command stores the values and instructions in the PortMaster memory. No new changes take effect until you enter a RESET command.
Tile SHOW command allows you to look at the current settings [or an~ of the serial ports and for the parallel port. It also lets you list the contents of the local hosts table.
The syntax for the show command is:
SHOW port
-- or -
SHOW ALL
- or-
SHOW table hosts
For example: show all
Shows the settings of all global parameters and a summary of each of the individual ports. This display is similar to the VIEW command in the Sunview based PMconsole described earlier in this chapter.
show s1
Displays the full set of configuration values for serial port s1. If "Extended" mode is turned on (described above), a more detailed set of information will be displayed.
show table hosts
Displays the currently stored hosts table.
Reboots the PortMaster, loading the currently saved serial and parallel port parameter values. All ports will be set to the state of the last saved configuration. The syntax is:
REBOOT
Reset a port to it's currently stored values. Any terminal that is logged in through the PortMaster will be disconnected, You will need to log in again. The syntax is:
RESET port
Of --
RESET ALL
Where port is one of S0 - S9 or PO
These commands will log you out of the PortMaster command mode and will return you to login mode.
Saves the current port configurations to the PortMaster disk. The syntax is:
SAVE ALL
-- or --
SAVE port
Where port is one of SO - S9 or PO. Using SAVE ALL will store all global parameters on the PortMaster disk.
Provides a very brief example of the command syntax. For example:
HELP SET
displays the syntax for the set command:
Usage: set SO S9,PO,all option value
Each device attached to the Ethernet (with uses TCP/IP) is assigned a unique internet address. Internet addresses are four byte numerical values. To make it easier to remember these values, most systems on the network support a way of aliasing the internet address to some unique and easy to remember name. This is done on the Sun Workstation (and other UNIX systems) in the fetc/hosts file. Tile PortMaster also supports the same capability by maintaining a local hosts table.
The PortMaster hosts table should be used when any of the ports are set to prompt tine user for a host name on the network. This table is then consulted to determine the correct internet address of the host.
If the hostname specified by the user is not found in the hosts table, then the PortMaster will attempt to match the hostname using the Network Information Service (NIS), also known as "yP". See the section "Setting Global Parameters" for more information on setting the YP server and YP domain.
Three commands have been established for managing the local hosts table;
ADD Command - adds entries to the local hosts table.
DELETE Command - deletes entries from the local hosts table.
SHOW Command - shows the entries in the local hosts table.
ADD Command
Add an entry to the local hosts table. The syntax is:
ADD host internet address hostname
Where:
internetaddress - is a valid host internet address in the form:
XXX.XXX,XXX.XXX
where XXX is a decimal number between 0 and 255.
hostname - is a character string of printable characters.
Delete an entry from the local hosts table, The syntax is:
DELETE host internetaddress
- OR -
DELETE host hostname
Where:
internet_address,~s - is a valid host internet address in the form:
XXX.XXX,XXX,XXX
where XXX is a decimal number between 0 and 255~
hostname - is a character string of printable characters.
SHOW Command
list the contents of the local hosts table.
The syntax for the show command is:
SHOW table hosts