git.gag.com Git - debian/amanda/blob - man/xml-source/amdd.8.xml

   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"
   4 [
   5   <!-- entities files to use -->
   6   <!ENTITY % global_entities SYSTEM '../entities/global.entities'>
   7   %global_entities;
   8 ]>
   9
  10 <!-- lifted from troff+man+tkman by doclifter -->
  11 <refentry id='amdd.8'>
  12
  13 <!-- CO listing suppressed (not used) -->
  14 <refmeta>
  15 <refentrytitle>amdd</refentrytitle>
  16 <manvolnum>8</manvolnum>
  17 </refmeta>
  18 <refnamediv>
  19 <refname>amdd</refname>
  20 <refpurpose>&A; version of dd</refpurpose>
  21 </refnamediv>
  22 <!-- body begins here -->
  23 <refsynopsisdiv>
  24 <cmdsynopsis>
  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>
  32 </cmdsynopsis>
  33 </refsynopsisdiv>
  34
  35
  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>
  44
  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>
  48
  49 <para>See the
  50 <citerefentry><refentrytitle>amanda</refentrytitle><manvolnum>8</manvolnum></citerefentry>
  51 man page for more details about &A;.
  52 See the
  53 <emphasis remap='B'>OUTPUT DRIVERS</emphasis>
  54 section of
  55 <emphasis remap='I'>amanda(8)</emphasis>
  56 for more information on the &A; output drivers.</para>
  57 </refsect1>
  58
  59 <refsect1><title>OPTIONS</title>
  60 <variablelist remap='TP'>
  61   <varlistentry>
  62   <term><option>-d</option></term>
  63   <listitem>
  64 <para>Turn on debugging output.</para>
  65   </listitem>
  66   </varlistentry>
  67   <varlistentry>
  68   <term><option>-l</option><replaceable>length</replaceable></term>
  69   <listitem>
  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>
  75
  76 <literallayout>
  77 k -> 1024 (Kilobytes)
  78 b -> 512 (Blocks)
  79 M -> 1024*1024 (Megabytes)
  80 </literallayout>
  81
  82 <para>The default is no multiplier (bytes).</para>
  83   </listitem>
  84   </varlistentry>
  85 </variablelist>
  86
  87 <variablelist remap='TP'>
  88   <varlistentry>
  89   <term><emphasis remap='B'>if=</emphasis><emphasis remap='I'>input</emphasis></term>
  90   <listitem>
  91 <para>Input to
  92 <emphasis remap='B'>dd</emphasis>.
  93 Default is stdin.</para>
  94   </listitem>
  95   </varlistentry>
  96   <varlistentry>
  97   <term><emphasis remap='B'>of=</emphasis><emphasis remap='I'>output</emphasis></term>
  98   <listitem>
  99 <para>Where to send the output of
 100 <emphasis remap='B'>dd</emphasis>.
 101 Default is stdout.</para>
 102   </listitem>
 103   </varlistentry>
 104   <varlistentry>
 105   <term><emphasis remap='B'>bs=</emphasis><emphasis remap='I'>blocksize</emphasis></term>
 106   <listitem>
 107 <para>Size of each record.
 108 Input records smaller than this will
 109 <emphasis remap='I'>not</emphasis>
 110 be padded.
 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>
 115 <literallayout>
 116 k -> 1024 (Kilobytes)
 117 b -> 512 (Blocks)
 118 M -> 1024*1024 (Megabytes)
 119 </literallayout>
 120 <para>The default is no multiplier (bytes).</para>
 121   </listitem>
 122   </varlistentry>
 123 </variablelist>
 124
 125 <variablelist remap='TP'>
 126   <varlistentry>
 127   <term><emphasis remap='B'>count=</emphasis><emphasis remap='I'>count</emphasis></term>
 128   <listitem>
 129 <para>Number of records to copy.
 130 Default is all records until end of file.</para>
 131   </listitem>
 132   </varlistentry>
 133   <varlistentry>
 134   <term><emphasis remap='B'>skip=</emphasis><emphasis remap='I'>count</emphasis></term>
 135   <listitem>
 136 <para>Number of records to skip before copying input to output.
 137 Default is zero.</para>
 138   </listitem>
 139   </varlistentry>
 140 </variablelist>
 141 </refsect1>
 142
 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>
 147 </refsect1>
 148
 149 <refsect1><title>SEE ALSO</title>
 150 <para><citerefentry><refentrytitle>amanda</refentrytitle><manvolnum>8</manvolnum></citerefentry></para>
 151 </refsect1>
 152 </refentry>
 153