NAME

nlioinit − initialize Native Language I/O

SYNOPSIS

/usr/lib/nlioinit tty pty tb [ server ]

DESCRIPTION

Nlioinit initializes Native Language I/O by attaching a translating server to a terminal device. 

The argument tty is the name of the terminal device file in /dev that is associated with the user terminal to which the server will be attached. 

The argument pty is the name of the master side of a pseudo terminal in /dev (for example, ptyp1 or ptym/ptyp1) that the server will use to perform the translation.  Native Language I/O is available to the user process on the slave side of the pseudo terminal whose master is pty.

The argument tb specifies the terminal behavior for the I/O.  The supported terminal behaviors are as follows:

bj Japanese

bk Korean

bc Simplified Chinese

bt Traditional Chinese

hp35714a Japanese, with 25 screen lines

atbj Japanese, with 24 lines and a line used for host input conversion

The terminal behaviors hp35714a and atbj are for HP-16 terminals that require host input conversion. 

The optional argument server is the name of the server that nlioinit invokes to perform Native Language I/O.  If the server is omitted, the default server bserver is invoked. 

Each server is capable of conversion between internal code (HP-15) and external code, although some features are not available on all servers.  When the stty(1) command option icanon is set, entering a single erase character erases the preceding 16-bit or 8-bit input character. 

bserver Code conversion between internal code (HP-15) and external code for the languages of Japanese, Korean, Simplified Chinese, and Traditional Chinese.  It is not capable of host input conversion. 

j0server Code conversion for the Japanese language only.  Also capable of host input conversion using word and phrase dictionaries.  It uses the input window for 16-bit character input. 

DIAGNOSTICS

Nlioinit complains about fatal errors to /dev/console. 

EXAMPLES

To initialize Native Language I/O for the terminal on /dev/tty0p1, add the following entries to the /etc/inittab file:

p1:2:respawn:/etc/getty pty/ttyp1 9600
s1:2:once:/usr/lib/nlioinit tty0p1 ptym/ptyp1 bj

and, execute:

init 2

It is recommended that the action of nlioinit be set to once. 

WARNINGS

If the specified terminal behavior is invalid or not appropriate to the invoked server, nlioinit does not warn the user, and the server works with its default behavior.  Eight-bit character I/O is always available.  However, sixteen-bit character I/O may be unpleasant if, for example, code conversion is not done by the particular server selected. 

Do not set the tty special control characters such as intr, erase, and kill (see stty(1)) to ASCII characters with values in the range of ’\021’ to ’\0176’ inclusive for the terminal that the Native Language I/O server is associated with, because HP-15 can include these values as the second byte of a 16-bit character code. 

The pty used by the server is allocated upon invocation of this command, and is thereafter made unavailable to other services.  The system administrator may wish to consider adding more ptys to the system if many Native Language I/O servers will be used. 

AUTHOR

Nlioinit was developed by HP. 

SEE ALSO

nlio(1), nlioenv(1), nliostart(1), stty(1), getty(1M), init(1M), mknod(1M), pty(7), termio(7), inittab(4). 

INTERNATIONAL SUPPORT

8-bit and 16-bit data and messages, 8-bit file names. 

Hewlett-Packard Company  —  Version B.1,  May 11, 2021