projdbfinit Subroutine

Purpose

Sets the handle to use a local project database as specified in the dbfile pointer and opens the file with the specified mode.

Library

The libaacct.a library.

Syntax

<sys/aacct.h>

projdbfinit(void *handle, char *file, int mode)

Description

The projdbfinit subroutine sets the specified handle to use the specified project definition file. The file is opened in the specified mode. Subsequently, the project database, as represented by the handle parameter, will be referenced through file system primitives.

The project database must be initialized before calling this subroutine. The routines projdballoc and projdbfinit are provided for this purpose. The specified file is opened in the specified mode. File system calls are used to operate on these types of files. The struct projdb is filled as follows:

projdb.type = PROJ_LOCAL

projdb.fdes = value returned from open() call.

If the file parameter is NULL, then the system project database is opened.

Parameters

Item	Description
handle	Pointer to handle
file	Indicate the project definition file name
mode	Indicates the mode in which the file is opened

Security

Only for privileged users. Privilege can be extended to nonroot users by granting the CAP_AACCT capability to a user.

Return Values

Item	Description
0	Success
-1	Failure

Error Codes

Item	Description
EINVAL	Passed handle or file is invalid