unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



wwconfig(8)							  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]
  [-utxnumnumber]

  /usr/sbin/wwconfig [-d  | -D]	[-n  | -N]

  /usr/sbin/wwconfig [-list  | -active	| -kernel  | -mvunix]

OPTIONS

  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
      among options.

  -n  Does not rebuild the kernel.

  -N  Rebuilds the network kernel .vmunix for DMS (Dataless Management Ser-
      vices) 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	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.

  -pty
      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.

  -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	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

  -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 proto-
      col.

  -vmunix
      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.







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 result-
  ing 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 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
       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 dae-
       mons.

    +  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
       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)