Man Linux: Main Page and Category List

NAME

       hex - hexadecimal dump tool (with Japanese support)

SYNOPSIS

       hex [ options...  ] [ file ]
       hex -r [ file ]

DESCRIPTION

       hex  will  show the contents of file (or standard input) in hexadecimal
       and/or character.  At this time, this will show in Japanese text as  if
       it seems to be.

   OPTIONS
       You can specify option in environment variable HEX_OPTIONS

   OPTIONS - how to shownon printable character’
       see EXAMPLE below

       ‘Non  printable character’ here is that control codes and/or codes that
       is 8bits and out of range of kanji or kana character codes.

       -c, --color (default if output is tty)
              show ‘non printable character’ with colors.  Terminal with color
              support,  such  as kterm , MS-DOS Prompt in Windows95 and so on)
              show all of J with color by EXAMPLE options.

              Blue and light bule is used by default,  using  escape  sequence
              such  as ^[[34m These colors can be changed by -cs1, -cs2 option
              described below.

       -b, --bold
              show ‘non printable character’ in bold.  EXAMPLE will show all J
              in bold.  It will be showen in bold even if you see via less

              When output is tty, escape sequence ^[[1m is used, and otherwise
              (such pipe), it will output like A^HA for bold A.

              This program does not refer termcap/terminfo , so some  terminal
              can not show in bold.  In Windows95, it looks brighter.

       -d, --dot (default if output is not tty)
              show  ‘non  printable character’ as ‘.’ as if ‘J’ substituted in
              ‘.’ in EXAMPLE case.

       -t, --text
              show ‘non printable character’ in normal text. Same  as  EXAMPLE
              No use.

       -u, --underline
              show ‘non printable character’ with underline.  In EXAMPLE case,
              all J has underline.  You can see with underline even if you see
              via less or more

              When  output  to  tty,  escape sequence ^[[4m is used, otherwise
              (such as pipe), it will output like _^HA for A  with  underline.
              You can’t see underline in Windows95.

       EXAMPLE
              0x00000000: a4 cf a4 e8 a4 f3 0a 0a - 0a 0a 0a 0a 0a 0a 0a 0a HAYONNJJJJJJJJJJ
              (actually, "HAYONN" shows in Hiragana characters).

   OPTION - output code
       To check what is specified by default, hex -h

       -e, -oe, --oeuc
              output using *euc-japan*

       -s, -os, --osjis
              output using *sjis*

       -j, -oj, --ojis
              output using *iso-2022-jp*

   OPTION - input code
       To check what is specified by default, hex -h

       -E, -ie, --ieuc
              Assume *euc-japan* or *iso-2022-jp* for input.

       -S, -is, --isjis
              Assume *sjis* or *iso-2022-jp* for input

       -U, -iu, --iunknown
              Assume  unknown  input code.  Japanese handling won’t be done by
              this option.

   OPTION - other
       -cs1 cs, --colorstring1 cs
              specify code 1 of color.  This color is used for  control  codes
              and/or  codes  that  is  8bits and out of range of kanji or kana
              character codes.

              For example,  if you specified -cs1 43;31 (‘;’ will  be  handled
              by  shell, so you should escape it as -cs1 43;31 ), output red
              character with yellow background.

       -cs2 cs, --colorstring2 cs
              specify code 2 for color.  This color is used for half of  kanji
              character,  part of EUC halfwidth kana and/or escape sequence of
              iso-2022.

       -dsiso, --disablesiso, +siso
              Usually, character between ^N/^O is treated as  halfwidth  kana,
              but disabled with this option.

       -siso, --enablesiso
              Oppose to above (default)

       -r, --restore
              % hex < hoe | hex -r > hoge
              is same as
              % cat < hoe > hoge

       -h, --help
              show usage.

PAGER

       If  you  use  pager such as less for output of hex, you can’t see color
       however, you can see color by doing like the followings:
       % hex -cwhich hex| less -r
       % hex -cwhich hex| lv -C
       If you use command prompt on WindowsNT, try
       % hex -uwhich hex| less
       less will show with colors for underline, so it looks like  with  color
       option.  (disabled hex color option)

SEE ALSO

       od(1), hexdump(1), jhd(1), less(1), lv(1)

COPYRIGHT

       Copyright (C) 1996-1998, TAGA Nayuta <nayuta@is.s.u-tokyo.ac.jp>

       This program is free software.

       THERE IS NO WARRANTY FOR THE PROGRAM.

       The        latest       version       can       be       found       at
       http://www.is.s.u-tokyo.ac.jp/~nayuta/

AUTHOR

       TAGA Nayuta (nayuta@is.s.u-tokyo.ac.jp)

       This manual page was translated by Fumitoshi UKAI  <ukai@debian.or.jp>,
       for the Debian GNU/Linux system (but may be used by others).

BUGS

       This program doesn’t refer termcap/terminfo so some terminal can’t show
       bold.

       No autodetection of Japanese encodings.

       Wrong efficiency for output. (color sequence with each characters.  For
       *iso-2022-jp* output, ^[(J for each characters.)

       Space  of  halfwidth kana ( 0x8e 0xa0 in *euc-japan* , 0xa0 in *sjis* ,
       0x20 in *iso-2022-jp* ) will output as normal space character ( 0x20 )

       You can’t see color in some part on Windows95. (bug of Windows95 ?)

       No support supplimental characters in *iso-2022-jp*.