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
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
|
.TH ASNTOOL 1 2016-09-01 NCBI "NCBI Tools User's Manual"
.SH NAME
asntool \- process ASN.1 module specifications
.SH SYNOPSIS
.B asntool
[\|\fB\-\fP\|]
[\|\fB\-B\fP\ \fIfilename\fP\|]
[\|\fB\-D\fP\ \fIN\fP\|]
[\|\fB\-F\fP\ \fIN\fP\|]
[\|\fB\-G\fP\|]
[\|\fB\-I\fP\ \fIstr\fP\|]
[\|\fB\-J\fP\ \fItype\fP\|]
[\|\fB\-K\fP\ \fIstr\fP\|]
[\|\fB\-L\fP\ \fIstr\fP\|]
[\|\fB\-M\fP\ \fIfilename,...\fP\|]
[\|\fB\-N\fP\ \fIN\fP\|]
[\|\fB\-P\fP\ \fIstr\fP\|]
[\|\fB\-Q\fP\|]
[\|\fB\-S\fP\ \fIfilename\fP\|]
[\|\fB\-T\fP\ \fIfilename\fP\|]
[\|\fB\-U\fP\ \fIN\fP\|]
[\|\fB\-V\fP\|]
[\|\fB\-X\fP\ \fIfilename\fP\|]
[\|\fB\-Z\fP\|]
[\|\fB\-b\fP\ \fIN\fP\|]
[\|\fB\-d\fP\ \fIfilename\fP\|]
[\|\fB\-e\fP\ \fIfilename\fP\|]
[\|\fB\-f\fP\ \fIfilename\fP\|]
[\|\fB\-l\fP\ \fIfilename\fP\|]
\fB\-m\fP\ \fIfilename\fP
[\|\fB\-o\fP\ \fIfilename\fP\|]
[\|\fB\-p\fP\ \fIfilename\fP\|]
[\|\fB\-t\fP\ \fIstr\fP\|]
[\|\fB\-v\fP\ \fIfilename\fP\|]
[\|\fB\-w\fP\ \fIN\fP\|]
[\|\fB\-x\fP\ \fIfilename\fP\|]
.SH DESCRIPTION
\fBasntool\fP reads, validates, and displays ASN.1 module specifications.
.SH OPTIONS
A summary of options is included below.
.TP
\fB\-\fP
Print usage message
.TP
\fB\-B\fP\ \fIfilename\fP
Generate objects and code in files named \fIfilename\fP.*
.TP
\fB\-D\fP\ \fIN\fP
Debugging level for code generation:
.RS
.PD 0
.IP 0
No debugging (default)
.IP 1
Shallow debugging
.IP 2
Deep debugging
.IP 3-9
Same as 2
.PD
.RE
.TP
\fB\-F\fP\ \fIN\fP
Fix non-printing characters:
.RS
.PD 0
.IP 0
Replace with #, post ERROR (default)
.IP 1
Replace with # silently
.IP 2
Pass through silently
.IP 3
Replace with #, post FATAL
.PD
.RE
.TP
\fB\-G\fP
Generate object loader .c and .h files
.TP
\fB\-I\fP\ \fIstr\fP
Put "#include \fIstr\fP" in generated .c file
.TP
\fB\-J\fP\ \fItype\fP
Register type \fItype\fP with object manager
.TP
\fB\-K\fP\ \fIstr\fP
In generated .c, force name of #included asn header to \fIstr\fP
.TP
\fB\-L\fP\ \fIstr\fP
Label registered type as \fIstr\fP
.TP
\fB\-M\fP\ \fIfilename,...\fP
Search the ASN.1 modules in \fIfilename,...\fP for external references
.TP
\fB\-N\fP\ \fIN\fP
UTF8 input conversion:
.RS
.PD 0
.IP 0
Convert silently (default)
.IP 1
Convert, post WARNING first time
.IP 2
Convert, post WARNING each time
.IP 3
Do not convert
.PD
.RE
.TP
\fB\-P\fP\ \fIstr\fP
XML module prefix for \fBDOCTYPE\fP
.TP
\fB\-Q\fP
Use quoted syntax form for generated include files
.TP
\fB\-S\fP\ \fIfilename\fP
Send debugging output to \fIfilename\fP rather than stderr
.TP
\fB\-T\fP\ \fIfilename\fP
Dump ASN.1 tree to \fIfilename\fP
.TP
\fB\-U\fP\ \fIN\fP
UTF8 output conversion:
.RS
.PD 0
.IP 0
Convert silently (default)
.IP 1
Convert, post WARNING first time
.IP 2
Convert, post WARNING each time
.IP 3
Do not convert
.PD
.RE
.TP
\fB\-V\fP
Force CHOICE objects to use custom structures rather than ValNodePtrs,
for compatibility with some old hand-coded object loaders.
.TP
\fB\-X\fP\ \fIfilename\fP
Write XML DTD to \fIfilename\fP. If \fIfilename\fP is "m", print each
module to a separate file.
.TP
\fB\-Z\fP
Bit twiddle for optional zero value base slots
.TP
\fB\-b\fP\ \fIN\fP
Use \fIN\fP-byte buffers (default = 1024; anything between 512 and
10000 is legal)
.TP
\fB\-d\fP\ \fIfilename\fP
Read binary values from \fIfilename\fP (requires \fB\-t\fP)
.TP
\fB\-e\fP\ \fIfilename\fP
Write binary values to \fIfilename\fP
.TP
\fB\-f\fP\ \fIfilename\fP
Write ASN.1 module to \fIfilename\fP
.TP
\fB\-l\fP\ \fIfilename\fP
Write ASN.1 loader to \fIfilename\fP
.TP
\fB\-m\fP\ \fIfilename\fP
Read ASN.1 module from \fIfilename\fP
.TP
\fB\-o\fP\ \fIfilename\fP
Write header to \fIfilename\fP
.TP
\fB\-p\fP\ \fIfilename\fP
Write print values to \fIfilename\fP
.TP
\fB\-t\fP\ \fIstr\fP
Expect binary values to have type \fIstr\fP
.TP
\fB\-v\fP\ \fIfilename\fP
Read print values from \fIfilename\fP
.TP
\fB\-w\fP\ \fIN\fP
Limit values in #defines to \fIN\fP bits (default = 31; anything
between 31 and 128 is legal)
.TP
\fB\-x\fP\ \fIfilename\fP
Write XML data to \fIfilename\fP
.SH AUTHOR
The National Center for Biotechnology Information.
|
