2 * Device operations for the pnfs client.
5 * The Regents of the University of Michigan
8 * Dean Hildebrand <dhildebz@umich.edu>
9 * Garth Goodson <Garth.Goodson@netapp.com>
11 * Permission is granted to use, copy, create derivative works, and
12 * redistribute this software and such derivative works for any purpose,
13 * so long as the name of the University of Michigan is not used in
14 * any advertising or publicity pertaining to the use or distribution
15 * of this software without specific, written prior authorization. If
16 * the above copyright notice or any other identification of the
17 * University of Michigan is included in any copy of any portion of
18 * this software, then the disclaimer below must also be included.
20 * This software is provided as is, without representation or warranty
21 * of any kind either express or implied, including without limitation
22 * the implied warranties of merchantability, fitness for a particular
23 * purpose, or noninfringement. The Regents of the University of
24 * Michigan shall not be liable for any damages, including special,
25 * indirect, incidental, or consequential damages, with respect to any
26 * claim arising out of or in connection with the use of the software,
27 * even if it has been or is hereafter advised of the possibility of
31 #include <linux/export.h>
34 #define NFSDBG_FACILITY NFSDBG_PNFS
37 * Device ID RCU cache. A device ID is unique per server and layout type.
39 #define NFS4_DEVICE_ID_HASH_BITS 5
40 #define NFS4_DEVICE_ID_HASH_SIZE (1 << NFS4_DEVICE_ID_HASH_BITS)
41 #define NFS4_DEVICE_ID_HASH_MASK (NFS4_DEVICE_ID_HASH_SIZE - 1)
43 #define PNFS_DEVICE_RETRY_TIMEOUT (120*HZ)
45 static struct hlist_head nfs4_deviceid_cache[NFS4_DEVICE_ID_HASH_SIZE];
46 static DEFINE_SPINLOCK(nfs4_deviceid_lock);
50 nfs4_print_deviceid(const struct nfs4_deviceid *id)
54 dprintk("%s: device id= [%x%x%x%x]\n", __func__,
55 p[0], p[1], p[2], p[3]);
57 EXPORT_SYMBOL_GPL(nfs4_print_deviceid);
61 nfs4_deviceid_hash(const struct nfs4_deviceid *id)
63 unsigned char *cptr = (unsigned char *)id->data;
64 unsigned int nbytes = NFS4_DEVICEID4_SIZE;
71 return x & NFS4_DEVICE_ID_HASH_MASK;
74 static struct nfs4_deviceid_node *
75 _lookup_deviceid(const struct pnfs_layoutdriver_type *ld,
76 const struct nfs_client *clp, const struct nfs4_deviceid *id,
79 struct nfs4_deviceid_node *d;
81 hlist_for_each_entry_rcu(d, &nfs4_deviceid_cache[hash], node)
82 if (d->ld == ld && d->nfs_client == clp &&
83 !memcmp(&d->deviceid, id, sizeof(*id))) {
84 if (atomic_read(&d->ref))
93 * Lookup a deviceid in cache and get a reference count on it if found
95 * @clp nfs_client associated with deviceid
96 * @id deviceid to look up
98 static struct nfs4_deviceid_node *
99 _find_get_deviceid(const struct pnfs_layoutdriver_type *ld,
100 const struct nfs_client *clp, const struct nfs4_deviceid *id,
103 struct nfs4_deviceid_node *d;
106 d = _lookup_deviceid(ld, clp, id, hash);
113 struct nfs4_deviceid_node *
114 nfs4_find_get_deviceid(const struct pnfs_layoutdriver_type *ld,
115 const struct nfs_client *clp, const struct nfs4_deviceid *id)
117 return _find_get_deviceid(ld, clp, id, nfs4_deviceid_hash(id));
119 EXPORT_SYMBOL_GPL(nfs4_find_get_deviceid);
122 * Remove a deviceid from cache
124 * @clp nfs_client associated with deviceid
125 * @id the deviceid to unhash
127 * @ret the unhashed node, if found and dereferenced to zero, NULL otherwise.
130 nfs4_delete_deviceid(const struct pnfs_layoutdriver_type *ld,
131 const struct nfs_client *clp, const struct nfs4_deviceid *id)
133 struct nfs4_deviceid_node *d;
135 spin_lock(&nfs4_deviceid_lock);
137 d = _lookup_deviceid(ld, clp, id, nfs4_deviceid_hash(id));
140 spin_unlock(&nfs4_deviceid_lock);
143 hlist_del_init_rcu(&d->node);
144 spin_unlock(&nfs4_deviceid_lock);
147 /* balance the initial ref set in pnfs_insert_deviceid */
148 if (atomic_dec_and_test(&d->ref))
149 d->ld->free_deviceid_node(d);
151 EXPORT_SYMBOL_GPL(nfs4_delete_deviceid);
154 nfs4_init_deviceid_node(struct nfs4_deviceid_node *d,
155 const struct pnfs_layoutdriver_type *ld,
156 const struct nfs_client *nfs_client,
157 const struct nfs4_deviceid *id)
159 INIT_HLIST_NODE(&d->node);
160 INIT_HLIST_NODE(&d->tmpnode);
162 d->nfs_client = nfs_client;
165 atomic_set(&d->ref, 1);
167 EXPORT_SYMBOL_GPL(nfs4_init_deviceid_node);
170 * Uniquely initialize and insert a deviceid node into cache
172 * @new new deviceid node
173 * Note that the caller must set up the following members:
178 * @ret the inserted node, if none found, otherwise, the found entry.
180 struct nfs4_deviceid_node *
181 nfs4_insert_deviceid_node(struct nfs4_deviceid_node *new)
183 struct nfs4_deviceid_node *d;
186 spin_lock(&nfs4_deviceid_lock);
187 hash = nfs4_deviceid_hash(&new->deviceid);
188 d = _find_get_deviceid(new->ld, new->nfs_client, &new->deviceid, hash);
190 spin_unlock(&nfs4_deviceid_lock);
194 hlist_add_head_rcu(&new->node, &nfs4_deviceid_cache[hash]);
195 spin_unlock(&nfs4_deviceid_lock);
196 atomic_inc(&new->ref);
200 EXPORT_SYMBOL_GPL(nfs4_insert_deviceid_node);
203 * Dereference a deviceid node and delete it when its reference count drops
206 * @d deviceid node to put
208 * return true iff the node was deleted
209 * Note that since the test for d->ref == 0 is sufficient to establish
210 * that the node is no longer hashed in the global device id cache.
213 nfs4_put_deviceid_node(struct nfs4_deviceid_node *d)
215 if (!atomic_dec_and_test(&d->ref))
217 d->ld->free_deviceid_node(d);
220 EXPORT_SYMBOL_GPL(nfs4_put_deviceid_node);
223 nfs4_mark_deviceid_unavailable(struct nfs4_deviceid_node *node)
225 node->timestamp_unavailable = jiffies;
226 set_bit(NFS_DEVICEID_UNAVAILABLE, &node->flags);
228 EXPORT_SYMBOL_GPL(nfs4_mark_deviceid_unavailable);
231 nfs4_test_deviceid_unavailable(struct nfs4_deviceid_node *node)
233 if (test_bit(NFS_DEVICEID_UNAVAILABLE, &node->flags)) {
234 unsigned long start, end;
237 start = end - PNFS_DEVICE_RETRY_TIMEOUT;
238 if (time_in_range(node->timestamp_unavailable, start, end))
240 clear_bit(NFS_DEVICEID_UNAVAILABLE, &node->flags);
244 EXPORT_SYMBOL_GPL(nfs4_test_deviceid_unavailable);
247 _deviceid_purge_client(const struct nfs_client *clp, long hash)
249 struct nfs4_deviceid_node *d;
252 spin_lock(&nfs4_deviceid_lock);
254 hlist_for_each_entry_rcu(d, &nfs4_deviceid_cache[hash], node)
255 if (d->nfs_client == clp && atomic_read(&d->ref)) {
256 hlist_del_init_rcu(&d->node);
257 hlist_add_head(&d->tmpnode, &tmp);
260 spin_unlock(&nfs4_deviceid_lock);
262 if (hlist_empty(&tmp))
266 while (!hlist_empty(&tmp)) {
267 d = hlist_entry(tmp.first, struct nfs4_deviceid_node, tmpnode);
268 hlist_del(&d->tmpnode);
269 if (atomic_dec_and_test(&d->ref))
270 d->ld->free_deviceid_node(d);
275 nfs4_deviceid_purge_client(const struct nfs_client *clp)
279 if (!(clp->cl_exchange_flags & EXCHGID4_FLAG_USE_PNFS_MDS))
281 for (h = 0; h < NFS4_DEVICE_ID_HASH_SIZE; h++)
282 _deviceid_purge_client(clp, h);
286 * Stop use of all deviceids associated with an nfs_client
289 nfs4_deviceid_mark_client_invalid(struct nfs_client *clp)
291 struct nfs4_deviceid_node *d;
295 for (i = 0; i < NFS4_DEVICE_ID_HASH_SIZE; i ++){
296 hlist_for_each_entry_rcu(d, &nfs4_deviceid_cache[i], node)
297 if (d->nfs_client == clp)
298 set_bit(NFS_DEVICEID_INVALID, &d->flags);