1 /* -*- mode: c; c-basic-offset: 8; indent-tabs-mode: nil; -*-
2 * vim:expandtab:shiftwidth=8:tabstop=8:
6 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License version 2 only,
10 * as published by the Free Software Foundation.
12 * This program is distributed in the hope that it will be useful, but
13 * WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * General Public License version 2 for more details (a copy is included
16 * in the LICENSE file that accompanied this code).
18 * You should have received a copy of the GNU General Public License
19 * version 2 along with this program; If not, see
20 * http://www.sun.com/software/products/lustre/docs/GPLv2.pdf
22 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
23 * CA 95054 USA or visit www.sun.com if you need additional information or
29 * Copyright 2008 Sun Microsystems, Inc. All rights reserved
30 * Use is subject to license terms.
33 * This file is part of Lustre, http://www.lustre.org/
34 * Lustre is a trademark of Sun Microsystems, Inc.
36 * lustre/llite/llite_capa.c
38 * Author: Lai Siyao <lsy@clusterfs.com>
41 #define DEBUG_SUBSYSTEM S_LLITE
44 #include <linux/version.h>
45 #include <asm/uaccess.h>
46 #include <linux/file.h>
47 #include <linux/kmod.h>
49 #include <lustre_lite.h>
50 #include "llite_internal.h"
52 /* for obd_capa.c_list, client capa might stay in three places:
55 * 3. stand alone: just allocated.
58 /* capas for oss writeback and those failed to renew */
59 static LIST_HEAD(ll_idle_capas);
60 static struct ptlrpc_thread ll_capa_thread;
61 static struct list_head *ll_capa_list = &capa_list[CAPA_SITE_CLIENT];
63 /* llite capa renewal timer */
64 struct timer_list ll_capa_timer;
65 /* for debug: indicate whether capa on llite is enabled or not */
66 static atomic_t ll_capa_debug = ATOMIC_INIT(0);
67 static unsigned long long ll_capa_renewed = 0;
68 static unsigned long long ll_capa_renewal_noent = 0;
69 static unsigned long long ll_capa_renewal_failed = 0;
70 static unsigned long long ll_capa_renewal_retries = 0;
72 static inline void update_capa_timer(struct obd_capa *ocapa, cfs_time_t expiry)
74 if (time_before(expiry, ll_capa_timer.expires) ||
75 !timer_pending(&ll_capa_timer)) {
76 mod_timer(&ll_capa_timer, expiry);
77 DEBUG_CAPA(D_SEC, &ocapa->c_capa,
78 "ll_capa_timer update: %lu/%lu by", expiry, jiffies);
82 static inline cfs_time_t capa_renewal_time(struct obd_capa *ocapa)
84 return cfs_time_sub(ocapa->c_expiry,
85 cfs_time_seconds(ocapa->c_capa.lc_timeout) / 2);
88 static inline int capa_is_to_expire(struct obd_capa *ocapa)
90 return cfs_time_beforeq(capa_renewal_time(ocapa), cfs_time_current());
93 static inline int have_expired_capa(void)
95 struct obd_capa *ocapa = NULL;
98 /* if ll_capa_list has client capa to expire or ll_idle_capas has
99 * expired capa, return 1.
101 spin_lock(&capa_lock);
102 if (!list_empty(ll_capa_list)) {
103 ocapa = list_entry(ll_capa_list->next, struct obd_capa, c_list);
104 expired = capa_is_to_expire(ocapa);
106 update_capa_timer(ocapa, capa_renewal_time(ocapa));
107 } else if (!list_empty(&ll_idle_capas)) {
108 ocapa = list_entry(ll_idle_capas.next, struct obd_capa, c_list);
109 expired = capa_is_expired(ocapa);
111 update_capa_timer(ocapa, ocapa->c_expiry);
113 spin_unlock(&capa_lock);
116 DEBUG_CAPA(D_SEC, &ocapa->c_capa, "expired");
120 static inline int ll_capa_check_stop(void)
122 return (ll_capa_thread.t_flags & SVC_STOPPING) ? 1: 0;
125 static void sort_add_capa(struct obd_capa *ocapa, struct list_head *head)
127 struct obd_capa *tmp;
128 struct list_head *before = NULL;
130 /* TODO: client capa is sorted by expiry, this could be optimized */
131 list_for_each_entry_reverse(tmp, head, c_list) {
132 if (cfs_time_aftereq(ocapa->c_expiry, tmp->c_expiry)) {
133 before = &tmp->c_list;
138 LASSERT(&ocapa->c_list != before);
139 list_add(&ocapa->c_list, before ?: head);
142 static inline int obd_capa_open_count(struct obd_capa *oc)
144 struct ll_inode_info *lli = ll_i2info(oc->u.cli.inode);
145 return atomic_read(&lli->lli_open_count);
148 static void ll_delete_capa(struct obd_capa *ocapa)
150 struct ll_inode_info *lli = ll_i2info(ocapa->u.cli.inode);
152 if (capa_for_mds(&ocapa->c_capa)) {
153 LASSERT(lli->lli_mds_capa == ocapa);
154 lli->lli_mds_capa = NULL;
155 } else if (capa_for_oss(&ocapa->c_capa)) {
156 list_del_init(&ocapa->u.cli.lli_list);
159 DEBUG_CAPA(D_SEC, &ocapa->c_capa, "free client");
160 list_del(&ocapa->c_list);
161 capa_count[CAPA_SITE_CLIENT]--;
165 /* three places where client capa is deleted:
166 * 1. capa_thread_main(), main place to delete expired capa.
167 * 2. ll_clear_inode_capas() in ll_clear_inode().
168 * 3. ll_truncate_free_capa() delete truncate capa explicitly in ll_truncate().
170 static int capa_thread_main(void *unused)
172 struct obd_capa *ocapa, *tmp, *next;
173 struct inode *inode = NULL;
174 struct l_wait_info lwi = { 0 };
178 cfs_daemonize("ll_capa");
180 ll_capa_thread.t_flags = SVC_RUNNING;
181 wake_up(&ll_capa_thread.t_ctl_waitq);
184 l_wait_event(ll_capa_thread.t_ctl_waitq,
185 (ll_capa_check_stop() || have_expired_capa()),
188 if (ll_capa_check_stop())
193 spin_lock(&capa_lock);
194 list_for_each_entry_safe(ocapa, tmp, ll_capa_list, c_list) {
195 LASSERT(ocapa->c_capa.lc_opc != CAPA_OPC_OSS_TRUNC);
197 if (!capa_is_to_expire(ocapa)) {
202 list_del_init(&ocapa->c_list);
204 /* for MDS capability, only renew those which belong to
205 * dir, or its inode is opened, or client holds LOOKUP
208 if (capa_for_mds(&ocapa->c_capa) &&
209 !S_ISDIR(ocapa->u.cli.inode->i_mode) &&
210 obd_capa_open_count(ocapa) == 0 &&
211 !ll_have_md_lock(ocapa->u.cli.inode,
212 MDS_INODELOCK_LOOKUP)) {
213 DEBUG_CAPA(D_SEC, &ocapa->c_capa,
215 sort_add_capa(ocapa, &ll_idle_capas);
219 /* for OSS capability, only renew those whose inode is
222 if (capa_for_oss(&ocapa->c_capa) &&
223 obd_capa_open_count(ocapa) == 0) {
224 /* oss capa with open count == 0 won't renew,
225 * move to idle list */
226 sort_add_capa(ocapa, &ll_idle_capas);
230 /* NB iput() is in ll_update_capa() */
231 inode = igrab(ocapa->u.cli.inode);
233 DEBUG_CAPA(D_ERROR, &ocapa->c_capa,
240 spin_unlock(&capa_lock);
242 rc = md_renew_capa(ll_i2mdexp(inode), ocapa,
244 spin_lock(&capa_lock);
246 DEBUG_CAPA(D_ERROR, &ocapa->c_capa,
247 "renew failed: %d", rc);
248 ll_capa_renewal_failed++;
253 update_capa_timer(next, capa_renewal_time(next));
255 list_for_each_entry_safe(ocapa, tmp, &ll_idle_capas, c_list) {
256 if (!capa_is_expired(ocapa)) {
258 update_capa_timer(ocapa, ocapa->c_expiry);
262 if (atomic_read(&ocapa->c_refc)) {
263 DEBUG_CAPA(D_SEC, &ocapa->c_capa,
264 "expired(c_refc %d), don't release",
265 atomic_read(&ocapa->c_refc));
266 /* don't try to renew any more */
267 list_del_init(&ocapa->c_list);
271 /* expired capa is released. */
272 DEBUG_CAPA(D_SEC, &ocapa->c_capa, "release expired");
273 ll_delete_capa(ocapa);
276 spin_unlock(&capa_lock);
279 ll_capa_thread.t_flags = SVC_STOPPED;
280 wake_up(&ll_capa_thread.t_ctl_waitq);
284 void ll_capa_timer_callback(unsigned long unused)
286 wake_up(&ll_capa_thread.t_ctl_waitq);
289 int ll_capa_thread_start(void)
294 init_waitqueue_head(&ll_capa_thread.t_ctl_waitq);
296 rc = kernel_thread(capa_thread_main, NULL, 0);
298 CERROR("cannot start expired capa thread: rc %d\n", rc);
301 wait_event(ll_capa_thread.t_ctl_waitq,
302 ll_capa_thread.t_flags & SVC_RUNNING);
307 void ll_capa_thread_stop(void)
309 ll_capa_thread.t_flags = SVC_STOPPING;
310 wake_up(&ll_capa_thread.t_ctl_waitq);
311 wait_event(ll_capa_thread.t_ctl_waitq,
312 ll_capa_thread.t_flags & SVC_STOPPED);
315 static struct obd_capa *do_lookup_oss_capa(struct inode *inode, int opc)
317 struct ll_inode_info *lli = ll_i2info(inode);
318 struct obd_capa *ocapa;
320 /* inside capa_lock */
321 list_for_each_entry(ocapa, &lli->lli_oss_capas, u.cli.lli_list) {
322 if ((capa_opc(&ocapa->c_capa) & opc) != opc)
325 LASSERT(lu_fid_eq(capa_fid(&ocapa->c_capa),
326 ll_inode2fid(inode)));
327 LASSERT(ocapa->c_site == CAPA_SITE_CLIENT);
329 DEBUG_CAPA(D_SEC, &ocapa->c_capa, "found client");
336 struct obd_capa *ll_osscapa_get(struct inode *inode, __u64 opc)
338 struct ll_inode_info *lli = ll_i2info(inode);
339 struct obd_capa *ocapa;
344 if ((ll_i2sbi(inode)->ll_flags & LL_SBI_OSS_CAPA) == 0)
347 LASSERT(opc == CAPA_OPC_OSS_WRITE || opc == CAPA_OPC_OSS_RW ||
348 opc == CAPA_OPC_OSS_TRUNC);
350 spin_lock(&capa_lock);
351 list_for_each_entry(ocapa, &lli->lli_oss_capas, u.cli.lli_list) {
352 if (capa_is_expired(ocapa))
354 if ((opc & CAPA_OPC_OSS_WRITE) &&
355 capa_opc_supported(&ocapa->c_capa, CAPA_OPC_OSS_WRITE)) {
357 } else if ((opc & CAPA_OPC_OSS_READ) &&
358 capa_opc_supported(&ocapa->c_capa,
359 CAPA_OPC_OSS_READ)) {
361 } else if ((opc & CAPA_OPC_OSS_TRUNC) &&
362 capa_opc_supported(&ocapa->c_capa, opc)) {
368 LASSERT(lu_fid_eq(capa_fid(&ocapa->c_capa),
369 ll_inode2fid(inode)));
370 LASSERT(ocapa->c_site == CAPA_SITE_CLIENT);
374 DEBUG_CAPA(D_SEC, &ocapa->c_capa, "found client");
378 if (atomic_read(&ll_capa_debug)) {
379 CERROR("no capability for "DFID" opc "LPX64"\n",
380 PFID(&lli->lli_fid), opc);
381 atomic_set(&ll_capa_debug, 0);
384 spin_unlock(&capa_lock);
388 EXPORT_SYMBOL(ll_osscapa_get);
390 struct obd_capa *ll_mdscapa_get(struct inode *inode)
392 struct ll_inode_info *lli = ll_i2info(inode);
393 struct obd_capa *ocapa;
396 LASSERT(inode != NULL);
398 if ((ll_i2sbi(inode)->ll_flags & LL_SBI_MDS_CAPA) == 0)
401 spin_lock(&capa_lock);
402 ocapa = capa_get(lli->lli_mds_capa);
403 spin_unlock(&capa_lock);
404 if (!ocapa && atomic_read(&ll_capa_debug)) {
405 CERROR("no mds capability for "DFID"\n", PFID(&lli->lli_fid));
406 atomic_set(&ll_capa_debug, 0);
412 static struct obd_capa *do_add_mds_capa(struct inode *inode,
413 struct obd_capa *ocapa)
415 struct ll_inode_info *lli = ll_i2info(inode);
416 struct obd_capa *old = lli->lli_mds_capa;
417 struct lustre_capa *capa = &ocapa->c_capa;
420 ocapa->u.cli.inode = inode;
421 lli->lli_mds_capa = ocapa;
422 capa_count[CAPA_SITE_CLIENT]++;
424 DEBUG_CAPA(D_SEC, capa, "add MDS");
426 spin_lock(&old->c_lock);
428 spin_unlock(&old->c_lock);
430 DEBUG_CAPA(D_SEC, capa, "update MDS");
438 static inline void inode_add_oss_capa(struct inode *inode,
439 struct obd_capa *ocapa)
441 struct ll_inode_info *lli = ll_i2info(inode);
442 struct obd_capa *tmp;
443 struct list_head *next = NULL;
445 /* capa is sorted in lli_oss_capas so lookup can always find the
447 list_for_each_entry(tmp, &lli->lli_oss_capas, u.cli.lli_list) {
448 if (cfs_time_after(ocapa->c_expiry, tmp->c_expiry)) {
449 next = &tmp->u.cli.lli_list;
453 LASSERT(&ocapa->u.cli.lli_list != next);
454 list_move_tail(&ocapa->u.cli.lli_list, next ?: &lli->lli_oss_capas);
457 static struct obd_capa *do_add_oss_capa(struct inode *inode,
458 struct obd_capa *ocapa)
460 struct obd_capa *old;
461 struct lustre_capa *capa = &ocapa->c_capa;
463 LASSERTF(S_ISREG(inode->i_mode),
464 "inode has oss capa, but not regular file, mode: %d\n",
467 /* FIXME: can't replace it so easily with fine-grained opc */
468 old = do_lookup_oss_capa(inode, capa_opc(capa) & CAPA_OPC_OSS_ONLY);
470 ocapa->u.cli.inode = inode;
471 INIT_LIST_HEAD(&ocapa->u.cli.lli_list);
472 capa_count[CAPA_SITE_CLIENT]++;
474 DEBUG_CAPA(D_SEC, capa, "add OSS");
476 spin_lock(&old->c_lock);
478 spin_unlock(&old->c_lock);
480 DEBUG_CAPA(D_SEC, capa, "update OSS");
486 inode_add_oss_capa(inode, ocapa);
490 struct obd_capa *ll_add_capa(struct inode *inode, struct obd_capa *ocapa)
492 spin_lock(&capa_lock);
493 ocapa = capa_for_mds(&ocapa->c_capa) ? do_add_mds_capa(inode, ocapa) :
494 do_add_oss_capa(inode, ocapa);
496 /* truncate capa won't renew */
497 if (ocapa->c_capa.lc_opc != CAPA_OPC_OSS_TRUNC) {
498 set_capa_expiry(ocapa);
499 list_del(&ocapa->c_list);
500 sort_add_capa(ocapa, ll_capa_list);
502 update_capa_timer(ocapa, capa_renewal_time(ocapa));
505 spin_unlock(&capa_lock);
507 atomic_set(&ll_capa_debug, 1);
511 static inline void delay_capa_renew(struct obd_capa *oc, cfs_time_t delay)
513 /* NB: set a fake expiry for this capa to prevent it renew too soon */
514 oc->c_expiry = cfs_time_add(oc->c_expiry, cfs_time_seconds(delay));
517 int ll_update_capa(struct obd_capa *ocapa, struct lustre_capa *capa)
519 struct inode *inode = ocapa->u.cli.inode;
528 spin_lock(&capa_lock);
530 DEBUG_CAPA(D_SEC, &ocapa->c_capa,
531 "renewal canceled because object removed");
532 ll_capa_renewal_noent++;
534 ll_capa_renewal_failed++;
536 /* failed capa won't be renewed any longer, but if -EIO,
537 * client might be doing recovery, retry in 2 min. */
538 if (rc == -EIO && !capa_is_expired(ocapa)) {
539 delay_capa_renew(ocapa, 120);
540 DEBUG_CAPA(D_ERROR, &ocapa->c_capa,
541 "renewal failed: -EIO, retry in 2 mins");
542 ll_capa_renewal_retries++;
545 DEBUG_CAPA(D_ERROR, &ocapa->c_capa,
546 "renewal failed(rc: %d) for", rc);
550 list_del(&ocapa->c_list);
551 sort_add_capa(ocapa, &ll_idle_capas);
552 spin_unlock(&capa_lock);
559 spin_lock(&ocapa->c_lock);
560 LASSERT(!memcmp(&ocapa->c_capa, capa,
561 offsetof(struct lustre_capa, lc_flags)));
562 ocapa->c_capa = *capa;
563 set_capa_expiry(ocapa);
564 spin_unlock(&ocapa->c_lock);
566 spin_lock(&capa_lock);
567 if (capa_for_oss(capa))
568 inode_add_oss_capa(inode, ocapa);
569 DEBUG_CAPA(D_SEC, capa, "renew");
572 list_del_init(&ocapa->c_list);
573 sort_add_capa(ocapa, ll_capa_list);
574 update_capa_timer(ocapa, capa_renewal_time(ocapa));
575 spin_unlock(&capa_lock);
582 void ll_capa_open(struct inode *inode)
584 struct ll_inode_info *lli = ll_i2info(inode);
586 if ((ll_i2sbi(inode)->ll_flags & (LL_SBI_MDS_CAPA | LL_SBI_OSS_CAPA))
590 if (!S_ISREG(inode->i_mode))
593 atomic_inc(&lli->lli_open_count);
596 void ll_capa_close(struct inode *inode)
598 struct ll_inode_info *lli = ll_i2info(inode);
600 if ((ll_i2sbi(inode)->ll_flags & (LL_SBI_MDS_CAPA | LL_SBI_OSS_CAPA))
604 if (!S_ISREG(inode->i_mode))
607 atomic_dec(&lli->lli_open_count);
610 /* delete CAPA_OPC_OSS_TRUNC only */
611 void ll_truncate_free_capa(struct obd_capa *ocapa)
616 LASSERT(ocapa->c_capa.lc_opc & CAPA_OPC_OSS_TRUNC);
617 DEBUG_CAPA(D_SEC, &ocapa->c_capa, "free truncate");
620 spin_lock(&capa_lock);
621 ll_delete_capa(ocapa);
622 spin_unlock(&capa_lock);
625 void ll_clear_inode_capas(struct inode *inode)
627 struct ll_inode_info *lli = ll_i2info(inode);
628 struct obd_capa *ocapa, *tmp;
630 spin_lock(&capa_lock);
631 ocapa = lli->lli_mds_capa;
633 ll_delete_capa(ocapa);
635 list_for_each_entry_safe(ocapa, tmp, &lli->lli_oss_capas,
637 ll_delete_capa(ocapa);
638 spin_unlock(&capa_lock);
641 void ll_print_capa_stat(struct ll_sb_info *sbi)
643 if (sbi->ll_flags & (LL_SBI_MDS_CAPA | LL_SBI_OSS_CAPA))
644 LCONSOLE_INFO("Fid capabilities renewed: %llu\n"
645 "Fid capabilities renewal ENOENT: %llu\n"
646 "Fid capabilities failed to renew: %llu\n"
647 "Fid capabilities renewal retries: %llu\n",
648 ll_capa_renewed, ll_capa_renewal_noent,
649 ll_capa_renewal_failed, ll_capa_renewal_retries);