NAME

CAM::PDF::Decrypt - PDF security helper

LICENSE

See CAM::PDF.

SYNOPSIS

    use CAM::PDF;
    my $pdf = CAM::PDF->new($filename);

DESCRIPTION

This class is used invisibly by CAM::PDF whenever it detects that a document is encrypted. See new(), getPrefs() and setPrefs() in that module.

FUNCTIONS

$pkg->new($pdf, $ownerpass, $userpass, $prompt)

Create and validate a new decryption object. If this fails, it will set $CAM::PDF::errstr and return undef.

$prompt is a boolean that says whether the user should be prompted for a password on the command line.

$self->decode_permissions($field)

Given a binary encoded permissions string from a PDF document, return the four individual boolean fields as an array:

  print boolean
  modify boolean
  copy boolean
  add boolean

$self->encode_permissions($print, $modify, $copy, $add)

Given four booleans, pack them into a single field in the PDF style that decode_permissions can understand. Returns that scalar.

$self->set_passwords($doc, $ownerpass, $userpass)

$self->set_passwords($doc, $ownerpass, $userpass, $permissions)

Change the PDF passwords to the specified values. When the PDF is output, it will be encrypted with the new passwords.

PERMISSIONS is an optional scalar of the form that decode_permissions can understand. If not specified, the existing values will be retained.

Note: we only support writing using encryption version 1, even though we can read encryption version 2 as well.

$self->encrypt($doc, $string)

Encrypt the scalar using the passwords previously specified.

$self->decrypt($doc, $string)

Decrypt the scalar using the passwords previously specified.

AUTHOR

See CAM::PDF