1 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN"
2 "http://www.oasis-open.org/docbook/xml/4.1/docbookx.dtd"
4 <!-- $Id: yaz-marcdump-man.xml,v 1.7 2006-04-24 12:41:00 marc Exp $ -->
5 <refentry id="yaz-marcdump">
7 <refentrytitle>yaz-marcdump</refentrytitle>
8 <manvolnum>1</manvolnum>
12 <refname>yaz-marcdump</refname>
13 <refpurpose>MARC record dump utility</refpurpose>
18 <command>yaz-marcdump</command>
19 <arg choice="opt"><option>-x</option></arg>
20 <arg choice="opt"><option>-X</option></arg>
21 <arg choice="opt"><option>-e</option></arg>
22 <arg choice="opt"><option>-I</option></arg>
23 <arg choice="opt"><option>-f <replaceable>from</replaceable></option></arg>
24 <arg choice="opt"><option>-t <replaceable>to</replaceable></option></arg>
25 <arg choice="opt"><option>-v</option></arg>
26 <arg choice="opt"><option>-c <replaceable>cfile</replaceable></option></arg>
27 <arg choice="opt" rep="repeat">file</arg>
31 <refsect1><title>DESCRIPTION</title>
33 <command>yaz-marcdump</command> reads MARC records from one or
35 It parses each record and supports output in line-format,
36 ISO2709, MARCXML, MarcXchange as well as Hex output.
39 This utility parses records ISO2709(raw MARC) as well as XML
40 if that is structured as MARCXML/MarcXchange.
44 As of YAZ 2.1.18, OAI-MARC is no longer supported.
45 OAI-MARC is deprecated. Use MARCXML instead.
49 By default, each record is written to standard output in a line
50 format with newline for each field, $x for each subfield x.
51 The output format may be changed with options <literal>-X</literal>,
52 <literal>-e</literal>, <literal>-I</literal>.
55 <command>yaz-marcdump</command> can also be requested to perform
56 character set conversion of each record.
60 <refsect1><title>OPTIONS</title>
66 Reads MARC records in MARCXML/MarcXchange format. Without
67 this option, <command>yaz-marcdump</command> reads records
75 Writes MARC records in MARCXML.
76 This format is equivalent to YAZ_MARC_MARCXML in
77 <filename>yaz/marcdisp.h</filename>.
84 Writes MARC records in MarcXchange format.
85 This format is equivalent to YAZ_MARC_XCHANGE in
86 <filename>yaz/marcdisp.h</filename>.
93 Writes MARC records in ISO2709 format.
94 This format is equivalent to YAZ_MARC_ISO2709 in
95 <filename>yaz/marcdisp.h</filename>.
100 <term>-f<replaceable>from</replaceable>]</term>
102 Specify the character set <replaceable>from</replaceable>
103 of the input MARC record.
104 Should be used in conjunction with option <literal>-t</literal>.
109 <term>-t<replaceable>to</replaceable>]</term>
111 Specify the character set <replaceable>of</replaceable>
113 Should be used in conjunction with option <literal>-f</literal>.
120 Writes more information about the parsing process.
121 Useful if you have ill-formatted ISO2709 records as input.
128 <refsect1><title>EXAMPLES</title>
130 The following command converts MARC21/USMARC in MARC-8 encoding to
131 MARC21/USMARC in UTF-8 encoding. (Both input and output is in ISO2709).
133 yaz-marcdump -f MARC-8 -t UTF-8 -I marc21.raw >marc21.utf8.raw
137 The same records may be converted to MARCXML instead in UTF-8:
139 yaz-marcdump -f MARC-8 -t UTF-8 -X marc21.raw >marcxml.xml
144 <refsect1><title>FILES</title>
146 <filename><replaceable>prefix</replaceable>/bin/yaz-marcdump</filename>
149 <filename><replaceable>prefix</replaceable>/include/yaz/marcdisp.h</filename>
152 <refsect1><title>SEE ALSO</title>
159 <!-- Keep this Emacs mode comment at the end of the file