services/view.h

   1 /*
   2  * services/view.h - named views containing local zones authority service.
   3  *
   4  * Copyright (c) 2016, NLnet Labs. All rights reserved.
   5  *
   6  * This software is open source.
   7  *
   8  * Redistribution and use in source and binary forms, with or without
   9  * modification, are permitted provided that the following conditions
  10  * are met:
  11  *
  12  * Redistributions of source code must retain the above copyright notice,
  13  * this list of conditions and the following disclaimer.
  14  *
  15  * Redistributions in binary form must reproduce the above copyright notice,
  16  * this list of conditions and the following disclaimer in the documentation
  17  * and/or other materials provided with the distribution.
  18  *
  19  * Neither the name of the NLNET LABS nor the names of its contributors may
  20  * be used to endorse or promote products derived from this software without
  21  * specific prior written permission.
  22  *
  23  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  24  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  25  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  26  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  27  * HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  28  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
  29  * TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
  30  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
  31  * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
  32  * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
  33  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  34  */
  35
  36 /**
  37  * \file
  38  *
  39  * This file contains functions to enable named views that can hold local zone
  40  * authority service.
  41  */
  42
  43 #ifndef SERVICES_VIEW_H
  44 #define SERVICES_VIEW_H
  45 #include "util/rbtree.h"
  46 #include "util/locks.h"
  47 struct regional;
  48 struct config_file;
  49 struct config_view;
  50
  51
  52 /**
  53  * Views storage, shared.
  54  */
  55 struct views {
  56         /** lock on the view tree */
  57         lock_rw_type lock;
  58         /** rbtree of struct view */
  59         rbtree_type vtree;
  60 };
  61
  62 /**
  63  * View. Named structure holding local authority zones.
  64  */
  65 struct view {
  66         /** rbtree node, key is name */
  67         rbnode_type node;
  68         /** view name.
  69          * Has to be right after rbnode_t due to pointer arithmatic in
  70          * view_create's lock protect */
  71         char* name;
  72         /** view specific local authority zones */
  73         struct local_zones* local_zones;
  74         /** Fallback to global local_zones when there is no match in the view
  75          * specific tree. 1 for yes, 0 for no */
  76         int isfirst;
  77         /** lock on the data in the structure
  78          * For the node and name you need to also hold the views_tree lock to
  79          * change them. */
  80         lock_rw_type lock;
  81 };
  82
  83
  84 /**
  85  * Create views storage
  86  * @return new struct or NULL on error.
  87  */
  88 struct views* views_create(void);
  89
  90 /**
  91  * Delete views storage
  92  * @param v: views to delete.
  93  */
  94 void views_delete(struct views* v);
  95
  96 /**
  97  * Apply config settings;
  98  * Takes care of locking.
  99  * @param v: view is set up.
 100  * @param cfg: config data.
 101  * @return false on error.
 102  */
 103 int views_apply_cfg(struct views* v, struct config_file* cfg);
 104
 105 /**
 106  * Compare two view entries in rbtree. Sort canonical.
 107  * @param v1: view 1
 108  * @param v2: view 2
 109  * @return: negative, positive or 0 comparison value.
 110  */
 111 int view_cmp(const void* v1, const void* v2);
 112
 113 /**
 114  * Delete one view
 115  * @param v: view to delete.
 116  */
 117 void view_delete(struct view* v);
 118
 119 /**
 120  * Debug helper. Print all views
 121  * Takes care of locking.
 122  * @param v: the views tree
 123  */
 124 void views_print(struct views* v);
 125
 126 /* Find a view by name.
 127  * @param vs: views
 128  * @param name: name of the view we are looking for
 129  * @param write: 1 for obtaining write lock on found view, 0 for read lock
 130  * @return: locked view or NULL.
 131  */
 132 struct view* views_find_view(struct views* vs, const char* name, int write);
 133
 134 #endif /* SERVICES_VIEW_H */