diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-19 05:31:45 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-19 05:31:45 +0000 |
commit | 74aa0bc6779af38018a03fd2cf4419fe85917904 (patch) | |
tree | 9cb0681aac9a94a49c153d5823e7a55d1513d91f /src/util/sss_ini.h | |
parent | Initial commit. (diff) | |
download | sssd-74aa0bc6779af38018a03fd2cf4419fe85917904.tar.xz sssd-74aa0bc6779af38018a03fd2cf4419fe85917904.zip |
Adding upstream version 2.9.4.upstream/2.9.4
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'src/util/sss_ini.h')
-rw-r--r-- | src/util/sss_ini.h | 164 |
1 files changed, 164 insertions, 0 deletions
diff --git a/src/util/sss_ini.h b/src/util/sss_ini.h new file mode 100644 index 0000000..4e3f67f --- /dev/null +++ b/src/util/sss_ini.h @@ -0,0 +1,164 @@ +/* + SSSD + + sss_ini.c + + Authors: + Ondrej Kos <okos@redhat.com> + + Copyright (C) 2013 Red Hat + + + 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 3 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/>. +*/ + + +#ifndef __SSS_INI_H__ +#define __SSS_INI_H__ + +#include <stdbool.h> + +/** + * @brief INI data structure + */ +struct sss_ini; + +/** + * @brief create new ini data object + * + * @param[in] tmp_ctx talloc context + * + * @return + * - pointer to newly allocated and initialized structure + * - NULL in case of error + */ +struct sss_ini* sss_ini_new(TALLOC_CTX *tmp_ctx); + + +/** + * @brief Open ini file or use fallback_cfg if file is not present. Include + * configuration snippets and perform access check. + * + * @param[in] self pointer to sss_ini structure + * @param[in] config_file ini file + * @param[in] config_dir directory containing ini files to be included + * + * @return + * - EOK - success + * - ERR_INI_OPEN_FAILED - sss_ini_open failed + * - ERR_INI_INVALID_PERMISSION - access check failed + * - ERR_INI_PARSE_FAILED - failed to parse configuration file + * - ERR_INI_ADD_SNIPPETS_FAILED - failed to add configuration snippets + */ +int sss_ini_read_sssd_conf(struct sss_ini *self, + const char *config_file, + const char *config_dir); + +/** + * @brief Open ini file or use fallback_cfg if file is not present + * + * @param[in] self pointer to sss_ini structure + * @param[in] config_file ini file + * @param[in] fallback_cfg string with ini content. This parameter is used + * when config_file doesn't exist or it is set to NULL + * + * @return error code + */ +int sss_ini_open(struct sss_ini *self, + const char *config_file, + const char *fallback_cfg); + +/** + * @brief Check whether sss_ini_open() reported that ini file is + * not present + * + * @param[in] self pointer to sss_ini structure + * + * @return + * - true we are using ini file + * - false file was not found + */ +bool sss_ini_exists(struct sss_ini *self); + +/** + * @brief get Cstat structure of the ini file + */ +int sss_ini_get_stat(struct sss_ini *self); + +/** + * @brief Get mtime of the ini file + */ +int sss_ini_get_mtime(struct sss_ini *self, + size_t timestr_len, + char *timestr); + +/** + * @brief Get pointer to list of snippet parsing errors + */ +struct ref_array * +sss_ini_get_ra_error_list(struct sss_ini *self); + +/** + * @brief Get pointer to list of successfully merged snippet files + */ +struct ref_array * +sss_ini_get_ra_success_list(struct sss_ini *self); + +/** + * @brief Get configuration object + */ +int sss_ini_get_cfgobj(struct sss_ini *self, + const char *section, const char *name); + +/** + * @brief Check configuration object + */ +int sss_ini_check_config_obj(struct sss_ini *self); + +/** + * @brief Get int value + */ +int sss_ini_get_int_config_value(struct sss_ini *self, + int strict, int def, int *error); + +/** + * @brief Get string value + */ +const char *sss_ini_get_string_config_value(struct sss_ini *self, + int *error); + +/** + * @brief Create LDIF + */ +int sss_confdb_create_ldif(TALLOC_CTX *mem_ctx, + struct sss_ini *self, + const char *only_section, + const char **config_ldif); + +/** + * @brief Validate sssd.conf if libini_config support it + */ +int sss_ini_call_validators(struct sss_ini *data, + const char *rules_path); + +/** + * @brief Get errors from validators in array of strings + */ +int sss_ini_call_validators_strs(TALLOC_CTX *mem_ctx, + struct sss_ini *data, + const char *rules_path, + char ***_strs, + size_t *_num_errors); + +#endif /* __SSS_INI_H__ */ |