1 <?xml version="1.0" encoding="ISO-8859-1"?>
2 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
3 "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"
5 <!-- entities files to use -->
6 <!ENTITY % global_entities SYSTEM '../entities/global.entities'>
10 <!-- lifted from troff+man+tkman by doclifter -->
11 <refentry id='amdd.8'>
13 <!-- CO listing suppressed (not used) -->
15 <refentrytitle>amdd</refentrytitle>
16 <manvolnum>8</manvolnum>
19 <refname>amdd</refname>
20 <refpurpose>&A; version of dd</refpurpose>
22 <!-- body begins here -->
25 <command>amdd</command>
26 <arg choice='opt'>-d </arg>
27 <arg choice='opt'><replaceable>if=input</replaceable></arg>
28 <arg choice='opt'><replaceable>of=output</replaceable></arg>
29 <arg choice='opt'><replaceable>bs=blocksize</replaceable></arg>
30 <arg choice='opt'><replaceable>skip=count</replaceable></arg>
31 <arg choice='opt'><replaceable>count=count</replaceable></arg>
36 <refsect1><title>DESCRIPTION</title>
37 <para><emphasis remap='B'>Amdd</emphasis>
38 provides just enough of the standard UNIX
39 <emphasis remap='B'>dd</emphasis>
40 command for the needs of &A;.
41 This is handy when doing a full restore and the standard
42 <emphasis remap='B'>dd</emphasis>
43 program has not yet been found.</para>
45 <para><emphasis remap='B'>Amdd</emphasis>
46 also provides access to the &A; output drivers that support various tape simulations.
47 This may be used for debugging or to convert from one format to another.</para>
50 <citerefentry><refentrytitle>amanda</refentrytitle><manvolnum>8</manvolnum></citerefentry>
51 man page for more details about &A;.
53 <emphasis remap='B'>OUTPUT DRIVERS</emphasis>
55 <emphasis remap='I'>amanda(8)</emphasis>
56 for more information on the &A; output drivers.</para>
59 <refsect1><title>OPTIONS</title>
60 <variablelist remap='TP'>
62 <term><option>-d</option></term>
64 <para>Turn on debugging output.</para>
68 <term><option>-l</option><replaceable>length</replaceable></term>
70 <para>Set the output length.
71 If the output driver limits the output size, this controls
72 when end of tape will be simulated.</para>
73 <para><emphasis remap='I'>Length</emphasis>
74 may have a multiplier suffix:</para>
79 M -> 1024*1024 (Megabytes)
82 <para>The default is no multiplier (bytes).</para>
87 <variablelist remap='TP'>
89 <term><emphasis remap='B'>if=</emphasis><emphasis remap='I'>input</emphasis></term>
92 <emphasis remap='B'>dd</emphasis>.
93 Default is stdin.</para>
97 <term><emphasis remap='B'>of=</emphasis><emphasis remap='I'>output</emphasis></term>
99 <para>Where to send the output of
100 <emphasis remap='B'>dd</emphasis>.
101 Default is stdout.</para>
105 <term><emphasis remap='B'>bs=</emphasis><emphasis remap='I'>blocksize</emphasis></term>
107 <para>Size of each record.
108 Input records smaller than this will
109 <emphasis remap='I'>not</emphasis>
111 Output records will be the same size as the corresponding input record.
112 Default is 512 bytes.</para>
113 <para><emphasis remap='I'>Blocksize</emphasis>
114 may have a multiplier suffix:</para>
116 k -> 1024 (Kilobytes)
118 M -> 1024*1024 (Megabytes)
120 <para>The default is no multiplier (bytes).</para>
125 <variablelist remap='TP'>
127 <term><emphasis remap='B'>count=</emphasis><emphasis remap='I'>count</emphasis></term>
129 <para>Number of records to copy.
130 Default is all records until end of file.</para>
134 <term><emphasis remap='B'>skip=</emphasis><emphasis remap='I'>count</emphasis></term>
136 <para>Number of records to skip before copying input to output.
137 Default is zero.</para>
143 <refsect1><title>AUTHOR</title>
144 <para>Marc Mengel <email>mengel@fnal.gov</email>, John R. Jackson
145 <email>jrj@purdue.edu</email> : Original text</para>
146 <para>&maintainer.sgw;: XML-conversion</para>
149 <refsect1><title>SEE ALSO</title>
151 <citerefentry><refentrytitle>amanda</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
152 <ulink url="http://wiki.zmanda.com"/>