shishi_init_with_paths3
Api function
Usage
#include <shishi.h>
int shishi_init_with_paths(Shishi ** handle, const char * tktsfile, const char * systemcfgfile, const char * usercfgfile);
Arguments
Shishi ** handle
|
Pointer to a Shishi handle created by this call. |
|---|---|
const char * tktsfile
|
Filename of ticket file, or NULL. |
const char * systemcfgfile
|
Filename of system configuration, or NULL. |
const char * usercfgfile
|
Filename of user configuration, or NULL. |
Overview
Creates a Shishi library handle, using shishi(), and reads the system configuration file, user configuration file, and user tickets at the specified locations. If any of usercfgfile or systemcfgfile is NULL, the file is read from its default location, which for the system configuration is decided at compile time, and is $sysconfdir/shishi.conf, and for the user configuration it is $HOME/.shishi/config. If the ticket file name is NULL, a ticket file is not read at all.
The handle is allocated regardless of return value. The single exception being SHISHI_HANDLE_ERROR, which indicates a problem in allocating the handle. Other error conditions could arise while reading files.
Return value
Returns SHISHI_OK iff successful.
Releases
10 releases since Debian 4.0 (Etch); the text changed 5 times.