about summary refs log tree commit homepage
path: root/Documentation/dtas-archive.txt
blob: f701a5eea6290e644bbeab9e728282266ec0117c (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
% 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 and
computers without ECC memory, attempting to read data multiple times in
an attempt to detect memory 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)