File: diffindex-download.1.sgml

package info (click to toggle)
apt-file 2.5.1
  • links: PTS, VCS
  • area: main
  • in suites: wheezy
  • size: 608 kB
  • sloc: perl: 1,246; python: 132; makefile: 99; sh: 87
file content (154 lines) | stat: -rw-r--r-- 3,601 bytes parent folder | download | duplicates (3)
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
<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
<refentry>
  <refentryinfo>
    <address>
      <email>sf@debian.org</email>
    </address>
    <author>
      <firstname>Stefan</firstname>
      <surname>Fritsch</surname>
    </author>
    <date>January 2009</date>
  </refentryinfo>

  <refmeta>
    <refentrytitle>diffindex-download</refentrytitle>
    <manvolnum>1</manvolnum>
  </refmeta>

  <refnamediv>
    <refname>diffindex-download</refname>
    <refpurpose>
      Download utility for Debian Contents files
    </refpurpose>
  </refnamediv>

  <refsynopsisdiv>
    <cmdsynopsis>
      <command>diffindex-download</command>
      <arg><option>options</option></arg>
      <arg choice="Req">URL</arg>
      <arg choice="Req">filename</arg>
    </cmdsynopsis>
  </refsynopsisdiv>

  <refsect1>
    <title>DESCRIPTION</title>
    <para><command>diffindex-download</command> is a command line tool for
      downloading Contents files. It uses APT's diff/Index format patches when
      available to avoid downloading the full file.
      <command>diffindex-download</command> is used by
      <command>apt-file</command>.</para>
  </refsect1>

  <refsect1>
    <title>OPTIONS</title>
    <variablelist>
      <varlistentry>
	<term>
	  <option>-n</option> <literal>number</literal>
	</term>
	<listitem>
	  <para>
	    If more than <literal>number</literal> patches would be necessary,
            download the whole file. Specifying 0 to always download the whole
            file is possible.
	  </para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>
	  <option>-k</option>
	</term>
	<listitem>
	  <para>
	    Don't verify the peer certificate when using https.
	  </para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>
	  <option>-c</option> <literal>cacert</literal>
	</term>
	<listitem>
	  <para>
	    If <literal>cacert</literal> is a directory: Use
	    <literal>cacert</literal> as CA certificate path. Otherwise use
	    <literal>cacert</literal> as CA certificate bundle. See the
	    <literal>--capath</literal> and <literal>--cacert</literal>
	    options in the <command>curl</command>(1) man page.
	  </para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>
	  <option>-i</option>
	</term>
	<listitem>
	  <para>
	    Don't exit with errror if the URL does not exist. This is useful
            as some archives don't provide Contents files.
	  </para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>
	  <option>-q</option>
	</term>
	<listitem>
	  <para>
            Be quiet (opposite of -v). The default if stdout is not a terminal.
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>
	  <option>-v</option>
	</term>
	<listitem>
	  <para>
            Be verbose (opposite of -q). The default if stdout is a terminal.
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>
	  <option>-d</option>
	</term>
	<listitem>
	  <para>
	  Print additional debug info.
	  </para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>
	  <option>-h</option>
	</term>
	<listitem>
	  <para>Display a short help screen.</para>
	</listitem>
      </varlistentry>
    </variablelist>
  </refsect1>

  <refsect1>
    <title>SEE ALSO</title>
    <para>
      <command>apt-file</command>(1), <command>diffindex-rred</command>(1),
      <command>curl</command>(1)
    </para>
  </refsect1>
  <refsect1>
    <title>AUTHOR</title>
    <para>
      <command>diffindex-download</command> was written by Stefan Fritsch
      <email>sf@debian.org</email>.
    </para>
  </refsect1>
</refentry>