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] [-utxnum number]
/usr/sbin/wwconfig [-d | -D] [-n | -N]
/usr/sbin/wwconfig [-list | -active | -kernel | -vmunix]
wwconfig 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) support.
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). Alternatively,
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 override the
default with the -pty option. Specifies the terminal
driver protocol used by the pseudoterminal
device (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: Starts the UTX daemon that supports the
Kana-Kanji conversion method for Japanese 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 terminal
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) Simplified/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
configuration 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 character set support
Mitac Telex character set support Simplified/Traditional
Chinese character set support UTF-8 (Unicode) character
set support 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 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 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 protocol. Displays the Asian tty features that
are statically linked into /vmunix, as well as the pseudoterminal
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.
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 features include: Whether the I18N tty driver
will use BSD or STREAMS terminal 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 functions 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 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 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 codeset
conversion support is included for Simplified and
Traditional 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 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)
wwconfig(8)
[ Back ] |
