Man Linux: Main Page and Category List

NAME

       hexcurse - an ncurses-based hex editor

SYNOPSIS

       hexcurse [ -?  |  -help ] [ -a ] [ -r rnum ] [ -o outputfile ] [ [ -i ]
       inputfile ]

DESCRIPTION

       hexcurse is an ncurses-based hexeditor utility that is  able  to  open,
       modify,  and  save  a  file  to disk while providing useful editing and
       searching options.

OPTIONS

       -?  |  -help   Prints out the command usage info

       -a             Specifies the addresses to be output in  decimal  format
                      initially.

       -r rnum        Specifies  the  number  of  characters per line that the
                      hexeditor should output.  If rnum is either less than  1
                      or  greater  than  the  columns of the current terminal,
                      hexcurse will fill the terminal width, just as if the -r
                      was not specified.

       -o outputfile  Specifies the output file to be written to by default.

       [-i] inputfile Specifies  the  input  file  to  be  read in.  -i is not
                      needed if inputfile is the last argument on the line.

INTERACTIVE OPTIONS

       F1 | ctrl+?    Shows key command help.

       F2 | ctrl+s    Save the current file.

       F3 | ctrl+o    Opens a file.

       F4 | ctrl+g    Goto a certain location in the current file.   Depending
                      on  which  way  the  addresses  are  being viewed at the
                      moment, the search  will  behave  differently.   If  the
                      addresses  are  currently in hex format, the search will
                      search as if the input was given in hexadecimal  format.
                      If  the  addresses  are  in decimal format, the function
                      will search for the address in decimal.

       F5 | ctrl+f    Search  for  a  certain  string  in  the  current  file.
                      Depending  on which window the user is currently editing
                      in, this search will behave differently.  If editing  in
                      the hex window, the input should only be in hexadecimal,
                      and it will search for the hexadecimal "string."  If the
                      current  editing  window  is the ASCII window, the input
                      should be ASCII characters, and  the  search  will  find
                      that ASCII string in the file.

       F6 | ctrl+a    Switch  between  hexadecimal  address values and decimal
                      address values.

       F7 | TAB       Switch  between  the  hexadecimal  and   ASCII   editing
                      windows.

       F8 | ctrl+q | ctrl+x
                      Exit out of the program.

       Page Up | ctrl+u
                      Scroll one ’page’ up.

       Page Down | ctrl+d
                      Scroll one ’page’ down.

       Home | ctrl+t  Returns to the top of the file.

       End | ctrl+b   Jumps to the bottom of the file.

       ctrl+z         Undo the last modification.  Can be used multiple times.

       Esc            Escapes out of the save, open, goto, and find prompts.

SEE ALSO

       hexdump(1) , ncurses(3)

AUTHORS

       The authors of hexcurse are:

              jewfish <jewfish@jewfish.net>
              armoth <uknowho@jewfish.net>

       The current version of this software is always availabe at

              http://www.jewfish.net/software.php

BUGS

       On some terminals the function keys will not work.

       Support for resizable terminals is still a bit  rudimentary.   At  this
       time,  when  the  terminal  is resized, the cursor is positioned at the
       beginning of the file.  This will be corrected  in  the  next  release.
       There  is also an issue where the labels on the bottom of the screen do
       not resize correctly.  A fix for the latter is in the works.

       To report a bug or problem, please e-mail:

              devel@jewfish.net

TODO

       When we get the time, we would like to implement the ability to  insert
       and  delete  data  from the file.  Please e-mail us with any additional
       suggestions.

                               22 December 2003