File: index.html

package info (click to toggle)
dar 2.6.13-2
  • links: PTS
  • area: main
  • in suites: bullseye
  • size: 10,364 kB
  • sloc: cpp: 77,385; sh: 6,192; ansic: 776; makefile: 435; python: 242; csh: 95; perl: 43; sed: 16
file content (298 lines) | stat: -rw-r--r-- 13,214 bytes parent folder | download
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
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head>






  <meta content="text/html; charset=ISO-8859-1" http-equiv="content-type"><title>Dar's Documentation</title></head><body style="background-color: rgb(221, 221, 221); color: rgb(0, 0, 170);" alink="#ff0000" link="#0000ff" vlink="#000055">
<center>
<div style="text-align: center;"><img style="width: 320px; height: 240px;" alt="DAR's Documentation" src="dar_doc.jpg"><br>
<br>
</div><div style="text-align: center;">
<table style="width: 90%; text-align: left; margin-right: auto; margin-left: auto;" border="0" cellpadding="2" cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;">
      <h2 style="text-align: justify;"><a name="Summary"></a>Summary</h2>

      <div style="text-align: justify; margin-left: 40px;">This is the summary page for <a href="http://dar.linux.free.fr/">dar</a>'s
documentation<br>
      </div>
      <ol style="text-align: justify;">

        <ol>
          <li><a href="presentation.html">Presentation</a></li>
          <li><a href="#obtaining">Obtaing dar/libdar</a><br>
        </li>
          <li><a href="#command_line">Command-line tools usage</a></li>
          <li><a href="#libdar">Libdar and its API</a><br>
        </li>
          <li><a href="#3">Dar/libdar internals<br>
</a></li>
          <li><a href="#actions"><span style="text-decoration: underline;">Actions</span></a></li>
</ol>
      </ol>

      </td>
    </tr>
  </tbody>
</table>
</div>
<hr style="width: 100%; height: 2px;"><br>
<table style="width: 90%; text-align: left; margin-left: auto; margin-right: auto;" border="0" cellpadding="2" cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;">

      <div style="margin-left: 40px;">
      <h4 style="text-align: justify;"><a name="presentation"></a>1 - Presentation</h4>

      <ul style="text-align: justify;">

        <ul>
          <li><a href="presentation.html">General Presentation</a></li>
          <li><a href="Features.html">Abstract list of features</a></li>
          <li><a href="presentation.html#external_tools">known projects that rely on dar/libdar</a><br>
        </li>
          <li><a href="Limitations.html">Limitations</a></li>
          <li><a href="presentation.html#dar_news">Staying informed of dar/libdar's events</a><br>
        </li>
        </ul>





      </ul>
<a name="obtaining"></a><span style="font-weight: bold;">2 - Obtaining dar/libdar</span><br>
      <ul style="text-align: justify;">
        <ul>
          <li><a href="downloading.html">Obtaining Packages signature</a></li>
          <li><a href="downloading.html#source_download">Downloading source packages</a><br>
        </li>
          <li><a href="downloading.html#linux_binaries">Downloading binaries for Linux</a><br>
        </li>
          <li><a href="downloading.html#windows_binaries">Downloading binary packages for windows</a></li>
          <li><a href="downloading.html#MacOS">Downloading binary packages for Mac OS</a><br>
          </li>


          <li><a href="downloading.html#FreeBSD_portage"><span style="text-decoration: underline;">FreeBSD portage</span></a><br>
        </li>
          <li><a href="from_sources.html">Compiling dar from source</a></li>

          <li><a href="from_sources.html#Tools_sites">Related Softwares</a><br>
        </li>
        </ul>
      </ul>

      <h4 style="text-align: justify;"><span style="font-weight: bold;"><a name="command_line"></a>3
- Command-line</span> tools usage<br>
</h4>
      <div style="margin-left: 40px; text-align: justify;">Dar's
command-line tools is set of six command-line. Since release 2.0.0, dar
source code has been split in two parts, one is command-line specific,
the second is the <span style="font-weight: bold;">libdar</span>
library with its API (application interface). But both parts stay
released under the same package. The command-line tools relies on libdar
to manage dar archives. Some other <a href="presentation.html#external_tools">external tools</a>
do also use dar or libdar, to provide additional features or other
interfaces like a Graphical User Interface. Here we will see how to use
the dar command-line tools, see external tools respective documentation for more details about their usage.<br>
      <br>
You are invited to read the following documents:<br>
      </div>
      <ul style="margin-left: 40px; text-align: justify;">
        <li><a href="Tutorial.html">Tutorial</a></li>
        <li><a href="mini-howto/index.html">Mini-Howto</a></li>
        <li><a href="FAQ.html">FAQ</a></li>
        <li><a href="usage_notes.html">command line usage notes</a><br>
        </li>

        <li><a href="man/index.html">Man pages</a></li><li><a href="Good_Backup_Practice.html">Good Backup Practice
short Guide</a></li>
        <li><a href="samples/index.html">Sample and real Scripts</a></li>
</ul>
      <div style="margin-left: 40px;">
	If you lack some information from the previous documents, you are welcome to <a href="#ask_for_support">ask for support</a>

      </div>
<h4 style="text-align: justify;"><a name="libdar"></a>4 - <span style="font-weight: bold;">Libdar</span> and its API</h4>


      <div style="margin-left: 40px; text-align: justify;">Libdar has (I hope) a well documented interface that let you access dar's features
from your
program. Libdar is written in C++ thus you have either to use C or C++
or use existing bindings for the language of your choice. <br>
      <br>
You are invited to read the following documents in order, up to the time
you get enough information to address your need. Most of the time the
two first source of information should be enough, but don't hesitate to
subscribe to libdar-api mailing-list if some points are not clear about
the API and the way to use it.<br>
      </div>


      <div style="margin-left: 40px; text-align: justify;">
	<ul>
	  <li>The <a href="api_tutorial.html">API tutorial</a></li>
          <li>Dar command-line source code for API usage illustration<br>
          </li>
	  <li>The libdar's <a href="python/libdar_test.py">python binding tutorial</a> based on examples of use</li>
<li>The <a href="man/index.html">API reference
documentation</a></li><li>The <a href="https://lists.sourceforge.net/lists/listinfo/dar-libdar_api">libdar-api</a> mailing-list</li>
        <li>To report a bug about libdar use the <a href="http://sourceforge.net/tracker/?group_id=65612&amp;atid=511612">dar bug tracker</a> (do not report bugs concerning development code).</li>
</ul>
      </div>


      <ul style="margin-left: 40px; text-align: justify;">
      </ul>

      <h4 style="text-align: justify;"><span style="font-weight: bold;"><a name="3"></a>5
- Dar's internals</span></h4>
      <div style="margin-left: 40px; text-align: justify;">

      <div style="margin-left: 40px;">If you want to know more about the way dar is implemented you can read the&nbsp; <a href="Notes.html">dar/libdar internals notes</a>. The <a href="https://lists.sourceforge.net/lists/listinfo/dar-discussions">dar-discussion</a>&nbsp;
mailing-list is also a place where discussions about the current
implementation, alternative way of doing and future evolution of dar
are welcome.<br>
      </div>

      </div>
      <h4 style="text-align: justify;"><a name="actions"></a>6 - Actions</h4>

      <div style="margin-left: 40px;">
      <ul>
        <li><a href="#stay_tuned">Stay informed about dar/libdar events</a></li>
        <li><a href="#ask_for_support">Asking for support</a><br>
        </li>
        <li><a href="#reporting_a_bug">Reporting a bug</a></li>

        <li><a href="#Asking_for_a_new_feature">Asking for a new
feature</a></li>
        <li><a href="#Submiting_a_patch">Submitting a patch</a></li>
      </ul>

      </div>
      <div style="text-align: justify; margin-left: 40px;"><i><b>Important :</b> I no
longer answer support
requests made
by email directly addressed to me. The reason is simple: posting your
request in a public area (like the dar-support mailing-list), makes it
visible to anyone. Answers to your problem might concern other people,
and so a public area is the best place for answers to reside as well.
I do not have as much time as I wish to develop DAR (adding new
features
and porting to new systems), so keeping support public will save me a
little time, since it avoids me repeating the same answers to
the same questions.</i><br>
      </div>
      <div style="margin-left: 40px;">
      <i>
      </i>

      <div style="text-align: right;"><i>&nbsp;Sharing must be both directions. </i></div>

      </div>

      <ul>
      </ul>
      </div>

      </td>
    </tr>
  </tbody>
</table><br>
<hr style="width: 100%; height: 2px;"><br>

<table style="width: 90%; text-align: left; margin-left: auto; margin-right: auto;" border="0" cellpadding="2" cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold; text-decoration: underline;"><a name="stay_tuned"></a><br>
Stay informed about dar/libdar events<br>
      <br>
</span>
      <div style="text-align: justify; margin-left: 40px;">You can subscribe to the <a href="http://lists.sourceforge.net/lists/listinfo/dar-news">dar-news mailing-list</a>,
which is a read-only mailing-list that has a very low email volume (in
average, less than one a month), to be informed about major events
like new releases or security issues.<br>
      </div>
      <br>
      <span style="font-weight: bold; text-decoration: underline;"><a name="ask_for_support"></a><br>
Asking for support<br>
      <br>
      </span>
      <div style="margin-left: 40px;">
      <div style="text-align: justify;">If <a href="FAQ.html">FAQ</a>, <a href="Tutorial.html">tutorial</a>, <a href="mini-howto/index.html">mini-howto</a>, <a href="usage_notes.html">usage notes</a>, or <a href="man/index.html">man page</a> do not answer your question, you can read the <a href="http://news.gmane.org/gmane.comp.sysutils.backup.dar.support">dar-support mailing-list archive</a> at <a href="http://gmane.org/">gmane</a>,
and use the search engine (the green text box at the bottom of the
page) to look for keywords that match your problem. If that still does
not solve your problem, you can subscribe to <a href="https://lists.sourceforge.net/lists/listinfo/dar-support">dar-support mailing-list</a> and send an email to the mailing-list describing your issue.<span style="font-weight: bold; text-decoration: underline;"></span><br>
      </div>
      <span style="font-weight: bold; text-decoration: underline;"></span></div>
      <span style="font-weight: bold; text-decoration: underline;">
      <br>
      <a name="reporting_a_bug"></a><br>
Reporting a Bug</span><br>
      <br>
      <div style="text-align: justify;">
      <div style="margin-left: 40px;">First, check that the problem has not already been seen and addressed in <a href="http://news.gmane.org/gmane.comp.sysutils.backup.dar.support">dar-support mailing-list</a>. Then, check the <a href="http://sourceforge.net/tracker/?group_id=65612&amp;atid=511612">Bug
Tracker</a>
to see whether the bug has not already been reported (thanks to avoid duplicated). If found, you can monitor
the corresponding item to be informed of any update concerning this
bug. If the item is fixed you can grab the source code with the fix
from <a href="from_sources.html#GIT">GIT</a>. But if the bug you met is not yet reported feel free to
create a new report providing as much information and details as you can
to ease reproducing and fixing the bug.<br>
&nbsp;&nbsp;&nbsp; Note that you need to register at Sourceforge to be
able
to open a bug
(subscription to Sourceforge is free, and won't spam your email: I use
it since 2002 and never got spam on the email I gave and which is only
known by sourceforge).
Giving
a real email address is beneficial, because you'll get a notification
when the status of the bug changes (like when it has been resolved) it
also avoids me wasting time trying to reproduce a bug reported
anonymously and impossible to reproduce (real bug with very little
information, user mistake, ...).<br>
      </div>

      <br>
      <span style="font-weight: bold; text-decoration: underline;"><a name="Asking_for_a_new_feature"></a><br>
Asking for a new feature</span><br>
      <br>
      <div style="margin-left: 40px;">Use the <a href="http://sourceforge.net/tracker/?group_id=65612&amp;atid=511615">New
Feature tracker</a>,
first checking that no one has already thought about the request you
are about to ask (thanks to avoid duplications). Note that the ability to ask a feature does not mean
an obligation for me to implement it, in particular if the feature is not
compatible with an already existing feature.<br>
      </div>

      <br>
      <span style="font-weight: bold; text-decoration: underline;"><a name="Submiting_a_patch"></a>Submitting a patch</span><br>
      <br>
      <div style="margin-left: 40px;">Feel free to use the <a href="http://sourceforge.net/tracker/?group_id=65612&amp;atid=511614">Patch
Tracker</a>
at Sourceforge.<br>
      </div>

      <br>
      </div>
      </td>
    </tr>
  </tbody>
</table><br>
<br>
<br>
<br>
<br>
</center>




</body></html>