NAME

Crypt::OpenPGP::Util - Miscellaneous utility functions

DESCRIPTION

Crypt::OpenPGP::Util contains a set of exportable utility functions used through the Crypt::OpenPGP set of libraries.

bitsize($n)

Returns the number of bits in the Math::BigInt integer object $n.

bin2bigint($string)

Given a string $string of any length, treats the string as a base-256 representation of an integer, and returns that integer, a Math::BigInt object.

bin2mp is an alias for this function, for backwards compatibility reasons.

bigint2bin($int)

Given a biginteger $int (a Math::BigInt object), linearizes the integer into an octet string, and returns the octet string.

mp2bin is an alias for this function, for backwards compatibility reasons.

mod_exp($a, $exp, $n)

Computes $a ^ $exp mod $n and returns the value. The calculations are done using Math::BigInt, and the return value is a Math::BigInt object.

mod_inverse($a, $n)

Computes the multiplicative inverse of $a mod $n and returns the value. The calculations are done using Math::BigInt, and the return value is a Math::BigInt object.

canonical_text($text)

Takes a piece of text content $text and formats it into PGP canonical text, where: 1) all whitespace at the end of lines is stripped, and 2) all line endings are made up of a carriage return followed by a line feed. Returns the canonical form of the text.

dash_escape($text)

Escapes $text for use in a cleartext signature; the escaping looks for any line starting with a dash, and on such lines prepends a dash ('-') followed by a space (' '). Returns the escaped text.

AUTHOR & COPYRIGHTS

Please see the Crypt::OpenPGP manpage for author, copyright, and license information.