[Forensics-changes] [safecopy] 02/02: Imported Debian patch 1.7-1

Joao Eriberto Mota Filho eriberto at moszumanska.debian.org
Thu Jun 25 15:10:57 UTC 2015


This is an automated email from the git hooks/post-receive script.

eriberto pushed a commit to branch debian
in repository safecopy.

commit 73f9d8c596cad4b00ba7b3b449e458b5f49621e8
Merge: 627d402 8dafc9d
Author: Joao Eriberto Mota Filho <eriberto at debian.org>
Date:   Thu Jun 25 08:58:06 2015 -0300

    Imported Debian patch 1.7-1

 ChangeLog                             |      7 +
 Makefile.in                           |    203 +-
 README                                |     22 +-
 aclocal.m4                            |    292 +-
 benchmark/benchmark.sh                |     46 -
 benchmark/cdrom-dell/README           |      5 -
 benchmark/cdrom-dell/simulator.cfg    | 235622 -------------------------------
 benchmark/cdrom-lighton/README        |      5 -
 benchmark/cdrom-lighton/simulator.cfg |  64383 ---------
 benchmark/floppy/README               |      3 -
 benchmark/floppy/simulator.cfg        |    151 -
 benchmark/scripts/README              |     20 -
 benchmark/scripts/auswertung.sh       |     94 -
 benchmark/scripts/characteristics.sh  |    102 -
 benchmark/scripts/mean-calculation.sh |     44 -
 configure                             |   3762 +-
 configure.in                          |      2 +-
 debian/README.Debian                  |     15 +
 debian/changelog                      |     33 +-
 debian/compat                         |      2 +-
 debian/control                        |     43 +-
 debian/copyright                      |     58 +-
 debian/docs                           |      2 +
 debian/manpages/safecopy.1            |    266 -
 debian/patches/fix-manpage            |    335 +
 debian/patches/series                 |      1 +
 debian/rules                          |     15 +-
 debian/safecopy.docs                  |      1 -
 debian/safecopy.manpages              |      1 -
 debian/source.lintian-overrides       |      3 -
 debian/source/format                  |      1 +
 debian/watch                          |      2 +-
 depcomp                               |     87 +-
 install-sh                            |      5 +-
 missing                               |     49 +-
 simulator/Makefile.in                 |    201 +-
 simulator/aclocal.m4                  |    292 +-
 simulator/config.h.in                 |      3 +
 simulator/configure                   |   3881 +-
 simulator/doc/analysis.pdf            |    Bin 8086928 -> 0 bytes
 simulator/src/Makefile.in             |    114 +-
 src/Makefile.in                       |    221 +-
 src/lowlevel.c                        |      2 +-
 src/lowlevel.h                        |      2 +-
 src/safecopy.1                        |     50 +-
 src/safecopy.c                        |   2151 +-
 test/test1/test.sh                    |      5 +-
 test/test10/test.sh                   |     30 +-
 test/test11/test.sh                   |     25 +-
 test/test12/test.sh                   |      5 +-
 test/test13/simulator.cfg             |     12 +
 test/test13/test.dat                  |    Bin 0 -> 20480 bytes
 test/test13/test.sh                   |     43 +
 test/test13/test1.dat                 |    Bin 0 -> 10240 bytes
 test/test13/test2.dat                 |    Bin 0 -> 20480 bytes
 test/test13/test3.dat                 |    Bin 0 -> 20480 bytes
 test/test2/test.sh                    |     20 +-
 test/test3/test.sh                    |     15 +-
 test/test4/test.sh                    |     20 +-
 test/test5/test.sh                    |     10 +-
 test/test6/test.sh                    |     25 +-
 test/test7/test.sh                    |     30 +-
 test/test8/test.sh                    |     25 +-
 test/test9/test.sh                    |     25 +-
 64 files changed, 6177 insertions(+), 306712 deletions(-)

diff --cc debian/README.Debian
index 0000000,0000000..0efdd47
new file mode 100644
--- /dev/null
+++ b/debian/README.Debian
@@@ -1,0 -1,0 +1,15 @@@
++safecopy for Debian
++-------------------
++
++There are several complementary information about Safecopy at these places:
++
++http://safecopy.sourceforge.net
++http://safecopy.sourceforge.net/analysis/analysis.html
++
++You can use this site as a quick start for Safecopy:
++
++http://tuxdiary.com/2014/12/10/safecopy/
++
++Thanks!
++
++ -- Joao Eriberto Mota Filho <eriberto at debian.org>  Thu, 25 Jun 2015 11:02:30 -0300
diff --cc debian/changelog
index 4a57d05,0000000..045c411
mode 100644,000000..100644
--- a/debian/changelog
+++ b/debian/changelog
@@@ -1,66 -1,0 +1,97 @@@
++safecopy (1.7-1) unstable; urgency=medium
++
++  * New upstream release. (Closes: #718732, LP: #1148388)
++  * New co-maintainer.
++  * Migrations:
++      - debian/changelog to 1.0 format.
++      - DebSrc to 3.0 format.
++      - DH level to 9.
++      - Using dh-autoreconf.
++  * Removed the manpage from debian/ because the upstream is providing
++      an updated manpage.
++  * Removed the direct changes in upstream source code. No patch needed
++      because the upstream fixed the code. Thanks!
++  * debian/control:
++      - Bumped Standards-Version to 3.9.6.
++      - Improved the short and long descriptions.
++      - Updated the Vcs-* fields.
++  * debian/copyright: full updated.
++  * debian/patches/fix-manpage: created to fix some issues in manpage.
++  * debian/README.Debian: added to list some documentation places.
++  * debian/rules:
++      - Added DEB_BUILD_MAINT_OPTIONS to improve the GCC hardening.
++      - Removed some unnecessary lines.
++  * debian/safecopy.docs:
++      - Renamed to docs.
++      - Added the specification.txt file.
++  * debian/source.lintian-overrides: removed. Using 'Team upload' now.
++  * debian/watch: fixed and improved.
++
++ -- Joao Eriberto Mota Filho <eriberto at debian.org>  Thu, 25 Jun 2015 08:58:06 -0300
++
 +safecopy (1.6-1) unstable; urgency=low
 +
 +  [ Christophe Monniez ]
 +  * Merging upstream version 1.6.
 +
 + -- Michael Prokop <mika at debian.org>  Thu, 05 Nov 2009 00:40:59 +0100
 +
 +safecopy (1.5-1) unstable; urgency=low
 +
 +  [ Daniel Baumann ]
 +  * Minimizing rules file.
 +  * Adding stuff in rules that doesn't get done by dh automatically.
 +
 +  [ Christophe Monniez ]
 +  * Merging upstream version 1.5.
 +  * Filling out the man page (Closes: #541339).
 +
 +  [ Michael Prokop ]
 +  * Update to Standards-Version 3.8.3 (no further changes).
 +  * Update VCS-* headers (moved to alioth).
 +  * Bump build dependency on debhelper to >= 7.0.50~.
 +
 + -- Michael Prokop <mika at debian.org>  Fri, 25 Sep 2009 01:18:18 +0200
 +
 +safecopy (1.3-2) unstable; urgency=low
 +
 +  * Updating package to standards version 3.8.2.
 +  * Adding lintian overrides.
 +
 + -- Daniel Baumann <daniel at debian.org>  Thu, 09 Jul 2009 12:35:49 +0200
 +
 +safecopy (1.3-1) unstable; urgency=low
 +
 +  * Merging upstream version 1.3.
 +
 + -- Daniel Baumann <daniel at debian.org>  Thu, 28 May 2009 23:21:36 +0200
 +
 +safecopy (0.2-2) unstable; urgency=low
 +
 +  * Adding myself to copyright.
 +  * Improving description, thanks to Loic Minier <lool at dooz.org>
 +    (Closes: #520096, #520208).
 +  * Tidy rules file.
 +  * Updating to standards 3.8.1.
 +
 + -- Daniel Baumann <daniel at debian.org>  Thu, 28 May 2009 22:27:36 +0200
 +
 +safecopy (0.2-1) unstable; urgency=low
 +
 +  [ Juan Angulo Moreno ]
 +  * Initial release (Closes: #512208).
 +
 +  [ Daniel Baumann ]
 +  * Removing useless whitespaces at EOF and EOL.
 +  * Updating vcs fields in control.
 +  * Rewrapping package long description to 80 chars a line in control.
-   * Crorrecting copyright file.
++  * Correcting copyright file.
 +  * Removing useless dirs debhelper file.
 +  * Removing AUTHORS from docs, doesn't contain new information over copyright
 +    file.
 +  * Removing NEWS from docs, doesn't contain new information over ChangeLog.
 +  * Reordering rules file.
 +  * Moving out manpage of debian directory to subdirectory.
 +  * Prefixing debhelper files with package name.
 +
 + -- Daniel Baumann <daniel at debian.org>  Tue, 20 Jan 2009 21:22:26 +0100
diff --cc debian/compat
index 7f8f011,0000000..ec63514
mode 100644,000000..100644
--- a/debian/compat
+++ b/debian/compat
@@@ -1,1 -1,0 +1,1 @@@
- 7
++9
diff --cc debian/control
index 609babf,0000000..8577594
mode 100644,000000..100644
--- a/debian/control
+++ b/debian/control
@@@ -1,19 -1,0 +1,42 @@@
 +Source: safecopy
 +Section: admin
 +Priority: optional
 +Maintainer: Debian Forensics <forensics-devel at lists.alioth.debian.org>
- Uploaders: Juan Angulo Moreno <juan at apuntale.com>
- Build-Depends: debhelper (>= 7.0.50~), autotools-dev
- Standards-Version: 3.9.1
- Homepage: http://safecopy.sourceforge.net
- Vcs-Browser: http://git.debian.org/?p=forensics/safecopy.git
- Vcs-Git: git://git.debian.org/forensics/safecopy.git
++Uploaders: Joao Eriberto Mota Filho <eriberto at debian.org>
++Build-Depends: debhelper (>= 9), dh-autoreconf
++Standards-Version: 3.9.6
++Homepage: http://safecopy.sf.net
++Vcs-Browser: https://anonscm.debian.org/cgit/forensics/safecopy.git
++Vcs-Git: git://anonscm.debian.org/forensics/safecopy.git
 +
 +Package: safecopy
 +Architecture: any
 +Depends: ${shlibs:Depends}, ${misc:Depends}
- Description: Copy utility ignoring errors
++Description: data recovery tool for problematic media
 + Safecopy is a data recovery tool which tries to extract as much data as
-  possible from a seekable, but problematic (i.e. damaged sectors) source - like
-  floppy drives, harddisk partitions, CDs, ..., where other tools like dd would
-  fail due to I/O errors.
++ possible from a seekable, but problematic (i.e. damaged sectors) source.
++ .
++ Safecopy works over every media, like floppy disks, harddisk partitions,
++ CDs, DVDs, tape devices, where other tools like dd would fail due to I/O
++ errors.
++ .
++ Safecopy includes a low level I/O layer to read CDROM disks in raw mode,
++ and issue device resets and other helpful low level operations on a number
++ of other device classes.
++ .
++ Other Safecopy features are:
++ .
++   - Can run from a previous or arbitrary position, and to keep trying to
++     open source files even when they went away. This allows copying from
++     devices that vanish temporarily in case of errors, like USB drives
++     that renumerate in case of device resets.
++   - Supports generic direct hardware access with O_DIRECT, as well as
++     reading from /dev/raw devices.
++   - DMA transfers to the read buffer are possible, bypassing CPU-based
++     in-memory copying by the kernel.
++   - Can generate a statistics file with the read timing information in
++     microseconds for each read block. This is useful for statistical
++     analysis of bad hardware behaviour and finding strategies to speed
++     up recovery tools like safecopy, ddrescue and the like.
++ .
++ Safecopy is useful in forensics investigations.
diff --cc debian/copyright
index cc6ed43,0000000..7e527c9
mode 100644,000000..100644
--- a/debian/copyright
+++ b/debian/copyright
@@@ -1,43 -1,0 +1,53 @@@
- Author: Corvus Corax <corvuscorax at cybertrench.com>
- Download: http://safecopy.sourceforge.net/
++Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
++Upstream-Name: Safecopy
++Source: http://safecopy.sf.net/
 +
 +Files: *
- Copyright: (C) 2005 Corvus Corax <corvuscorax at cybertrench.com>
- License: GPL-2
-  This program is free software; you can redistribute it and/or
-  modify it under the terms of the GNU General Public License
-  as published by the Free Software Foundation; version 2
-  of the License.
++Copyright: 2005-2012 Corvus Corax <corvuscorax at cybertrench.com, eric.noack at gemia.de, corvuscorax at users.sf.net>
++License: GPL-2+
++
++Files: simulator/*
++Copyright: 2009-2012 Corvus Corax <corvuscorax at cybertrench.com, eric.noack at gemia.de, corvuscorax at users.sf.net>
++License: GPL-3
++
++Files: debian/*
++Copyright: 2008-2009 Juan Angulo Moreno <juan at apuntale.com>
++           2008-2009 Daniel Baumann <daniel at debian.org>
++           2009      Christophe Monniez <christophe.monniez at fccu.be>
++           2009      Michael Prokop <mika at debian.org>
++           2015      Joao Eriberto Mota Filho <eriberto at debian.org>
++License: GPL-3+
++
++License: GPL-2+
++ This package is free software; you can redistribute it and/or modify
++ it under the terms of the GNU General Public License as published by
++ the Free Software Foundation; either version 2 of the License, or
++ (at your option) any later version.
 + .
-  This program is distributed in the hope that it will be useful,
++ This package is distributed in the hope that it will be useful,
 + but WITHOUT ANY WARRANTY; without even the implied warranty of
-  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
++ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 + GNU General Public License for more details.
 + .
 + You should have received a copy of the GNU General Public License
-  along with this program; if not, write to the Free Software
-  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
++ along with this program. If not, see <https://www.gnu.org/licenses/>
 + .
-  On Debian systems, the complete text of the GNU General Public License
-  can be found in /usr/share/common-licenses/GPL-2 file.
++ On Debian systems, the complete text of the GNU General
++ Public License version 2 can be found in "/usr/share/common-licenses/GPL-2".
 +
- Files: debian/*
- Copyright:
-  (C) 2008-2009 Juan Angulo Moreno <juan at apuntale.com>
-  (C) 2008-2009 Daniel Baumann <daniel at debian.org>
- License: GPL-3+
++License: GPL-3 or GPL-3+
 + This program is free software: you can redistribute it and/or modify
 + it under the terms of the GNU General Public License as published by
 + the Free Software Foundation, either version 3 of the License, or
 + (at your option) any later version.
 + .
-  This program is distributed in the hope that it will be useful,
++ This package is distributed in the hope that it will be useful,
 + but WITHOUT ANY WARRANTY; without even the implied warranty of
-  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
++ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 + GNU General Public License for more details.
 + .
 + You should have received a copy of the GNU General Public License
-  along with this program. If not, see <http://www.gnu.org/licenses/>.
++ along with this program. If not, see <https://www.gnu.org/licenses/>.
 + .
-  On Debian systems, the complete text of the GNU General Public License
-  can be found in /usr/share/common-licenses/GPL-3 file.
++ On Debian systems, the complete text of the GNU General
++ Public License version 3 can be found in "/usr/share/common-licenses/GPL-3"
diff --cc debian/docs
index 0000000,0000000..7b85f72
new file mode 100644
--- /dev/null
+++ b/debian/docs
@@@ -1,0 -1,0 +1,2 @@@
++README
++specification.txt
diff --cc debian/patches/fix-manpage
index 0000000,0000000..2f8c250
new file mode 100644
--- /dev/null
+++ b/debian/patches/fix-manpage
@@@ -1,0 -1,0 +1,335 @@@
++Description: fix some hyphens used as minus sign and a spelling error.
++Author: Joao Eriberto Mota Filho <eriberto at debian.org>
++Last-Update: 2015-06-25
++Index: safecopy-1.7/src/safecopy.1
++===================================================================
++--- safecopy-1.7.orig/src/safecopy.1
+++++ safecopy-1.7/src/safecopy.1
++@@ -33,13 +33,13 @@ devices (like tapes) you can try to use
++ controlled skip over the damaged part for you.
++ .PP
++ (For example by using "mt seek" and "mt tell" on an SCSI tape device)
++-See the "-S <seekscript>" parameter for details.
+++See the "\-S <seekscript>" parameter for details.
++ .PP
++ Performance and success of this tool depend extremely on the device driver,
++ firmware and underlying hardware.
++ .PP
++ Currently safecopy supports RAW access to CDROM drives to read data directly of
++-a CD, bypassing some driver dependant error correction. This can speed up data
+++a CD, bypassing some driver dependent error correction. This can speed up data
++ retrieval from CDs and reduce system load during recovery, as well as
++ increase the success rate. Safecopy uses the disc status syscall to determine
++ sector size and addressing of CDs. This fails on mixed-mode or multi-session
++@@ -95,20 +95,20 @@ specification.txt shipped with safecopy.
++ Preset to rescue most of the data fast,
++ using no retries and avoiding bad areas.
++ .IP
++-\fBPresets\fR: -f 10% -r 10% -R 1 -Z 0 -L 2 -M BaDbLoCk -o stage1.badblocks
+++\fBPresets\fR: \-f 10% \-r 10% \-R 1 \-Z 0 \-L 2 \-M BaDbLoCk \-o stage1.badblocks
++ .TP
++ \fB\-\-stage2\fR
++ Preset to rescue more data, using no retries
++ but searching for exact ends of bad areas.
++ .IP
++-\fBPresets\fR: -f 128* -r 1* -R 1 -Z 0 -L 2 -I stage1.badblocks -o stage2.badblocks
+++\fBPresets\fR: \-f 128* \-r 1* \-R 1 \-Z 0 \-L 2 \-I stage1.badblocks \-o stage2.badblocks
++ .TP
++ \fB\-\-stage3\fR
++ Preset to rescue everything that can be rescued
++ using maximum retries, head realignment tricks
++ and low level access.
++ .IP
++-\fBPresets\fR: -f 1* -r 1* -R 4 -Z 1 -L 2 -I stage2.badblocks -o stage3.badblocks
+++\fBPresets\fR: \-f 1* \-r 1* \-R 4 \-Z 1 \-L 2 \-I stage2.badblocks \-o stage3.badblocks
++ .PP
++ All stage presets can be overridden by individual options.
++ .TP
++@@ -213,7 +213,7 @@ badblock list.
++ .IP
++ \fBImplies\fR: \-c 0 if \-c is not specified
++ .IP
++-\fBDefault\fR: none ( /dev/null if -c is given )
+++\fBDefault\fR: none ( /dev/null if \-c is given )
++ .TP
++ \fB\-i\fR <\fIbytes\fR>
++ Blocksize to interpret the badblockfile given with \-I.
++@@ -225,7 +225,7 @@ Continue copying at this position.
++ This allows continuing if the output is a block device
++ with a fixed size as opposed to a growable file,
++ where safecopy cannot determine how far it already got.
++-The blocksize used is the same as for the -I option.
+++The blocksize used is the same as for the \-I option.
++ .br
++ \-c 0 will continue at the current destination size.
++ .IP
++@@ -269,7 +269,7 @@ on any later run.
++ .IP
++ \fBWarning\fR:
++ When used in combination with incremental mode (\-I) this may overwrite data in
++-any block that occurs in the -I file.  Blocks not in the \-I file, or covered
+++any block that occurs in the \-I file.  Blocks not in the \-I file, or covered
++ by the file specified with \-X are save from being overwritten.
++ .IP
++ \fBDefault\fR: none
++@@ -366,49 +366,49 @@ How do I...
++ - resurrect data as thoroughly as possible?
++ .IP
++ .B safecopy
++-source dest -f 1* -R 8 -Z 2
+++source dest \-f 1* \-R 8 \-Z 2
++ .br
++ (assuming logical misalignment of blocks to sectors)
++ .IP
++ .B safecopy
++-source dest -f 1* -r 1 -R 8 -Z 2
+++source dest \-f 1* \-r 1 \-R 8 \-Z 2
++ .TP
++ - resurrect data as fast as possible, or
++ .TP
++ - resurrect data with low risk of damaging the media further:
++-(you can use even higher values for -f and -r)
+++(you can use even higher values for \-f and \-r)
++ .IP
++ .B safecopy
++-source dest -f 10% -R 0 -Z 0
+++source dest \-f 10% \-R 0 \-Z 0
++ .TP
++ - resurrect some data fast, then read more data thoroughly later:
++ .IP
++ .B safecopy
++-source dest -f 10% -R 0 -Z 0 -o badblockfile
+++source dest \-f 10% \-R 0 \-Z 0 \-o badblockfile
++ .br
++ .B safecopy
++-source dest -f 1* -R 8 -Z 2 -I badblockfile
+++source dest \-f 1* \-R 8 \-Z 2 \-I badblockfile
++ .IP
++ .I Alternate approach using the new preset features:
++ .IP
++ .B safecopy
++-source dest --stage1
+++source dest \-\-stage1
++ .IP
++ .B safecopy
++-source dest --stage2
+++source dest \-\-stage2
++ .IP
++ .B safecopy
++-source dest --stage3
+++source dest \-\-stage3
++ .TP
++ - utilize some friends CD-ROM drives to complete the data from my damaged CD:
++ .B safecopy
++-/dev/mydrive imagefile <someoptions> -b <myblocksize> -o myblockfile
+++/dev/mydrive imagefile <someoptions> \-b <myblocksize> \-o myblockfile
++ .br
++ .B safecopy
++-/dev/otherdrive imagefile <someoptions> -b <otherblocksize> -I myblockfile -i <myblocksize> -o otherblockfile
+++/dev/otherdrive imagefile <someoptions> \-b <otherblocksize> \-I myblockfile \-i <myblocksize> \-o otherblockfile
++ .br
++ .B safecopy
++-/dev/anotherdrive imagefile <someoptions> -b <anotherblocksize> -I otherblockfile -i <otherblocksize>
+++/dev/anotherdrive imagefile <someoptions> \-b <anotherblocksize> \-I otherblockfile \-i <otherblocksize>
++ .TP
++ - interrupt and later resume a data rescue operation:
++ .B safecopy
++@@ -418,11 +418,11 @@ source dest
++ (safecopy aborts)
++ .br
++ .B safecopy
++-source dest -I /dev/null
+++source dest \-I /dev/null
++ .TP
++ - interrupt and later resume a data rescue operation with correct badblocks output:
++ .B safecopy
++-source dest <options> -o badblockfile
+++source dest <options> \-o badblockfile
++ .br
++ .B <CTRL+C>
++ (safecopy aborts)
++@@ -431,7 +431,7 @@ source dest <options> -o badblockfile
++ badblockfile savedbadblockfile
++ .br
++ .B safecopy
++-source dest -I /dev/null -o badblockfile
+++source dest \-I /dev/null \-o badblockfile
++ .br
++ .B cat
++ badblockfile >>savedbadblockfile
++@@ -442,59 +442,59 @@ badblockfile >>savedbadblockfile
++ .br
++ .B
++ safecopy
++-source dest <options> -o badblockfile1
+++source dest <options> \-o badblockfile1
++ .br
++ .B
++ safecopy
++-source dest <options> -I badblockfile1 -o badblockfile2
+++source dest <options> \-I badblockfile1 \-o badblockfile2
++ .br
++ .B <CTRL+C>
++ (safecopy aborts)
++ .br
++-latest=$( tail -n 1 badblockfile2 )
+++latest=$( tail \-n 1 badblockfile2 )
++ .br
++-if [ -z $latest ]; then latest=-1; fi;
+++if [ \-z $latest ]; then latest=-1; fi;
++ .br
++ cat badblockfile1 | while read block; do
++ .br
++-	[ $block -gt $latest ] && echo $block >>badblockfile2;
+++	[ $block \-gt $latest ] && echo $block >>badblockfile2;
++ .br
++ done;
++ .br
++ .B
++ safecopy
++-source dest <options> -I badblockfile2 -o badblockfile3
+++source dest <options> \-I badblockfile2 \-o badblockfile3
++ .TP
++ - find the corrupted files on a partially successful rescued file system:
++ .B safecopy
++-/dev/filesystem image -M CoRrUpTeD
+++/dev/filesystem image \-M CoRrUpTeD
++ .br
++ .B fsck
++ image
++ .br
++ .B mount
++--o loop image /mnt/mountpoint
+++\-o loop image /mnt/mountpoint
++ .br
++ .B grep
++--R /mnt/mountpoint "CoRrUpTeD"
+++\-R /mnt/mountpoint "CoRrUpTeD"
++ .br
++ (hint: this might not find all affected files if the unreadable
++ parts are smaller in size than your marker string)
++ .TP
++ - exclude the previously known badblocks list of a filesystem from filesystem image creation:
++ .B dumpe2fs
++--b /dev/filesystem >badblocklist
+++\-b /dev/filesystem >badblocklist
++ .br
++ .B safecopy
++-/dev/filesystem image -X badblocklist -x <blocksize of your fs>
+++/dev/filesystem image \-X badblocklist \-x <blocksize of your fs>
++ .TP
++ - create an image of a device that starts at X and is Y in size:
++ .B safecopy
++-/dev/filesystem -b <bsize> -s <X/bsize> -l <Y/bsize>
+++/dev/filesystem \-b <bsize> \-s <X/bsize> \-l <Y/bsize>
++ .TP
++ - combine two partial images of rescued data without access to the actual (damaged) source data:
++ (This is a bit tricky. You need to get badblocks lists for both files somehow
++-to make safecopy know where the missing data is. If you used the -M (mark)
+++to make safecopy know where the missing data is. If you used the \-M (mark)
++ feature you might be able to automatically compute these, however this feature
++ is not provided by safecopy. Lets assume you have two badblocks files.
++ .IP
++@@ -518,7 +518,7 @@ not, swap them)
++ image2.dat combined.dat
++ .br
++ .B safecopy
++-image1.dat combined.dat -I image2.badblocks -i blocksize2 -X image1.badblocks -x blocksize1
+++image1.dat combined.dat \-I image2.badblocks \-i blocksize2 \-X image1.badblocks \-x blocksize1
++ .br
++ (This gets you the combined data, but no output badblocklist.
++ The resulting badblocks list would be the badblocks that are
++@@ -532,7 +532,7 @@ a random open source project.)
++ .TP
++ - rescue data of a tape device:
++ If the tape device driver supports lseek(), treat it as any file,
++-otherwise utilize the "-S" option of safecopy with a to be
+++otherwise utilize the "\-S" option of safecopy with a to be
++ self-written script to skip over the bad blocks.
++ (for example using "mt seek")
++ Make sure your tape device doesn't auto-rewind on close.
++@@ -554,7 +554,7 @@ Meanwhile safecopy supports low level fe
++ .PP
++ .TP
++ Q:
++-What exactly does the -Z option do?
+++What exactly does the \-Z option do?
++ .TP
++ A:
++ Remember back in MS-DOS times when a floppy would make a "neek nark" sound 3
++@@ -576,22 +576,23 @@ CDRW drive, that even reads deeply and p
++ key, to make it unreadable) flawlessly. A CDRW drive of the same age at work
++ doesn't read any data from that part of the CD at all, while most DVD and combo
++ drives have bad blocks every couple hundred bytes.  Make full use of safecopys
++-RAW access features if applicable.  (-L 2 option)
+++RAW access features if applicable.  (\-L 2 option)
++ .IP
++ As a general guideline:
++--CDRW drives usually do better than read-only CD drives.
++ .br
++--CD only drives sometimes do better on CDs than DVD drives.
+++\-CDRW drives usually do better than read-only CD drives.
++ .br
++--PC drives are sometimes better than laptop ones.
+++\-CD only drives sometimes do better on CDs than DVD drives.
++ .br
++--A drive with a clean lens does better than a dirtball.
+++\-PC drives are sometimes better than laptop ones.
++ .br
++--Cleaning up CDs helps.
+++\-A drive with a clean lens does better than a dirtball.
++ .br
++--Unless you use chemicals.
+++\-Cleaning up CDs helps.
++ .br
++--Using sticky tape on a CD will rip of the reflective layer permanently
+++\-Unless you use chemicals.
+++.br
+++\-Using sticky tape on a CD will rip of the reflective layer permanently
++ rendering the disk unreadable.
++ .PP
++ .TP
++@@ -637,34 +638,34 @@ during operation.
++ .IP
++ When you rescue data, rescue good data first before attempting to
++ access bad sectors. Safecopy allows you to skip known problem sectors
++-using a badblock exclude file (-X) which you might be able to retrieve
+++using a badblock exclude file (\-X) which you might be able to retrieve
++ from system logs or from the drive internal logs, via smartmontools or
++ similar software. Be aware that you might possibly need to convert
++ physical sector numbers into logical block numbers depending on your
++ source.
++ .IP
++ Also you should tell safecopy to jump out of any problematic areas ASAP
++-and continue somewhere else. Parameters "-f 10% -r 10% -R 0 -Z 0" would
+++and continue somewhere else. Parameters "\-f 10% \-r 10% \-R 0 \-Z 0" would
++ do the trick by making safecopy skip 10% of the device content and
++ continue there without backtracking. You can always attempt to get the
++ data in between later, first get the supposedly good data on the rest
++ of the drive. Depending on the method of data recovery you plan on
++-using, it may make sense to mark the bad data with the "-M" option.
+++using, it may make sense to mark the bad data with the "\-M" option.
++ This allows you to later find files affected by data corruption more
++-easily.  Use the "-o" option to make safecopy write a badblock list
+++easily.  Use the "\-o" option to make safecopy write a badblock list
++ with all blocks skipped or unreadable.
++ .IP
++ When safecopy is done with this first run, you can attempt a second go
++-trying to get more data. Using smaller values for "-f" and allowing
++-safecopy to backtrack for the end of the affected area "-r 1*".
++-Be sure to use incremental mode "-I" to only read the blocks skipped
+++trying to get more data. Using smaller values for "\-f" and allowing
+++safecopy to backtrack for the end of the affected area "\-r 1*".
+++Be sure to use incremental mode "\-I" to only read the blocks skipped
++ in the first run.
++ .IP
++ It may make sense to let the drive cool down between runs.
++ Once you got all the data from the "good" areas of the drive you can
++ risk more "thorough" access to it. Increase the numbers of retries
++-"-R" in case of bad blocks, maybe together with a head realignment
++-"-Z 1". "-f 1*" would make safecopy try to read on every single block,
+++"\-R" in case of bad blocks, maybe together with a head realignment
+++"\-Z 1". "\-f 1*" would make safecopy try to read on every single block,
++ not skipping over bad areas at all.
++ .IP
++ If your drive stops responding, power it down, let it cool down for a
diff --cc debian/patches/series
index 0000000,0000000..15e5320
new file mode 100644
--- /dev/null
+++ b/debian/patches/series
@@@ -1,0 -1,0 +1,1 @@@
++fix-manpage
diff --cc debian/rules
index 9162658,0000000..63844c9
mode 100755,000000..100755
--- a/debian/rules
+++ b/debian/rules
@@@ -1,15 -1,0 +1,6 @@@
 +#!/usr/bin/make -f
 +
- %:
- 	dh ${@}
- 
- override_dh_auto_clean:
- 	dh_auto_clean
- 
- 	rm -f config.guess config.sub
++export DEB_BUILD_MAINT_OPTIONS = hardening=+all
 +
- override_dh_auto_configure:
- 	[ -r /usr/share/misc/config.guess ] && cp -f /usr/share/misc/config.guess config.guess
- 	[ -r /usr/share/misc/config.sub ] && cp -f /usr/share/misc/config.sub config.sub
- 
- 	dh_auto_configure -- LDFLAGS="-Wl,-z,defs"
++%:
++	dh $@ --with autoreconf
diff --cc debian/source/format
index 0000000,0000000..163aaf8
new file mode 100644
--- /dev/null
+++ b/debian/source/format
@@@ -1,0 -1,0 +1,1 @@@
++3.0 (quilt)
diff --cc debian/watch
index 1a6b322,0000000..7d94284
mode 100644,000000..100644
--- a/debian/watch
+++ b/debian/watch
@@@ -1,2 -1,0 +1,2 @@@
 +version=3
- http://sf.net/safecopy/safecopy-(.*)\.tar\.gz
++http://sf.net/safecopy/safecopy-([\d\.]+)\.tar\.(?:bz2|gz|xz)

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/forensics/safecopy.git



More information about the forensics-changes mailing list