[Forensics-changes] [SCM] debian-forensics/undbx branch, debian, updated. upstream/0.20-9-g1d03607

[Christophe Monniez]

The following commit has been merged in the debian branch:
commit 1d036078dae25d27c8438fa7f790471513114a51
Author: Christophe Monniez <christophe.monniez at fccu.be>
Date:   Wed Feb 23 16:13:17 2011 +0100

    Adding a man page.

diff --git a/debian/undbx.1 b/debian/undbx.1
new file mode 100644
index 0000000..758c069
--- /dev/null
+++ b/debian/undbx.1
@@ -0,0 +1,63 @@
+.TH undbx 1 "February 23, 2011" "" "undbx"
+
+.SH NAME
+undbx \- a tool to extract e-mails from Outlook Express .dbx files.
+
+.SH SYNOPSIS
+.B undbx
+.RI [ options ] <DBX-DIRECTORY | DBX-FILE> [<OUTPUT-DIRECTORY>]
+.br
+
+.SH DESCRIPTION
+\fBundbx\fR is a tool to extract, recover and undelete e-mails messages from Outlook Express .dbx files.
+.PP
+Email are extracted in individual .eml files.
+.PP
+When a target directory is specified, \fBundbx\fR will extract e-mails from dbx files found in this directory.
+Instead of providing a target directory, the usr can provide a target dbx file.
+.PP
+When no output directory is specified, \fBundbx\fR will extract emails in a subdirectory of the current directory.
+.PP
+In normal mode (not recovery), a message is extracted only if there is no corresponding .eml file in the destination directory.
+.PP
+On the other hand, if a .eml file exists in the destination directory and no corresponding mail is found in the .dbx file, the mail is considered deleted and \fBundbx\fR will delete this .eml file.
+This way, \fBundbx\fR can be used as an synchronization backup tool for .dbx files.
+.PP
+The file names of .eml files are composed by the From, To and Subjec: header fields.
+The modification time of each file is set to match the date specified in the Date field of the mail header.
+.SH OPTIONS
+
+.B
+.IP --help
+Provides a short help message.
+
+.B
+.IP --recover
+\fBundbx\fR attempt to recover e-mail messages from a corrupted .dbx file.
+.PP
+In this mode fragments of messages are collected into .eml files. This may take a long time and some messages maybe corrupted.
+.PP
+Also, all messages are extracted, not only the new ones.
+
+.B
+.IP --version
+Shows the version string
+
+.SH "SEE ALSO"
+.BR pffinfo (1)
+.BR pffexport (1)
+.BR munpack (1)
+
+.SH AUTHOR
+.br
+This manual page was written by Christophe Monniez <christophe.monniez at fccu.be> for the Debian system (but may be used by others).
+
+.br
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU General Public License, Version 3 or any
+later version published by the Free Software Foundation
+
+.br
+On Debian systems, the complete text of the GNU General Public License
+can be found in /usr/share/common-licenses/GPL.
+
diff --git a/debian/undbx.manpages b/debian/undbx.manpages
new file mode 100644
index 0000000..d6e580a
--- /dev/null
+++ b/debian/undbx.manpages
@@ -0,0 +1 @@
+debian/undbx.1

-- 
debian-forensics/undbx