[Forensics-changes] [ext3grep] 02/14: Imported Debian patch 0.6.0-1

Joao Eriberto Mota Filho eriberto at moszumanska.debian.org
Sun Mar 8 06:07:32 UTC 2015 

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

eriberto pushed a commit to branch debian
in repository ext3grep.

commit 1d2fb442ad829126485870b7766ee360fb7fb634
Author: Rich Ercolani <rercola at acm.jhu.edu>
Date:   Fri Mar 14 22:19:59 2008 -0400

    Imported Debian patch 0.6.0-1
---
 debian/changelog          |   5 ++
 debian/compat             |   1 +
 debian/control            |  19 +++++
 debian/copyright          |  62 ++++++++++++++++
 debian/docs               |   1 +
 debian/manpage/ext3grep.8 | 177 ++++++++++++++++++++++++++++++++++++++++++++++
 debian/manpages           |   1 +
 debian/rules              |  75 ++++++++++++++++++++
 debian/watch              |   2 +
 9 files changed, 343 insertions(+)

diff --git a/debian/changelog b/debian/changelog
new file mode 100644
index 0000000..6093bd5
--- /dev/null
+++ b/debian/changelog
@@ -0,0 +1,5 @@
+ext3grep (0.6.0-1) unstable; urgency=low
+
+  * Initial release (Closes: #470813)
+
+ -- Rich Ercolani <rercola at acm.jhu.edu>  Fri, 14 Mar 2008 22:19:59 -0400
diff --git a/debian/compat b/debian/compat
new file mode 100644
index 0000000..7f8f011
--- /dev/null
+++ b/debian/compat
@@ -0,0 +1 @@
+7
diff --git a/debian/control b/debian/control
new file mode 100644
index 0000000..03946d9
--- /dev/null
+++ b/debian/control
@@ -0,0 +1,19 @@
+Source: ext3grep
+Section: admin
+Priority: extra
+Maintainer: Debian Forensics <forensics-devel at lists.alioth.debian.org>
+Uploaders: Luca Bruno <lucab at debian.org>, Rich Ercolani <rercola at acm.jhu.edu>
+Build-Depends: debhelper (>= 7), autotools-dev, e2fslibs-dev, libncurses5 | libncurses-dev, pkg-config
+Standards-Version: 3.8.0
+Homepage: http://code.google.com/p/ext3grep/
+Vcs-Browser: http://git.debian.org/?p=forensics/ext3grep.git
+Vcs-Git: git://git.debian.org/git/forensics/ext3grep.git
+
+Package: ext3grep
+Architecture: any
+Depends: ${shlibs:Depends}, ${misc:Depends}
+Description: Tool to help recover deleted files on ext3 filesystems
+ ext3grep is a simple tool intended to aid anyone who accidentally deletes a
+ file on an ext3 filesystem, only to find that they wanted it shortly
+ thereafter.
+
diff --git a/debian/copyright b/debian/copyright
new file mode 100644
index 0000000..7478779
--- /dev/null
+++ b/debian/copyright
@@ -0,0 +1,62 @@
+Author: Carlo Wood <carlo at alinoe.com>
+Download: http://www.xs4all.nl/~carlo17/
+
+Files: *
+Copyright: (C) 2008 Carlo Wood <carlo at alinoe.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; 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,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ 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.
+ .
+ On Debian systems, the complete text of the GNU General Public License
+ can be found in /usr/share/common-licenses/GPL-2 file.
+
+Files: src/kernel-jbd.h
+Copyright: (C) 1998-2000 Red Hat, Inc
+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; 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,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ 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.
+ .
+ On Debian systems, the complete text of the GNU General Public License
+ can be found in /usr/share/common-licenses/GPL-2 file.
+
+Files: debian/*
+Copyright: (C) 2008 Rich Ercolani <rercola at acm.jhu.edu>
+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; 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,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ 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.
+ .
+ On Debian systems, the complete text of the GNU General Public License
+ can be found in /usr/share/common-licenses/GPL-2 file.
diff --git a/debian/docs b/debian/docs
new file mode 100644
index 0000000..e845566
--- /dev/null
+++ b/debian/docs
@@ -0,0 +1 @@
+README
diff --git a/debian/manpage/ext3grep.8 b/debian/manpage/ext3grep.8
new file mode 100644
index 0000000..848da73
--- /dev/null
+++ b/debian/manpage/ext3grep.8
@@ -0,0 +1,177 @@
+.TH EXT3GREP 8 "2008-03-14" "0.6.0" "recover files on ext3 filesystems"
+
+.SH NAME
+ext3grep \- ext3 file recovery tool
+
+.SH SYNOPSIS
+.B ext3grep
+[\fIoptions\fR] \fIfile\fR \&...
+
+.SH DESCRIPTION
+ext3grep is a tool which attempts to recover deleted files on ext3 filesystems.
+
+.SH OPTIONS
+.TP
+\fB\-\-superblock\fR
+Print contents of superblock in addition to the rest. If no action is specified
+then this option is implied.
+.TP
+\fB\-\-print\fR
+Print contents of block or inode, if any.
+.TP
+\fB\-\-ls\fR
+Print directories, one line per entry. See the \fBFILTERS\fR section for details
+on filtering this output.
+.TP
+\fB\-\-accept\fR \fIFILE\fR
+Accepts 'file' as a legal filename. Can be used multiple times. If you change
+any \fB\-\-accept\fR you must remove BOTH stage* files!
+.TP
+\fB\-\-journal\fR
+Prints the contents of the journal.
+.TP
+\fB\-\-show\-path\-inodes\fR
+Show the inode of each directory component in paths.
+
+.SS "Filters:"
+.TP
+\fB\-\-group\fR \fIgid\fR
+Only show/process files owned by process group \fIgid\fR.
+.TP
+\fB\-\-directory\fR
+Only show/process process directory inodes.
+.TP
+\fB\-\-after\fR \fIdtime\fR
+Only show/process entries deleted on or after \fIdtime\fR.
+.TP
+\fB\-\-before\fR \fIdtime\fR
+Only show/process entries deleted before \fIdtime\fR.
+.TP
+\fB\-\-deleted\fR
+Only show/process deleted entries.
+.TP
+\fB\-\-allocated\fR
+Only show/process allocated inodes/blocks.
+.TP
+\fB\-\-unallocated\fR
+Only show/process unallocated inodes/blocks.
+.TP
+\fB\-\-reallocated\fR
+Do not suppress entries with reallocated inodes. Inodes are
+considered 'reallocated' if the entry is deleted but the inode is allocated, but
+also when the file type in the dir entry and the inode are different.
+.TP
+\fB\-\-zeroed\-inodes\fR
+Do not suppress entries with zeroed inodes. Linked entries are always shown,
+regardless of this option.
+.TP
+\fB\-\-depth\fR depth
+Process directories recursively up till a depth of 'depth'.
+
+.SS "Actions:"
+.TP
+\fB\-\-inode\-to\-block\fR \fIinode_num\fR
+Print the block that contains inode \fIinode_num\fR.
+.TP
+\fB\-\-inode\fR \fIinode_num\fR
+Show info on inode \fIinode_num\fR. If \fB\-\-ls\fR is used and the inode is a
+directory, then the filters apply to the entries of the directory. If you do not
+use \fB\-\-ls\fR then \fB\-\-print\fR is implied.
+.TP
+\fB\-\-block\fR \fIblock_num\fR
+Show info on block \fIblock_num\fR. If \fB\-\-ls\fR is used and the block is the
+first block of a directory, then the filters apply to entries of the directory.
+If you do not use \fB\-\-ls\fR then \fB\-\-print\fR is implied.
+.TP
+\fB\-\-histogram\fR=[\fIatime\fR|\fIctime\fR|\fImtime\fR|\fIdtime\fR|\fIgroup\fR]
+Generate a histogram based on the given specs. Using atime, ctime or mtime will
+change the meaning of \fB\-\-after\fR and \fB\-\-before\fR to those times.
+.TP
+\fB\-\-journal\-block\fR \fIblock_num\fR
+Show info on journal block \fIblock_num\fR.
+.TP
+\fB\-\-journal\-transaction\fR \fIseq\fR
+Show info on transaction with sequence number \fIseq\fR.
+.TP
+\fB\-\-dump\-names\fR
+Write the paths of files to stdout. This implies \fB\-\-ls\fR but suppresses its
+output.
+.TP
+\fB\-\-search\-start\fR \fIstr\fR
+Find blocks that start with the fixed string \fIstr\fR.
+.TP
+\fB\-\-search\fR \fIstr\fR
+Find blocks that contain the fixed string \fIstr\fR.
+.TP
+\fB\-\-search\-inode\fR \fIblock_num\fR
+Find inodes that refer to block \fIblock_num\fR.
+.HP
+\fB\-\-search\-zeroed\-inodes\fR
+Return allocated inode table entries that are zeroed.
+.TP
+\fB\-\-inode\-dirblock\-table\fR \fIdir\fR
+Print a table for directory path \fIdir\fR of directory block numbers found and
+the inodes used for each file.
+.TP
+\fB\-\-show\-journal\-inodes\fR \fIinode_num\fR
+Show copies of inode \fIinode_num\fR still in the journal.
+.TP
+\fB\-\-restore\-file\fR \fIpath\fR
+Will restore file \fIpath\fR. \fIpath\fR is relative to root of the partition
+and does not start with a '/' (it must be one of the paths returned by
+\fB\-\-dump\-names\fR). The restored directory, file or symbolic link is created
+in the current directory as ./\fIpath\fR.
+.TP
+\fB\-\-restore\-all\fR
+As \fB\-\-restore\-file\fR but attempts to restore everything. The use of
+\fB\-\-after\fR is highly recommended because the attempt to restore very old
+files will only result in them being hard linked to a more recently deleted file
+and as such pollute the output.
+.TP
+\fB\-\-show\-hardlinks\fR
+Show all inodes that are shared by two or more files.
+.TP
+\fB\-\-version\fR, \fB\-[vV]\fR
+Prints the version information and exits.
+.TP
+\fB\-\-help\fR,
+Prints a help message and exits.
+.TP
+
+.SH EXAMPLES
+.B Restoring all files from the ext3 partition/file /backup/sda1:
+.nf
+ext3grep \-\-restore-all /backup/sda1
+.fi
+.B Listing the files owned by GID 1000 on /backup/sda1
+.nf
+ext3grep \-\-ls \-\-group 1000 /backup/sda1
+.fi
+.B Finding all files containing the string Critical_report in their name on
+/backup/sda1
+.nf
+ext3grep \-\-dump-names /backup/sda1 | grep 'Critical_report'
+.fi
+
+.SH LIMITATIONS
+Do not attempt to use ext3grep for recovery from a mounted filesystem. Ever.
+
+No, not even then.
+
+ext3grep sometimes runs out of memory spare on 32-bit architectures and crashes.
+It is highly recommended that you run ext3grep in a 64-bit environment when
+dealing with large filesystems, though this is seen as a bug.
+
+ext3grep cannot recover files if there are no remnants of them.
+
+Some files that ext3grep recovers may have trailing null bytes - just scrape
+them off like the burnt bits on toast.
+
+.SH SEE ALSO
+.BR "debugfs" "(8)"
+
+.SH AUTHOR
+This manual page was written by Rich Ercolani <rercola at acm.jhu.edu>, for the
+Debian project (but it may, of course, be used by others), because the original
+program lacked a manual page. It may be distributed under the same terms as
+ext3grep, the GNU GPL version 2 or later, at your option.
diff --git a/debian/manpages b/debian/manpages
new file mode 100644
index 0000000..31eb23e
--- /dev/null
+++ b/debian/manpages
@@ -0,0 +1 @@
+debian/manpage/*
diff --git a/debian/rules b/debian/rules
new file mode 100755
index 0000000..69a705c
--- /dev/null
+++ b/debian/rules
@@ -0,0 +1,75 @@
+#!/usr/bin/make -f
+# Uncomment the following line to disable optimization and enable
+# richer debug information.
+# DEB_BUILD_OPTIONS += nostrip noopt
+
+DEB_HOST_GNU_TYPE	?= $(shell dpkg-architecture -qDEB_HOST_GNU_TYPE)
+DEB_BUILD_GNU_TYPE	?= $(shell dpkg-architecture -qDEB_BUILD_GNU_TYPE)
+
+ifneq ($(DEB_HOST_GNU_TYPE),$(DEB_BUILD_GNU_TYPE))
+	CROSS= --build $(DEB_BUILD_GNU_TYPE) --host $(DEB_HOST_GNU_TYPE)
+else
+	CROSS= --build $(DEB_BUILD_GNU_TYPE)
+endif
+
+ifneq (,$(filter noopt,$(DEB_BUILD_OPTIONS)))
+	EXTRA += --enable-debug --disable-optimization
+endif
+
+clean:
+	dh_testdir
+	dh_testroot
+	rm -f build-stamp
+
+	[ ! -f Makefile ] || $(MAKE) distclean
+
+	dh_clean
+
+config.status: configure
+	dh_testdir
+
+ifneq "$(wildcard /usr/share/misc/config.sub)" ""
+	cp -f /usr/share/misc/config.sub config.sub
+endif
+ifneq "$(wildcard /usr/share/misc/config.guess)" ""
+	cp -f /usr/share/misc/config.guess config.guess
+endif
+
+	CFLAGS="$(CFLAGS)" LDFLAGS="-Wl,-z,defs" ./configure $(CROSS) --prefix=/usr $(EXTRA)
+
+build: build-stamp
+build-stamp: config.status
+	dh_testdir
+
+	$(MAKE)
+
+	touch build-stamp
+
+install: build
+	dh_testdir
+	dh_testroot
+	dh_clean -k
+	dh_installdirs
+
+	$(MAKE) DESTDIR=$(CURDIR)/debian/ext3grep install
+
+binary: binary-arch
+
+binary-arch: build install
+	dh_testdir
+	dh_testroot
+	dh_installchangelogs NEWS
+	dh_installdocs
+	dh_installman
+	dh_strip
+	dh_compress
+	dh_fixperms
+	dh_installdeb
+	dh_shlibdeps
+	dh_gencontrol
+	dh_md5sums
+	dh_builddeb
+
+binary-indep:
+
+.PHONY: clean build install binary binary-arch binary-indep
diff --git a/debian/watch b/debian/watch
new file mode 100644
index 0000000..c85c06e
--- /dev/null
+++ b/debian/watch
@@ -0,0 +1,2 @@
+version=3
+http://code.google.com/p/ext3grep/downloads/list http://ext3grep.googlecode.com/files/ext3grep-(.*).tar.gz

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

More information about the forensics-changes mailing list