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"
25 #include "lib/tdb_wrap/tdb_wrap.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 * execute an external script to debug.
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
44 * = false is used for freezing databases for
45 * recovery since the recovery cannot start till
46 * databases are locked on all the nodes.
47 * = true is used for record locks.
57 static const char * const lock_type_str[] = {
66 /* lock_context is the common part for a lock request */
68 struct lock_context *next, *prev;
70 struct ctdb_context *ctdb;
71 struct ctdb_db_context *ctdb_db;
75 struct lock_request *request;
78 struct tevent_fd *tfd;
79 struct tevent_timer *ttimer;
80 struct timeval start_time;
85 /* lock_request is the client specific part for a lock request */
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 int ctdb_db_prio_iterator(struct ctdb_context *ctdb, uint32_t priority,
117 ctdb_db_handler_t handler, void *private_data)
119 struct ctdb_db_context *ctdb_db;
122 for (ctdb_db = ctdb->db_list; ctdb_db; ctdb_db = ctdb_db->next) {
123 if (ctdb_db->priority != priority) {
126 if (later_db(ctdb, ctdb_db->db_name)) {
129 ret = handler(ctdb_db, private_data);
135 /* If priority != 1, later_db check is not required and can return */
140 for (ctdb_db = ctdb->db_list; ctdb_db; ctdb_db = ctdb_db->next) {
141 if (!later_db(ctdb, ctdb_db->db_name)) {
144 ret = handler(ctdb_db, private_data);
153 int ctdb_db_iterator(struct ctdb_context *ctdb, ctdb_db_handler_t handler,
156 struct ctdb_db_context *ctdb_db;
159 for (ctdb_db = ctdb->db_list; ctdb_db; ctdb_db = ctdb_db->next) {
160 ret = handler(ctdb_db, private_data);
170 * lock all databases - mark only
172 static int db_lock_mark_handler(struct ctdb_db_context *ctdb_db,
175 int tdb_transaction_write_lock_mark(struct tdb_context *);
177 DEBUG(DEBUG_INFO, ("marking locked database %s\n", ctdb_db->db_name));
179 if (tdb_transaction_write_lock_mark(ctdb_db->ltdb->tdb) != 0) {
180 DEBUG(DEBUG_ERR, ("Failed to mark (transaction lock) database %s\n",
185 if (tdb_lockall_mark(ctdb_db->ltdb->tdb) != 0) {
186 DEBUG(DEBUG_ERR, ("Failed to mark (all lock) database %s\n",
194 int ctdb_lockall_mark_prio(struct ctdb_context *ctdb, uint32_t priority)
197 * This function is only used by the main dameon during recovery.
198 * At this stage, the databases have already been locked, by a
199 * dedicated child process.
202 if (!ctdb_db_prio_frozen(ctdb, priority)) {
203 DEBUG(DEBUG_ERR, ("Attempt to mark all databases locked when not frozen\n"));
207 return ctdb_db_prio_iterator(ctdb, priority, db_lock_mark_handler, NULL);
210 static int ctdb_lockall_mark(struct ctdb_context *ctdb)
214 for (priority=1; priority<=NUM_DB_PRIORITIES; priority++) {
217 ret = ctdb_db_prio_iterator(ctdb, priority,
218 db_lock_mark_handler, NULL);
229 * lock all databases - unmark only
231 static int db_lock_unmark_handler(struct ctdb_db_context *ctdb_db,
234 int tdb_transaction_write_lock_unmark(struct tdb_context *);
236 DEBUG(DEBUG_INFO, ("unmarking locked database %s\n", ctdb_db->db_name));
238 if (tdb_transaction_write_lock_unmark(ctdb_db->ltdb->tdb) != 0) {
239 DEBUG(DEBUG_ERR, ("Failed to unmark (transaction lock) database %s\n",
244 if (tdb_lockall_unmark(ctdb_db->ltdb->tdb) != 0) {
245 DEBUG(DEBUG_ERR, ("Failed to unmark (all lock) database %s\n",
253 int ctdb_lockall_unmark_prio(struct ctdb_context *ctdb, uint32_t priority)
256 * This function is only used by the main daemon during recovery.
257 * At this stage, the databases have already been locked, by a
258 * dedicated child process.
261 if (!ctdb_db_prio_frozen(ctdb, priority)) {
262 DEBUG(DEBUG_ERR, ("Attempt to unmark all databases locked when not frozen\n"));
266 return ctdb_db_prio_iterator(ctdb, priority, db_lock_unmark_handler,
270 static int ctdb_lockall_unmark(struct ctdb_context *ctdb)
274 for (priority=NUM_DB_PRIORITIES; priority>0; priority--) {
277 ret = ctdb_db_prio_iterator(ctdb, priority,
278 db_lock_unmark_handler, NULL);
288 static void ctdb_lock_schedule(struct ctdb_context *ctdb);
291 * Destructor to kill the child locking process
293 static int ctdb_lock_context_destructor(struct lock_context *lock_ctx)
295 if (lock_ctx->request) {
296 lock_ctx->request->lctx = NULL;
298 if (lock_ctx->child > 0) {
299 ctdb_kill(lock_ctx->ctdb, lock_ctx->child, SIGKILL);
300 if (lock_ctx->type == LOCK_RECORD) {
301 DLIST_REMOVE(lock_ctx->ctdb_db->lock_current, lock_ctx);
303 DLIST_REMOVE(lock_ctx->ctdb->lock_current, lock_ctx);
305 if (lock_ctx->ctdb_db) {
306 lock_ctx->ctdb_db->lock_num_current--;
308 CTDB_DECREMENT_STAT(lock_ctx->ctdb, locks.num_current);
309 if (lock_ctx->ctdb_db) {
310 CTDB_DECREMENT_DB_STAT(lock_ctx->ctdb_db, locks.num_current);
313 if (lock_ctx->type == LOCK_RECORD) {
314 DLIST_REMOVE(lock_ctx->ctdb_db->lock_pending, lock_ctx);
316 DLIST_REMOVE(lock_ctx->ctdb->lock_pending, lock_ctx);
318 CTDB_DECREMENT_STAT(lock_ctx->ctdb, locks.num_pending);
319 if (lock_ctx->ctdb_db) {
320 CTDB_DECREMENT_DB_STAT(lock_ctx->ctdb_db, locks.num_pending);
324 ctdb_lock_schedule(lock_ctx->ctdb);
331 * Destructor to remove lock request
333 static int ctdb_lock_request_destructor(struct lock_request *lock_request)
335 if (lock_request->lctx == NULL) {
339 lock_request->lctx->request = NULL;
340 TALLOC_FREE(lock_request->lctx);
346 * Process all the callbacks waiting for lock
348 * If lock has failed, callback is executed with locked=false
350 static void process_callbacks(struct lock_context *lock_ctx, bool locked)
352 struct lock_request *request;
353 bool auto_mark = lock_ctx->auto_mark;
355 if (auto_mark && locked) {
356 switch (lock_ctx->type) {
358 tdb_chainlock_mark(lock_ctx->ctdb_db->ltdb->tdb, lock_ctx->key);
362 tdb_lockall_mark(lock_ctx->ctdb_db->ltdb->tdb);
365 case LOCK_ALLDB_PRIO:
366 ctdb_lockall_mark_prio(lock_ctx->ctdb, lock_ctx->priority);
370 ctdb_lockall_mark(lock_ctx->ctdb);
375 request = lock_ctx->request;
377 /* Since request may be freed in the callback, unset the lock
378 * context, so request destructor will not free lock context.
380 request->lctx = NULL;
383 /* Since request may be freed in the callback, unset the request */
384 lock_ctx->request = NULL;
386 request->callback(request->private_data, locked);
393 switch (lock_ctx->type) {
395 tdb_chainlock_unmark(lock_ctx->ctdb_db->ltdb->tdb, lock_ctx->key);
399 tdb_lockall_unmark(lock_ctx->ctdb_db->ltdb->tdb);
402 case LOCK_ALLDB_PRIO:
403 ctdb_lockall_unmark_prio(lock_ctx->ctdb, lock_ctx->priority);
407 ctdb_lockall_unmark(lock_ctx->ctdb);
412 talloc_free(lock_ctx);
416 static int lock_bucket_id(double t)
418 double ms = 1.e-3, s = 1;
423 } else if (t < 10*ms) {
425 } else if (t < 100*ms) {
427 } else if (t < 1*s) {
429 } else if (t < 2*s) {
431 } else if (t < 4*s) {
433 } else if (t < 8*s) {
435 } else if (t < 16*s) {
437 } else if (t < 32*s) {
439 } else if (t < 64*s) {
449 * Callback routine when the required locks are obtained.
450 * Called from parent context
452 static void ctdb_lock_handler(struct tevent_context *ev,
453 struct tevent_fd *tfd,
457 struct lock_context *lock_ctx;
463 lock_ctx = talloc_get_type_abort(private_data, struct lock_context);
465 /* cancel the timeout event */
466 TALLOC_FREE(lock_ctx->ttimer);
468 t = timeval_elapsed(&lock_ctx->start_time);
469 id = lock_bucket_id(t);
471 /* Read the status from the child process */
472 if (sys_read(lock_ctx->fd[0], &c, 1) != 1) {
475 locked = (c == 0 ? true : false);
478 /* Update statistics */
479 CTDB_INCREMENT_STAT(lock_ctx->ctdb, locks.num_calls);
480 if (lock_ctx->ctdb_db) {
481 CTDB_INCREMENT_DB_STAT(lock_ctx->ctdb_db, locks.num_calls);
485 if (lock_ctx->ctdb_db) {
486 CTDB_INCREMENT_STAT(lock_ctx->ctdb, locks.buckets[id]);
487 CTDB_UPDATE_LATENCY(lock_ctx->ctdb, lock_ctx->ctdb_db,
488 lock_type_str[lock_ctx->type], locks.latency,
489 lock_ctx->start_time);
491 CTDB_UPDATE_DB_LATENCY(lock_ctx->ctdb_db, lock_type_str[lock_ctx->type], locks.latency, t);
492 CTDB_INCREMENT_DB_STAT(lock_ctx->ctdb_db, locks.buckets[id]);
495 CTDB_INCREMENT_STAT(lock_ctx->ctdb, locks.num_failed);
496 if (lock_ctx->ctdb_db) {
497 CTDB_INCREMENT_DB_STAT(lock_ctx->ctdb_db, locks.num_failed);
501 process_callbacks(lock_ctx, locked);
506 * Callback routine when required locks are not obtained within timeout
507 * Called from parent context
509 static void ctdb_lock_timeout_handler(struct tevent_context *ev,
510 struct tevent_timer *ttimer,
511 struct timeval current_time,
514 static char debug_locks[PATH_MAX+1] = "";
515 struct lock_context *lock_ctx;
516 struct ctdb_context *ctdb;
521 lock_ctx = talloc_get_type_abort(private_data, struct lock_context);
522 ctdb = lock_ctx->ctdb;
524 /* If a node stopped/banned, don't spam the logs */
525 if (ctdb->nodes[ctdb->pnn]->flags & NODE_FLAGS_INACTIVE) {
526 lock_ctx->ttimer = NULL;
530 elapsed_time = timeval_elapsed(&lock_ctx->start_time);
531 if (lock_ctx->ctdb_db) {
533 ("Unable to get %s lock on database %s for %.0lf seconds\n",
534 (lock_ctx->type == LOCK_RECORD ? "RECORD" : "DB"),
535 lock_ctx->ctdb_db->db_name, elapsed_time));
538 ("Unable to get ALLDB locks for %.0lf seconds\n",
542 if (ctdb_set_helper("lock debugging helper",
543 debug_locks, sizeof(debug_locks),
545 getenv("CTDB_BASE"), "debug_locks.sh")) {
548 execl(debug_locks, debug_locks, NULL);
551 ctdb_track_child(ctdb, pid);
555 " Unable to setup lock debugging\n"));
558 /* Back-off logging if lock is not obtained for a long time */
559 if (elapsed_time < 100.0) {
561 } else if (elapsed_time < 1000.0) {
567 /* reset the timeout timer */
568 // talloc_free(lock_ctx->ttimer);
569 lock_ctx->ttimer = tevent_add_timer(ctdb->ev,
571 timeval_current_ofs(new_timer, 0),
572 ctdb_lock_timeout_handler,
577 static int db_count_handler(struct ctdb_db_context *ctdb_db, void *private_data)
579 int *count = (int *)private_data;
586 static int db_flags(struct ctdb_db_context *ctdb_db)
588 int tdb_flags = TDB_DEFAULT;
590 #ifdef TDB_MUTEX_LOCKING
591 if (!ctdb_db->persistent && ctdb_db->ctdb->tunable.mutex_enabled) {
592 tdb_flags = (TDB_MUTEX_LOCKING | TDB_CLEAR_IF_FIRST);
603 static int db_name_handler(struct ctdb_db_context *ctdb_db, void *private_data)
605 struct db_namelist *list = (struct db_namelist *)private_data;
607 list->names[list->n] = talloc_strdup(list->names, ctdb_db->db_path);
608 list->names[list->n+1] = talloc_asprintf(list->names, "0x%x",
615 static bool lock_helper_args(TALLOC_CTX *mem_ctx,
616 struct lock_context *lock_ctx, int fd,
617 int *argc, const char ***argv)
619 struct ctdb_context *ctdb = lock_ctx->ctdb;
620 const char **args = NULL;
623 struct db_namelist list;
625 switch (lock_ctx->type) {
634 case LOCK_ALLDB_PRIO:
636 ctdb_db_prio_iterator(ctdb, lock_ctx->priority,
637 db_count_handler, &nargs);
642 for (priority=1; priority<NUM_DB_PRIORITIES; priority++) {
643 ctdb_db_prio_iterator(ctdb, priority,
644 db_count_handler, &nargs);
649 /* Add extra argument for null termination */
652 args = talloc_array(mem_ctx, const char *, nargs);
657 args[0] = talloc_asprintf(args, "%d", getpid());
658 args[1] = talloc_asprintf(args, "%d", fd);
660 switch (lock_ctx->type) {
662 args[2] = talloc_strdup(args, "RECORD");
663 args[3] = talloc_strdup(args, lock_ctx->ctdb_db->db_path);
664 args[4] = talloc_asprintf(args, "0x%x",
665 db_flags(lock_ctx->ctdb_db));
666 if (lock_ctx->key.dsize == 0) {
667 args[5] = talloc_strdup(args, "NULL");
669 args[5] = hex_encode_talloc(args, lock_ctx->key.dptr, lock_ctx->key.dsize);
674 args[2] = talloc_strdup(args, "DB");
675 args[3] = talloc_strdup(args, lock_ctx->ctdb_db->db_path);
676 args[4] = talloc_asprintf(args, "0x%x",
677 db_flags(lock_ctx->ctdb_db));
680 case LOCK_ALLDB_PRIO:
681 args[2] = talloc_strdup(args, "DB");
684 ctdb_db_prio_iterator(ctdb, lock_ctx->priority,
685 db_name_handler, &list);
689 args[2] = talloc_strdup(args, "DB");
692 for (priority=1; priority<NUM_DB_PRIORITIES; priority++) {
693 ctdb_db_prio_iterator(ctdb, priority,
694 db_name_handler, &list);
699 /* Make sure last argument is NULL */
700 args[nargs-1] = NULL;
702 for (i=0; i<nargs-1; i++) {
703 if (args[i] == NULL) {
715 * Find a lock request that can be scheduled
717 static struct lock_context *ctdb_find_lock_context(struct ctdb_context *ctdb)
719 struct lock_context *lock_ctx, *next_ctx;
720 struct ctdb_db_context *ctdb_db;
722 /* First check if there are database lock requests */
724 for (lock_ctx = ctdb->lock_pending; lock_ctx != NULL;
725 lock_ctx = next_ctx) {
727 if (lock_ctx->request != NULL) {
728 /* Found a lock context with a request */
732 next_ctx = lock_ctx->next;
734 DEBUG(DEBUG_INFO, ("Removing lock context without lock "
736 DLIST_REMOVE(ctdb->lock_pending, lock_ctx);
737 CTDB_DECREMENT_STAT(ctdb, locks.num_pending);
738 if (lock_ctx->ctdb_db) {
739 CTDB_DECREMENT_DB_STAT(lock_ctx->ctdb_db,
742 talloc_free(lock_ctx);
745 /* Next check database queues */
746 for (ctdb_db = ctdb->db_list; ctdb_db; ctdb_db = ctdb_db->next) {
747 if (ctdb_db->lock_num_current ==
748 ctdb->tunable.lock_processes_per_db) {
752 for (lock_ctx = ctdb_db->lock_pending; lock_ctx != NULL;
753 lock_ctx = next_ctx) {
755 next_ctx = lock_ctx->next;
757 if (lock_ctx->request != NULL) {
761 DEBUG(DEBUG_INFO, ("Removing lock context without "
763 DLIST_REMOVE(ctdb_db->lock_pending, lock_ctx);
764 CTDB_DECREMENT_STAT(ctdb, locks.num_pending);
765 CTDB_DECREMENT_DB_STAT(ctdb_db, locks.num_pending);
766 talloc_free(lock_ctx);
774 * Schedule a new lock child process
775 * Set up callback handler and timeout handler
777 static void ctdb_lock_schedule(struct ctdb_context *ctdb)
779 struct lock_context *lock_ctx;
782 static char prog[PATH_MAX+1] = "";
785 if (!ctdb_set_helper("lock helper",
788 CTDB_HELPER_BINDIR, "ctdb_lock_helper")) {
789 ctdb_die(ctdb, __location__
790 " Unable to set lock helper\n");
793 /* Find a lock context with requests */
794 lock_ctx = ctdb_find_lock_context(ctdb);
795 if (lock_ctx == NULL) {
799 lock_ctx->child = -1;
800 ret = pipe(lock_ctx->fd);
802 DEBUG(DEBUG_ERR, ("Failed to create pipe in ctdb_lock_schedule\n"));
806 set_close_on_exec(lock_ctx->fd[0]);
808 /* Create data for child process */
809 tmp_ctx = talloc_new(lock_ctx);
810 if (tmp_ctx == NULL) {
811 DEBUG(DEBUG_ERR, ("Failed to allocate memory for helper args\n"));
812 close(lock_ctx->fd[0]);
813 close(lock_ctx->fd[1]);
817 /* Create arguments for lock helper */
818 if (!lock_helper_args(tmp_ctx, lock_ctx, lock_ctx->fd[1],
820 DEBUG(DEBUG_ERR, ("Failed to create lock helper args\n"));
821 close(lock_ctx->fd[0]);
822 close(lock_ctx->fd[1]);
823 talloc_free(tmp_ctx);
827 if (!ctdb_vfork_with_logging(lock_ctx, ctdb, "lock_helper",
828 prog, argc, (const char **)args,
829 NULL, NULL, &lock_ctx->child)) {
830 DEBUG(DEBUG_ERR, ("Failed to create a child in ctdb_lock_schedule\n"));
831 close(lock_ctx->fd[0]);
832 close(lock_ctx->fd[1]);
833 talloc_free(tmp_ctx);
838 close(lock_ctx->fd[1]);
840 talloc_free(tmp_ctx);
842 /* Set up timeout handler */
843 lock_ctx->ttimer = tevent_add_timer(ctdb->ev,
845 timeval_current_ofs(10, 0),
846 ctdb_lock_timeout_handler,
848 if (lock_ctx->ttimer == NULL) {
849 ctdb_kill(ctdb, lock_ctx->child, SIGKILL);
850 lock_ctx->child = -1;
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 close(lock_ctx->fd[0]);
869 tevent_fd_set_auto_close(lock_ctx->tfd);
871 /* Move the context from pending to current */
872 if (lock_ctx->type == LOCK_RECORD) {
873 DLIST_REMOVE(lock_ctx->ctdb_db->lock_pending, lock_ctx);
874 DLIST_ADD_END(lock_ctx->ctdb_db->lock_current, lock_ctx, NULL);
876 DLIST_REMOVE(ctdb->lock_pending, lock_ctx);
877 DLIST_ADD_END(ctdb->lock_current, lock_ctx, NULL);
879 CTDB_DECREMENT_STAT(lock_ctx->ctdb, locks.num_pending);
880 CTDB_INCREMENT_STAT(lock_ctx->ctdb, locks.num_current);
881 if (lock_ctx->ctdb_db) {
882 lock_ctx->ctdb_db->lock_num_current++;
883 CTDB_DECREMENT_DB_STAT(lock_ctx->ctdb_db, locks.num_pending);
884 CTDB_INCREMENT_DB_STAT(lock_ctx->ctdb_db, locks.num_current);
890 * Lock record / db depending on type
892 static struct lock_request *ctdb_lock_internal(TALLOC_CTX *mem_ctx,
893 struct ctdb_context *ctdb,
894 struct ctdb_db_context *ctdb_db,
897 void (*callback)(void *, bool),
902 struct lock_context *lock_ctx = NULL;
903 struct lock_request *request;
905 if (callback == NULL) {
906 DEBUG(DEBUG_WARNING, ("No callback function specified, not locking\n"));
910 lock_ctx = talloc_zero(ctdb, struct lock_context);
911 if (lock_ctx == NULL) {
912 DEBUG(DEBUG_ERR, ("Failed to create a new lock context\n"));
916 if ((request = talloc_zero(mem_ctx, struct lock_request)) == NULL) {
917 talloc_free(lock_ctx);
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);
927 if (lock_ctx->key.dptr == NULL) {
928 DEBUG(DEBUG_ERR, (__location__ "Memory allocation error\n"));
929 talloc_free(lock_ctx);
930 talloc_free(request);
933 lock_ctx->key_hash = ctdb_hash(&key);
935 lock_ctx->key.dptr = NULL;
937 lock_ctx->priority = priority;
938 lock_ctx->auto_mark = auto_mark;
940 lock_ctx->request = request;
941 lock_ctx->child = -1;
943 /* Non-record locks are required by recovery and should be scheduled
944 * immediately, so keep them at the head of the pending queue.
946 if (lock_ctx->type == LOCK_RECORD) {
947 DLIST_ADD_END(ctdb_db->lock_pending, lock_ctx, NULL);
949 DLIST_ADD_END(ctdb->lock_pending, lock_ctx, NULL);
951 CTDB_INCREMENT_STAT(ctdb, locks.num_pending);
953 CTDB_INCREMENT_DB_STAT(ctdb_db, locks.num_pending);
956 /* Start the timer when we activate the context */
957 lock_ctx->start_time = timeval_current();
959 request->lctx = lock_ctx;
960 request->callback = callback;
961 request->private_data = private_data;
963 talloc_set_destructor(request, ctdb_lock_request_destructor);
964 talloc_set_destructor(lock_ctx, ctdb_lock_context_destructor);
966 ctdb_lock_schedule(ctdb);
973 * obtain a lock on a record in a database
975 struct lock_request *ctdb_lock_record(TALLOC_CTX *mem_ctx,
976 struct ctdb_db_context *ctdb_db,
979 void (*callback)(void *, bool),
982 return ctdb_lock_internal(mem_ctx,
995 * obtain a lock on a database
997 struct lock_request *ctdb_lock_db(TALLOC_CTX *mem_ctx,
998 struct ctdb_db_context *ctdb_db,
1000 void (*callback)(void *, bool),
1003 return ctdb_lock_internal(mem_ctx,
1016 * obtain locks on all databases of specified priority
1018 struct lock_request *ctdb_lock_alldb_prio(TALLOC_CTX *mem_ctx,
1019 struct ctdb_context *ctdb,
1022 void (*callback)(void *, bool),
1025 if (priority < 1 || priority > NUM_DB_PRIORITIES) {
1026 DEBUG(DEBUG_ERR, ("Invalid db priority: %u\n", priority));
1030 return ctdb_lock_internal(mem_ctx,
1043 * obtain locks on all databases
1045 struct lock_request *ctdb_lock_alldb(TALLOC_CTX *mem_ctx,
1046 struct ctdb_context *ctdb,
1048 void (*callback)(void *, bool),
1051 return ctdb_lock_internal(mem_ctx,