Maintaining compatibility

These sections discuss creating a turnkey system while maintaining consistency and compatibility with other D3 platforms and releases.

Boot file /etc/inittab

The UNIX file /etc/inittab contains information on how each device is to be initialized and what has been modified. The /etc/inittab file can be modified so the desired tty devices boot directly to the D3 virtual machine.

To modify the entries in the /etc/inittab script file, use the Update Processor, the Editor, or the UNIX command vi.

See the man pages for more information on inittab entries.

Serial turnkey

A port designated as a serial turnkey process maintains compatibility. To create a turnkey system in this manner, include an entry similar to the example below in the inittab file.

An example entry to respawn tty2 to D3 port 1 is:

a1:2:respawn:d3 -n pick0 1 -t tty2

The label a1 is a unique two character ID. The d3 command follows the standard syntax defined in the D3 Reference Manual where:

  • -n pick0 identifies the D3 configuration file

  • 1 specifies the D3 PIB or port number

  • -t tty2 identifies the tty to which the D3 process is attached

Setting parameters for serial lines

There is a new way to configure a serial line. In the /usr/lib/pick directory, create a new subdirectory named pick_term. The pick_term directory will contain files that have serial configuration parameters for D3 lines. The name of each file is the PIB number that it represents. If the PIB is number 5, the file name is 5, and the full path to the file is /usr/lib/pick/pick_term/5

/usr/lib/pick/pick_term/5

The files within the newly created pick_term directory contain all of the configuration parameters needed for the serial line they represent.

Setting a nailed serial line to use the default parameters

If a file has not been created to use the pick_term directory for a nailed serial line, the system assigns the default parameters.

Both examples use a serial line on tty5 and PIB 5.

  • Starting a nailed serial line to use the default parameters, for example:

  • a5:2:respawn:/usr/bin/d3 -n pick0 5 -t tty5

    Omitting the -T option from the command line in the inittab sets the serial line to use the default parameters.

  • Starting a nailed serial line to use the configuration parameters stored in the pick_term directory, for example:

  • a5:2:respawn:/usr/bin/d3 -n pick0 5 -t tty5 -T

    Adding the -T option to the command line in the inittab sets the serial line to use the configuration stored in the pick_term directory.

Creating the files in the pick_term directory using the set-port command

The files in the pick_term directory contain stty serial configuration commands, and can be created and populated manually using the set-port command.

When you use the set-port command to create the files for the pick_term directory, if a file does not already exist one will be created. If a file does exist, the existing configuration will be overwritten.

Listed below are several commands that are supported:

Baud Rate Description
110 = 110 baud
150 = 150 baud
300 = 300 baud
600 = 600 baud
1200 = 1200 baud
2400 = 2400 baud
4800 = 4800 baud
9600 = 9600 baud
19200 = 19200 baud
38400 = 38400 baud

Word Length Description
cs7 = 7 bits
cs8 = 8 bits

Parity Description
-parenb = no parity
parenb parodd = odd parity
parenb -parodd = even parity

Stop Bit Description
-cstopb = 1 stop bit
cstopb = 2 stop bit

Examples

TCL Command Serial Line Configuration Command (as it appears in the file)
9600,8,N,1 = 9600 cs8 -parenb -cstopb
4800,7,0,2 = 4800 cs7 parenb parodd cstopb
38400,7,E,1 = 38400 cs7 parenb -parodd -cstopb

An example of this command at the TCL prompt is:

set-port 5,9600,8,N,1

where

  • 5 is the PIB

  • 9600 is the Baud Rate

  • 8 is the Word Length

  • N is no Parity

  • 1 is one Stop Bit