 |
Index for
Section 8 |
|
 |
Alphabetical
listing for W |
|
 |
Bottom of
page |
|
wwconfig(8)
NAME
wwconfig - 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]
OPTIONS
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:
-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
among options.
-n Does not rebuild the kernel.
-N Rebuilds the network kernel .vmunix for DMS (Dataless Management
Services) support.
-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
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.
-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
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.
-pty
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.
-config
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.
-utx
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
user-defined characters
sim Starts the UTX daemon that supports the software phrase input
method for Chinese
-code
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)
-[no]thai
Includes or excludes the Thai tty driver. This specification is only
applicable for a pseudoterminal device using the BSD protocol.
-utxnum
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:
-list
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:
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
-active
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:
utxnum=n
where n is the number of UTX pseudo devices
pty=protocol
where protocol is either BSD or STREAMS
static or dynamic
tty modules are either statically or dynamically linked into
the kernel
-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.
-vmunix
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.
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 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.
NOTES
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.
SEE ALSO
Commands: stty(1), kkcd(8), kreg(8), odld(8), simd(8), utxd(8)
Others: Chinese(5), Japanese(5), Thai(5)
|
Index for
Section 8 |
|
|
Alphabetical
listing for W |
|
 |
Top of
page |
|