File: asxxxx.1

package info (click to toggle)
sdcc 4.5.0%2Bdfsg-1
  • links: PTS, VCS
  • area: main
  • in suites: sid, trixie
  • size: 112,804 kB
  • sloc: ansic: 622,685; cpp: 259,454; makefile: 81,253; sh: 40,203; asm: 19,222; perl: 12,139; yacc: 7,761; awk: 3,378; lisp: 1,677; python: 1,097; lex: 1,028; sed: 76
file content (139 lines) | stat: -rw-r--r-- 3,232 bytes parent folder | download | duplicates (5)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
.TH ASXXXX 1 
.SH NAME
ASxxxx \- Series of microprocessor cross assemblers for SDCC.
.SH SYNOPSIS
.B sdas8051
.I "[options] file1 [file2 file3 ... file6]"
.br
.B sdasgb
.I "[options] file1 [file2 file3 ... file6]"
.br
.B sdasz80
.I "[options] file1 [file2 file3 ... file6]"
.br
.B sdas6808
.I "[options] file1 [file2 file3 ... file6]"
.br
.B sdas390
.I "[options] file1 [file2 file3 ... file6]"
.br
.B sdasrab
.I "[options] file1 [file2 file3 ... file6]"
.br
.B sdasstm8
.I "[options] file1 [file2 file3 ... file6]"
.br
.B sdastlcs90
.I "[options] file1 [file2 file3 ... file6]"
.br  
.SH WARNING
The information in this man page is an extract from the full
documentation of 
.B SDCC\c
\&, and is limited to the meaning of the options.
.PP
For complete and current documentation, refer to the
.B
ASxxxx Cross Assembler Documentation\c
\&, available in /usr/share/doc/sdcc-doc/aslink.
.SH "DESCRIPTION"
The
.B ASxxxx\c
\& assemblers are a series of microprocessor assemblers. Each assembler has
a device specific section. 
.PP
.B MCS51\c
\& family is supported by 
.B sdas8051\c
\&.
.br
.B Z80\c 
\&family is supported by
.B sdasz80\c
\&.
.br
.B GBZ80\c
\& (GameBoy Z80-like CPU) is supported by
.B sdasgb\c
\&.
.br
.B Motorola 6808\c
\& family is supported by
.B sdas6808\c
\&.
.SH OPTIONS
The  ASxxxx assemblers are command line oriented. The PC assemblers are 
started with the appropriate option(s) and file(s) to assemble following 
the assembler name.
.TP
.BI "\-d"
decimal listing.
.TP
.BI "\-q"
octal listing.
.TP
.BI "\-x"
hex listing (default)
.PP
The listing radix affects the .lst, .rel, and .sym files.
.TP
.BI "\-j"
add line number and debug information to file.
.TP
.BI "\-g"
undefined symbols made global.
.TP
.BI "\-a"
all user symbols made global.
.TP
.BI "\-l"
create list output file1.lst.
.TP
.BI "\-o"
create object output file1.rel.
.TP
.BI "\-s"
create symbol output file1.sym.
.TP
.BI "\-c"
generate sdcdb debug information
.TP
.BI "\-p"
disable listing pagination.
.TP
.BI "\-w"
wide listing format for symbol table.
.TP
.BI "\-z"
enable case sensitivity for symbols.
.TP
.BI "\-f"
flag relocatable references by ` in the listing file.
.TP
.BI "\-ff"
flag relocatable reference by mode in the listing file.
.TP
.BI "\-I"
add the named directory to the include file
search path.  This option may be used more than once.
Directories are searched in the order given.
.PP
The file name for the .lst, .rel, and .sym files is the first file name 
specified in the command line. All output files are ascii text files which 
may be edited, copied, etc. The output files are the concatenation of all 
the input files, if files are to be assembled independently invoke the 
assembler for each file.  
.PP
The .rel file contains a radix directive so that the linker will use the 
proper conversion for this file. Linked files may have different radices.  
.PP
If the list 
.B (l)\c
\& option is specified without the symbol table
.B (s)\c
\& option, the symbol table is placed at the end of the listing file.  
.SH SEE ALSO
sdcc(1), aslink(1), asx8051, as-z80(1), as-gbz80(1).
.SH AUTHOR
This manual page was written by Aurelien Jarno <aurel32@debian.org>,
for the Debian GNU/Linux system (but may be used by others).