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

md5

apr_md5_encode()

sha1

apr_sha1_base64()

and it's available only since Apache 2.0.50

crypt

Moreover on these three platforms if that function sees that the hash is not of md5 and sha1 formats, it'll do a clear to clear text matching, always returning success, no matter what the hashed value is.

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

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.

APR::Util - Perl API for Various APR Utilities