Penguin
Recent Changes
Annotated edit history of xmllint(1) version 2, including all changes. View license author blame.
Rev Author # Line
1 perry 1 xmllint
2 !!!xmllint
3 NAME
4 SYNOPSIS
5 INTRODUCTION
6 OPTIONS
7 SHELL
8 AUTHOR
9 ----
10 !!NAME
11
12
13 xmllint - command line XML tool
14 !!SYNOPSIS
15
16
17 __xmllint__ [[__--version__ | __--debug__ |
18 __--shell__ | __--debugent__ | __--copy__ |
19 __--recover__ | __--noent__ | __--noout__ |
20 __--htmlout__ | __--nowrap__ | __--valid__ |
21 __--postvalid__ | __--dtdvalid__ ''URL'' |
22 __--timing__ | __--repeat__ | __--insert__ |
23 __--compress__ | __--sgml__ | __--html__ |
24 __--push__ | __--memory__ | __--nowarning__ |
25 __--noblanks__ | __--format__ | __--testIO__ |
26 __--encode__ ''encoding'' | __--catalogs__ |
27 __--nocatalogs__ | __--auto__ | __--xinclude__ |
28 __--loaddtd__ | __--dtdattr__ | __--dropdtd__]
29 [[''xmlfile'']
30 !!INTRODUCTION
31
32
33 The xmllint program parses one or more XML files, specified
34 on the command line as ''xmlfile''. It prints various
35 types of output, depending upon the options selected. It is
36 useful for detecting errors both in XML code and in the XML
37 parser itself.
38
39
40 It is included in libxml2.
41 !!OPTIONS
42
43
44 __--version__
45
46
47 Display the version of libxml2 used.
48
49
50 __--debug__
51
52
53 Parse a file and output an annotated tree of the in-memory
54 version of the document.
55
56
57 __--shell__
58
59
60 Run a navigating shell. Details on available commands in
61 shell mode are below.
62
63
64 __--debugent__
65
66
67 Debug the entities defined in the document.
68
69
70 __--copy__
71
72
73 Test the internal copy implementation.
74
75
76 __--recover__
77
78
79 Output any parsable portions of an invalid
80 document.
81
82
83 __--noent__
84
85
86 Substitute entity values for entity references. By default,
87 xmllint leaves entity references in place.
88
89
90 __--noout__
91
92
93 Suppress output. By default, xmllint outputs the result
94 tree.
95
96
97 __--htmlout__
98
99
100 Output results as an HTML file. This causes xmllint to
101 output the necessary HTML tags surrounding the result tree
102 output so the results can be displayed in a
103 browser.
104
105
106 __--nowrap__
107
108
109 Do not output HTML doc wrapper.
110
111
112 __--valid__
113
114
115 Determine if the document is a valid instance of the
116 included Document Type Definition (DTD). A DTD to be
117 validated against also can be specified at the command line
118 using the __--dtdvalid__ option. By default, xmllint also
119 checks to determine if the document is
120 well-formed.
121
122
123 __--postvalid__
124
125
126 Validate after parsing is completed.
127
128
129 __--dtdvalid__ ''URL''
130
131
132 Use the DTD specified by ''URL'' for
133 validation.
134
135
136 __--timing__
137
138
139 Output information about the time it takes xmllint to
140 perform the various steps.
141
142
143 __--repeat__
144
145
146 Repeat 100 times, for timing or profiling.
147
148
149 __--insert__
150
151
152 Test for valid insertions.
153
154
155 __--compress__
156
157
158 Turn on gzip compression of output.
159
160
161 __--sgml__
162
163
2 perry 164 Use the !DocBook SGML parser. This allows documents written
165 in SGML !DocBook to be converted into an in-memory tree and
1 perry 166 treated as if they were written in XML.
167
168
169 __--html__
170
171
172 Use the HTML parser.
173
174
175 __--push__
176
177
178 Use the push mode of the parser.
179
180
181 __--memory__
182
183
184 Parse from memory.
185
186
187 __--nowarning__
188
189
190 Do not emit warnings from the parser and/or
191 validator.
192
193
194 __--noblanks__
195
196
197 Drop ignorable blank spaces.
198
199
200 __--format__
201
202
203 Reformat and reindent the output.
204
205
206 __--testIO__
207
208
209 Test user input/output support.
210
211
212 __--encode__ ''encoding''
213
214
215 Output in the given encoding.
216
217
218 __--catalogs__
219
220
221 Use the catalogs from $SGML_CATALOG_FILES. Otherwise
222 /etc/xml/catalog is used by default.
223
224
225 __--nocatalogs__
226
227
228 Do not use any catalogs.
229
230
231 __--auto__
232
233
234 Generate a small document for testing purposes.
235
236
237 __--xinclude__
238
239
240 Do XInclude processing.
241
242
243 __--loaddtd__
244
245
246 Fetch external DTD.
247
248
249 __--dtdattr__
250
251
252 Fetch external DTD and populate the tree with inherited
253 attributes.
254
255
256 __--dropdtd__
257
258
259 Remove DTD from output.
260 !!SHELL
261
262
263 xmllint offers an interactive shell mode invoked with the
264 __--shell__ command. Available commands in shell mode
265 include:
266
267
268 __base__
269
270
271 display XML base of the node
272
273
274 __bye__
275
276
277 leave shell
278
279
280 __cat__ ''node''
281
282
283 Display node if given or current node.
284
285
286 __cd__ ''path''
287
288
289 Change the current node to ''path'' (if given and unique)
290 or root if no argument given.
291
292
293 __dir__ ''path''
294
295
296 Dumps information about the node (namespace, attributes,
297 content).
298
299
300 __du__ ''path''
301
302
303 Show the structure of the subtree under path or the current
304 node.
305
306
307 __exit__
308
309
310 Leave the shell.
311
312
313 __help__
314
315
316 Show this help.
317
318
319 __free__
320
321
322 Display memory usage.
323
324
325 __load__ ''name''
326
327
328 Load a new document with the given name.
329
330
331 __ls__ ''path''
332
333
334 List contents of ''path'' (if given) or the current
335 directory.
336
337
338 __pwd__
339
340
341 Display the path to the current node.
342
343
344 __quit__
345
346
347 Leave the shell.
348
349
350 __save__ ''name''
351
352
353 Saves the current document to ''name'' if given or to the
354 original name.
355
356
357 __validate__
358
359
360 Check the document for error.
361
362
363 __write__ ''name''
364
365
366 Write the current node to the given filename.
367 !!AUTHOR
368
369
370 Copyright 2001
371
372
373 John Fleck
374 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.