Index

prism - PROSE Assembly Language assembler and disassembler

CONTENTS

Synopsis
Description
Options
Environment Variables
See Also
Author

prism [-D n|n1-n2] [-a] [-o output_file] [-e maxerrs] [source_file]

prism [-D n|n1-n2] -m source_file ...

prism [-D n|n1-n2] -d binary_file
prism [-D n|n1-n2] -v binary_file
prism -l
prism --help
prism --version

Assembles PROSE Assembly Language (PAL) source files into PROSE binary files, and disassembles or displays information on a previously assembled binary. PAL source files are ordinarily recognised by their .pal extension, while a PROSE binary file has a .pro extension.

In the first synopsis form, the -a argument is optional. The source_file is assembled into a binary file. If no filename is supplied, then standard input is assembled instead. If not specified with the -o argument, the output filename will match the name of the input filename, except it will use a .pro extension. If standard input was being assembled, the output filename will default to stdin.pro.

In the second synopsis form, the -m argument allows multiple source files to be assembled.

In the third synopsis form, the -d argument requests that the specified PROSE binary file is disassembled. The output of the disassembly process should match the original assembled source, with the exception of comments and argument formatting. Also, data segments will not appear in their original position in the source code, as they are disassembled first.

In the fourth synopsis form, the -v argument requests detailed information on the specified PROSE binary file. This will display data from headers, code tables, address and string tables, and will display the contents of all data segments.

In the fifth synopsis form, the -l argument displays all symbols known to the assembler. This lists assembly instructions, registers and their opcodes, as well as all macros.

Running prism --help displays a summary of the available command-line options, and prism --version displays version information and compilation date.

-D n|n1-n2
	enable debug mode, reporting debug messages at level n, or between the levels of n1 and n2. There are a number of debug levels available, ranging from 1-127, where 1 is the least amount of information. Debug levels from 50 and above are only available if the tool has been compiled with the ENABLE_EXTRADEBUG flag. Some example debug levels are level 10 that will display the file names being processed, and level 30 that displays the code offset positions of the instructions being processed (especially useful when disassembling).
-a	assemble a PAL source_file, or standard input.
-d	disassemble a PROSE binary file.
-e maxerrs
	maximum number of errors that will be tolerated by the assembler before parsing the source file should cease (default 10).
-l	list PAL instructions, registers and their opcodes supported by this assembler.
-o	specify a different output binary file when assembling.
-v	view detailed information on a PROSE binary file.

The following environment variables may also be used in place of command-line options. If the command-line option is also given, its value will take precedence.

PRISM_DEBUG
	Debug level, as -D above.

prose(1), libpal(3), pal_intro(5), pal_commands(5), pal_macros(5).

Copyright (c) 2002-2010 Mark R. Bannister <cambridge@users.sourceforge.net>.

This is free software and can be downloaded from prose.sourceforge.net; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.