Index for Section 1

Alphabetical listing for B

btou(1)
NAME
  btou - Binary ucode to ASCII ucode converter

SYNOPSIS
  btou binary_file [text_file] [-n]

DESCRIPTION
  The btou converter reads the binary ucode file and writes it in ASCII form
  to the file specified in the command line. It checks the version stamp of
  the ucode file, and if it does not correspond to its own stamp, a warning
  message will be printed. By convention, ASCII ucode files have the
  extension .U and  binary ucode files have the extension .B, but btou does
  not force this convention on the user. If the text file name is not given,
  the ASCII ucode is written to the standard output. The btou converter
  indents the ucode instructions to reflect their nesting levels within
  expressions, for easier readability.

  The btou converter also reads the source file that generates the binary
  ucode and prints the source line next to each LOC instruction as a COMM
  ucode instruction. If the source file is not found, this operation is not
  performed.  Because of these additional COMM ucode instructions, the output
  ucode file actually contains more ucode instructions than the input ucode
  file.

  The following options are interpreted by btou:

  -n  Turns off indentation when printing the ucode instructions.  Any error
      detected in the ordering of the ucode instructions will not be
      detected.

NOTES
  If the input file is not a valid binary ucode file, btou can behave
  erratically and produce useless output.

ERRORS
  The btou converter detects any error in the ordering of the ucode
  instructions. Such errors are detected while it recognizes the nesting
  levels of expressions, and it outputs the error messages. When such error
  occurs, the ucode instructions printed may not correspond to the original
  order in the input file.  In such a situation, the ucode instructions can
  be printed in their original order by using the -n option.








SEE ALSO
  utob(1)