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) 2017, 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/lustre_ioctl.h>
34 #include <lustre_swab.h>
35 #include <uapi/linux/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))
250 bool mgs_barrier_expired(struct fs_db *fsdb, time64_t timeout)
252 time64_t expired = fsdb->fsdb_barrier_latest_create_time + timeout;
254 return expired > ktime_get_real_seconds();
258 * Create the barrier for the given instance.
260 * We use two-phases barrier to guarantee that after the barrier setup:
261 * 1) All the server side pending async modification RPCs have been flushed.
262 * 2) Any subsequent modification will be blocked.
263 * 3) All async transactions on the MDTs have been committed.
265 * For phase1, we do the following:
267 * Firstly, it sets barrier flag on the instance that will block subsequent
268 * modifications from clients. (Note: server sponsored modification will be
269 * allowed for flush pending modifications)
271 * Secondly, it will flush all pending modification via dt_sync(), such as
272 * async OST-object destroy, async OST-object owner changes, and so on.
274 * If there are some on-handling clients sponsored modifications during the
275 * barrier creating, then related modifications may cause pending requests
276 * after the first dt_sync(), so call dt_sync() again after all on-handling
277 * modifications done.
279 * With the phase1 barrier set, all pending cross-servers modification RPCs
280 * have been flushed to remote servers, and any new modification will be
281 * blocked. But it does not guarantees that all the updates have been
282 * committed to storage on remote servers. So when all the instances have
283 * done phase1 barrier successfully, the MGS will notify all instances to
284 * do the phase2 barrier as following:
286 * Every barrier instance will call dt_sync() to make all async transactions
287 * to be committed locally.
289 * \param[in] env pointer to the thread context
290 * \param[in] mgs pointer to the MGS device
291 * \param[in] bc pointer the barrier control structure
293 * \retval 0 for success
294 * \retval negative error number on failure
296 static int mgs_barrier_freeze(const struct lu_env *env,
297 struct mgs_device *mgs,
298 struct barrier_ctl *bc)
300 char *name = mgs_env_info(env)->mgi_fsname;
308 snprintf(name, sizeof(mgs_env_info(env)->mgi_fsname) - 1, "%s-%s",
309 bc->bc_name, BARRIER_FILENAME);
311 down_write(&mgs->mgs_barrier_rwsem);
312 mutex_lock(&mgs->mgs_mutex);
314 fsdb = mgs_find_fsdb(mgs, name);
316 mutex_unlock(&mgs->mgs_mutex);
317 up_write(&mgs->mgs_barrier_rwsem);
322 if (unlikely(fsdb->fsdb_mdt_count == 0))
323 mgs_barrier_bitmap_setup(mgs, fsdb, bc->bc_name);
325 mutex_lock(&fsdb->fsdb_mutex);
326 mutex_unlock(&mgs->mgs_mutex);
328 switch (fsdb->fsdb_barrier_status) {
338 if (mgs_barrier_expired(fsdb, fsdb->fsdb_barrier_timeout)) {
346 if (fsdb->fsdb_barrier_disabled) {
348 } else if (unlikely(fsdb->fsdb_mdt_count == 0)) {
351 fsdb->fsdb_barrier_latest_create_time =
352 ktime_get_real_seconds();
353 fsdb->fsdb_barrier_status = BS_FREEZING_P1;
354 if (bc->bc_timeout != 0)
355 fsdb->fsdb_barrier_timeout = bc->bc_timeout;
357 fsdb->fsdb_barrier_timeout =
358 BARRIER_TIMEOUT_DEFAULT;
359 memset(fsdb->fsdb_barrier_map, 0, INDEX_MAP_SIZE);
363 LCONSOLE_WARN("%s: found unexpected barrier status %u\n",
364 bc->bc_name, fsdb->fsdb_barrier_status);
372 left = fsdb->fsdb_barrier_timeout;
375 mutex_unlock(&fsdb->fsdb_mutex);
376 up_write(&mgs->mgs_barrier_rwsem);
378 CFS_FAIL_TIMEOUT(OBD_FAIL_BARRIER_DELAY, cfs_fail_val);
380 rc = mgs_barrier_glimpse_lock(env, mgs, fsdb, left,
381 phase1 ? BS_FREEZING_P1 : BS_FROZEN);
382 down_write(&mgs->mgs_barrier_rwsem);
383 mutex_lock(&fsdb->fsdb_mutex);
386 left = fsdb->fsdb_barrier_latest_create_time +
387 fsdb->fsdb_barrier_timeout - ktime_get_real_seconds();
389 fsdb->fsdb_barrier_status = BS_EXPIRED;
391 GOTO(out, rc = -ETIME);
394 LASSERTF(fsdb->fsdb_barrier_status ==
395 (phase1 ? BS_FREEZING_P1 : BS_FREEZING_P2),
396 "unexpected barrier status %u\n",
397 fsdb->fsdb_barrier_status);
399 if (rc == -ETIMEDOUT) {
400 fsdb->fsdb_barrier_status = BS_EXPIRED;
403 fsdb->fsdb_barrier_status = rc;
406 fsdb->fsdb_barrier_status = BS_FAILED;
407 } else if (mgs_barrier_done(fsdb)) {
409 fsdb->fsdb_barrier_status = BS_FREEZING_P2;
410 memset(fsdb->fsdb_barrier_map, 0,
416 fsdb->fsdb_barrier_status = BS_FROZEN;
419 fsdb->fsdb_barrier_status = BS_FAILED;
426 mutex_unlock(&fsdb->fsdb_mutex);
427 up_write(&mgs->mgs_barrier_rwsem);
429 memset(fsdb->fsdb_barrier_map, 0, INDEX_MAP_SIZE);
430 mgs_barrier_glimpse_lock(env, mgs, fsdb, 0, BS_THAWED);
433 mgs_put_fsdb(mgs, fsdb);
438 static int mgs_barrier_thaw(const struct lu_env *env,
439 struct mgs_device *mgs,
440 struct barrier_ctl *bc)
442 char *name = mgs_env_info(env)->mgi_fsname;
447 snprintf(name, sizeof(mgs_env_info(env)->mgi_fsname) - 1, "%s-%s",
448 bc->bc_name, BARRIER_FILENAME);
450 down_write(&mgs->mgs_barrier_rwsem);
451 mutex_lock(&mgs->mgs_mutex);
453 fsdb = mgs_find_fsdb(mgs, name);
455 mutex_unlock(&mgs->mgs_mutex);
456 up_write(&mgs->mgs_barrier_rwsem);
461 if (unlikely(fsdb->fsdb_mdt_count == 0))
462 mgs_barrier_bitmap_setup(mgs, fsdb, bc->bc_name);
464 mutex_lock(&fsdb->fsdb_mutex);
465 mutex_unlock(&mgs->mgs_mutex);
467 switch (fsdb->fsdb_barrier_status) {
481 case BS_EXPIRED: /* The barrier on some MDT(s) may be expired,
482 * but may be not on others. Destory anyway. */
484 if (unlikely(fsdb->fsdb_mdt_count == 0)) {
487 fsdb->fsdb_barrier_status = BS_THAWING;
488 memset(fsdb->fsdb_barrier_map, 0, INDEX_MAP_SIZE);
492 LCONSOLE_WARN("%s: found unexpected barrier status %u\n",
493 bc->bc_name, fsdb->fsdb_barrier_status);
501 mutex_unlock(&fsdb->fsdb_mutex);
502 up_write(&mgs->mgs_barrier_rwsem);
504 CFS_FAIL_TIMEOUT(OBD_FAIL_BARRIER_DELAY, cfs_fail_val);
506 rc = mgs_barrier_glimpse_lock(env, mgs, fsdb, 0, BS_THAWED);
507 down_write(&mgs->mgs_barrier_rwsem);
508 mutex_lock(&fsdb->fsdb_mutex);
510 LASSERTF(fsdb->fsdb_barrier_status == BS_THAWING,
511 "unexpected barrier status %u\n",
512 fsdb->fsdb_barrier_status);
515 fsdb->fsdb_barrier_status = rc;
518 fsdb->fsdb_barrier_status = BS_FAILED;
519 } else if (mgs_barrier_done(fsdb)) {
520 fsdb->fsdb_barrier_status = BS_THAWED;
522 fsdb->fsdb_barrier_status = BS_FAILED;
529 mutex_unlock(&fsdb->fsdb_mutex);
530 up_write(&mgs->mgs_barrier_rwsem);
531 mgs_put_fsdb(mgs, fsdb);
536 static int mgs_barrier_stat(const struct lu_env *env,
537 struct mgs_device *mgs,
538 struct barrier_ctl *bc)
540 char *name = mgs_env_info(env)->mgi_fsname;
544 snprintf(name, sizeof(mgs_env_info(env)->mgi_fsname) - 1, "%s-%s",
545 bc->bc_name, BARRIER_FILENAME);
547 mutex_lock(&mgs->mgs_mutex);
549 fsdb = mgs_find_fsdb(mgs, name);
551 mutex_lock(&fsdb->fsdb_mutex);
552 mutex_unlock(&mgs->mgs_mutex);
554 bc->bc_status = fsdb->fsdb_barrier_status;
555 if (bc->bc_status == BS_FREEZING_P1 ||
556 bc->bc_status == BS_FREEZING_P2 ||
557 bc->bc_status == BS_FROZEN) {
558 if (mgs_barrier_expired(fsdb, fsdb->fsdb_barrier_timeout))
560 fsdb->fsdb_barrier_latest_create_time +
561 fsdb->fsdb_barrier_timeout -
562 ktime_get_real_seconds();
564 bc->bc_status = fsdb->fsdb_barrier_status =
568 mutex_unlock(&fsdb->fsdb_mutex);
569 mgs_put_fsdb(mgs, fsdb);
571 mutex_unlock(&mgs->mgs_mutex);
573 bc->bc_status = BS_INIT;
579 static int mgs_barrier_rescan(const struct lu_env *env,
580 struct mgs_device *mgs,
581 struct barrier_ctl *bc)
583 char *name = mgs_env_info(env)->mgi_fsname;
584 struct fs_db *b_fsdb;
585 struct fs_db *c_fsdb;
589 down_write(&mgs->mgs_barrier_rwsem);
590 mutex_lock(&mgs->mgs_mutex);
592 c_fsdb = mgs_find_fsdb(mgs, bc->bc_name);
593 if (!c_fsdb || unlikely(c_fsdb->fsdb_mdt_count == 0)) {
594 mutex_unlock(&mgs->mgs_mutex);
595 up_write(&mgs->mgs_barrier_rwsem);
600 snprintf(name, sizeof(mgs_env_info(env)->mgi_fsname) - 1, "%s-%s",
601 bc->bc_name, BARRIER_FILENAME);
602 b_fsdb = mgs_find_fsdb(mgs, name);
604 mutex_unlock(&mgs->mgs_mutex);
605 up_write(&mgs->mgs_barrier_rwsem);
606 mgs_put_fsdb(mgs, c_fsdb);
611 mutex_lock(&b_fsdb->fsdb_mutex);
612 mutex_lock(&c_fsdb->fsdb_mutex);
613 mutex_unlock(&mgs->mgs_mutex);
615 switch (b_fsdb->fsdb_barrier_status) {
625 if (mgs_barrier_expired(b_fsdb, b_fsdb->fsdb_barrier_timeout)) {
633 b_fsdb->fsdb_barrier_latest_create_time = ktime_get_real_seconds();
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 mgs_barrier_expired(b_fsdb, bc->bc_timeout)) {
669 memset(b_fsdb->fsdb_barrier_map, 0, INDEX_MAP_SIZE);
672 } else if (rc < 0 && rc != -ETIMEDOUT && rc != -ENODEV) {
673 b_fsdb->fsdb_barrier_status = BS_FAILED;
677 b_fsdb->fsdb_mdt_count = 0;
681 for (i = 0; i < INDEX_MAP_SIZE * 8; i++) {
682 if (test_bit(i, b_fsdb->fsdb_barrier_map)) {
683 b_fsdb->fsdb_mdt_count++;
684 } else if (test_bit(i, b_fsdb->fsdb_mdt_index_map)) {
685 b_fsdb->fsdb_mdt_count++;
690 bc->bc_total = b_fsdb->fsdb_mdt_count;
691 memcpy(b_fsdb->fsdb_mdt_index_map,
692 b_fsdb->fsdb_barrier_map, INDEX_MAP_SIZE);
693 b_fsdb->fsdb_barrier_status = BS_INIT;
699 mutex_unlock(&b_fsdb->fsdb_mutex);
700 up_write(&mgs->mgs_barrier_rwsem);
701 mgs_put_fsdb(mgs, b_fsdb);
706 int mgs_iocontrol_barrier(const struct lu_env *env,
707 struct mgs_device *mgs,
708 struct obd_ioctl_data *data)
710 struct barrier_ctl *bc = (struct barrier_ctl *)(data->ioc_inlbuf1);
714 if (unlikely(bc->bc_version != BARRIER_VERSION_V1))
717 if (unlikely(bc->bc_name[0] == '\0' ||
718 strnlen(bc->bc_name, sizeof(bc->bc_name)) > 8))
721 /* NOT allow barrier operations during recovery. */
722 if (unlikely(mgs->mgs_obd->obd_recovering))
725 switch (bc->bc_cmd) {
727 rc = mgs_barrier_freeze(env, mgs, bc);
730 rc = mgs_barrier_thaw(env, mgs, bc);
733 rc = mgs_barrier_stat(env, mgs, bc);
736 rc = mgs_barrier_rescan(env, mgs, bc);