APR::Util - Perl API for Various APR Utilities


APR::Util - Perl API for Various APR Utilities


  use APR::Util ();

  $ok = password_validate($passwd, $hash);


Various APR utilities that don't fit into any other group.


APR::Util provides the following functions and/or methods:


Validate an encrypted password hash against a plain text password (with lots of restrictions and peculiarities).

  $ok = password_validate($passwd, $hash);
arg1: $passwd ( string )
Plain text password string

arg2: $hash ( string )
Encrypted or encoded hash. See below for supported hash formats.

ret: $ok ( boolean )
The password either matches or not.

since: 1.99_15

The function handles the output of the following functions (it knows to tell md5 and sha1 from the others, since they are have a special pattern recognized by apr):

Warning: double check that you understand what this function does and does not before using it.

Unsupported API

APR::Socket also provides auto-generated Perl interface for a few other methods which aren't tested at the moment and therefore their API is a subject to change. These methods will be finalized later as a need arises. If you want to rely on any of the following methods please contact the the mod_perl development mailing list so we can help each other take the steps necessary to shift the method to an officially supported API.


META: Autogenerated - needs to be reviewed/completed

[We have File::Spec and File::Basename for this purpose, I can't see why this api is needed]

return the final element of the pathname

  $ret = filepath_name_get($pathname);
arg1: $pathname ( string )
The path to get the final element of

ret: $ret ( string )
the final element of the path

For example:

  "/foo/bar/gum"    => "gum"
  "/foo/bar/gum/"   => ""
  "gum"             => "gum"
  "bs\\path\\stuff" => "stuff"

since: subject to change


META: Autogenerated - needs to be reviewed/completed

Display a prompt and read in the password from stdin.

  $ret = password_get($prompt, $pwbuf, $bufsize);
arg1: $prompt ( string )
The prompt to display

arg2: $pwbuf ( string )
Buffer to store the password

arg3: $bufsize (number)
The length of the password buffer.

ret: $ret (integer)
since: subject to change

See Also

mod_perl 2.0 documentation.


mod_perl 2.0 and its core modules are copyrighted under The Apache Software License, Version 2.0.


The mod_perl development team and numerous contributors.

 APR::Util - Perl API for Various APR Utilities