unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

auto_ef(1)                       User Commands                      auto_ef(1)



NAME
       auto_ef - auto encoding finder

SYNOPSIS
       /usr/bin/auto_ef [-e encoding_list] [-a] [-l level] [file ...]

       /usr/bin/auto_ef -h

DESCRIPTION
       The  auto_ef utility identifies the encoding of a given file. The util-
       ity judges the encoding by using the iconv code conversion, determining
       whether  a  certain  code  conversion was successful with the file, and
       also by performing frequency analyses on the character  sequences  that
       appear in the file.

       The  auto_ef  utility  might produce unexpected output if the string is
       binary, a character table, a localized digit list, or a chronogram,  or
       if the string or file is very small in size (for example, less than one
       100 bytes).

       ASCII                   JIS
       ISO-2022-JP



       eucJP                   Japanese EUC



       PCK                     Japanese PC Kanji, CP932, Shift JIS



       UTF-8                   Korean EUC
       ko_KR.euc



       ko_KR.cp949             Unified Hangul



       ISO-2022-KR             ISO-2022 Korean



       zh_CN.iso2022-CN        ISO-2022 CN/CN-EXT



       zh_CN.euc               Simplified Chinese EUC, GB2312



       GB18030                 Simplified Chinese GB18030/GBK



       zh_TW-big5              BIG5



       zh_TW-euc               Traditional Chinese EUC



       zh_TW.hkscs             Hong Kong BIG5



       iso-8859-1              West European, and similar



       iso-8859-2              East European, and similar



       iso-8859-5              Cyrillic, and similar



       iso-8859-6              Arabic



       iso-8859-7              Greek



       iso-8859-8              Hebrew



       CP1250                  windows-1250, corresponding to ISO-8859-2



       CP1251                  windows-1251, corresponding to ISO-8859-5



       CP1252                  windows-1252, corresponding to ISO-8859-1



       CP1253                  windows-1253, corresponding to ISO-8859-7



       CP1255                  windows-1255, corresponding to ISO-8859-8



       koi8-r                  corresponding to iso-8859-5



       By default, auto_ef returns a single, most likely encoding for text  in
       a  specified  file. To get all possible encodings for the file, use the
       -a option.

       Also by default, auto_ef uses the fastest process to examine the  file.
       For more accurate results, use the -l option.

       To examine data with a limited set of encodings, use the -e option.

OPTIONS
       The following options are supported:

       -a                      Shows all possible encodings in order of possi-
                               bility, with scores in the  range  between  0.0
                               and  1.0.  A higher score means a higher possi-
                               bility. For example,

                               example% auto_ef -a test_file
                               eucJP           0.89
                               zh_CN.euc       0.04
                               ko_KR.euc       0.01


                               Without this option, only one encoding with the
                               highest score is shown.



       -e encoding_list        Examines  data  only  with specified encodings.
                               For example, when encoding_list is specified as
                               "ko_KR.euc:ko_KR.cp949",  auto_ef examines text
                               only with CP949  and  ko_KR.euc.  Without  this
                               option,  auto_ef  examines text with all encod-
                               ings. Multiple encodings can  be  specified  by
                               separating the encodings using a colon (:).



       -h                      Shows the usage message.



       -l level                Specifies  the  level of judgment. The value of
                               level can be 0, 1, 2, or 3.  Level  3  produces
                               the  best  result  but  can be slow. Level 0 is
                               fastest but results can be less  accurate  than
                               in higher levels. The default is level 0.



OPERANDS
       The following operands are supported:

       file            File name to examine.



EXAMPLES
       Example 1: Examining encoding of a file

       example% auto_ef file_name

       Example 2: Examining encoding of a file at level 2.

       example% auto_ef -l 2 file_name

       Example 3: Examining encoding of a file with only eucJP or ko_KR.euc

       example% auto_ef -e "eucJP:ko_KR.euc" file_name

EXIT STATUS
       The following exit values are returned:

       0        Successful completion



       1        An error occurred.



ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:


       tab()     allbox;     cw(2.750000i)|    cw(2.750000i)    lw(2.750000i)|
       lw(2.750000i).  ATTRIBUTE  TYPEATTRIBUTE  VALUE  AvailabilitySUNWautoef
       Interface StabilitySee below.


       Interface  Stability  of output format, when option -a is specified, is
       Evolving. Other interfaces are Stable.

SEE ALSO
       auto_ef(3EXT), libauto_ef(3LIB), attributes(5)

       International Language Environments Guide



SunOS 5.10                        26 Sep 2004                       auto_ef(1)