---
name: "firestring_conf_parse"
section: "3"
platform: "linux"
package: "libfirestring-dev"
version: "0.9.12-8"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/firestring_conf_parse"
---

# firestring\_conf\_parse(3)

read and parse a configuration file

## NAME

firestring\_conf\_parse - read and parse a configuration file

## SYNOPSIS

**#include \<firestring.h\>**\
 **-lfirestring**

**struct firestring\_conf\_t \*firestring\_conf\_parse(const char \****filename***)**

## DESCRIPTION

firestring\_conf\_parse() attempts to read a configuration from *filename* and parse the results into a structure that it then returns.

The support configuration format is fairly flexible:\
 \# Configuration file example\
 \# These are comments\
 variable\_name = value\
 variable\_name2=value\
 variable\_name3="quoted value"\
 variable\_name4="array value 1"\
 variable\_name4="array value 2"

**include** as a variable name is special; it causes firestring to parse the file referenced by the value, overriding any previous values (although they are still accessible as arrays).

## RETURN VALUE

Returns a pointer to a structure containing the data read from the config file, or *NULL* if the file cannot be opened.

## AUTHOR

Ian Gulliver \<ian@penguinhosting.net\>

## SEE ALSO

[**libfirestring**(3)](/libfirestring/3.md)