← Back to branch summary

~andreserl/ubuntu/lucid/bind9/bind9-apport-533601

« back to all changes in this revision

Viewing changes to lib/dns/include/dns/zt.h

  • Committer: Bazaar Package Importer
  • Author(s): LaMont Jones, LaMont Jones, Internet Software Consortium, Inc, localization folks
  • Date: 2008-08-02 14:20:20 UTC
  • mfrom: (1.2.1 upstream) (6.1.24 intrepid)
  • Revision ID: james.westby@ubuntu.com-20080802142020-l1hon9jy8lbbjxmg
http://bugs.debian.org/149259
http://bugs.debian.org/492418
http://bugs.debian.org/493392
http://bugs.debian.org/492564
http://bugs.debian.org/490027
http://bugs.debian.org/492949
http://bugs.debian.org/492425
http://bugs.debian.org/491369
http://bugs.debian.org/492048
http://bugs.debian.org/490630
http://bugs.debian.org/492587
[LaMont Jones]

* default to using resolvconf if it is installed
* fix sonames and dependencies.  Closes: #149259, #492418
* Do not build-depend libcap2-dev on non-linux.  Closes: #493392
* drop unused query-loc manpage.  Closes: #492564
* lwresd: Deliver /etc/bind directory.  Closes: #490027
* fix query-source comment in default install

[Internet Software Consortium, Inc]

* 9.5.0-P2.  Closes: #492949

[localization folks]

* l10n: Spanish debconf translation.  Closes: #492425 (Ignacio Mondino)
* l10n: Swedish debconf templates.  Closes: #491369 (Martin Ågren)
* l10n: Japanese debconf translations.  Closes: #492048 (Hideki Yamane
  (Debian-JP))
* l10n: Finnish translation.  Closes: #490630 (Esko Arajärvi)
* l10n: Italian debconf translations.  Closes: #492587 (Alessandro Vietta)

Show diffs side-by-side

added added

removed removed

Lines of Context:
lib/dns/include/dns/zt.h
1
1
/*
2
 
 * Copyright (C) 2004  Internet Systems Consortium, Inc. ("ISC")
 
2
 * Copyright (C) 2004-2007  Internet Systems Consortium, Inc. ("ISC")
3
3
 * Copyright (C) 1999-2002  Internet Software Consortium.
4
4
 *
5
 
 * Permission to use, copy, modify, and distribute this software for any
 
5
 * Permission to use, copy, modify, and/or distribute this software for any
6
6
 * purpose with or without fee is hereby granted, provided that the above
7
7
 * copyright notice and this permission notice appear in all copies.
8
8
 *
15
15
 * PERFORMANCE OF THIS SOFTWARE.
16
16
 */
17
17
 
18
 
/* $Id: zt.h,v 1.27.2.2.8.1 2004/03/06 08:14:01 marka Exp $ */
 
18
/* $Id: zt.h,v 1.38 2007/06/19 23:47:17 tbox Exp $ */
19
19
 
20
20
#ifndef DNS_ZT_H
21
21
#define DNS_ZT_H 1
22
22
 
 
23
/*! \file dns/zt.h */
 
24
 
23
25
#include <isc/lang.h>
24
26
 
25
27
#include <dns/types.h>
30
32
 
31
33
isc_result_t
32
34
dns_zt_create(isc_mem_t *mctx, dns_rdataclass_t rdclass, dns_zt_t **zt);
33
 
/*
 
35
/*%<
34
36
 * Creates a new zone table.
35
37
 *
36
38
 * Requires:
37
 
 *      'mctx' to be initialized.
 
39
 * \li  'mctx' to be initialized.
38
40
 *
39
41
 * Returns:
40
 
 *      ISC_R_SUCCESS on success.
41
 
 *      ISC_R_NOMEMORY
 
42
 * \li  #ISC_R_SUCCESS on success.
 
43
 * \li  #ISC_R_NOMEMORY
42
44
 */
43
45
 
44
46
isc_result_t
45
47
dns_zt_mount(dns_zt_t *zt, dns_zone_t *zone);
46
 
/*
 
48
/*%<
47
49
 * Mounts the zone on the zone table.
48
50
 *
49
51
 * Requires:
50
 
 *      'zt' to be valid
51
 
 *      'zone' to be valid
 
52
 * \li  'zt' to be valid
 
53
 * \li  'zone' to be valid
52
54
 *
53
55
 * Returns:
54
 
 *      ISC_R_SUCCESS
55
 
 *      ISC_R_EXISTS
56
 
 *      ISC_R_NOSPACE
57
 
 *      ISC_R_NOMEMORY
 
56
 * \li  #ISC_R_SUCCESS
 
57
 * \li  #ISC_R_EXISTS
 
58
 * \li  #ISC_R_NOSPACE
 
59
 * \li  #ISC_R_NOMEMORY
58
60
 */
59
61
 
60
62
isc_result_t
61
63
dns_zt_unmount(dns_zt_t *zt, dns_zone_t *zone);
62
 
/*
 
64
/*%<
63
65
 * Unmount the given zone from the table.
64
66
 *
65
67
 * Requires:
66
68
 *      'zt' to be valid
67
 
 *      'zone' to be valid
 
69
 * \li  'zone' to be valid
68
70
 *
69
71
 * Returns:
70
 
 *      ISC_R_SUCCESS
71
 
 *      ISC_R_NOTFOUND
72
 
 *      ISC_R_NOMEMORY
 
72
 * \li  #ISC_R_SUCCESS
 
73
 * \li  #ISC_R_NOTFOUND
 
74
 * \li  #ISC_R_NOMEMORY
73
75
 */
74
76
 
75
77
isc_result_t
76
78
dns_zt_find(dns_zt_t *zt, dns_name_t *name, unsigned int options,
77
79
            dns_name_t *foundname, dns_zone_t **zone);
78
 
/*
 
80
/*%<
79
81
 * Find the best match for 'name' in 'zt'.  If foundname is non NULL
80
82
 * then the name of the zone found is returned.
81
83
 *
82
84
 * Notes:
83
 
 *      If the DNS_ZTFIND_NOEXACT is set, the best partial match (if any)
 
85
 * \li  If the DNS_ZTFIND_NOEXACT is set, the best partial match (if any)
84
86
 *      to 'name' will be returned.
85
87
 *
86
88
 * Requires:
87
 
 *      'zt' to be valid
88
 
 *      'name' to be valid
89
 
 *      'foundname' to be initialized and associated with a fixedname or NULL
90
 
 *      'zone' to be non NULL and '*zone' to be NULL
 
89
 * \li  'zt' to be valid
 
90
 * \li  'name' to be valid
 
91
 * \li  'foundname' to be initialized and associated with a fixedname or NULL
 
92
 * \li  'zone' to be non NULL and '*zone' to be NULL
91
93
 *
92
94
 * Returns:
93
 
 *      ISC_R_SUCCESS
94
 
 *      DNS_R_PARTIALMATCH
95
 
 *      ISC_R_NOTFOUND
96
 
 *      ISC_R_NOSPACE
 
95
 * \li  #ISC_R_SUCCESS
 
96
 * \li  #DNS_R_PARTIALMATCH
 
97
 * \li  #ISC_R_NOTFOUND
 
98
 * \li  #ISC_R_NOSPACE
97
99
 */
98
100
 
99
101
void
100
102
dns_zt_detach(dns_zt_t **ztp);
101
 
/*
 
103
/*%<
102
104
 * Detach the given zonetable, if the reference count goes to zero the
103
105
 * zonetable will be freed.  In either case 'ztp' is set to NULL.
104
106
 *
105
107
 * Requires:
106
 
 *      '*ztp' to be valid
 
108
 * \li  '*ztp' to be valid
107
109
 */
108
110
 
109
111
void
110
112
dns_zt_flushanddetach(dns_zt_t **ztp);
111
 
/*
 
113
/*%<
112
114
 * Detach the given zonetable, if the reference count goes to zero the
113
115
 * zonetable will be flushed and then freed.  In either case 'ztp' is
114
116
 * set to NULL.
115
117
 *
116
118
 * Requires:
117
 
 *      '*ztp' to be valid
 
119
 * \li  '*ztp' to be valid
118
120
 */
119
121
 
120
122
void
121
123
dns_zt_attach(dns_zt_t *zt, dns_zt_t **ztp);
122
 
/*
 
124
/*%<
123
125
 * Attach 'zt' to '*ztp'.
124
126
 *
125
127
 * Requires:
126
 
 *      'zt' to be valid
127
 
 *      '*ztp' to be NULL
 
128
 * \li  'zt' to be valid
 
129
 * \li  '*ztp' to be NULL
128
130
 */
129
131
 
130
132
isc_result_t
132
134
 
133
135
isc_result_t
134
136
dns_zt_loadnew(dns_zt_t *zt, isc_boolean_t stop);
135
 
/*
 
137
/*%<
136
138
 * Load all zones in the table.  If 'stop' is ISC_TRUE,
137
139
 * stop on the first error and return it.  If 'stop'
138
140
 * is ISC_FALSE, ignore errors.
142
144
 * and whose master file has changed since the last load.
143
145
 *
144
146
 * Requires:
145
 
 *      'zt' to be valid
 
147
 * \li  'zt' to be valid
 
148
 */
 
149
 
 
150
isc_result_t
 
151
dns_zt_freezezones(dns_zt_t *zt, isc_boolean_t freeze);
 
152
/*%<
 
153
 * Freeze/thaw updates to master zones.
 
154
 * Any pending updates will be flushed.
 
155
 * Zones will be reloaded on thaw.
146
156
 */
147
157
 
148
158
isc_result_t
149
159
dns_zt_apply(dns_zt_t *zt, isc_boolean_t stop,
150
160
             isc_result_t (*action)(dns_zone_t *, void *), void *uap);
151
 
/*
 
161
 
 
162
isc_result_t
 
163
dns_zt_apply2(dns_zt_t *zt, isc_boolean_t stop, isc_result_t *sub,
 
164
              isc_result_t (*action)(dns_zone_t *, void *), void *uap);
 
165
/*%<
152
166
 * Apply a given 'action' to all zone zones in the table.
153
167
 * If 'stop' is 'ISC_TRUE' then walking the zone tree will stop if
154
168
 * 'action' does not return ISC_R_SUCCESS.
155
169
 *
156
170
 * Requires:
157
 
 *      'zt' to be valid.
158
 
 *      'action' to be non NULL.
 
171
 * \li  'zt' to be valid.
 
172
 * \li  'action' to be non NULL.
159
173
 *
160
174
 * Returns:
161
 
 *      ISC_R_SUCCESS if action was applied to all nodes.
 
175
 * \li  ISC_R_SUCCESS if action was applied to all nodes.  If 'stop' is
 
176
 *      ISC_FALSE and 'sub' is non NULL then the first error (if any)
 
177
 *      reported by 'action' is returned in '*sub';
162
178
 *      any error code from 'action'.
163
179
 */
164
180