Chris Dolan > CAM-PDF-1.52 >


Annotate this POD (1)


New  20
Open  18
View/Report Bugs
Source   Latest Release: CAM-PDF-1.60

NAME ^ - Rebuild a PDF file

SYNOPSIS ^ [options] infile.pdf [outfile.pdf] [password(s)]\n";

   -c --cleanse        seek and destroy unreferenced metadata in the document
   -C --clearannots    remove all annotations (including forms)
   -d --decode         uncompress any encoded elements
   -f --filter=name    compress all elements with this filter (can use more than once)
   -X --decrypt        remove encryption from the document
   -o --order          preserve the internal PDF ordering for output
   -v --verbose        print diagnostic messages
   -h --help           verbose help message
   -V --version        print CAM::PDF version

   -p --pass opass upass              set a new owner and user password
   -P --prefs print modify copy add   set boolean permissions for the document

The optional password arguments are needed to open password-protected PDF files. Here's an example of password-protecting and then unprotecting it in sequence: --pass SecretPass SecretPass orig.pdf passworded.pdf --decrypt passworded.pdf unprotected.pdf SecretPass

If you want to prevent people from being able to perform the latter step, then tighten your permissions: -p Secret Secret -P 1 0 0 0 orig.pdf passworded.pdf

which means that users can print the passworded PDF, but not change it, copy-and-paste from it, or append to it.


Read and write a PDF document, and possibly modify it along the way.

The --cleanse option could possibly break some PDFs which use undocumented or poorly documented PDF features. Namely, some PDFs implicitly store their FontDescriptor objects just before their Font objects, without explicitly referring to the former. Cleansing removes the former, causing Acrobat Reader to choke.

We recommend that you avoid the --decode and --filter options, as we're not sure they work right any longer.





syntax highlighting: