1 /* Licensed to the Apache Software Foundation (ASF) under one or more
2 * contributor license agreements. See the NOTICE file distributed with
3 * this work for additional information regarding copyright ownership.
4 * The ASF licenses this file to You under the Apache License, Version 2.0
5 * (the "License"); you may not use this file except in compliance with
6 * the License. You may obtain a copy of the License at
8 * http://www.apache.org/licenses/LICENSE-2.0
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
18 * @file util_cfgtree.h
19 * @brief Config Tree Package
21 * @defgroup APACHE_CORE_CONFIG_TREE Config Tree Package
22 * @ingroup APACHE_CORE_CONFIG
29 #include "ap_config.h"
35 typedef struct ap_directive_t ap_directive_t;
38 * @brief Structure used to build the config tree.
40 * The config tree only stores
41 * the directives that will be active in the running server. Directives
42 * that contain other directions, such as <Directory ...> cause a sub-level
43 * to be created, where the included directives are stored. The closing
44 * directive (</Directory>) is not stored in the tree.
46 struct ap_directive_t {
47 /** The current directive */
48 const char *directive;
49 /** The arguments for the current directive, stored as a space
52 /** The next directive node in the tree */
53 struct ap_directive_t *next;
54 /** The first child node of this directive */
55 struct ap_directive_t *first_child;
56 /** The parent node of this directive */
57 struct ap_directive_t *parent;
59 /** directive's module can store add'l data here */
62 /* ### these may go away in the future, but are needed for now */
63 /** The name of the file this directive was found in */
65 /** The line number the directive was on */
70 * The root of the configuration tree
71 * @var ap_directive_t *conftree
73 AP_DECLARE_DATA extern ap_directive_t *ap_conftree;
76 * Add a node to the configuration tree.
77 * @param parent The current parent node. If the added node is a first_child,
78 then this is changed to the current node
79 * @param current The current node
80 * @param toadd The node to add to the tree
81 * @param child Is the node to add a child node
82 * @return the added node
84 ap_directive_t *ap_add_node(ap_directive_t **parent, ap_directive_t *current,
85 ap_directive_t *toadd, int child);