000503fad7
In the past, OpenRC was a hybrid of a centralized and file-scope license/copyright structure. I followed the instructions from the Software Freedom Law Center [1] to convert to a Centralized structure where possible, for easier future maintenance. [1] https://softwarefreedom.org/resources/2012/ManagingCopyrightInformation.html
60 lines
1.7 KiB
Groff
60 lines
1.7 KiB
Groff
.\" Copyright (c) 2007-2015 The OpenRC Authors.
|
|
.\" See the Authors file at the top-level directory of this distribution and
|
|
.\" https://github.com/OpenRC/openrc/blob/master/AUTHORS
|
|
.\"
|
|
.\" This file is part of OpenRC. It is subject to the license terms in
|
|
.\" the LICENSE file found in the top-level directory of this
|
|
.\" distribution and at https://github.com/OpenRC/openrc/blob/master/LICENSE
|
|
.\" This file may not be copied, modified, propagated, or distributed
|
|
.\" except according to the terms contained in the LICENSE file.
|
|
.\"
|
|
.Dd Mar 17, 2008
|
|
.Dt RC_CONFIG 3 SMM
|
|
.Os OpenRC
|
|
.Sh NAME
|
|
.Nm rc_config_list , rc_config_load , rc_config_value , rc_yesno
|
|
.Nd functions to query OpenRC service configurations
|
|
.Sh LIBRARY
|
|
Run Command library (librc, -lrc)
|
|
.Sh SYNOPSIS
|
|
.In rc.h
|
|
.Ft "RC_STRINGLIST *" Fn rc_config_list "const char *file"
|
|
.Ft "RC_STRINGLIST *" Fn rc_config_load "const char *file"
|
|
.Ft "char *" Fn rc_config_value "const char *const *list" "const char *entry"
|
|
.Ft bool Fn rc_yesno "const char *value"
|
|
.Sh DESCRIPTION
|
|
These functions provide an easy means of querying OpenRC configuration files.
|
|
.Pp
|
|
.Fn rc_config_list
|
|
returns a list of non comment lines in
|
|
.Fa file .
|
|
.Fn rc_config_load
|
|
does the same, but attempts to parse the line as if it was
|
|
a shell assignment.
|
|
.Fn rc_config_value
|
|
returns the value of
|
|
.Fa entry
|
|
found in
|
|
.Fa list .
|
|
.Pp
|
|
Each list should be freed using
|
|
.Fn rc_stringlist_free
|
|
when done.
|
|
.Pp
|
|
.Fn rc_yesno
|
|
returns if
|
|
.Fa value
|
|
is true, yes, on or 1 regardless of case, otherwise false.
|
|
If
|
|
.Fa value
|
|
is also not false, no, off or 0 regardless of case then
|
|
.Va errno
|
|
is set to
|
|
.Va EINVAL .
|
|
.Sh SEE ALSO
|
|
.Xr malloc 3 ,
|
|
.Xr rc_stringlist_free 3 ,
|
|
.Xr sh 1
|
|
.Sh AUTHORS
|
|
.An Roy Marples <roy@marples.name>
|