diff options
Diffstat (limited to 'plist.1')
| -rw-r--r-- | plist.1 | 84 |
1 files changed, 84 insertions, 0 deletions
@@ -0,0 +1,84 @@ +.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) + |