hexwords.1

debug source code under unix platform.

HEXWORDS(1)              mpatrol library              HEXWORDS(1)


NNAAMMEE
       hexwords  -  extracts  any  words  from a file that can be
       written as hex numbers

SSYYNNOOPPSSIISS
       hheexxwwoorrddss [_o_p_t_i_o_n_s] [_d_i_c_t_f_i_l_e]

DDEESSCCRRIIPPTTIIOONN
       The hheexxwwoorrddss command is a little tool that can be used  to
       generate  hexadecimal constants from a dictionary of known
       words.  Such numerical constants can  be  used  in  source
       files  for  a  variety of debugging problems, and problems
       with uninitialised variables are especially relevant since
       these special numbers will stand out if seen from within a
       debugger.  For example, here are  some  common  (and  some
       not-so-common)  32-bit  hexadecimal  constants that can be
       used as debugging aids:

           _w_o_r_d   _h_e_x _c_o_n_s_t_a_n_t
       addedbad   0xaddedbad
       allocate   0xa110ca7e
       badlabel   0xbad1abe1
       baseball   0xba5eba11
       codebabe   0xc0debabe
       codedbad   0xc0dedbad
       deadbeef   0xdeadbeef
       deadcode   0xdeadc0de
       failsafe   0xfa115afe
       feedface   0xfeedface
       freedata   0xf4eeda7a
       goodcode   0x600dc0de

       As can be seen above, many decimal digits can be  used  to
       represent  the  letters  that  they most closely resemble,
       along with the hexadecimal digits _A through _F.  This  pro-
       vides  a  much  larger  selection  of  words  that  can be
       matched, although the digits _3 and _8 cannot be used due to
       the  lack  of any similar-looking letters.  The digits and
       their corresponding letters are  given  in  the  following
       table.

       _d_i_g_i_t   _l_e_t_t_e_r
       0       O, o or Q
       1       I, i or l
       2       Z or z
       3       -
       4       q or R
       5       S or s
       6       G
       7       J or T
       8       -
       9       g
       A-F     A-F
       a-f     a-f

       The  _d_i_c_t_f_i_l_e argument must be a valid dictionary filename
       but  if  _d_i_c_t_f_i_l_e  is  omitted  then  hheexxwwoorrddss  will   use
       _/_u_s_r_/_d_i_c_t_/_w_o_r_d_s as the name of the dictionary file to use.
       If  that  cannot  be  found   then   hheexxwwoorrddss   will   try
       _/_u_s_r_/_l_i_b_/_d_i_c_t_/_w_o_r_d_s    and   _/_u_s_r_/_s_h_a_r_e_/_d_i_c_t_/_w_o_r_d_s.    The
       dictionary file must be a plain text  file  that  contains
       one  word  per  line,  otherwise  few  to no words will be
       matched.

       The hheexxwwoorrddss command currently makes use of  several  UNIX
       text processing commands in order to extract the words and
       their hexadecimal equivalents.  As a result, the  hheexxwwoorrddss
       command  is  only  likely  to work on UNIX platforms or on
       systems which have the necessary commands installed.

OOPPTTIIOONNSS
       ----hheellpp [--hh]
              Displays a quick-reference option summary.

       ----mmaattcchh <_e_x_a_c_t|_l_o_w_e_r|_u_p_p_e_r|_a_n_y> [--mm]
              Sets the type of case-sensitivity to use.   A  set-
              ting  of _e_x_a_c_t performs a case-sensitive comparison
              of all of the words in the dictionary file and  the
              hexadecimal  digits,  whereas a setting of _a_n_y does
              not.  The _l_o_w_e_r  and  _u_p_p_e_r  settings  convert  the
              words  in  the  dictionary  file to lower and upper
              case respectively before performing  a  case-sensi-
              tive  comparison.   The default case-sensitivity is
              _e_x_a_c_t.

       ----mmaaxxiimmuumm <_c_o_u_n_t> [--uu]
              Sets the maximum number of letters to match.   None
              of  the hexadecimal numbers displayed will have any
              more digits than this.  The default is _8.

       ----mmiinniimmuumm <_c_o_u_n_t> [--ll]
              Sets the minimum number of letters to match.   None
              of  the hexadecimal numbers displayed will have any
              less digits than this.  The default is _4.

       ----vveerrssiioonn [--VV]
              Displays the version number of  the  hheexxwwoorrddss  com-
              mand.

SSEEEE AALLSSOO
       mmppaattrrooll(1),   mmpprrooff(1),  mmppttrraaccee(1),  mmlleeaakk(1),  mmppssyymm(1),
       mmppeeddiitt(1), lliibbmmppaattrrooll(3), lliibbmmppaalllloocc(3).

       The mpatrol manual and reference card.

       http://www.cbmamiga.demon.co.uk/mpatrol/

AAUUTTHHOORR
       Graeme S. Roy <[e-mail]>

CCOOPPYYRRIIGGHHTT
       Copyright (C) 1997-2002  Graeme  S.  Roy  <graeme.roy@ana-
       log.com>

       This  library  is  free  software; you can redistribute it
       and/or modify it under the terms of the GNU  Library  Gen-
       eral  Public  License  as  published  by the Free Software
       Foundation; either version 2 of the License, or  (at  your
       option) any later version.

       This  library  is  distributed in the hope that it will be
       useful, but WITHOUT ANY WARRANTY; without even the implied
       warranty  of  MERCHANTABILITY  or FITNESS FOR A PARTICULAR
       PURPOSE.  See the GNU Library General Public  License  for
       more details.

       You should have received a copy of the GNU Library General
       Public License along with this library; if not,  write  to
       the Free Software Foundation, Inc., 59 Temple Place, Suite
       330, Boston, MA 02111-1307, USA.



Release 1.4               8 January 2002                        1