4 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License version 2 only,
8 * as published by the Free Software Foundation.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License version 2 for more details. A copy is
14 * included in the COPYING file that accompanied this code.
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, write to the Free Software
18 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
23 * Copyright (c) 2016, Intel Corporation.
25 * lustre/mgs/mgs_barrier.c
27 * Author: Fan, Yong <fan.yong@intel.com>
30 #define DEBUG_SUBSYSTEM S_MGS
31 #define D_MGS D_CONFIG
33 #include <uapi/linux/lustre_ioctl.h>
34 #include <lustre_swab.h>
35 #include <lustre/lustre_barrier_user.h>
37 #include "mgs_internal.h"
40 * Handle the barrier lock glimpse reply.
42 * The barrier lock glimpse reply contains the target MDT's index and
43 * the barrier operation status on such MDT. With such infomation. If
44 * the MDT given barrier status is the expected one, then set related
45 * 'fsdb''s barrier bitmap; otherwise record the failure or status.
47 * \param[in] env pointer to the thread context
48 * \param[in] req pointer to the glimpse callback RPC request
49 * \param[in] data pointer the async glimpse callback data
50 * \param[in] rc the glimpse callback RPC return value
52 * \retval 0 for success
53 * \retval negative error number on failure
55 static int mgs_barrier_gl_interpret_reply(const struct lu_env *env,
56 struct ptlrpc_request *req,
59 struct ldlm_cb_async_args *ca = data;
60 struct fs_db *fsdb = ca->ca_set_arg->gl_interpret_data;
61 struct barrier_lvb *lvb;
66 /* The lock is useless, cancel it. */
67 ldlm_lock_cancel(ca->ca_lock);
74 lvb = req_capsule_server_swab_get(&req->rq_pill, &RMF_DLM_LVB,
75 lustre_swab_barrier_lvb);
77 GOTO(out, rc = -EPROTO);
79 if (lvb->lvb_status == fsdb->fsdb_barrier_expected) {
80 if (unlikely(lvb->lvb_index > INDEX_MAP_SIZE))
83 set_bit(lvb->lvb_index, fsdb->fsdb_barrier_map);
84 } else if (likely(!test_bit(lvb->lvb_index, fsdb->fsdb_barrier_map))) {
85 fsdb->fsdb_barrier_result = lvb->lvb_status;
92 fsdb->fsdb_barrier_result = rc;
98 * Send glimpse callback to the barrier locks holders.
100 * The glimpse callback takes the current barrier status. The barrier locks
101 * holders (on the MDTs) will take related barrier actions according to the
102 * given barrier status, then return their local barrier status.
104 * \param[in] env pointer to the thread context
105 * \param[in] mgs pointer to the MGS device
106 * \param[in] fsdb pointer the barrier 'fsdb'
107 * \param[in] timeout indicate when the barrier will be expired
108 * \param[in] expected the expected barrier status on remote servers (MDTs)
110 * \retval positive number for unexpected barrier status
111 * \retval 0 for success
112 * \retval negative error number on failure
114 static int mgs_barrier_glimpse_lock(const struct lu_env *env,
115 struct mgs_device *mgs,
117 __u32 timeout, __u32 expected)
119 union ldlm_gl_desc *desc = &mgs_env_info(env)->mgi_gl_desc;
120 struct ldlm_res_id res_id;
121 struct ldlm_resource *res;
122 struct ldlm_glimpse_work *work;
123 struct ldlm_glimpse_work *tmp;
124 struct list_head gl_list = LIST_HEAD_INIT(gl_list);
125 struct list_head *pos;
130 LASSERT(fsdb->fsdb_mdt_count > 0);
132 rc = mgc_logname2resid(fsdb->fsdb_name, &res_id, CONFIG_T_BARRIER);
136 res = ldlm_resource_get(mgs->mgs_obd->obd_namespace, NULL, &res_id,
139 RETURN(PTR_ERR(res));
141 fsdb->fsdb_barrier_result = 0;
142 fsdb->fsdb_barrier_expected = expected;
143 desc->barrier_desc.lgbd_status = fsdb->fsdb_barrier_status;
144 desc->barrier_desc.lgbd_timeout = timeout;
147 list_for_each_entry(work, &gl_list, gl_list) {
151 LDLM_LOCK_RELEASE(work->gl_lock);
152 work->gl_lock = NULL;
155 /* It is not big issue to alloc more work item than needed. */
156 for (i = 0; i < fsdb->fsdb_mdt_count; i++) {
159 GOTO(out, rc = -ENOMEM);
161 list_add_tail(&work->gl_list, &gl_list);
164 work = list_entry(gl_list.next, struct ldlm_glimpse_work, gl_list);
167 list_for_each(pos, &res->lr_granted) {
168 struct ldlm_lock *lock = list_entry(pos, struct ldlm_lock,
171 work->gl_lock = LDLM_LOCK_GET(lock);
173 work->gl_desc = desc;
174 work->gl_interpret_reply = mgs_barrier_gl_interpret_reply;
175 work->gl_interpret_data = fsdb;
177 if (unlikely(work->gl_list.next == &gl_list)) {
178 if (likely(pos->next == &res->lr_granted))
182 /* The granted locks are more than the MDTs count. */
186 work = list_entry(work->gl_list.next, struct ldlm_glimpse_work,
191 /* The MDTs count may be more than the granted locks. */
192 list_for_each_entry_safe_reverse(work, tmp, &gl_list, gl_list) {
196 list_del(&work->gl_list);
200 if (!list_empty(&gl_list))
201 rc = ldlm_glimpse_locks(res, &gl_list);
208 list_for_each_entry_safe(work, tmp, &gl_list, gl_list) {
209 list_del(&work->gl_list);
211 LDLM_LOCK_RELEASE(work->gl_lock);
215 ldlm_resource_putref(res);
217 rc = fsdb->fsdb_barrier_result;
222 static void mgs_barrier_bitmap_setup(struct mgs_device *mgs,
223 struct fs_db *b_fsdb,
226 struct fs_db *c_fsdb;
228 c_fsdb = mgs_find_fsdb(mgs, name);
229 if (likely(c_fsdb)) {
230 memcpy(b_fsdb->fsdb_mdt_index_map,
231 c_fsdb->fsdb_mdt_index_map, INDEX_MAP_SIZE);
232 b_fsdb->fsdb_mdt_count = c_fsdb->fsdb_mdt_count;
233 mgs_put_fsdb(mgs, c_fsdb);
237 static bool mgs_barrier_done(struct fs_db *fsdb)
241 for (i = 0; i < INDEX_MAP_SIZE * 8; i++) {
242 if (test_bit(i, fsdb->fsdb_mdt_index_map) &&
243 !test_bit(i, fsdb->fsdb_barrier_map))
251 * Create the barrier for the given instance.
253 * We use two-phases barrier to guarantee that after the barrier setup:
254 * 1) All the server side pending async modification RPCs have been flushed.
255 * 2) Any subsequent modification will be blocked.
256 * 3) All async transactions on the MDTs have been committed.
258 * For phase1, we do the following:
260 * Firstly, it sets barrier flag on the instance that will block subsequent
261 * modifications from clients. (Note: server sponsored modification will be
262 * allowed for flush pending modifications)
264 * Secondly, it will flush all pending modification via dt_sync(), such as
265 * async OST-object destroy, async OST-object owner changes, and so on.
267 * If there are some on-handling clients sponsored modifications during the
268 * barrier creating, then related modifications may cause pending requests
269 * after the first dt_sync(), so call dt_sync() again after all on-handling
270 * modifications done.
272 * With the phase1 barrier set, all pending cross-servers modification RPCs
273 * have been flushed to remote servers, and any new modification will be
274 * blocked. But it does not guarantees that all the updates have been
275 * committed to storage on remote servers. So when all the instances have
276 * done phase1 barrier successfully, the MGS will notify all instances to
277 * do the phase2 barrier as following:
279 * Every barrier instance will call dt_sync() to make all async transactions
280 * to be committed locally.
282 * \param[in] env pointer to the thread context
283 * \param[in] mgs pointer to the MGS device
284 * \param[in] bc pointer the barrier control structure
286 * \retval 0 for success
287 * \retval negative error number on failure
289 static int mgs_barrier_freeze(const struct lu_env *env,
290 struct mgs_device *mgs,
291 struct barrier_ctl *bc)
293 char *name = mgs_env_info(env)->mgi_fsname;
301 snprintf(name, sizeof(mgs_env_info(env)->mgi_fsname) - 1, "%s-%s",
302 bc->bc_name, BARRIER_FILENAME);
304 down_write(&mgs->mgs_barrier_rwsem);
305 mutex_lock(&mgs->mgs_mutex);
307 fsdb = mgs_find_fsdb(mgs, name);
309 mutex_unlock(&mgs->mgs_mutex);
310 up_write(&mgs->mgs_barrier_rwsem);
315 if (unlikely(fsdb->fsdb_mdt_count == 0))
316 mgs_barrier_bitmap_setup(mgs, fsdb, bc->bc_name);
318 mutex_lock(&fsdb->fsdb_mutex);
319 mutex_unlock(&mgs->mgs_mutex);
321 switch (fsdb->fsdb_barrier_status) {
331 if (cfs_time_before(cfs_time_current_sec(),
332 fsdb->fsdb_barrier_latest_create_time +
333 fsdb->fsdb_barrier_timeout)) {
341 if (fsdb->fsdb_barrier_disabled) {
343 } else if (unlikely(fsdb->fsdb_mdt_count == 0)) {
346 fsdb->fsdb_barrier_latest_create_time =
347 cfs_time_current_sec();
348 fsdb->fsdb_barrier_status = BS_FREEZING_P1;
349 if (bc->bc_timeout != 0)
350 fsdb->fsdb_barrier_timeout = bc->bc_timeout;
352 fsdb->fsdb_barrier_timeout =
353 BARRIER_TIMEOUT_DEFAULT;
354 memset(fsdb->fsdb_barrier_map, 0, INDEX_MAP_SIZE);
358 LCONSOLE_WARN("%s: found unexpected barrier status %u\n",
359 bc->bc_name, fsdb->fsdb_barrier_status);
367 left = fsdb->fsdb_barrier_timeout;
370 mutex_unlock(&fsdb->fsdb_mutex);
371 up_write(&mgs->mgs_barrier_rwsem);
373 CFS_FAIL_TIMEOUT(OBD_FAIL_BARRIER_DELAY, cfs_fail_val);
375 rc = mgs_barrier_glimpse_lock(env, mgs, fsdb, left,
376 phase1 ? BS_FREEZING_P1 : BS_FROZEN);
377 down_write(&mgs->mgs_barrier_rwsem);
378 mutex_lock(&fsdb->fsdb_mutex);
381 left = fsdb->fsdb_barrier_latest_create_time +
382 fsdb->fsdb_barrier_timeout - cfs_time_current_sec();
384 fsdb->fsdb_barrier_status = BS_EXPIRED;
386 GOTO(out, rc = -ETIME);
389 LASSERTF(fsdb->fsdb_barrier_status ==
390 (phase1 ? BS_FREEZING_P1 : BS_FREEZING_P2),
391 "unexpected barrier status %u\n",
392 fsdb->fsdb_barrier_status);
394 if (rc == -ETIMEDOUT) {
395 fsdb->fsdb_barrier_status = BS_EXPIRED;
398 fsdb->fsdb_barrier_status = rc;
401 fsdb->fsdb_barrier_status = BS_FAILED;
402 } else if (mgs_barrier_done(fsdb)) {
404 fsdb->fsdb_barrier_status = BS_FREEZING_P2;
405 memset(fsdb->fsdb_barrier_map, 0,
411 fsdb->fsdb_barrier_status = BS_FROZEN;
414 fsdb->fsdb_barrier_status = BS_FAILED;
421 mutex_unlock(&fsdb->fsdb_mutex);
422 up_write(&mgs->mgs_barrier_rwsem);
424 memset(fsdb->fsdb_barrier_map, 0, INDEX_MAP_SIZE);
425 mgs_barrier_glimpse_lock(env, mgs, fsdb, 0, BS_THAWED);
428 mgs_put_fsdb(mgs, fsdb);
433 static int mgs_barrier_thaw(const struct lu_env *env,
434 struct mgs_device *mgs,
435 struct barrier_ctl *bc)
437 char *name = mgs_env_info(env)->mgi_fsname;
442 snprintf(name, sizeof(mgs_env_info(env)->mgi_fsname) - 1, "%s-%s",
443 bc->bc_name, BARRIER_FILENAME);
445 down_write(&mgs->mgs_barrier_rwsem);
446 mutex_lock(&mgs->mgs_mutex);
448 fsdb = mgs_find_fsdb(mgs, name);
450 mutex_unlock(&mgs->mgs_mutex);
451 up_write(&mgs->mgs_barrier_rwsem);
456 if (unlikely(fsdb->fsdb_mdt_count == 0))
457 mgs_barrier_bitmap_setup(mgs, fsdb, bc->bc_name);
459 mutex_lock(&fsdb->fsdb_mutex);
460 mutex_unlock(&mgs->mgs_mutex);
462 switch (fsdb->fsdb_barrier_status) {
476 case BS_EXPIRED: /* The barrier on some MDT(s) may be expired,
477 * but may be not on others. Destory anyway. */
479 if (unlikely(fsdb->fsdb_mdt_count == 0)) {
482 fsdb->fsdb_barrier_status = BS_THAWING;
483 memset(fsdb->fsdb_barrier_map, 0, INDEX_MAP_SIZE);
487 LCONSOLE_WARN("%s: found unexpected barrier status %u\n",
488 bc->bc_name, fsdb->fsdb_barrier_status);
496 mutex_unlock(&fsdb->fsdb_mutex);
497 up_write(&mgs->mgs_barrier_rwsem);
499 CFS_FAIL_TIMEOUT(OBD_FAIL_BARRIER_DELAY, cfs_fail_val);
501 rc = mgs_barrier_glimpse_lock(env, mgs, fsdb, 0, BS_THAWED);
502 down_write(&mgs->mgs_barrier_rwsem);
503 mutex_lock(&fsdb->fsdb_mutex);
505 LASSERTF(fsdb->fsdb_barrier_status == BS_THAWING,
506 "unexpected barrier status %u\n",
507 fsdb->fsdb_barrier_status);
510 fsdb->fsdb_barrier_status = rc;
513 fsdb->fsdb_barrier_status = BS_FAILED;
514 } else if (mgs_barrier_done(fsdb)) {
515 fsdb->fsdb_barrier_status = BS_THAWED;
517 fsdb->fsdb_barrier_status = BS_FAILED;
524 mutex_unlock(&fsdb->fsdb_mutex);
525 up_write(&mgs->mgs_barrier_rwsem);
526 mgs_put_fsdb(mgs, fsdb);
531 static int mgs_barrier_stat(const struct lu_env *env,
532 struct mgs_device *mgs,
533 struct barrier_ctl *bc)
535 char *name = mgs_env_info(env)->mgi_fsname;
539 snprintf(name, sizeof(mgs_env_info(env)->mgi_fsname) - 1, "%s-%s",
540 bc->bc_name, BARRIER_FILENAME);
542 mutex_lock(&mgs->mgs_mutex);
544 fsdb = mgs_find_fsdb(mgs, name);
546 mutex_lock(&fsdb->fsdb_mutex);
547 mutex_unlock(&mgs->mgs_mutex);
549 bc->bc_status = fsdb->fsdb_barrier_status;
550 if (bc->bc_status == BS_FREEZING_P1 ||
551 bc->bc_status == BS_FREEZING_P2 ||
552 bc->bc_status == BS_FROZEN) {
553 if (cfs_time_before(cfs_time_current_sec(),
554 fsdb->fsdb_barrier_latest_create_time +
555 fsdb->fsdb_barrier_timeout))
557 fsdb->fsdb_barrier_latest_create_time +
558 fsdb->fsdb_barrier_timeout -
559 cfs_time_current_sec();
561 bc->bc_status = fsdb->fsdb_barrier_status =
565 mutex_unlock(&fsdb->fsdb_mutex);
566 mgs_put_fsdb(mgs, fsdb);
568 mutex_unlock(&mgs->mgs_mutex);
570 bc->bc_status = BS_INIT;
576 static int mgs_barrier_rescan(const struct lu_env *env,
577 struct mgs_device *mgs,
578 struct barrier_ctl *bc)
580 char *name = mgs_env_info(env)->mgi_fsname;
581 struct fs_db *b_fsdb;
582 struct fs_db *c_fsdb;
586 down_write(&mgs->mgs_barrier_rwsem);
587 mutex_lock(&mgs->mgs_mutex);
589 c_fsdb = mgs_find_fsdb(mgs, bc->bc_name);
590 if (!c_fsdb || unlikely(c_fsdb->fsdb_mdt_count == 0)) {
591 mutex_unlock(&mgs->mgs_mutex);
592 up_write(&mgs->mgs_barrier_rwsem);
597 snprintf(name, sizeof(mgs_env_info(env)->mgi_fsname) - 1, "%s-%s",
598 bc->bc_name, BARRIER_FILENAME);
599 b_fsdb = mgs_find_fsdb(mgs, name);
601 mutex_unlock(&mgs->mgs_mutex);
602 up_write(&mgs->mgs_barrier_rwsem);
603 mgs_put_fsdb(mgs, c_fsdb);
608 mutex_lock(&b_fsdb->fsdb_mutex);
609 mutex_lock(&c_fsdb->fsdb_mutex);
610 mutex_unlock(&mgs->mgs_mutex);
612 switch (b_fsdb->fsdb_barrier_status) {
622 if (cfs_time_before(cfs_time_current_sec(),
623 b_fsdb->fsdb_barrier_latest_create_time +
624 b_fsdb->fsdb_barrier_timeout)) {
632 b_fsdb->fsdb_barrier_latest_create_time =
633 cfs_time_current_sec();
634 b_fsdb->fsdb_barrier_status = BS_RESCAN;
635 memcpy(b_fsdb->fsdb_mdt_index_map, c_fsdb->fsdb_mdt_index_map,
637 memset(b_fsdb->fsdb_barrier_map, 0, INDEX_MAP_SIZE);
638 b_fsdb->fsdb_mdt_count = c_fsdb->fsdb_mdt_count;
641 LCONSOLE_WARN("%s: found unexpected barrier status %u\n",
642 bc->bc_name, b_fsdb->fsdb_barrier_status);
647 mutex_unlock(&c_fsdb->fsdb_mutex);
648 mgs_put_fsdb(mgs, c_fsdb);
654 mutex_unlock(&b_fsdb->fsdb_mutex);
655 up_write(&mgs->mgs_barrier_rwsem);
656 rc = mgs_barrier_glimpse_lock(env, mgs, b_fsdb, 0, BS_INIT);
657 down_write(&mgs->mgs_barrier_rwsem);
658 mutex_lock(&b_fsdb->fsdb_mutex);
660 LASSERTF(b_fsdb->fsdb_barrier_status == BS_RESCAN,
661 "unexpected barrier status %u\n",
662 b_fsdb->fsdb_barrier_status);
665 b_fsdb->fsdb_barrier_status = rc;
667 } else if (rc == -ETIMEDOUT &&
668 cfs_time_before(cfs_time_current_sec(),
669 b_fsdb->fsdb_barrier_latest_create_time +
671 memset(b_fsdb->fsdb_barrier_map, 0, INDEX_MAP_SIZE);
674 } else if (rc < 0 && rc != -ETIMEDOUT && rc != -ENODEV) {
675 b_fsdb->fsdb_barrier_status = BS_FAILED;
679 b_fsdb->fsdb_mdt_count = 0;
683 for (i = 0; i < INDEX_MAP_SIZE * 8; i++) {
684 if (test_bit(i, b_fsdb->fsdb_barrier_map)) {
685 b_fsdb->fsdb_mdt_count++;
686 } else if (test_bit(i, b_fsdb->fsdb_mdt_index_map)) {
687 b_fsdb->fsdb_mdt_count++;
692 bc->bc_total = b_fsdb->fsdb_mdt_count;
693 memcpy(b_fsdb->fsdb_mdt_index_map,
694 b_fsdb->fsdb_barrier_map, INDEX_MAP_SIZE);
695 b_fsdb->fsdb_barrier_status = BS_INIT;
701 mutex_unlock(&b_fsdb->fsdb_mutex);
702 up_write(&mgs->mgs_barrier_rwsem);
703 mgs_put_fsdb(mgs, b_fsdb);
708 int mgs_iocontrol_barrier(const struct lu_env *env,
709 struct mgs_device *mgs,
710 struct obd_ioctl_data *data)
712 struct barrier_ctl *bc = (struct barrier_ctl *)(data->ioc_inlbuf1);
716 if (unlikely(bc->bc_version != BARRIER_VERSION_V1))
719 if (unlikely(bc->bc_name[0] == '\0' ||
720 strnlen(bc->bc_name, sizeof(bc->bc_name)) > 8))
723 /* NOT allow barrier operations during recovery. */
724 if (unlikely(mgs->mgs_obd->obd_recovering))
727 switch (bc->bc_cmd) {
729 rc = mgs_barrier_freeze(env, mgs, bc);
732 rc = mgs_barrier_thaw(env, mgs, bc);
735 rc = mgs_barrier_stat(env, mgs, bc);
738 rc = mgs_barrier_rescan(env, mgs, bc);