Content-type: text/html Man page of btou

btou

Section: User Commands (1)
Index Return to Main Contents
 

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: 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)


 

Index

NAME
SYNOPSIS
DESCRIPTION
NOTES
ERRORS
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:42:45 GMT, October 02, 2010