---
name: "shisa_init_with_paths"
section: "3"
platform: "linux"
package: "libshisa-dev"
version: "1.0.3-5+b1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/shisa_init_with_paths"
---

# shisa\_init\_with\_paths(3)

API function

## NAME

shisa\_init\_with\_paths - API function

## SYNOPSIS

**#include \<shisa.h\>**

**int shisa\_init\_with\_paths(Shisa \*\*** *dbh***, const char \*** *file***);**

## ARGUMENTS

- Shisa \*\* dbh

  Returned pointer to a created Shisa library handle.

- const char \* file

  Filename of system configuration, or **NULL**.

## DESCRIPTION

Creates a Shisa library handle, using **shisa()**, but reading the system configuration file at the location *file*, or at the default location, should *file* be **NULL**.  The path to the default system configuration file is decided at compile time ($sysconfdir/shisa.conf).

The handle is allocated regardless of return value, the only exception being **SHISA\_INIT\_ERROR**, which indicates a problem in allocating the handle.  Other error conditions arise while reading a file.

## RETURN VALUE

Returns **SHISA\_OK**, or an error code.  The value **SHISA\_INIT\_ERROR** indicates a failure to create the handle.

## REPORTING BUGS

Report bugs to \<bug-shishi@gnu.org\>. GNU Shishi home page: http://www.gnu.org/software/shishi/ General help using GNU software: http://www.gnu.org/gethelp/

## COPYRIGHT

Copyright © 2002-2022 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.

## SEE ALSO

The full documentation for **shishi** is maintained as a Texinfo manual.  If the **info** and **shishi** programs are properly installed at your site, the command

-

  **info shishi**

should give you access to the complete manual.