dtas.git  about / heads / tags
duct tape audio suite for *nix
blob 4d7f4e8a11224e4253b86ed2d9a39b7159359c1f 1840 bytes (raw)
$ git show v0.16.1:Documentation/dtas-archive.pod	# shows this blob on the CLI

 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
 
% dtas-archive(1) dtas user manual

=head1 NAME

dtas-archive - paranoid audio file copy

=head1 SYNOPSYS

dtas-archive [OPTIONS] SOURCE DESTINATION

=head1 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 L<posix_fadvise(2)> can be used to
drop caches for a particular file after L<fsync(2)>.

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

=head1 OPTIONS

=over

=item -j, --jobs [JOBS]

Number of jobs to run in parallel.  Incrementing this may hurt
performance on slow storage devices.  Default: 1

=item -n, --dry-run

Print, but do not run the commands to be executed

=item -s, --quiet, --silent

Silent operation, commands are not printed as executed

=item -S, --stats

Run and save the text output of the sox "stats" effect as
$DESTINATION_FILE_WITHOUT_SUFFIX.stats next to the output file

=item -k, --keep-going

Continue after error

=item -r, --repeat [COUNT]

Number of times to repeat the L<sndfile-cmp(1)> check.  Default: 1

=back

=head1 COPYRIGHT

Copyright 2013-2016 all contributors L<mailto:dtas-all@nongnu.org>

License: GPL-3.0+ L<https://www.gnu.org/licenses/gpl-3.0.txt>

=head1 CONTACT

All feedback welcome via plain-text mail to: L<mailto:dtas-all@nongnu.org>

Mailing list archives available at L<https://80x24.org/dtas-all/>
and L<ftp://lists.gnu.org/dtas-all/>

No subscription is necessary to post to the mailing list.

=head1 SEE ALSO

L<sndfile-cmp(1)>, L<sox(1)>

git clone git://80x24.org/dtas.git
git clone https://80x24.org/dtas.git