system/extundelete: New maintainer, man page.

Signed-off-by: B. Watson <urchlay@slackware.uk>

Signed-off-by: Willy Sudiarto Raharjo <willysr@slackbuilds.org>
This commit is contained in:
B. Watson 2023-07-09 06:07:48 -04:00 committed by Willy Sudiarto Raharjo
parent 590ff449db
commit cf6205c607
No known key found for this signature in database
GPG Key ID: 3F617144D7238786
3 changed files with 136 additions and 25 deletions

View File

@ -0,0 +1,117 @@
.\" Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH EXTUNDELETE 1 "September 29, 2010"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh disable hyphenation
.\" .hy enable hyphenation
.\" .ad l left justify
.\" .ad b justify to both left and right margins
.\" .nf disable filling
.\" .fi enable filling
.\" .br insert line break
.\" .sp <n> insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
extundelete \- utility to undelete files from an ext3 or ext4 partition.
.SH SYNOPSIS
.B extundelete
.RI [ options ] " device-file" ...
.br
.SH DESCRIPTION
.PP
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
.\" respectively.
\fBextundelete\fP is a utility that can recover deleted files from an ext3 or ext4 partition
.br
extundelete uses the information stored in the partition's journal to attempt to recover
a file that has been deleted from the partition.
.br
There is no guarantee that any particular file will be able to be undeleted, so always try to have
a good backup system in place, or at least put one in place after recovering your files!
.SH OPTIONS
.TP
.B \-\-version
Prints the version number of extundelete.
.TP
.B \-\-help
Print a brief usage summary for extundelete.
.TP
.B Partition name
Name of the partition that has deleted files, such as /dev/sda3.
.br
Could also be the file name of a copy of the partition, such as that made with dd.
.TP
.B \-\-superblock
Prints information about the filesystem from the superblock.
.TP
.B \-\-journal \-\-superblock
Prints information about the journal from the journal's superblock.
.TP
.B \-\-inode #
Prints the information from the inode number of the filesystem given, such as "\-\-inode 2".
.TP
.B \-\-block #
Prints the contents of the block, called as "\-\-block 9652".
.TP
.B \-\-restore\-file path/to/deleted/file
Attempts to restore the file which was deleted at the given filename, called as "\-\-restore-file dirname/filename".
.TP
.B \-\-restore\-inode #
Used to restore inodes by number, called as "\-\-restore-inode 2569".
.br
Also accepts a list of inodes separated by only commas, such as "\-\-restore-inode 2569,5692,6925".
.TP
.B \-\-restore\-files filename
Restores a list of files. First, construct a list of files in the same style as would be
.br
used in the \-\-restore\-file option, and save it to the file "filename".
.br
Then, this option may be used to attempt to restore those files with a single call to extundelete.
.br
This form also reduces redundancy from multiple calls parsing the journal multiple times.
.TP
.B \-\-restore\-all
Restores all files possible to undelete to their names before deletion, when possible.
Other files are restored to a filename like "file.NNNN".
.TP
.B \-\-restore\-directory path/of/directory
Restores all files possible to link to specified directory to their names before deletion, when possible.
.TP
.B \-j journal_dev
Specifies the device that is the external journal of the file system.
.TP
.B \-b block_number
Specifies the block number of the backup superblock to be used when opening the file system.
.TP
.B \-B block_size
Specifies the block size of the partition to be used when opening the file system.
.TP
.B \-\-before date
Only restore files deleted before the date specified, which should be in the form of the number of seconds since the UNIX epoch.
Use a shell command like
.br
$ date \-d "Aug 1 9:02" +%s
.br
to convert a human-readable date to the proper format. The conversion from the number of seconds to a readable format may be found
by using either of the following:
.br
$ date \-d@1234567890
.br
$ perl \-le "print scalar localtime 1234567890"
.TP
.B \-\-after date
Only restore files deleted after the date specified, which should be in the form of the number of seconds since the UNIX epoch.
.br
See the notes for the \-\-before option for more information.
.br
.SH AUTHOR
extundelete was written by Nic Case <number9652@users.sourceforge.net> Copyright (C) 2009, 2012
.PP
This manual page was written by Elías Alejandro Año Mendoza <ealmdz@gmail.com>,
for the Debian project (and may be used by others).

View File

@ -23,13 +23,17 @@
# OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
# SUCH DAMAGE.
#
# Markus Reichelt, slackbuilds@mareichelt.de, 0xCCEEF115
# Markus Reichelt, (email removed)
# 20230709 bkw: BUILD=2
# - new maintainer.
# - add man page, cribbed from Debian.
cd $(dirname $0) ; CWD=$(pwd)
PRGNAM=extundelete
VERSION=${VERSION:-0.2.4}
BUILD=${BUILD:-1}
BUILD=${BUILD:-2}
TAG=${TAG:-_SBo}
PKGTYPE=${PKGTYPE:-tgz}
@ -41,9 +45,6 @@ if [ -z "$ARCH" ]; then
esac
fi
# If the variable PRINT_PACKAGE_NAME is set, then this script will report what
# the name of the created package would be, and then exit. This information
# could be useful to other scripts.
if [ ! -z "${PRINT_PACKAGE_NAME}" ]; then
echo "$PRGNAM-$VERSION-$ARCH-$BUILD$TAG.$PKGTYPE"
exit 0
@ -55,16 +56,12 @@ OUTPUT=${OUTPUT:-/tmp}
if [ "$ARCH" = "i586" ]; then
SLKCFLAGS="-O2 -march=i586 -mtune=i686"
LIBDIRSUFFIX=""
elif [ "$ARCH" = "i686" ]; then
SLKCFLAGS="-O2 -march=i686 -mtune=i686"
LIBDIRSUFFIX=""
elif [ "$ARCH" = "x86_64" ]; then
SLKCFLAGS="-O2 -fPIC"
LIBDIRSUFFIX="64"
else
SLKCFLAGS="-O2"
LIBDIRSUFFIX=""
fi
set -e
@ -76,29 +73,26 @@ rm -rf $PRGNAM-$VERSION
tar xvf $CWD/$PRGNAM-$VERSION.tar.bz2
cd $PRGNAM-$VERSION
chown -R root:root .
find -L . \
\( -perm 777 -o -perm 775 -o -perm 750 -o -perm 711 -o -perm 555 \
-o -perm 511 \) -exec chmod 755 {} \; -o \
\( -perm 666 -o -perm 664 -o -perm 640 -o -perm 600 -o -perm 444 \
-o -perm 440 -o -perm 400 \) -exec chmod 644 {} \;
find -L . -perm /111 -a \! -perm 755 -a -exec chmod 755 {} + -o \
\! -perm /111 -a \! -perm 644 -a -exec chmod 644 {} +
patch -p1 < $CWD/extundelete-e2fsprogs-1.44.1.patch
mkdir -p $PKG/usr/bin $PKG/usr/doc
mkdir -p $PKG/usr/bin
DFLAGS=$LDFLAGS \
CFLAGS=$SLKCFLAGS \
./configure --prefix=$PKG/usr
./configure --prefix=/usr
make
make install
make install-strip DESTDIR=$PKG
find $PKG -print0 | xargs -0 file | grep -e "executable" -e "shared object" | grep ELF \
| cut -f 1 -d : | xargs strip --strip-unneeded 2> /dev/null || true
mkdir -p $PKG/usr/man/man1
gzip -9c < $CWD/$PRGNAM.1 > $PKG/usr/man/man1/$PRGNAM.1.gz
mkdir -p $PKG/usr/doc/$PRGNAM-$VERSION
cp -a LICENSE* README* $PKG/usr/doc/$PRGNAM-$VERSION
cat $CWD/$PRGNAM.SlackBuild > $PKG/usr/doc/$PRGNAM-$VERSION/$PRGNAM.SlackBuild
PKGDOC=$PKG/usr/doc/$PRGNAM-$VERSION
mkdir -p $PKGDOC
cp -a LICENSE* README* $PKGDOC
cat $CWD/$PRGNAM.SlackBuild > $PKGDOC/$PRGNAM.SlackBuild
mkdir -p $PKG/install
cat $CWD/slack-desc > $PKG/install/slack-desc

View File

@ -6,5 +6,5 @@ MD5SUM="77e626ad31433680c0a222069295d2ca"
DOWNLOAD_x86_64=""
MD5SUM_x86_64=""
REQUIRES=""
MAINTAINER="Markus Reichelt"
EMAIL="slackbuilds@mareichelt.de"
MAINTAINER="B. Watson"
EMAIL="urchlay@slackware.uk"