atty(7) 						 Miscellaneous Information Manual						   atty(7)

NAME

       atty - Asian terminal driver

SYNOPSIS

       #include <sys/aioctl.h>

DESCRIPTION

       This  reference	page describes the additional features supported in the Asian terminal driver used for conversational computing in a Japa-
       nese, Chinese, or Korean environment.  See tty(7) for a description of the general terminal interface.  See stty(1) for information on  how
       to activate the features discussed here.

       The  Asian  terminal  driver  is  available  only if you install the Tru64 UNIX optional subsets for worldwide support.	The Asian terminal
       driver must be configured into the current running kernel in order for the features described below to be enabled.

   Line Disciplines
       Line discipline switching to the Asian terminal driver is accomplished with the TIOCSETD ioctl as follows:

       int ldisc = ASYDISC;

       ioctl(f, TIOCSETD, &ldisc);

   Input Editing
       A character for the Asian terminal driver can be composed of one or more bytes, depending on the terminal codeset selected by the user.	In
       addition,  the  ISTRIP  mask  of  the c_iflag field does not work with this driver. The erase character (VERASE) logically erases the whole
       character, which may be more than one byte long.

   Code Conversion
       The Asian terminal driver allows an application to communicate with the driver in one codeset while the driver communicates with the physi-
       cal  device  in	another  codeset.  These two different codesets are called the application codeset and the terminal codeset, respectively.
       The driver performs any necessary codeset conversion on data passed between your application and the device.

       The following application codesets are supported by the Asian terminal driver. The keyword that specifies the codeset in command parameters
       is  shown  in parentheses.  DEC Kanji (deckanji) Super DEC Kanji (sdeckanji) Japanese EUC (eucJP) Shift JIS (SJIS) DEC Hanzi (dechanzi) DEC
       Hanyu (dechanyu) Taiwanese EUC (eucTW) DEC Korean (deckorean) Korean EUC (eucKR) UTF-8 (UTF-8) Big-5 (big5)

       Reference pages are available for each codeset; for example, to find out more about the DEC Korean codeset, see deckorean(5).

       The following terminal codesets are supported by the Asian terminal driver. The keyword that specifies the codeset in command parameters is
       shown in parentheses.  DEC Kanji (dec) DEC Kanji - 1978 (dec78) Japanese EUC (eucJP) Shift JIS (SJIS) 7-bit JIS (jis7) 8-bit JIS (jis8) DEC
       Hanzi (dechanzi) Taiwanese EUC (eucTW) DEC Korean (deckorean) Korean EUC (eucKR) UTF-8 (UTF-8) Big-5 (big5) Telecode (telecode)

       By default, the Asian terminal driver supports all listed codesets except for Big-5, Telecode, and UTF-8. Support for the BIG-5, UTF-8, and
       Telecode codesets requires linking additional modules (that are supplied in optional subsets) into the kernel.

   History Mode Line Editing
       The  history  mode supported by the Asian terminal driver allows the user to have Emacs-like control for editing previously entered command
       lines. Up to 32 lines can be stored in history mode, and each line can have a maximum length of 127 characters.	When commands are long, it
       is  possible  that fewer than 32 commands are stored in the history list.  Short commands, those less than three characters (single-byte or
       multibyte) in length, are not stored in the history list.

       The following editing commands are available in history mode: Move to the beginning of line.  Delete the character under the cursor.   Move
       to  the	end  of the line.  Recall the previous command in the history list.  Recall the next command in the history list.  Move the cursor
       left by one character.  Move the cursor right by one character.	Delete the character before the cursor.  You can use the stty  command	to
       determine and set the character that erases a character.  Delete the word before the cursor.  You can use the stty command to determine and
       set the character that erases a word.

       Typing a normal character causes it to be inserted before the character under the cursor. The kill, interrupt, and suspend characters cause
       the Asian terminal driver to break out of history mode.

   Kana-Kanji Conversion
       The  Kana-Kanji	conversion  mechanism for Japanese allows users to enter an ASCII or Kana string and convert it to a Kanji or another Kana
       string. The conversion is supported in both cbreak and cooked mode, but activation of Kana-Kanji conversion is  different  for  each  mode.
       See kkc(5) for more information about Kana-Kanji conversion.  See stty(1) on how to activate Kana-Kanji conversion under different modes.

   Software On-Demand Loading
       The  Software  On-Demand  Loading (SoftODL) mechanism allows users to display any number of user-defined characters (UDC) on terminals that
       support hardware On-Demand Loading (ODL). Refer to odl(5) for more information about on-demand loading of UDCs.

   Software Phrase Input Method
       The Software phrase Input Method (SIM) mechanism for Chinese allows users to enter a long phrase by typing in a short phrase key. Refer	to
       sim(5) for more information on this input mechanism.

RELATED INFORMATION

       Commands: stty(1)

       Functions: ioctl(2)

       Files: tty(7), utx(7)

       Others:	big5(5),  Chinese(5), dechanyu(5), dechanzi(5), deckanji(5), eucJP(5), eucKR(5), eucTW(5), Japanese(5), kkc(5), Korean(5), odl(5),
       sdeckanji(5), shiftjis(5), sim(5), telecode(5), Unicode(5) delim off

																	   atty(7)