NAME

nlioinit − initialize Native Language I/O

SYNOPSIS

/usr/lib/nlioinit tty pty tb [ server ]
/usr/lib/nlioinit −p lp_device pty pb [ server ]

DESCRIPTION

Nlioinit initializes Native Language I/O by attaching a translating server to a terminal or printer device.  If the optional argument −p is specified, nlioinit assumes that the device is a printer. 

The argument tty is the name of the terminal device file and lp_device is the name of the printer device file in /dev that is associated with the user terminal or the printer 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, and is designated by the following values:

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 hp35714a and atbj represent HP-16 terminals that require host input conversion. 

The argument pb specifies the printer behavior for the I/O, and is designated by the following values:

hp41063aj Japanese

hp41063ac Simplified Chinese

hp41063at Traditional Chinese

hpc1200aj Japanese

hpc1200ak Korean

hpc1200ac Simplified Chinese

hpc1200at Traditional Chinese

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 for terminal or pserver for printer is invoked. 

Terminal servers are 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.  The printer server is also capable of conversion from internal code (HP-15) to external code. 

bserver Code conversion between internal code (HP-15) and external code for the Japanese, Korean, Simplified Chinese, and Traditional Chinese languages.  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. 

pserver Code conversion from internal code (HP-15) to external code for the Japanese, Korean, Simplified Chinese, and Traditional Chinese languages.  It provides the same functionality as the line printer driver (see lp(7)).

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:respawn:/usr/lib/nlioinit tty0p1 ptym/ptyp1 bj

and, execute:

init 2

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), inittab(4), lp(7), pty(7), termio(7). 

EXTERNAL INFLUENCES

Environment Variables

LANG determines the language in which messages are displayed. 

International Code Set Support

Single- and multi-byte character code sets are supported. 

Hewlett-Packard Company  —  HP-UX Release 7.0: Sept 1989