'\" t
.\"     Title: ECONF_SET_CONF_DIRS
.\"    Author: libeconf Developers
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 2025-12-04
.\"    Manual: libeconf Manual
.\"    Source: libeconf
.\"  Language: English
.\"
.TH "ECONF_SET_CONF_DIRS" "3" "2025\-12\-04" "libeconf" "libeconf Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------

.SH "NAME"
econf_set_conf_dirs \- sets the list of configuration directory post\-fixes

.SH "SYNOPSIS"
      
.sp
.ft B
.nf
#include <libeconf\&.h>
.fi
.ft
.sp

.BI "econf_err econf_set_conf_dirs(const\ char\ **" "dir_postfix_list" ");"

.SH "DESCRIPTION"

.PP
The \fBeconf_set_conf_dirs\fR() function sets a list of directory structures (with order) which describes the directories
in which the files have to be parsed\&.

.PP
The argument \fIdir_postfix_list\fR is an array of null\-terminated strings, terminated by a \fBNULL\fR pointer\&.

.PP
E.G. with the given list: {"/conf.d/", ".d/", "/", NULL} files in following
directories will be parsed: <default_dirs>/<project_name>.<suffix>.d/
<default_dirs>/<project_name>/conf.d/, <default_dirs>/<project_name>.d/,
<default_dirs>/<project_name>/. The entry <default_dirs>/<project_name>.<suffix>.d/
will be added automatically\&.

.SH "RETURN VALUE"

.PP
On success, \fBeconf_set_conf_dirs\fR() returns \fBECONF_SUCCESS\fR\&.

.PP
On failure, an error code of type \fBeconf_err\fR is returned\&.

.SH "ERRORS"

.PP
\fBECONF_NOMEM\fR
.RS 4
          Out of memory\&.

.RE

.SH "SEE ALSO"

.PP
\fBlibeconf\fR(3),
\fBeconf_readConfig\fR(3),
\fBeconf_errString\fR(3).

.RE