about summary refs log tree commit homepage
path: root/Documentation/dtas-archive.txt
blob: c78e1c4a9b1bd021278e701816f7031976d13c4f (plain)
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
% dtas-archive(1) dtas user manual
%

# NAME

dtas-archive - paranoid audio file copy

# SYNOPSYS

dtas-archive [OPTIONS] SOURCE DESTINATION

# DESCRIPTION

dtas-archive is intended for archiving audio data to/from laptops,
marginal USB ports, and computers without ECC memory, attempting
to read data multiple times in an attempt to detect memory or
bus corruption.  dtas-archive may only be effective on machines
running the Linux kernel where posix_fadvise(2) can be used to
drop caches for a particular file after fsync(2).

dtas-archive spawns sox(1) to archive audio data (likely uncompressed
WAVE) to FLAC and verifies the result using sndfile-cmp(1), a tool
implemented by different than sox and less likely to share the same bugs
(if any) as sox.

# OPTIONS

-j, \--jobs [JOBS]
:    Number of jobs to run in parallel.  Incrementing this may hurt
     performance on slow storage devices.  Default: 1

-n, \--dry-run
:    Print, but do not run the commands to be executed

-s, \--quiet, \--silent
:    Silent operation, commands are not printed as executed

-S, \--stats
:    Run and save the text output of the sox "stats" effect as
     $DESTINATION_FILE_WITHOUT_SUFFIX.stats next to the output file

-k, \--keep-going
:    Continue after error

-r, \--repeat [COUNT]
:    Number of times to repeat the sndfile-cmp(1) check.  Default: 1

# COPYRIGHT

Copyright 2015 all contributors <dtas-all@nongnu.org>.\
License: GPL-3.0+ <http://www.gnu.org/licenses/gpl-3.0.txt>

# CONTACT

All feedback welcome via plain-text mail to: <dtas-all@nongnu.org>\
Mailing list archives available at <http://80x24.org/dtas-all/> and
<ftp://lists.gnu.org/dtas-all/>\
No subscription is necessary to post to the mailing list.

# SEE ALSO

sndfile-cmp(1), sox(1)