src/common/ini.c


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116

/*
 *  ini.c
 *
 *  Copyright (c) 2013-2015 Pacman Development Team <pacman-dev@archlinux.org>
 *
 *  This program is free software; you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation; either version 2 of the License, or
 *  (at your option) any later version.
 *
 *  This program is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License
 *  along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */

#include <errno.h>
#include <limits.h>
#include <string.h> /* strdup */

#include <alpm.h>

#include "ini.h"
#include "util.h"

/**
 * @brief Parse a pacman-style INI config file.
 *
 * @param file path to the config file
 * @param cb callback for key/value pairs
 * @param data caller defined data to be passed to the callback
 *
 * @return the callback return value
 *
 * @note The callback will be called at the beginning of each section with an
 * empty key and value and for each key/value pair.
 *
 * @note If the parser encounters an error the callback will be called with
 * section, key, and value set to NULL and errno set by fopen, fgets, or
 * strdup.
 *
 * @note The @a key and @a value passed to @ cb will be overwritten between
 * calls.  The section name will remain valid until after @a cb is called to
 * begin a new section.
 *
 * @note Parsing will immediately stop if the callback returns non-zero.
 */
int parse_ini(const char *file, ini_parser_fn cb, void *data)
{
        char line[PATH_MAX], *section_name = NULL;
        FILE *fp = NULL;
        int linenum = 0;
        int ret = 0;

        fp = fopen(file, "r");
        if(fp == NULL) {
                return cb(file, 0, NULL, NULL, NULL, data);
        }

        while(safe_fgets(line, PATH_MAX, fp)) {
                char *key, *value, *ptr;
                size_t line_len;

                linenum++;

                /* ignore whole line and end of line comments */
                if((ptr = strchr(line, '#'))) {
                        *ptr = '\0';
                }

                line_len = strtrim(line);

                if(line_len == 0) {
                        continue;
                }

                if(line[0] == '[' && line[line_len - 1] == ']') {
                        char *name;
                        /* new config section, skip the '[' */
                        name = strdup(line + 1);
                        name[line_len - 2] = '\0';

                        ret = cb(file, linenum, name, NULL, NULL, data);
                        free(section_name);
                        section_name = name;

                        /* we're at a new section; perform any post-actions for the prior */
                        if(ret) {
                                goto cleanup;
                        }
                        continue;
                }

                /* directive */
                /* strsep modifies the 'line' string: 'key \0 value' */
                key = line;
                value = line;
                strsep(&value, "=");
                strtrim(key);
                strtrim(value);

                if((ret = cb(file, linenum, section_name, key, value, data)) != 0) {
                        goto cleanup;
                }
        }

cleanup:
        fclose(fp);
        free(section_name);
        return ret;
}

/* vim: set noet: */