diff options
author | Eric Wong <e@80x24.org> | 2015-04-05 09:26:34 +0000 |
---|---|---|
committer | Eric Wong <e@80x24.org> | 2015-04-07 07:42:10 +0000 |
commit | 7266a4bcceb1feb1dc7db9fa2e263b1fcc91ac4e (patch) | |
tree | 16daa2fb1e555b435aa8dc041dac4317da4270eb /Documentation | |
parent | 1167fad45bf65f22871190fc6468148287ef5aa8 (diff) | |
download | dtas-7266a4bcceb1feb1dc7db9fa2e263b1fcc91ac4e.tar.gz |
This archives audio files (typically .wav from a portable devices) as FLAC and performs a best-effort verification the file was transferred succesfully without bit errors by dropping kernel caches and rechecking the result.
Diffstat (limited to 'Documentation')
-rw-r--r-- | Documentation/GNUmakefile | 1 | ||||
-rw-r--r-- | Documentation/dtas-archive.txt | 61 |
2 files changed, 62 insertions, 0 deletions
diff --git a/Documentation/GNUmakefile b/Documentation/GNUmakefile index 4f44cdc..537c659 100644 --- a/Documentation/GNUmakefile +++ b/Documentation/GNUmakefile @@ -18,6 +18,7 @@ m1 += dtas-sinkedit m1 += dtas-sourceedit m1 += dtas-tl m1 += dtas-splitfx +m1 += dtas-archive m7 = m7 += dtas-player_protocol diff --git a/Documentation/dtas-archive.txt b/Documentation/dtas-archive.txt new file mode 100644 index 0000000..9f2fe04 --- /dev/null +++ b/Documentation/dtas-archive.txt @@ -0,0 +1,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: GPLv3 or later <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) |