85 lines
1.9 KiB
Groff
85 lines
1.9 KiB
Groff
.TH plist 1
|
|
|
|
.SH NAME
|
|
.B plist \- list contents of output files generated by AS
|
|
|
|
.SH SYNTAX
|
|
.B plist
|
|
[ file name ]
|
|
|
|
.SH DESCRIPTION
|
|
|
|
PLIST is a program to list the contents of code output files generated by
|
|
AS, a cross assembler for a variety of microprocessors and -controllers.
|
|
PLIST takes only one argument: the name of the file to list. If [ name ]
|
|
does not have an extension, the default extension '.p' will be added
|
|
automatically. The output consists of a single line for each record in
|
|
the file, listing the target processor, target address space, number of
|
|
code/data bytes, and start/stop address. Note that the difference between
|
|
the start and stop address need not equal the number of bytes, since there
|
|
are target processors whose memory is not bytewise-organized. The records
|
|
that specify entry address and file creator have a different layout and
|
|
therefore have a little bit different look in PLIST's output.
|
|
|
|
PLIST does not accept multiple file arguments; processing of several files
|
|
must be done with individual calls.
|
|
|
|
.SH COMMAND-LINE PARAMETERS
|
|
|
|
none.
|
|
|
|
.SH NATIONAL LANGUAGE SUPPORT
|
|
|
|
plist supports national languages in the same way as AS. See the manual
|
|
page for asl(1) for maore information about this.
|
|
|
|
.SH RETURN CODES
|
|
|
|
.B plist
|
|
may return with the following codes:
|
|
.TP
|
|
.B 0
|
|
no errors.
|
|
.TP
|
|
.B 1
|
|
incorrect command line parameters.
|
|
.TP
|
|
.B 2
|
|
I/O-error.
|
|
.TP
|
|
.B 3
|
|
An input file had an incorrect format.
|
|
|
|
.SH EXAMPLES
|
|
|
|
To list the contents of a code file
|
|
.B file1.p,
|
|
use:
|
|
.PP
|
|
.B plist file1
|
|
.PP
|
|
There aren't more meaningful examples, as PLIST does not have
|
|
any command line parameters.
|
|
|
|
.SH TIPS
|
|
|
|
If PLIST is started without any argument, it will prompt for a file's name.
|
|
|
|
.SH SEE ALSO
|
|
|
|
asl(1), pbind(1), p2hex(1), p2bin(1)
|
|
|
|
.SH HISTORY
|
|
|
|
PLIST originally appeared as an AS tool in 1992, written in
|
|
Borland-Pascal, and was ported to C and UNIX in 1996.
|
|
|
|
.SH BUGS
|
|
|
|
There are too few options.
|
|
|
|
.SH AUTHOR(S)
|
|
|
|
Alfred Arnold (a.arnold@kfa-juelich.de)
|
|
|