unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (Debian-5.0)
Page:
Section:
Apropos / Subsearch:
optional field

BMORE(1)                    General Commands Manual                   BMORE(1)



NAME
       bmore - browse through a binary file

SYNOPSIS
       bmore [ -acdi ] [ -n lines ] [ -w cols ] [ +linenumber ] [ +/ASCII-pat-
       tern ] [ +\Hex-pattern ] [ filename ... ]

DESCRIPTION
       more is a filter that displays the contents of a  binary  file  on  the
       terminal,  one  screenful  at  a  time.   It normally pauses after each
       screenful, and prints --More-- at the bottom of the screen.  bmore pro-
       vides  a  two-line overlap between screens for continuity.  If bmore is
       reading from a file rather than a pipe, the  percentage  of  characters
       displayed so far is also shown.

       bmore  scrolls  up  to  display  one  more screen line in response to a
       RETURN character; it displays another screenful in response to a  SPACE
       character.  Other commands are listed below.

       The  screen  is  divided  in  three  sections or panes: The byte offset
       (extreme left), the hex pane (middle), and an ascii pane (right)  which
       shows  as  printable  characters those bytes in the hex pane.  On an 80
       column terminal there will be sixteen hex values and their ASCII values
       on  each  screen  line.  Note that (as one would expect) the first byte
       has the offset 0 (zero).

       bmore sets the terminal to noecho mode, so that the output can be  con-
       tinuous.  Commands that you type do not normally show up on your termi-
       nal, except for the / , \ and !  commands.

       If the standard output is not a terminal, more acts just like  cat(1V),
       except that a header is printed before each file in a series.

OPTIONS
       -a     ASCII mode: no hex representation of the contents. Non printable
              characters are displayed as a dot (.)

       -c     Clear  before  displaying.  Redrawing  the  screen  instead   of
              scrolling.

       -d     Display  error messages rather than ringing the terminal bell if
              an unrecognized command is used.  This is helpful for  inexperi-
              enced users.

       -i     Ignore case for searching.

       -n lines
              Displays the indicated number of lines in each screenful, rather
              than the default (the number of lines  in  the  terminal  screen
              less two).

       -w cols
              Display number of cols in each line.

       +linenumber
              Start up at linenumber.

       +/ASCII-pattern
              Start  up at the line containing the regular expression pattern.
              Note: unlike editors, this construct should not end with a  `/'.
              If  it  does, then the trailing slash is taken as a character in
              the search pattern.


       USAGE

   Commands
       The commands take effect immediately;  it is not necessary  to  type  a
       carriage  return.   Up to the time when the command character itself is
       given, the user may type the line kill character to cancel the  numeri-
       cal  argument  being  formed.  In addition, the user may type the erase
       character to redisplay the `--More--(xx%)' message.

       In the following commands, i is a numerical argument (1 by default).

       iSPACE    Display another screenful, or i more lines if i is specified.

       iRETURN   Display another line, or i more lines, if specified.

       i^D       (CTRL-D) Display (scroll down) 11 more lines.   i  is  given,
                 the scroll size is set to i.

       id        Same as ^D.

       iz        Same  as  SPACE,  except  that i, if present, becomes the new
                 default number of lines per screenful.

       is        Skip i lines and then print a screenful.

       if        Skip i screenfuls and then print a screenful.

       i^B       (CTRL-B) Skip back i screenfuls and then print a screenful.

       b         Same as ^B (CTRL-D).

       q
       Q         Exit from more.

       =         Display the current line number.

       v         Drop into the bvi(1) editor at the current offset of the cur-
                 rent file.

       w         Drop into the bvi(1) editor at the current offset of the cur-
                 rent file. Only the portion of  the  file  displayed  on  the
                 screen will be loaded.

       h         Help.  Give a description of all the more commands.

       i/pattern Search  for the ith occurrence of the regular expression pat-
                 tern.  Display the screenful starting at  the  file  position
                 that contains the ith match for the regular expression ASCII-
                 pattern, or the end of a pipe,  whichever  comes  first.   If
                 bmore  is  displaying  a file and there is no such match, its
                 position in the file remains unchanged.  Regular  expressions
                 can  be edited using erase and kill characters.  Erasing back
                 past the first column cancels the search command.

       '         Single quote.  Go to the point from  which  the  last  search
                 started.   If  no  search  has  been performed in the current
                 file, go to the beginning of the file.

       !command  Invoke a shell to execute command.  The characters %  and  !,
                 when  used within command are replaced with the current file-
                 name and the previous shell command, respectively.  If  there
                 is  no  current  filename, % is not expanded. Prepend a back-
                 slash to these characters to escape expansion.

       i:n       Skip to the ith next filename given in the command  line,  or
                 to the last filename in the list if i is out of range.

       i:p       Skip  to the ith previous filename given in the command line,
                 or to the first filename if i is  out  of  range.   If  given
                 while  more  is positioned within a file, go to the beginning
                 of the file.  If more is reading from  a  pipe,  more  simply
                 rings the terminal bell.

       :f        Display the current filename and offset number.

       :q
       :Q        Exit from bmore (same as q or Q ).

       .         Dot.  Repeat the previous command.


       FILES
       /etc/termcap        terminal data base
       /usr/local/share/bmore.help
                           help file

SEE ALSO
       bvi(1), termcap(5)



                                  3 Jan 2004                          BMORE(1)