mirror of
https://github.com/Ponce/slackbuilds
synced 2024-11-16 19:50:19 +01:00
193 lines
4.1 KiB
Groff
193 lines
4.1 KiB
Groff
|
.\" Man page generated from reStructuredText.
|
||
|
|
.
|
||
|
|
.
|
||
|
|
.nr rst2man-indent-level 0
|
||
|
|
.
|
||
|
|
.de1 rstReportMargin
|
||
|
|
\\$1 \\n[an-margin]
|
||
|
|
level \\n[rst2man-indent-level]
|
||
|
|
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||
|
|
-
|
||
|
|
\\n[rst2man-indent0]
|
||
|
|
\\n[rst2man-indent1]
|
||
|
|
\\n[rst2man-indent2]
|
||
|
|
..
|
||
|
|
.de1 INDENT
|
||
|
|
.\" .rstReportMargin pre:
|
||
|
|
. RS \\$1
|
||
|
|
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
|
||
|
|
. nr rst2man-indent-level +1
|
||
|
|
.\" .rstReportMargin post:
|
||
|
|
..
|
||
|
|
.de UNINDENT
|
||
|
|
. RE
|
||
|
|
.\" indent \\n[an-margin]
|
||
|
|
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||
|
|
.nr rst2man-indent-level -1
|
||
|
|
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||
|
|
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||
|
|
..
|
||
|
|
.TH "DIS" 1 "2021-08-30" "0.6" "SlackBuilds.org"
|
||
|
|
.SH NAME
|
||
|
|
dis \- dis - statically tracing 6502 disassembler
|
||
|
|
.\" RST source for dis(1) man page. Convert with:
|
||
|
|
.
|
||
|
|
.\" rst2man.py dis.rst > dis.1
|
||
|
|
.
|
||
|
|
.\" rst2man.py comes from the SBo development/docutils package.
|
||
|
|
.
|
||
|
|
.SH SYNOPSIS
|
||
|
|
.sp
|
||
|
|
dis [\fI\-options\fP] file ...
|
||
|
|
.SH DESCRIPTION
|
||
|
|
.sp
|
||
|
|
dis creates XASM/MADS\-compatible assembly code from a memory dump or
|
||
|
|
an executable. dis statically traces execution paths starting from
|
||
|
|
code entry points to mark which memory locations contain code. All
|
||
|
|
other memory is treated as data. dis traces through JMP, JSR and BXX
|
||
|
|
branch instructions. It stops at RTS, RTI and illegal instructions.
|
||
|
|
.sp
|
||
|
|
dis automatically determines common code entry points when
|
||
|
|
disassembling Atari XEX/SAP files and Commodore 64 PRG files.
|
||
|
|
.sp
|
||
|
|
The disassembly is written to standard output.
|
||
|
|
.SH OPTIONS
|
||
|
|
.INDENT 0.0
|
||
|
|
.TP
|
||
|
|
.B \fI\-c\fP \fBL=XXXX\fP
|
||
|
|
Code entry point(s)
|
||
|
|
.TP
|
||
|
|
.B \fI\-d\fP \fBL=XXXX\fP
|
||
|
|
Data location(s) \- Disallow tracing as code
|
||
|
|
.TP
|
||
|
|
.B \fI\-C\fP \fBL=XXXX\fP
|
||
|
|
Constant value(s)
|
||
|
|
.TP
|
||
|
|
.B \fI\-v\fP \fBL=XXXX\fP
|
||
|
|
Vector(s), e.g. FFFA
|
||
|
|
.TP
|
||
|
|
.B \fI\-A\fP \fBL=XXXX\fP
|
||
|
|
Data address(es)
|
||
|
|
.TP
|
||
|
|
.B \fI\-P\fP \fBL=XXXX\fP
|
||
|
|
Code address(es) \- Trace target as code
|
||
|
|
.TP
|
||
|
|
.B \fI\-o\fP \fBL=XXXX\fP
|
||
|
|
Origin for raw files
|
||
|
|
.TP
|
||
|
|
.B \fI\-l\fP
|
||
|
|
Create labels
|
||
|
|
.TP
|
||
|
|
.B \fI\-i\fP
|
||
|
|
Emit illegal opcodes
|
||
|
|
.TP
|
||
|
|
.B \fI\-t\fP \fBTYPE\fP
|
||
|
|
Disassemble as TYPE:
|
||
|
|
.INDENT 7.0
|
||
|
|
.INDENT 3.5
|
||
|
|
.sp
|
||
|
|
.nf
|
||
|
|
.ft C
|
||
|
|
xex \- Atari executable (\-x)
|
||
|
|
sap \- Atari SAP file
|
||
|
|
prg \- Commodore 64 executable (\-p)
|
||
|
|
raw \- raw memory
|
||
|
|
.ft P
|
||
|
|
.fi
|
||
|
|
.UNINDENT
|
||
|
|
.UNINDENT
|
||
|
|
.TP
|
||
|
|
.B \fI\-x\fP
|
||
|
|
Disassemble as Atari executable (same as \fB\-t xex\fP)
|
||
|
|
.TP
|
||
|
|
.B \fI\-p\fP
|
||
|
|
Disassemble as Commodore 64 executable (same as \fB\-t prg\fP)
|
||
|
|
.TP
|
||
|
|
.B \fI\-comment\fP
|
||
|
|
Emit comments
|
||
|
|
.TP
|
||
|
|
.B \fI\-call\fP
|
||
|
|
Emit callers
|
||
|
|
.TP
|
||
|
|
.B \fI\-access\fP
|
||
|
|
Emit accessors
|
||
|
|
.TP
|
||
|
|
.B \fI\-extern\fP
|
||
|
|
Emit labels for out\-of\-range addresses
|
||
|
|
.TP
|
||
|
|
.B \fI\-rangelabels\fP
|
||
|
|
Emit labels for ranges instead of base+offset
|
||
|
|
.TP
|
||
|
|
.B \fI\-verbose\fP
|
||
|
|
Print info to STDERR
|
||
|
|
.TP
|
||
|
|
.B \fI\-dump\fP
|
||
|
|
Print options in format for \-a
|
||
|
|
.TP
|
||
|
|
.B \fI\-dumpequ\fP
|
||
|
|
Print equ statements for all labels
|
||
|
|
.TP
|
||
|
|
.B \fI\-headers\fP
|
||
|
|
Print opt h\- if disabled with \-noheaders
|
||
|
|
.TP
|
||
|
|
.B \fI\-a\fP \fBFILE\fP
|
||
|
|
Read options from FILE. Lines are: OPTION VALUE. If \fBFILE\fP
|
||
|
|
is not found, it will be searched for in \fB/usr/share/dis\fP instead.
|
||
|
|
.UNINDENT
|
||
|
|
.sp
|
||
|
|
Addresses may include a range, e.g. table=$300+F
|
||
|
|
.sp
|
||
|
|
Addresses may include xex segment number, e.g. 3:1FAE
|
||
|
|
.sp
|
||
|
|
Addresses for \-A and \-P may be given as HIGH_LOW, e.g. 3C64_3C62
|
||
|
|
.SH FILES
|
||
|
|
.INDENT 0.0
|
||
|
|
.TP
|
||
|
|
.B \fB/usr/share/dis/*.dop\fP
|
||
|
|
Predefined option files for various platforms, for use with \fI\-a\fP\&.
|
||
|
|
These include:
|
||
|
|
.INDENT 7.0
|
||
|
|
.INDENT 3.5
|
||
|
|
sys.dop, hardware.dop: for use with Atari 8\-bit object code.
|
||
|
|
.sp
|
||
|
|
6510.dop, cia.dop, sid.dop, vic.dop: for use with Commodore 64 object code.
|
||
|
|
.UNINDENT
|
||
|
|
.UNINDENT
|
||
|
|
.UNINDENT
|
||
|
|
.SH COPYRIGHT
|
||
|
|
.sp
|
||
|
|
See the file /usr/doc/dis\-0.6/LICENSE.md for license information.
|
||
|
|
.SH AUTHORS
|
||
|
|
.sp
|
||
|
|
dis was written by Lyren Brown.
|
||
|
|
.sp
|
||
|
|
This man page written for the SlackBuilds.org project
|
||
|
|
by B. Watson, and is licensed under the WTFPL.
|
||
|
|
.SH SEE ALSO
|
||
|
|
.sp
|
||
|
|
The full documentation for \fBdis\fP:
|
||
|
|
.INDENT 0.0
|
||
|
|
.INDENT 3.5
|
||
|
|
.sp
|
||
|
|
.nf
|
||
|
|
.ft C
|
||
|
|
/usr/doc/dis\-0.6/README.md
|
||
|
|
.ft P
|
||
|
|
.fi
|
||
|
|
.UNINDENT
|
||
|
|
.UNINDENT
|
||
|
|
.sp
|
||
|
|
The AtariAge thread:
|
||
|
|
.INDENT 0.0
|
||
|
|
.INDENT 3.5
|
||
|
|
.sp
|
||
|
|
.nf
|
||
|
|
.ft C
|
||
|
|
http://atariage.com/forums/topic/232658\-statically\-tracing\-6502\-disassembler/
|
||
|
|
.ft P
|
||
|
|
.fi
|
||
|
|
.UNINDENT
|
||
|
|
.UNINDENT
|
||
|
|
.\" Generated by docutils manpage writer.
|
||
|
|
.
|