Manual Page Result
0
Command: btou | Section: 1 | Source: Digital UNIX | File: btou.1.gz
btou(1) General Commands Manual 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 out-
put. 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: Turns off indentation
when printing the ucode instructions. Any error detected in the order-
ing of the ucode instructions will not be detected.
NOTES
If the input file is not a valid binary ucode file, btou can behave er-
ratically and produce useless output.
ERRORS
The btou converter detects any error in the ordering of the ucode in-
structions. 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 in-
structions can be printed in their original order by using the -n flag.
RELATED INFORMATION
utob(1) delim off
btou(1)