1/* config_file.h : authz parsing and searching, private to libsvn_repos 2 * 3 * ==================================================================== 4 * Licensed to the Apache Software Foundation (ASF) under one 5 * or more contributor license agreements. See the NOTICE file 6 * distributed with this work for additional information 7 * regarding copyright ownership. The ASF licenses this file 8 * to you under the Apache License, Version 2.0 (the 9 * "License"); you may not use this file except in compliance 10 * with the License. You may obtain a copy of the License at 11 * 12 * http://www.apache.org/licenses/LICENSE-2.0 13 * 14 * Unless required by applicable law or agreed to in writing, 15 * software distributed under the License is distributed on an 16 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 17 * KIND, either express or implied. See the License for the 18 * specific language governing permissions and limitations 19 * under the License. 20 * ==================================================================== 21 */ 22 23#ifndef SVN_REPOS_CONFIG_FILE_H 24#define SVN_REPOS_CONFIG_FILE_H 25 26#include <apr_hash.h> 27#include <apr_pools.h> 28#include <apr_tables.h> 29 30#include "svn_config.h" 31#include "svn_error.h" 32#include "svn_io.h" 33#include "svn_repos.h" 34 35#ifdef __cplusplus 36extern "C" { 37#endif /* __cplusplus */ 38 39 40 41/* An opaque struct that helps making config data access resource efficient. */ 42typedef struct config_access_t config_access_t; 43 44/* Return a new config access struct allocated in RESULT_POOL. 45 * Try to access REPOS_HINT first when resolving URLs; may be NULL. */ 46config_access_t * 47svn_repos__create_config_access(svn_repos_t *repos_hint, 48 apr_pool_t *result_pool); 49 50/* Release all resources allocated while using ACCESS. */ 51void 52svn_repos__destroy_config_access(config_access_t *access); 53 54/* Using ACCESS as a helper object, access the textual configuration at PATH, 55 * which may be an URL or a local path. Return content's checksum in 56 * *CHECKSUM and provide its content in *STREAM. 57 * 58 * The access will fail if the item does not exist and MUST_EXIST is set. 59 * The result has the same lifetime as ACCESS. Use SCRATCH_POOL for 60 * temporary allocations. 61 */ 62svn_error_t * 63svn_repos__get_config(svn_stream_t **stream, 64 svn_checksum_t **checksum, 65 config_access_t *access, 66 const char *path, 67 svn_boolean_t must_exist, 68 apr_pool_t *scratch_pool); 69 70#ifdef __cplusplus 71} 72#endif /* __cplusplus */ 73 74#endif /* SVN_REPOS_CONFIG_FILE_H */ 75