From 7266a4bcceb1feb1dc7db9fa2e263b1fcc91ac4e Mon Sep 17 00:00:00 2001 From: Eric Wong Date: Sun, 5 Apr 2015 09:26:34 +0000 Subject: dtas-archive: paranoid archival script 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. --- Documentation/GNUmakefile | 1 + Documentation/dtas-archive.txt | 61 ++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 62 insertions(+) create mode 100644 Documentation/dtas-archive.txt (limited to 'Documentation') 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 .\ +License: GPLv3 or later + +# CONTACT + +All feedback welcome via plain-text mail to: \ +Mailing list archives available at and +\ +No subscription is necessary to post to the mailing list. + +# SEE ALSO + +sndfile-cmp(1), sox(1) -- cgit v1.2.3-24-ge0c7