wwconfig - Configures tty features for Asian countries
/usr/sbin/wwconfig [-a | -A] [-n | -N] [-s | -l] [-pty [bsd | streams]]
[-config config-file] [-utx utx-options] [-code codeset] [-[no]thai]
/usr/sbin/wwconfig [-d | -D] [-n | -N]
/usr/sbin/wwconfig [-list | -active | -kernel | -mvunix]
wwconfig defines Asian tty support options and merges them into the system
configuration file, deletes Asian tty support options from the system con-
figuration file, and lists the tty support options. These three operations
are mutually exclusive.
The wwconfig definition and merge options are:
-a Merges installed Asian tty features into the system configuration file
by prompting you to choose among options. If the command line contains
-pty, -utx, -code, or -utxnum specifications, the prompt for that
feature is not repeated in the -a option dialogue.
-A Merges all installed Asian tty features into the system configuration
file. When you specify the -A option, you are not prompted to choose
-n Does not rebuild the kernel.
-N Rebuilds the network kernel .vmunix for DMS (Dataless Management Ser-
-s Statically links the Asian terminal driver into the kernel image. A
kernel rebuild and replacement must be done before the Asian terminal
driver is available for use. Use this option to establish the BSD ter-
minal driver protocol as the default for the pseudoterminal device used
for rlogin and telnet sessions (network login). Alternatively, use the
-pty option to override the default.
-l Dynamically links the Asian terminal driver into the kernel at boot
time. A kernel rebuild is not required when the driver is dynamically
linked. However, if you are changing from a statically linked kernel to
a dynamic link or from a dynamically linked kernel to a static link, a
kernel rebuild is required.
The -l option also specifies use of the STREAMS terminal driver proto-
col with the pseudoterminal device used for network login. (If past use
of wwconfig caused the BSD terminal driver protocol to be used for this
pseudoterminal device, then the -l option causes a fallback to the
STREAMS terminal driver.)
The -l option is the default if the Asian terminal driver is not
already installed. Otherwise, wwconfig uses the linking method that was
used for the currently installed driver. You can override the default
with the -pty option.
Specifies the terminal driver protocol used by the pseudoterminal dev-
ice (pty) for network login. If you use -pty bsd, it forces use of the
BSD terminal driver protocol with the pseudoterminal device used for
network login. If you use -pty streams, it forces use of the STREAMS
terminal driver protocol.
Specifies use of an existing file (config-file) in /usr/sys/conf/ as
the kernel configuration file. In the absence of this option, the
default kernel configuration file is a file in the same directory with
a name that is derived from the host name.
Specifies one or more UTX support options that are added to the Asian
terminal driver. The appropriate kernel module (kkc, odl, or sim) must
be installed for the option specification to take effect. Separate
multiple options with a comma. The -utx arguments are:
kkc Starts the UTX daemon that supports the Kana-Kanji conversion
method for Japanese
odl Starts the UTX daemon that supports on-demand font loading of
sim Starts the UTX daemon that supports the software phrase input
method for Chinese
Specifies one or more codeset support options that are added to the
Asian terminal driver. Separate multiple options with a comma. The
-code arguments are:
big BIG-5 character set support (Traditional Chinese)
tlx Mitac Telex character set support (Traditional Chinese)
cyz Simplified/Traditional Chinese mapping support
utf8 UTF-8 character set support (Unicode)
Includes or excludes the Thai tty driver. This specification is only
applicable for a pseudoterminal device using the BSD protocol.
Specifies the number of UTX pseudo devices that will be created.
The wwconfig deletion options are:
-d Deletes from the system configuration file only the Asian tty features
that have been de-installed
-D Deletes from the system configuration file all Asian tty features
-n Does not rebuild the kernel
-N Rebuilds the network kernel .vmunix for DMS support
The wwconfig list options are:
Displays I18N tty features that you can specify for inclusion in the
system configuration file (by means of a -utx, -code, -thai, or -a
command option). The display is derived from the currently installed
I18N kernel modules and, depending on what is installed with your sys-
tem, may contain:
atd Asian tty driver
utx UNIX terminal extension pseudo device
kkc Kana-Kanji conversion UTX driver
odl On-demand font loading UTX driver
sim Software phrase input method UTX driver
big BIG-5 character set support
tlx Mitac Telex character set support
cyz Simplified/Traditional Chinese character set support
utf8 UTF-8 (Unicode) character set support
thai Thai tty driver
Displays all the Asian tty options currently activated in the kernel
configuration file and other configuration files in /var/i18n/sys.
Depending on the options configured for your system, the display may
contain all of the tty options described for the -list option, plus:
where n is the number of UTX pseudo devices
where protocol is either BSD or STREAMS
static or dynamic
tty modules are either statically or dynamically linked into
Displays the currently active Asian tty options in the running kernel.
(The running kernel may differ from /vmunix.) Depending on the modules
and options configured for your system, the display may contain all of
the features described for the -list option and all of the features
described for the -active option, with the exception of the pty proto-
Displays the Asian tty features that are statically linked into
/vmunix, as well as the pseudoterminal driver protocol in use. Depend-
ing on the features statically configured for your system, the display
may contain all of the features described for the -list option and the
-active option pty display.
The wwconfig procedure integrates installed Asian tty features into the
running kernel, removes those features from the kernel, or lists the
installed or currently active features. Currently, you can configure a
generic Asian multibyte tty driver (atty) and a single-byte Thai tty driver
(ttty) into the running kernel.
The Asian tty driver has several optional features that you can set up if
the appropriate subsets are installed. You can specify the features that
will be merged into the system configuration file with an option on the
wwconfig command line or you can specify the -a option and use the result-
ing dialogue to choose tty driver features. The optional features include:
+ Whether the I18N tty driver will use BSD or STREAMS terminal driver
Tru64 UNIX uses the STREAMS pseudoterminal driver protocol. While the
STREAMS protocol is more advanced that BSD, the STREAMS portion of the
I18N tty driver lacks some of the functions that are in the BSD por-
tion of the driver. By default, wwconfig uses BSD protocol for a stat-
ically linked kernel (wwconfig -s) and STREAMS protocol for a dynami-
cally linked kernel (wwconfig -l). To override the default, specify
the -pty option and the desired protocol on the wwconfig command line.
+ The UTX daemons to start and connect to the atty driver through the
You can choose to start the kkcd, odld, and simd UTX daemons. Refer to
kkcd(8), odld(8), and simd(8) for more information about these dae-
+ Whether BIG-5, Telecode (Mitac Telex), and Unicode are supported as
valid terminal codes and whether codeset conversion support is
included for Simplified and Traditional Chinese.
+ How many UTX pseudo devices to create. UTX pseudo devices provide com-
munication between a server process (such as kkcd) and the terminal
+ Whether the Thai tty driver, if installed, is set up in addition to
the Asian tty driver.
As is true for kernel layered products, the wwconfig command uses the kreg
utility to register the Asian tty features. After the kernel configuration
process completes, config.file in the /usr/i18n/sys/BINARY directory is
updated to reflect the tty features that you selected. The current system
configuration file is also updated, if necessary.
Because the tty features are registered through the kreg utility, you can
use the doconfig command to build a new kernel without affecting the
current setup for Asian tty features.
When you execute the wwconfig command, the dialogue gives you the option to
specify an automated kernel build and provides information on the amount of
space required for the build. The dialogue also gives you the option of
editing the configuration file.
You must be root to execute the wwconfig command.
The -code cyz option enables character mapping support between Traditional
Chinese and Simplified Chinese. However, because a Simplified Chinese to
Traditional Chinese mapping is one to many, the mappings in that direction
may not be completely accurate for all cases.
If a command line option contains an invalid argument, the argument is
ignored with no error or warning. For example, if the kkc driver is not
installed on the system, a command line to add that feature ( -utx kkc) is
ignored. To display the installed I18N tty options, use the -list option.
Commands: stty(1), kkcd(8), kreg(8), odld(8), simd(8), utxd(8)
Others: Chinese(5), Japanese(5), Thai(5)