106 lines
2.7 KiB
Groff
106 lines
2.7 KiB
Groff
.\" Copyright 2011 Glyph & Cog, LLC
|
|
.TH pdfdetach 1 "15 August 2011"
|
|
.SH NAME
|
|
pdfdetach \- Portable Document Format (PDF) document embedded file
|
|
extractor (version 3.03)
|
|
.SH SYNOPSIS
|
|
.B pdfdetach
|
|
[options]
|
|
.RI [ PDF-file ]
|
|
.SH DESCRIPTION
|
|
.B Pdfdetach
|
|
lists or extracts embedded files (attachments) from a Portable
|
|
Document Format (PDF) file.
|
|
.SH CONFIGURATION FILE
|
|
Pdfdetach reads a configuration file at startup. It first tries to
|
|
find the user's private config file, ~/.xpdfrc. If that doesn't
|
|
exist, it looks for a system-wide config file, typically
|
|
/usr/local/etc/xpdfrc (but this location can be changed when pdfinfo
|
|
is built). See the
|
|
.BR xpdfrc (5)
|
|
man page for details.
|
|
.SH OPTIONS
|
|
Some of the following options can be set with configuration file
|
|
commands. These are listed in square brackets with the description of
|
|
the corresponding command line option.
|
|
.TP
|
|
.B \-list
|
|
List all of the embedded files in the PDF file. File names are
|
|
converted to the text encoding specified by the "\-enc" switch.
|
|
.TP
|
|
.BI \-save " number"
|
|
Save the specified embedded file. By default, this uses the file name
|
|
associated with the embedded file (as printed by the "\-list" switch);
|
|
the file name can be changed with the "\-o" switch.
|
|
.TP
|
|
.BI \-saveall
|
|
Save all of the embedded files. This uses the file names associated
|
|
with the embedded files (as printed by the "\-list" switch). By
|
|
default, the files are saved in the current directory; this can be
|
|
changed with the "\-o" switch.
|
|
.TP
|
|
.BI \-o " path"
|
|
Set the file name used when saving an embedded file with the "\-save"
|
|
switch, or the directory used by "\-saveall".
|
|
.TP
|
|
.BI \-enc " encoding-name"
|
|
Sets the encoding to use for text output (embedded file names). The
|
|
.I encoding\-name
|
|
must be defined with the unicodeMap command (see
|
|
.BR xpdfrc (5)).
|
|
This defaults to "Latin1" (which is a built-in encoding).
|
|
.RB "[config file: " textEncoding ]
|
|
.TP
|
|
.BI \-opw " password"
|
|
Specify the owner password for the PDF file. Providing this will
|
|
bypass all security restrictions.
|
|
.TP
|
|
.BI \-upw " password"
|
|
Specify the user password for the PDF file.
|
|
.TP
|
|
.BI \-cfg " config-file"
|
|
Read
|
|
.I config-file
|
|
in place of ~/.xpdfrc or the system-wide config file.
|
|
.TP
|
|
.B \-v
|
|
Print copyright and version information.
|
|
.TP
|
|
.B \-h
|
|
Print usage information.
|
|
.RB ( \-help
|
|
and
|
|
.B \-\-help
|
|
are equivalent.)
|
|
.SH EXIT CODES
|
|
The Xpdf tools use the following exit codes:
|
|
.TP
|
|
0
|
|
No error.
|
|
.TP
|
|
1
|
|
Error opening a PDF file.
|
|
.TP
|
|
2
|
|
Error opening an output file.
|
|
.TP
|
|
3
|
|
Error related to PDF permissions.
|
|
.TP
|
|
99
|
|
Other error.
|
|
.SH AUTHOR
|
|
The pdfinfo software and documentation are copyright 1996-2011 Glyph &
|
|
Cog, LLC.
|
|
.SH "SEE ALSO"
|
|
.BR xpdf (1),
|
|
.BR pdftops (1),
|
|
.BR pdftotext (1),
|
|
.BR pdfinfo (1),
|
|
.BR pdffonts (1),
|
|
.BR pdftoppm (1),
|
|
.BR pdfimages (1),
|
|
.BR xpdfrc (5)
|
|
.br
|
|
.B http://www.foolabs.com/xpdf/
|