docs: Merge both samba.8 manpages.
[Samba/gebeck_regimport.git] / source4 / dsdb / repl / drepl_ridalloc.c
blobbd3a62b14b1a7fb888c786fd8618eb9934bc4d3f
1 /*
2 Unix SMB/CIFS mplementation.
4 DSDB replication service - RID allocation code
6 Copyright (C) Andrew Tridgell 2010
7 Copyright (C) Andrew Bartlett 2010
9 based on drepl_notify.c
11 This program is free software; you can redistribute it and/or modify
12 it under the terms of the GNU General Public License as published by
13 the Free Software Foundation; either version 3 of the License, or
14 (at your option) any later version.
16 This program is distributed in the hope that it will be useful,
17 but WITHOUT ANY WARRANTY; without even the implied warranty of
18 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 GNU General Public License for more details.
21 You should have received a copy of the GNU General Public License
22 along with this program. If not, see <http://www.gnu.org/licenses/>.
26 #include "includes.h"
27 #include "ldb_module.h"
28 #include "dsdb/samdb/samdb.h"
29 #include "smbd/service.h"
30 #include "dsdb/repl/drepl_service.h"
31 #include "param/param.h"
34 called when a rid allocation request has completed
36 static void drepl_new_rid_pool_callback(struct dreplsrv_service *service,
37 WERROR werr,
38 enum drsuapi_DsExtendedError ext_err,
39 void *cb_data)
41 if (!W_ERROR_IS_OK(werr)) {
42 DEBUG(0,(__location__ ": RID Manager failed RID allocation - %s - extended_ret[0x%X]\n",
43 win_errstr(werr), ext_err));
44 } else {
45 DEBUG(3,(__location__ ": RID Manager completed RID allocation OK\n"));
48 service->rid_alloc_in_progress = false;
52 schedule a getncchanges request to the RID Manager to ask for a new
53 set of RIDs using DRSUAPI_EXOP_FSMO_RID_ALLOC
55 static WERROR drepl_request_new_rid_pool(struct dreplsrv_service *service,
56 struct ldb_dn *rid_manager_dn, struct ldb_dn *fsmo_role_dn,
57 uint64_t alloc_pool)
59 WERROR werr = drepl_request_extended_op(service,
60 rid_manager_dn,
61 fsmo_role_dn,
62 DRSUAPI_EXOP_FSMO_RID_ALLOC,
63 alloc_pool,
65 drepl_new_rid_pool_callback, NULL);
66 if (W_ERROR_IS_OK(werr)) {
67 service->rid_alloc_in_progress = true;
69 return werr;
74 see if we are on the last pool we have
76 static int drepl_ridalloc_pool_exhausted(struct ldb_context *ldb,
77 bool *exhausted,
78 uint64_t *_alloc_pool)
80 struct ldb_dn *server_dn, *machine_dn, *rid_set_dn;
81 TALLOC_CTX *tmp_ctx = talloc_new(ldb);
82 uint64_t alloc_pool;
83 uint64_t prev_pool;
84 uint32_t prev_pool_lo, prev_pool_hi;
85 uint32_t next_rid;
86 static const char * const attrs[] = {
87 "rIDAllocationPool",
88 "rIDPreviousAllocationPool",
89 "rIDNextRid",
90 NULL
92 int ret;
93 struct ldb_result *res;
95 *exhausted = false;
96 *_alloc_pool = UINT64_MAX;
98 server_dn = ldb_dn_get_parent(tmp_ctx, samdb_ntds_settings_dn(ldb, tmp_ctx));
99 if (!server_dn) {
100 talloc_free(tmp_ctx);
101 return ldb_operr(ldb);
104 ret = samdb_reference_dn(ldb, tmp_ctx, server_dn, "serverReference", &machine_dn);
105 if (ret != LDB_SUCCESS) {
106 DEBUG(0,(__location__ ": Failed to find serverReference in %s - %s\n",
107 ldb_dn_get_linearized(server_dn), ldb_errstring(ldb)));
108 talloc_free(tmp_ctx);
109 return ret;
112 ret = samdb_reference_dn(ldb, tmp_ctx, machine_dn, "rIDSetReferences", &rid_set_dn);
113 if (ret == LDB_ERR_NO_SUCH_ATTRIBUTE) {
114 *exhausted = true;
115 *_alloc_pool = 0;
116 talloc_free(tmp_ctx);
117 return LDB_SUCCESS;
119 if (ret != LDB_SUCCESS) {
120 DEBUG(0,(__location__ ": Failed to find rIDSetReferences in %s - %s\n",
121 ldb_dn_get_linearized(machine_dn), ldb_errstring(ldb)));
122 talloc_free(tmp_ctx);
123 return ret;
126 ret = ldb_search(ldb, tmp_ctx, &res, rid_set_dn, LDB_SCOPE_BASE, attrs, NULL);
127 if (ret != LDB_SUCCESS) {
128 DEBUG(0,(__location__ ": Failed to load RID Set attrs from %s - %s\n",
129 ldb_dn_get_linearized(rid_set_dn), ldb_errstring(ldb)));
130 talloc_free(tmp_ctx);
131 return ret;
134 alloc_pool = ldb_msg_find_attr_as_uint64(res->msgs[0], "rIDAllocationPool", 0);
135 prev_pool = ldb_msg_find_attr_as_uint64(res->msgs[0], "rIDPreviousAllocationPool", 0);
136 prev_pool_lo = prev_pool & 0xFFFFFFFF;
137 prev_pool_hi = prev_pool >> 32;
138 next_rid = ldb_msg_find_attr_as_uint(res->msgs[0], "rIDNextRid", 0);
140 if (alloc_pool != prev_pool) {
141 talloc_free(tmp_ctx);
142 return LDB_SUCCESS;
145 if (next_rid < (prev_pool_hi + prev_pool_lo)/2) {
146 talloc_free(tmp_ctx);
147 return LDB_SUCCESS;
150 *exhausted = true;
151 *_alloc_pool = alloc_pool;
152 talloc_free(tmp_ctx);
153 return LDB_SUCCESS;
158 see if we are low on RIDs in the RID Set rIDAllocationPool. If we
159 are, then schedule a replication call with DRSUAPI_EXOP_FSMO_RID_ALLOC
160 to the RID Manager
162 WERROR dreplsrv_ridalloc_check_rid_pool(struct dreplsrv_service *service)
164 struct ldb_dn *rid_manager_dn, *fsmo_role_dn;
165 TALLOC_CTX *tmp_ctx = talloc_new(service);
166 struct ldb_context *ldb = service->samdb;
167 bool exhausted;
168 WERROR werr;
169 int ret;
170 uint64_t alloc_pool;
171 bool is_us;
173 if (service->am_rodc) {
174 talloc_free(tmp_ctx);
175 return WERR_OK;
178 if (service->rid_alloc_in_progress) {
179 talloc_free(tmp_ctx);
180 return WERR_OK;
184 steps:
185 - find who the RID Manager is
186 - if we are the RID Manager then nothing to do
187 - find our RID Set object
188 - load rIDAllocationPool and rIDPreviousAllocationPool
189 - if rIDAllocationPool != rIDPreviousAllocationPool then
190 nothing to do
191 - schedule a getncchanges with DRSUAPI_EXOP_FSMO_RID_ALLOC
192 to the RID Manager
195 /* work out who is the RID Manager */
196 ret = samdb_rid_manager_dn(ldb, tmp_ctx, &rid_manager_dn);
197 if (ret != LDB_SUCCESS) {
198 DEBUG(0, (__location__ ": Failed to find RID Manager object - %s\n", ldb_errstring(ldb)));
199 talloc_free(tmp_ctx);
200 return WERR_DS_DRA_INTERNAL_ERROR;
203 /* find the DN of the RID Manager */
204 ret = samdb_reference_dn(ldb, tmp_ctx, rid_manager_dn, "fSMORoleOwner", &fsmo_role_dn);
205 if (ret != LDB_SUCCESS) {
206 DEBUG(0,(__location__ ": Failed to find fSMORoleOwner in RID Manager object - %s\n",
207 ldb_errstring(ldb)));
208 talloc_free(tmp_ctx);
209 return WERR_DS_DRA_INTERNAL_ERROR;
212 ret = samdb_dn_is_our_ntdsa(ldb, fsmo_role_dn, &is_us);
213 if (ret != LDB_SUCCESS) {
214 DEBUG(0,(__location__ ": Failed to find detrmine if %s is our ntdsDsa object - %s\n",
215 ldb_dn_get_linearized(fsmo_role_dn), ldb_errstring(ldb)));
216 talloc_free(tmp_ctx);
217 return WERR_DS_DRA_INTERNAL_ERROR;
220 if (is_us) {
221 /* we are the RID Manager - no need to do a
222 DRSUAPI_EXOP_FSMO_RID_ALLOC */
223 talloc_free(tmp_ctx);
224 return WERR_OK;
227 ret = drepl_ridalloc_pool_exhausted(ldb, &exhausted, &alloc_pool);
228 if (ret != LDB_SUCCESS) {
229 talloc_free(tmp_ctx);
230 return WERR_DS_DRA_INTERNAL_ERROR;
233 if (!exhausted) {
234 /* don't need a new pool */
235 talloc_free(tmp_ctx);
236 return WERR_OK;
239 DEBUG(2,(__location__ ": Requesting more RIDs from RID Manager\n"));
241 werr = drepl_request_new_rid_pool(service, rid_manager_dn, fsmo_role_dn, alloc_pool);
242 talloc_free(tmp_ctx);
243 return werr;
246 /* called by the samldb ldb module to tell us to ask for a new RID
247 pool */
248 void dreplsrv_allocate_rid(struct imessaging_context *msg, void *private_data,
249 uint32_t msg_type,
250 struct server_id server_id, DATA_BLOB *data)
252 struct dreplsrv_service *service = talloc_get_type(private_data, struct dreplsrv_service);
253 dreplsrv_ridalloc_check_rid_pool(service);