NAME

shisa_init - API function

SYNOPSIS

#include <shisa.h>

int shisa_init(Shisa ** dbh);

ARGUMENTS

Shisa ** dbh: pointer to library handle to be created.

DESCRIPTION

Create a Shisa library handle, using shisa(), and read the system configuration file from their default locations. The paths to the default system configuration file is decided at compile time ($sysconfdir/shisa.conf).

The handle is allocated regardless of return values, except for SHISA_INIT_ERROR which indicates a problem allocating the handle. (The other error conditions comes from reading the files.)

RETURN VALUE

Returns SHISA_OK iff successful.

REPORTING BUGS

Report bugs to <bug-shishi@gnu.org>.

COPYRIGHT

Copyright © 2002-2010 Simon Josefsson.
Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved.