Return to kaspconf.h CVS log

Up to [cvs.NetBSD.org] / src / external / mpl / bind / dist / lib / isccfg / include / isccfg

Annotation of src/external/mpl/bind/dist/lib/isccfg/include/isccfg/kaspconf.h, Revision 1.3

1.1       christos    1: /*     $NetBSD$        */
                      2:
                      3: /*
                      4:  * Copyright (C) Internet Systems Consortium, Inc. ("ISC")
                      5:  *
                      6:  * This Source Code Form is subject to the terms of the Mozilla Public
                      7:  * License, v. 2.0. If a copy of the MPL was not distributed with this
1.3     ! christos    8:  * file, you can obtain one at https://mozilla.org/MPL/2.0/.
1.1       christos    9:  *
                     10:  * See the COPYRIGHT file distributed with this work for additional
                     11:  * information regarding copyright ownership.
                     12:  */
                     13:
                     14: #ifndef ISCCFG_KASPCONF_H
                     15: #define ISCCFG_KASPCONF_H 1
                     16:
                     17: #include <isc/lang.h>
                     18:
                     19: #include <dns/types.h>
                     20:
                     21: #include <isccfg/cfg.h>
                     22:
                     23: /***
                     24:  *** Functions
                     25:  ***/
                     26:
                     27: ISC_LANG_BEGINDECLS
                     28:
                     29: isc_result_t
1.3     ! christos   30: cfg_kasp_fromconfig(const cfg_obj_t *config, const char *name, isc_mem_t *mctx,
        !            31:                    isc_log_t *logctx, dns_kasplist_t *kasplist,
        !            32:                    dns_kasp_t **kaspp);
1.1       christos   33: /*%<
1.3     ! christos   34:  * Create and configure a KASP. If 'config' is NULL, a built-in configuration
        !            35:  * is used, referred to by 'name'. If a 'kasplist' is provided, a lookup
        !            36:  * happens and if a KASP already exists with the same name, no new KASP is
        !            37:  * created, and no attach to 'kaspp' happens.
1.1       christos   38:  *
                     39:  * Requires:
                     40:  *
1.3     ! christos   41:  *\li  'name' is either NULL, or a valid C string.
        !            42:  *
1.1       christos   43:  *\li  'mctx' is a valid memory context.
                     44:  *
                     45:  *\li  'logctx' is a valid logging context.
                     46:  *
                     47:  *\li  kaspp != NULL && *kaspp == NULL
                     48:  *
                     49:  * Returns:
                     50:  *
                     51:  *\li  #ISC_R_SUCCESS  If creating and configuring the KASP succeeds.
                     52:  *\li  #ISC_R_EXISTS   If 'kasplist' already has a kasp structure with 'name'.
                     53:  *\li  #ISC_R_NOMEMORY
                     54:  *
                     55:  *\li  Other errors are possible.
                     56:  */
                     57:
                     58: ISC_LANG_ENDDECLS
                     59:
                     60: #endif /* ISCCFG_KASPCONF_H */