summaryrefslogtreecommitdiff
path: root/doc/pdfdetach.hlp
blob: f85cd0f500c9744043d410c9de76c616b0506dec (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
! Generated automatically by mantohlp
1 pdfdetach

       pdfdetach - Portable Document Format (PDF) document embedded file

       pdfdetach [options] [PDF-file]

       Pdfdetach  lists or extracts embedded files (attachments) from a Porta-
       ble Document Format (PDF) file.

                                                                            ()

2 ONFIGURATION_FIL

       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
       xpdfrc(5) man page for details.

                                                                            ()

2 OPTIONS

       Some  of  the following options can be set with configuration file com-
       mands.  These are listed in square brackets with the description of the
       corresponding command line option.

       -list  List  all of the embedded files in the PDF file.  File names are
              converted to the text encoding specified by the "-enc" switch.

       -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.

       -saveall
              Save  all of the embedded files.  This uses the file names asso-
              ciated with the  embedded  files  (as  printed  by  the  "-list"
              switch).   By default, the files are saved in the current direc-
              tory; this can be changed with the "-o" switch.

       -o path
              Set the file name used when saving an  embedded  file  with  the
              "-save" switch, or the directory used by "-saveall".

       -enc encoding-name
              Sets  the encoding to use for text output (embedded file names).
              The encoding-name must be defined with  the  unicodeMap  command
              (see xpdfrc(5)).  This defaults to "Latin1" (which is a built-in
              encoding).  [config file: textEncoding]

       -opw password
              Specify the owner password for the  PDF  file.   Providing  this
              will bypass all security restrictions.

       -upw password
              Specify the user password for the PDF file.

       -cfg config-file
              Read config-file in place of ~/.xpdfrc or the system-wide config
              file.

       -v     Print copyright and version information.

       -h     Print usage information.  (-help and --help are equivalent.)

                                                                            ()

2 XIT_CODE

       The Xpdf tools use the following exit codes:

       0      No error.

       1      Error opening a PDF file.

       2      Error opening an output file.

       3      Error related to PDF permissions.

       99     Other error.

                                                                            ()

2 AUTHOR

       The  pdfinfo software and documentation are copyright 1996-2011 Glyph &
       Cog, LLC.

                                                                            ()

2 SEE_ALSO

       xpdf(1),    pdftops(1),    pdftotext(1),    pdfinfo(1),    pdffonts(1),
       pdftoppm(1), pdfimages(1), xpdfrc(5)
       http://www.foolabs.com/xpdf/

                                                                            ()