Sous-routine projdbfinit

Objectif

Définit le descripteur pour utiliser une base de données de projet locale comme indiqué dans le pointeur dbfile et ouvre le fichier avec le mode spécifié.

Bibliothèque

La bibliothèque libaacct.a .

Syntaxe

<sys/aacct.h>

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

Descriptif

La sous-routine projdbfinit définit le descripteur spécifié pour utiliser le fichier de définition de projet spécifié. Le fichier est ouvert dans le mode indiqué. Par la suite, la base de données de projet, représentée par le paramètre handle , sera référencée via des primitives de système de fichiers.

La base de données du projet doit être initialisée avant d'appeler cette sous-routine. Les routines projdballoc et projdbfinit sont fournies à cette fin. Le fichier indiqué est ouvert dans le mode indiqué. Les appels de système de fichiers sont utilisés pour opérer sur ces types de fichiers. La structure projdb est remplie comme suit:
projdb.type = PROJ_LOCAL

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

Si le paramètre file est NULL, la base de données du projet système est ouverte.

Paramètres

Article Descriptif
gestionnaire Pointeur vers le descripteur
Fichier Indiquez le nom du fichier de définition de projet
mode Indique le mode d'ouverture du fichier

Security

Uniquement pour les utilisateurs privilégiés. Le privilège peut être étendu à des utilisateurs non root en accordant la fonction CAP_AACCT à un utilisateur.

Valeurs renvoyées

Article Descriptif
0 Succès
-1 Echec

Codes d'erreur

Article Descriptif
EINVAL Le descripteur ou le fichier transmis n'est pas valide