wwconfig(8)wwconfig(8)NAMEwwconfig - Configures tty features for Asian countries
SYNOPSIS
/usr/sbin/wwconfig [-a | -A] [-n | -N] [-s | -l] [-pty [bsd |
streams]] [-config config-file] [-utx utx-options] [-code codeset]
[-[no]thai] [-utxnum number]
/usr/sbin/wwconfig [-d | -D] [-n | -N]
/usr/sbin/wwconfig [-list | -active | -kernel | -vmunix]
OPTIONSwwconfig defines Asian tty support options and merges them into the
system configuration file, deletes Asian tty support options from the
system configuration file, and lists the tty support options. These
three operations are mutually exclusive.
The wwconfig definition and merge options are: 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. Merges all installed Asian tty features
into the system configuration file. When you specify the -A option, you
are not prompted to choose among options. Does not rebuild the kernel.
Rebuilds the network kernel for DMS (Dataless Management Services) sup‐
port. 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 terminal driver protocol as the default for the pseudoterminal
device used for rlogin and telnet sessions (network login). Alterna‐
tively, use the -pty option to override the default. 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
protocol 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 over‐
ride the default with the -pty option. Specifies the terminal
driver protocol used by the pseudoterminal device (pty) for net‐
work login. If you use -pty bsd, it forces use of the BSD termi‐
nal driver protocol with the pseudoterminal device used for net‐
work 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 configu‐
ration 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 appro‐
priate 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: Starts the UTX
daemon that supports the Kana-Kanji conversion method for Japa‐
nese Starts the UTX daemon that supports on-demand font loading
of user-defined characters 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 termi‐
nal driver. Separate multiple options with a comma. The -code
arguments are: BIG-5 character set support (Traditional Chinese)
Mitac Telex character set support (Traditional Chinese) Simpli‐
fied/Traditional Chinese mapping support 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: Deletes from the system configura‐
tion file only the Asian tty features that have been de-installed
Deletes from the system configuration file all Asian tty features Does
not rebuild the kernel Rebuilds the network kernel 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 system, may contain: Asian tty driver UNIX terminal
extension pseudo device Kana-Kanji conversion UTX driver On-demand font
loading UTX driver Software phrase input method UTX driver BIG-5 char‐
acter set support Mitac Telex character set support Simplified/Tradi‐
tional Chinese character set support UTF-8 (Unicode) character set sup‐
port Thai tty driver Displays all the Asian tty options currently acti‐
vated 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 proto‐
col is either BSD or STREAMS tty modules are either statically or
dynamically linked into the kernel 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 sys‐
tem, 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 protocol. Displays the Asian tty fea‐
tures that are statically linked into /vmunix, as well as the pseu‐
doterminal driver protocol in use. Depending 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.
DESCRIPTION
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 resulting dialogue to choose tty driver features. The optional fea‐
tures include: Whether the I18N tty driver will use BSD or STREAMS ter‐
minal driver protocol.
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 func‐
tions that are in the BSD portion of the driver. By default,
wwconfig uses BSD protocol for a statically linked kernel
(wwconfig -s) and STREAMS protocol for a dynamically linked ker‐
nel (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 utxd daemon.
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 daemons. Whether BIG-5, Telecode (Mitac Telex), and
Unicode are supported as valid terminal codes and whether code‐
set conversion support is included for Simplified and Tradi‐
tional Chinese. How many UTX pseudo devices to create. UTX
pseudo devices provide communication between a server process
(such as kkcd) and the terminal driver subsystem. 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 con‐
figuration 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.
NOTES
You must be root to execute the wwconfig command.
The -code cyz option enables character mapping support between Tradi‐
tional 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.
SEE ALSO
Commands: stty(1), kkcd(8), kreg(8), odld(8), simd(8), utxd(8)
Others: Chinese(5), Japanese(5), Thai(5)wwconfig(8)