2
1
mirror of https://github.com/qpdf/qpdf.git synced 2025-01-23 15:18:33 +00:00

Clarify methods to get user password

With newer encryption formats, it is no longer possible to recover the
user password using the owner password.
This commit is contained in:
Jay Berkenbilt 2013-01-03 20:45:53 -05:00
parent 9261f3b922
commit a04a835849

View File

@ -345,12 +345,16 @@ class QPDF
std::string& encryption_key, std::string& encryption_key,
std::string& O, std::string& U, std::string& O, std::string& U,
std::string& OE, std::string& UE, std::string& Perms); std::string& OE, std::string& UE, std::string& Perms);
// Return the full user password as stored in the PDF file. If // Return the full user password as stored in the PDF file. For
// you are attempting to recover the user password in a // files encrypted with 40-bit or 128-bit keys, the user password
// can be recovered when the file is opened using the owner
// password. This is not possible with newer encryption formats.
// If you are attempting to recover the user password in a
// user-presentable form, call getTrimmedUserPassword() instead. // user-presentable form, call getTrimmedUserPassword() instead.
QPDF_DLL QPDF_DLL
std::string const& getPaddedUserPassword() const; std::string const& getPaddedUserPassword() const;
// Return human-readable form of user password. // Return human-readable form of user password subject to same
// limitations as getPaddedUserPassword().
QPDF_DLL QPDF_DLL
std::string getTrimmedUserPassword() const; std::string getTrimmedUserPassword() const;
// Return the previously computed or retrieved encryption key for // Return the previously computed or retrieved encryption key for