DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH
 

APR::Util



NAME

APR::Util - Perl API for Various APR Utilities


Synopsis

  use APR::Util ();
  
  $ok = password_validate($passwd, $hash);


Description

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


API

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

password_validate

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: 2.0.00

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.

filepath_name_get

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

password_get

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.


Copyright

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


Authors

The mod_perl development team and numerous contributors.