3 provide API to do non-blocking locks for single or all databases
5 Copyright (C) Amitay Isaacs 2012
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program; if not, see <http://www.gnu.org/licenses/>.
21 #include "include/ctdb_private.h"
22 #include "include/ctdb_protocol.h"
26 #include "system/filesys.h"
27 #include "lib/util/dlinklist.h"
30 * Non-blocking Locking API
32 * 1. Create a child process to do blocking locks.
33 * 2. Once the locks are obtained, signal parent process via fd.
34 * 3. Invoke registered callback routine with locking status.
35 * 4. If the child process cannot get locks within certain time,
36 * diagnose using /proc/locks and log warning message
38 * ctdb_lock_record() - get a lock on a record
39 * ctdb_lock_db() - get a lock on a DB
40 * ctdb_lock_alldb_prio() - get a lock on all DBs with given priority
41 * ctdb_lock_alldb() - get a lock on all DBs
43 * auto_mark - whether to mark/unmark DBs in before/after callback
46 /* FIXME: Add a tunable max_lock_processes_per_db */
47 #define MAX_LOCK_PROCESSES_PER_DB (100)
56 static const char * const lock_type_str[] = {
65 /* lock_context is the common part for a lock request */
67 struct lock_context *next, *prev;
69 struct ctdb_context *ctdb;
70 struct ctdb_db_context *ctdb_db;
74 struct lock_request *req_queue;
77 struct tevent_fd *tfd;
78 struct tevent_timer *ttimer;
81 struct timeval start_time;
84 /* lock_request is the client specific part for a lock request */
86 struct lock_request *next, *prev;
87 struct lock_context *lctx;
88 void (*callback)(void *, bool);
94 * Support samba 3.6.x (and older) versions which do not set db priority.
96 * By default, all databases are set to priority 1. So only when priority
97 * is set to 1, check for databases that need higher priority.
99 static bool later_db(struct ctdb_context *ctdb, const char *name)
101 if (ctdb->tunable.samba3_hack == 0) {
105 if (strstr(name, "brlock") ||
106 strstr(name, "g_lock") ||
107 strstr(name, "notify_onelevel") ||
108 strstr(name, "serverid") ||
109 strstr(name, "xattr_tdb")) {
116 typedef int (*db_handler_t)(struct ctdb_db_context *ctdb_db,
120 static int ctdb_db_iterator(struct ctdb_context *ctdb, uint32_t priority,
121 db_handler_t handler, void *private_data)
123 struct ctdb_db_context *ctdb_db;
126 for (ctdb_db = ctdb->db_list; ctdb_db; ctdb_db = ctdb_db->next) {
127 if (ctdb_db->priority != priority) {
130 if (later_db(ctdb, ctdb_db->db_name)) {
133 ret = handler(ctdb_db, priority, private_data);
139 /* If priority != 1, later_db check is not required and can return */
144 for (ctdb_db = ctdb->db_list; ctdb_db; ctdb_db = ctdb_db->next) {
145 if (!later_db(ctdb, ctdb_db->db_name)) {
148 ret = handler(ctdb_db, priority, private_data);
159 * lock all databases - mark only
161 static int db_lock_mark_handler(struct ctdb_db_context *ctdb_db, uint32_t priority,
164 int tdb_transaction_write_lock_mark(struct tdb_context *);
166 DEBUG(DEBUG_INFO, ("marking locked database %s, priority:%u\n",
167 ctdb_db->db_name, priority));
169 if (tdb_transaction_write_lock_mark(ctdb_db->ltdb->tdb) != 0) {
170 DEBUG(DEBUG_ERR, ("Failed to mark (transaction lock) database %s\n",
175 if (tdb_lockall_mark(ctdb_db->ltdb->tdb) != 0) {
176 DEBUG(DEBUG_ERR, ("Failed to mark (all lock) database %s\n",
184 int ctdb_lockall_mark_prio(struct ctdb_context *ctdb, uint32_t priority)
187 * This function is only used by the main dameon during recovery.
188 * At this stage, the databases have already been locked, by a
189 * dedicated child process. The freeze_mode variable is used to track
190 * whether the actual locks are held by the child process or not.
193 if (ctdb->freeze_mode[priority] != CTDB_FREEZE_FROZEN) {
194 DEBUG(DEBUG_ERR, ("Attempt to mark all databases locked when not frozen\n"));
198 return ctdb_db_iterator(ctdb, priority, db_lock_mark_handler, NULL);
201 static int ctdb_lockall_mark(struct ctdb_context *ctdb)
205 for (priority=1; priority<=NUM_DB_PRIORITIES; priority++) {
206 if (ctdb_db_iterator(ctdb, priority, db_lock_mark_handler, NULL) != 0) {
216 * lock all databases - unmark only
218 static int db_lock_unmark_handler(struct ctdb_db_context *ctdb_db, uint32_t priority,
221 int tdb_transaction_write_lock_unmark(struct tdb_context *);
223 DEBUG(DEBUG_INFO, ("unmarking locked database %s, priority:%u\n",
224 ctdb_db->db_name, priority));
226 if (tdb_transaction_write_lock_unmark(ctdb_db->ltdb->tdb) != 0) {
227 DEBUG(DEBUG_ERR, ("Failed to unmark (transaction lock) database %s\n",
232 if (tdb_lockall_unmark(ctdb_db->ltdb->tdb) != 0) {
233 DEBUG(DEBUG_ERR, ("Failed to unmark (all lock) database %s\n",
241 int ctdb_lockall_unmark_prio(struct ctdb_context *ctdb, uint32_t priority)
244 * This function is only used by the main dameon during recovery.
245 * At this stage, the databases have already been locked, by a
246 * dedicated child process. The freeze_mode variable is used to track
247 * whether the actual locks are held by the child process or not.
250 if (ctdb->freeze_mode[priority] != CTDB_FREEZE_FROZEN) {
251 DEBUG(DEBUG_ERR, ("Attempt to unmark all databases locked when not frozen\n"));
255 return ctdb_db_iterator(ctdb, priority, db_lock_unmark_handler, NULL);
258 static int ctdb_lockall_unmark(struct ctdb_context *ctdb)
262 for (priority=NUM_DB_PRIORITIES; priority>0; priority--) {
263 if (ctdb_db_iterator(ctdb, priority, db_lock_unmark_handler, NULL) != 0) {
272 static void ctdb_lock_schedule(struct ctdb_context *ctdb);
275 * Destructor to kill the child locking process
277 static int ctdb_lock_context_destructor(struct lock_context *lock_ctx)
279 if (lock_ctx->child > 0) {
280 ctdb_kill(lock_ctx->ctdb, lock_ctx->child, SIGKILL);
281 DLIST_REMOVE(lock_ctx->ctdb->lock_current, lock_ctx);
282 if (lock_ctx->ctdb_db) {
283 lock_ctx->ctdb_db->lock_num_current--;
285 CTDB_DECREMENT_STAT(lock_ctx->ctdb, locks.num_current);
286 if (lock_ctx->type == LOCK_RECORD || lock_ctx->type == LOCK_DB) {
287 CTDB_DECREMENT_DB_STAT(lock_ctx->ctdb_db, locks.num_current);
290 DLIST_REMOVE(lock_ctx->ctdb->lock_pending, lock_ctx);
291 lock_ctx->ctdb->lock_num_pending--;
292 CTDB_DECREMENT_STAT(lock_ctx->ctdb, locks.num_pending);
293 if (lock_ctx->type == LOCK_RECORD || lock_ctx->type == LOCK_DB) {
294 CTDB_DECREMENT_DB_STAT(lock_ctx->ctdb_db, locks.num_pending);
298 ctdb_lock_schedule(lock_ctx->ctdb);
305 * Destructor to remove lock request
307 static int ctdb_lock_request_destructor(struct lock_request *lock_request)
309 DLIST_REMOVE(lock_request->lctx->req_queue, lock_request);
314 void ctdb_lock_free_request_context(struct lock_request *lock_req)
316 struct lock_context *lock_ctx;
318 lock_ctx = lock_req->lctx;
319 talloc_free(lock_req);
320 talloc_free(lock_ctx);
325 * Process all the callbacks waiting for lock
327 * If lock has failed, callback is executed with locked=false
329 static void process_callbacks(struct lock_context *lock_ctx, bool locked)
331 struct lock_request *request, *next;
333 if (lock_ctx->auto_mark && locked) {
334 switch (lock_ctx->type) {
336 tdb_chainlock_mark(lock_ctx->ctdb_db->ltdb->tdb, lock_ctx->key);
340 tdb_lockall_mark(lock_ctx->ctdb_db->ltdb->tdb);
343 case LOCK_ALLDB_PRIO:
344 ctdb_lockall_mark_prio(lock_ctx->ctdb, lock_ctx->priority);
348 ctdb_lockall_mark(lock_ctx->ctdb);
353 /* Iterate through all callbacks */
354 request = lock_ctx->req_queue;
356 if (lock_ctx->auto_mark) {
357 /* Reset the destructor, so request is not removed from the list */
358 talloc_set_destructor(request, NULL);
361 /* In case, callback frees the request, store next */
362 next = request->next;
363 request->callback(request->private_data, locked);
367 if (lock_ctx->auto_mark && locked) {
368 switch (lock_ctx->type) {
370 tdb_chainlock_unmark(lock_ctx->ctdb_db->ltdb->tdb, lock_ctx->key);
374 tdb_lockall_unmark(lock_ctx->ctdb_db->ltdb->tdb);
377 case LOCK_ALLDB_PRIO:
378 ctdb_lockall_unmark_prio(lock_ctx->ctdb, lock_ctx->priority);
382 ctdb_lockall_unmark(lock_ctx->ctdb);
389 static int lock_bucket_id(double t)
391 double ms = 1.e-3, s = 1;
396 } else if (t < 10*ms) {
398 } else if (t < 100*ms) {
400 } else if (t < 1*s) {
402 } else if (t < 2*s) {
404 } else if (t < 4*s) {
406 } else if (t < 8*s) {
408 } else if (t < 16*s) {
410 } else if (t < 32*s) {
412 } else if (t < 64*s) {
422 * Callback routine when the required locks are obtained.
423 * Called from parent context
425 static void ctdb_lock_handler(struct tevent_context *ev,
426 struct tevent_fd *tfd,
430 struct lock_context *lock_ctx;
431 TALLOC_CTX *tmp_ctx = NULL;
437 lock_ctx = talloc_get_type_abort(private_data, struct lock_context);
439 /* cancel the timeout event */
440 if (lock_ctx->ttimer) {
441 TALLOC_FREE(lock_ctx->ttimer);
444 t = timeval_elapsed(&lock_ctx->start_time);
445 id = lock_bucket_id(t);
447 if (lock_ctx->auto_mark) {
448 tmp_ctx = talloc_new(ev);
449 talloc_steal(tmp_ctx, lock_ctx);
452 /* Read the status from the child process */
453 if (read(lock_ctx->fd[0], &c, 1) != 1) {
456 locked = (c == 0 ? true : false);
459 /* Update statistics */
460 CTDB_DECREMENT_STAT(lock_ctx->ctdb, locks.num_pending);
461 CTDB_INCREMENT_STAT(lock_ctx->ctdb, locks.num_calls);
462 if (lock_ctx->ctdb_db) {
463 CTDB_DECREMENT_DB_STAT(lock_ctx->ctdb_db, locks.num_pending);
464 CTDB_INCREMENT_DB_STAT(lock_ctx->ctdb_db, locks.num_calls);
468 if (lock_ctx->ctdb_db) {
469 CTDB_INCREMENT_STAT(lock_ctx->ctdb, locks.buckets[id]);
470 CTDB_UPDATE_LATENCY(lock_ctx->ctdb, lock_ctx->ctdb_db,
471 lock_type_str[lock_ctx->type], locks.latency,
472 lock_ctx->start_time);
474 CTDB_UPDATE_DB_LATENCY(lock_ctx->ctdb_db, lock_type_str[lock_ctx->type], locks.latency, t);
475 CTDB_INCREMENT_DB_STAT(lock_ctx->ctdb_db, locks.buckets[id]);
478 CTDB_INCREMENT_STAT(lock_ctx->ctdb, locks.num_failed);
479 if (lock_ctx->ctdb_db) {
480 CTDB_INCREMENT_DB_STAT(lock_ctx->ctdb_db, locks.num_failed);
484 process_callbacks(lock_ctx, locked);
486 if (lock_ctx->auto_mark) {
487 talloc_free(tmp_ctx);
493 * Callback routine when required locks are not obtained within timeout
494 * Called from parent context
496 static void ctdb_lock_timeout_handler(struct tevent_context *ev,
497 struct tevent_timer *ttimer,
498 struct timeval current_time,
501 static const char * debug_locks = NULL;
502 struct lock_context *lock_ctx;
503 struct ctdb_context *ctdb;
506 lock_ctx = talloc_get_type_abort(private_data, struct lock_context);
507 ctdb = lock_ctx->ctdb;
509 if (lock_ctx->type == LOCK_RECORD || lock_ctx->type == LOCK_DB) {
511 ("Unable to get %s lock on database %s for %.0lf seconds\n",
512 (lock_ctx->type == LOCK_RECORD ? "RECORD" : "DB"),
513 lock_ctx->ctdb_db->db_name,
514 timeval_elapsed(&lock_ctx->start_time)));
517 ("Unable to get ALLDB locks for %.0lf seconds\n",
518 timeval_elapsed(&lock_ctx->start_time)));
521 /* Fire a child process to find the blocking process. */
522 if (debug_locks == NULL) {
523 debug_locks = getenv("CTDB_DEBUG_LOCKS");
524 if (debug_locks == NULL) {
525 debug_locks = talloc_asprintf(ctdb,
527 getenv("CTDB_BASE"));
530 if (debug_locks != NULL) {
533 execl(debug_locks, debug_locks, NULL);
538 " Unable to setup lock debugging - no memory?\n"));
541 /* reset the timeout timer */
542 // talloc_free(lock_ctx->ttimer);
543 lock_ctx->ttimer = tevent_add_timer(ctdb->ev,
545 timeval_current_ofs(10, 0),
546 ctdb_lock_timeout_handler,
551 static int db_count_handler(struct ctdb_db_context *ctdb_db, uint32_t priority,
554 int *count = (int *)private_data;
566 static int db_name_handler(struct ctdb_db_context *ctdb_db, uint32_t priority,
569 struct db_namelist *list = (struct db_namelist *)private_data;
571 list->names[list->n] = talloc_strdup(list->names, ctdb_db->db_path);
577 static char **lock_helper_args(TALLOC_CTX *mem_ctx, struct lock_context *lock_ctx, int fd)
579 struct ctdb_context *ctdb = lock_ctx->ctdb;
583 struct db_namelist list;
585 switch (lock_ctx->type) {
594 case LOCK_ALLDB_PRIO:
596 ctdb_db_iterator(ctdb, lock_ctx->priority, db_count_handler, &nargs);
601 for (priority=1; priority<NUM_DB_PRIORITIES; priority++) {
602 ctdb_db_iterator(ctdb, priority, db_count_handler, &nargs);
607 /* Add extra argument for null termination */
610 args = talloc_array(mem_ctx, char *, nargs);
615 args[0] = talloc_strdup(args, "ctdb_lock_helper");
616 args[1] = talloc_asprintf(args, "%d", getpid());
617 args[2] = talloc_asprintf(args, "%d", fd);
619 switch (lock_ctx->type) {
621 args[3] = talloc_strdup(args, "RECORD");
622 args[4] = talloc_strdup(args, lock_ctx->ctdb_db->db_path);
623 if (lock_ctx->key.dsize == 0) {
624 args[5] = talloc_strdup(args, "NULL");
626 args[5] = hex_encode_talloc(args, lock_ctx->key.dptr, lock_ctx->key.dsize);
631 args[3] = talloc_strdup(args, "DB");
632 args[4] = talloc_strdup(args, lock_ctx->ctdb_db->db_path);
635 case LOCK_ALLDB_PRIO:
636 args[3] = talloc_strdup(args, "DB");
639 ctdb_db_iterator(ctdb, lock_ctx->priority, db_name_handler, &list);
643 args[3] = talloc_strdup(args, "DB");
646 for (priority=1; priority<NUM_DB_PRIORITIES; priority++) {
647 ctdb_db_iterator(ctdb, priority, db_name_handler, &list);
652 /* Make sure last argument is NULL */
653 args[nargs-1] = NULL;
655 for (i=0; i<nargs-1; i++) {
656 if (args[i] == NULL) {
667 * Find the lock context of a given type
669 static struct lock_context *find_lock_context(struct lock_context *lock_list,
670 struct ctdb_db_context *ctdb_db,
675 struct lock_context *lock_ctx;
677 /* Search active locks */
678 for (lock_ctx=lock_list; lock_ctx; lock_ctx=lock_ctx->next) {
679 if (lock_ctx->type != type) {
683 switch (lock_ctx->type) {
685 if (ctdb_db == lock_ctx->ctdb_db &&
686 key.dsize == lock_ctx->key.dsize &&
687 memcmp(key.dptr, lock_ctx->key.dptr, key.dsize) == 0) {
693 if (ctdb_db == lock_ctx->ctdb_db) {
698 case LOCK_ALLDB_PRIO:
699 if (priority == lock_ctx->priority) {
710 /* Did not find the lock context we are searching for */
720 * Schedule a new lock child process
721 * Set up callback handler and timeout handler
723 static void ctdb_lock_schedule(struct ctdb_context *ctdb)
725 struct lock_context *lock_ctx, *next_ctx, *active_ctx;
728 const char *helper = BINDIR "/ctdb_lock_helper";
729 static const char *prog = NULL;
735 t = getenv("CTDB_LOCK_HELPER");
737 prog = talloc_strdup(ctdb, t);
739 prog = talloc_strdup(ctdb, helper);
741 CTDB_NO_MEMORY_VOID(ctdb, prog);
744 if (ctdb->lock_pending == NULL) {
748 /* Find a lock context with requests */
749 lock_ctx = ctdb->lock_pending;
750 while (lock_ctx != NULL) {
751 next_ctx = lock_ctx->next;
752 if (! lock_ctx->req_queue) {
753 DEBUG(DEBUG_INFO, ("Removing lock context without lock requests\n"));
754 DLIST_REMOVE(ctdb->lock_pending, lock_ctx);
755 ctdb->lock_num_pending--;
756 CTDB_DECREMENT_STAT(ctdb, locks.num_pending);
757 if (lock_ctx->ctdb_db) {
758 CTDB_DECREMENT_DB_STAT(lock_ctx->ctdb_db, locks.num_pending);
760 talloc_free(lock_ctx);
762 active_ctx = find_lock_context(ctdb->lock_current, lock_ctx->ctdb_db,
763 lock_ctx->key, lock_ctx->priority,
765 if (active_ctx == NULL) {
766 if (lock_ctx->ctdb_db == NULL ||
767 lock_ctx->ctdb_db->lock_num_current < MAX_LOCK_PROCESSES_PER_DB) {
768 /* Found a lock context with lock requests */
773 /* There is already a child waiting for the
774 * same key. So don't schedule another child
781 if (lock_ctx == NULL) {
785 lock_ctx->child = -1;
786 ret = pipe(lock_ctx->fd);
788 DEBUG(DEBUG_ERR, ("Failed to create pipe in ctdb_lock_schedule\n"));
792 set_close_on_exec(lock_ctx->fd[0]);
794 /* Create data for child process */
795 tmp_ctx = talloc_new(lock_ctx);
796 if (tmp_ctx == NULL) {
797 DEBUG(DEBUG_ERR, ("Failed to allocate memory for helper args\n"));
798 close(lock_ctx->fd[0]);
799 close(lock_ctx->fd[1]);
803 /* Create arguments for lock helper */
804 args = lock_helper_args(tmp_ctx, lock_ctx, lock_ctx->fd[1]);
806 DEBUG(DEBUG_ERR, ("Failed to create lock helper args\n"));
807 close(lock_ctx->fd[0]);
808 close(lock_ctx->fd[1]);
809 talloc_free(tmp_ctx);
813 lock_ctx->child = ctdb_fork(ctdb);
815 if (lock_ctx->child == (pid_t)-1) {
816 DEBUG(DEBUG_ERR, ("Failed to create a child in ctdb_lock_schedule\n"));
817 close(lock_ctx->fd[0]);
818 close(lock_ctx->fd[1]);
819 talloc_free(tmp_ctx);
825 if (lock_ctx->child == 0) {
826 ret = execv(prog, args);
828 DEBUG(DEBUG_ERR, ("Failed to execute helper %s (%d, %s)\n",
829 prog, errno, strerror(errno)));
835 close(lock_ctx->fd[1]);
837 talloc_set_destructor(lock_ctx, ctdb_lock_context_destructor);
839 talloc_free(tmp_ctx);
841 /* Set up timeout handler */
842 lock_ctx->ttimer = tevent_add_timer(ctdb->ev,
844 timeval_current_ofs(10, 0),
845 ctdb_lock_timeout_handler,
847 if (lock_ctx->ttimer == NULL) {
848 ctdb_kill(ctdb, lock_ctx->child, SIGKILL);
849 lock_ctx->child = -1;
850 talloc_set_destructor(lock_ctx, NULL);
851 close(lock_ctx->fd[0]);
855 /* Set up callback */
856 lock_ctx->tfd = tevent_add_fd(ctdb->ev,
862 if (lock_ctx->tfd == NULL) {
863 TALLOC_FREE(lock_ctx->ttimer);
864 ctdb_kill(ctdb, lock_ctx->child, SIGKILL);
865 lock_ctx->child = -1;
866 talloc_set_destructor(lock_ctx, NULL);
867 close(lock_ctx->fd[0]);
870 tevent_fd_set_auto_close(lock_ctx->tfd);
872 /* Move the context from pending to current */
873 DLIST_REMOVE(ctdb->lock_pending, lock_ctx);
874 ctdb->lock_num_pending--;
875 DLIST_ADD_END(ctdb->lock_current, lock_ctx, NULL);
876 if (lock_ctx->ctdb_db) {
877 lock_ctx->ctdb_db->lock_num_current++;
878 CTDB_INCREMENT_STAT(lock_ctx->ctdb, locks.num_current);
879 CTDB_INCREMENT_DB_STAT(lock_ctx->ctdb_db, locks.num_current);
885 * Lock record / db depending on type
887 static struct lock_request *ctdb_lock_internal(struct ctdb_context *ctdb,
888 struct ctdb_db_context *ctdb_db,
891 void (*callback)(void *, bool),
896 struct lock_context *lock_ctx = NULL;
897 struct lock_request *request;
899 if (callback == NULL) {
900 DEBUG(DEBUG_WARNING, ("No callback function specified, not locking\n"));
905 /* Disable this optimization to ensure first-in-first-out fair
906 * scheduling of lock requests */
908 /* get a context for this key - search only the pending contexts,
909 * current contexts might in the middle of processing callbacks */
910 lock_ctx = find_lock_context(ctdb->lock_pending, ctdb_db, key, priority, type);
913 /* No existing context, create one */
914 if (lock_ctx == NULL) {
915 lock_ctx = talloc_zero(ctdb, struct lock_context);
916 if (lock_ctx == NULL) {
917 DEBUG(DEBUG_ERR, ("Failed to create a new lock context\n"));
921 lock_ctx->type = type;
922 lock_ctx->ctdb = ctdb;
923 lock_ctx->ctdb_db = ctdb_db;
924 lock_ctx->key.dsize = key.dsize;
926 lock_ctx->key.dptr = talloc_memdup(lock_ctx, key.dptr, key.dsize);
928 lock_ctx->key.dptr = NULL;
930 lock_ctx->priority = priority;
931 lock_ctx->auto_mark = auto_mark;
933 lock_ctx->child = -1;
934 lock_ctx->block_child = -1;
936 DLIST_ADD_END(ctdb->lock_pending, lock_ctx, NULL);
937 ctdb->lock_num_pending++;
938 CTDB_INCREMENT_STAT(ctdb, locks.num_pending);
940 CTDB_INCREMENT_DB_STAT(ctdb_db, locks.num_pending);
943 /* Start the timer when we activate the context */
944 lock_ctx->start_time = timeval_current();
947 if ((request = talloc_zero(lock_ctx, struct lock_request)) == NULL) {
951 request->lctx = lock_ctx;
952 request->callback = callback;
953 request->private_data = private_data;
955 talloc_set_destructor(request, ctdb_lock_request_destructor);
956 DLIST_ADD_END(lock_ctx->req_queue, request, NULL);
958 ctdb_lock_schedule(ctdb);
965 * obtain a lock on a record in a database
967 struct lock_request *ctdb_lock_record(struct ctdb_db_context *ctdb_db,
970 void (*callback)(void *, bool),
973 return ctdb_lock_internal(ctdb_db->ctdb,
985 * obtain a lock on a database
987 struct lock_request *ctdb_lock_db(struct ctdb_db_context *ctdb_db,
989 void (*callback)(void *, bool),
992 return ctdb_lock_internal(ctdb_db->ctdb,
1004 * obtain locks on all databases of specified priority
1006 struct lock_request *ctdb_lock_alldb_prio(struct ctdb_context *ctdb,
1009 void (*callback)(void *, bool),
1012 if (priority < 1 || priority > NUM_DB_PRIORITIES) {
1013 DEBUG(DEBUG_ERR, ("Invalid db priority: %u\n", priority));
1017 return ctdb_lock_internal(ctdb,
1029 * obtain locks on all databases
1031 struct lock_request *ctdb_lock_alldb(struct ctdb_context *ctdb,
1033 void (*callback)(void *, bool),
1036 return ctdb_lock_internal(ctdb,