b067d27d61
In order to avoid global state, add a context parameter to qdf_ini_parse. This parameter will get passed back to consumers via the existing callbacks. Change-Id: Icd74a58815701b4603924838bb84c7956058da6b CRs-Fixed: 2194517
64 linhas
2.3 KiB
C
64 linhas
2.3 KiB
C
/*
|
|
* Copyright (c) 2018 The Linux Foundation. All rights reserved.
|
|
*
|
|
* Permission to use, copy, modify, and/or distribute this software for
|
|
* any purpose with or without fee is hereby granted, provided that the
|
|
* above copyright notice and this permission notice appear in all
|
|
* copies.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
|
|
* WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
|
|
* WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
|
|
* AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
|
|
* DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
|
|
* PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
|
|
* TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
|
|
* PERFORMANCE OF THIS SOFTWARE.
|
|
*/
|
|
|
|
/**
|
|
* DOC: Text parsing related abstractions, not related to a specific type
|
|
*/
|
|
|
|
#ifndef __QDF_PARSE_H
|
|
#define __QDF_PARSE_H
|
|
|
|
#include "qdf_status.h"
|
|
|
|
typedef QDF_STATUS (*qdf_ini_section_cb)(void *context, const char *name);
|
|
typedef QDF_STATUS (*qdf_ini_item_cb)(void *context,
|
|
const char *key,
|
|
const char *value);
|
|
|
|
/**
|
|
* qdf_ini_parse() - parse an ini file
|
|
* @ini_path: The full file path of the ini file to parse
|
|
* @context: The caller supplied context to pass into callbacks
|
|
* @item_cb: Ini item (key/value pair) handler callback function
|
|
* Return QDF_STATUS_SUCCESS to continue parsing, else to abort
|
|
* @section_cb: Ini section header handler callback function
|
|
* Return QDF_STATUS_SUCCESS to continue parsing, else to abort
|
|
*
|
|
* The *.ini file format is a simple format consisting of a list of key/value
|
|
* pairs (items), separated by an '=' character. Comments are initiated with
|
|
* a '#' character. Sections are also supported, using '[' and ']' around the
|
|
* section name. e.g.
|
|
*
|
|
* # comments are started with a '#' character
|
|
* # items are key/value string pairs, separated by the '=' character
|
|
* someKey1=someValue1
|
|
* someKey2=someValue2 # this is also a comment
|
|
*
|
|
* # section headers are enclosed in square brackets
|
|
* [some section header] # new section begins
|
|
* someKey3=someValue3
|
|
*
|
|
* Return: QDF_STATUS
|
|
*/
|
|
QDF_STATUS
|
|
qdf_ini_parse(const char *ini_path, void *context,
|
|
qdf_ini_item_cb item_cb, qdf_ini_section_cb section_cb);
|
|
|
|
#endif /* __QDF_PARSE_H */
|
|
|