DragonFly On-Line Manual Pages
PRIVMAN(7) Miscellaneous PRIVMAN(7)
NAME
priv_init - initialize the Privman library
SYNOPSIS
#include <privman.h>
void priv_init(const char *appname);
DESCRIPTION
priv_init() initializes the Privman libraries. appname is the name of
the application. A configuration file is expected at
${prefix}/etc/privman.d/appname which describes the allowed privileged
requests from the application. The appname is also used for syslog
messages and the like.
priv_init() needs to be invoked with raised privilege (super-user
rights).
RETURN VALUE
Upon successful return, the application resumes running as an
unprivileged user, normally "nobody'. Actually, the application has
forked, and the child process has returned from priv_init().
The process has changed directory into the root of the chroot jail
specified by the configuration file. See privman_conf(5) for further
details.
FILES
${prefix}/etc/privman.d/appname
The configuration file that lists the granted privileges for the
application. See privman_conf(5) for more information.
BUGS
May continue when it should exit. Might exit when it should continue.
Isn't very forgiving of errors.
AUTHOR
Network Associates. Send email to <privman@nailabs.com>
SEE ALSO
priv_bind(3) priv_daemon(3) priv_execve(3) priv_fopen(3) priv_fork(3)
privman_conf(5) priv_open(3) priv_pam(3) priv_rerunas(3) privman(7)
Unix SEPTEMBER 2002 PRIVMAN(7)