NAME

PApp::User - manage users, preferences and access rights

SYNOPSIS

use PApp::User;

DESCRIPTION

This module helps administrate users and groups (groups are more commonly called "access rights" within PApp). Wherever a so-called "group" or "access right" is required you can either use a string (group name) or a number (the numerical group id).

Both usernames and group names must be valid XML-Names (this might or might not be enforced).

FUNCTIONS

grpid grpname-or-grpid

Return the numerical group id of the given group.

authen_p

Return true when the user has logged in ("authenticitated herself") using this module

access_p $grp

Return true when the user has the specified access right (and is logged in!). This function checks first for the given global access right and then for the app-specific access right of the same name (by prepending <appname>\x00 to the name).

enum_access [$uid]

Return all access rights of the logged-in (or specified) user.

grant_access [$userid, ]accessright

Grant the specified access right to the logged-in (or specified) user.

revoke_access [$userid, ]accessright

Revoke the specified access right to the logged-in (or specified) user.

find_access $accessright

Find all users (uid's) with the given access right.

SEE ALSO

PApp.

AUTHOR

Marc Lehmann <pcg@goof.com>
http://www.goof.com/pcg/marc/