View on
Fred Moyer > mod_perl > APR::Util


Annotate this POD


New  25
Open  9
View/Report Bugs
Source   Latest Release: mod_perl-2.0.10


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.


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


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.

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.

syntax highlighting: