/contrib/bind9/lib/isccfg/include/isccfg/aclconf.h

https://bitbucket.org/freebsd/freebsd-head/ · C Header · 83 lines · 27 code · 14 blank · 42 comment · 0 complexity · e4c088b299920a889b79ebb7108ce897 MD5 · raw file

  1. /*
  2. * Copyright (C) 2004-2007, 2010-2012 Internet Systems Consortium, Inc. ("ISC")
  3. * Copyright (C) 1999-2001 Internet Software Consortium.
  4. *
  5. * Permission to use, copy, modify, and/or distribute this software for any
  6. * purpose with or without fee is hereby granted, provided that the above
  7. * copyright notice and this permission notice appear in all copies.
  8. *
  9. * THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
  10. * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
  11. * AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
  12. * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
  13. * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
  14. * OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
  15. * PERFORMANCE OF THIS SOFTWARE.
  16. */
  17. /* $Id$ */
  18. #ifndef ISCCFG_ACLCONF_H
  19. #define ISCCFG_ACLCONF_H 1
  20. #include <isc/lang.h>
  21. #include <isccfg/cfg.h>
  22. #include <dns/types.h>
  23. typedef struct cfg_aclconfctx {
  24. ISC_LIST(dns_acl_t) named_acl_cache;
  25. isc_mem_t *mctx;
  26. isc_refcount_t references;
  27. } cfg_aclconfctx_t;
  28. /***
  29. *** Functions
  30. ***/
  31. ISC_LANG_BEGINDECLS
  32. isc_result_t
  33. cfg_aclconfctx_create(isc_mem_t *mctx, cfg_aclconfctx_t **ret);
  34. /*
  35. * Creates and initializes an ACL configuration context.
  36. */
  37. void
  38. cfg_aclconfctx_detach(cfg_aclconfctx_t **actxp);
  39. /*
  40. * Removes a reference to an ACL configuration context; when references
  41. * reaches zero, clears the contents and deallocate the structure.
  42. */
  43. void
  44. cfg_aclconfctx_attach(cfg_aclconfctx_t *src, cfg_aclconfctx_t **dest);
  45. /*
  46. * Attaches a pointer to an existing ACL configuration context.
  47. */
  48. isc_result_t
  49. cfg_acl_fromconfig(const cfg_obj_t *caml,
  50. const cfg_obj_t *cctx,
  51. isc_log_t *lctx,
  52. cfg_aclconfctx_t *ctx,
  53. isc_mem_t *mctx,
  54. unsigned int nest_level,
  55. dns_acl_t **target);
  56. /*
  57. * Construct a new dns_acl_t from configuration data in 'caml' and
  58. * 'cctx'. Memory is allocated through 'mctx'.
  59. *
  60. * Any named ACLs referred to within 'caml' will be be converted
  61. * into nested dns_acl_t objects. Multiple references to the same
  62. * named ACLs will be converted into shared references to a single
  63. * nested dns_acl_t object when the referring objects were created
  64. * passing the same ACL configuration context 'ctx'.
  65. *
  66. * On success, attach '*target' to the new dns_acl_t object.
  67. */
  68. ISC_LANG_ENDDECLS
  69. #endif /* ISCCFG_ACLCONF_H */