1 // SPDX-License-Identifier: GPL-2.0
3 * Device operations for the pnfs nfs4 file layout driver.
5 * Copyright (c) 2014, Primary Data, Inc. All rights reserved.
10 #include <linux/nfs_fs.h>
11 #include <linux/vmalloc.h>
12 #include <linux/module.h>
13 #include <linux/sunrpc/addr.h>
15 #include "../internal.h"
16 #include "../nfs4session.h"
17 #include "flexfilelayout.h"
19 #define NFSDBG_FACILITY NFSDBG_PNFS_LD
21 static unsigned int dataserver_timeo = NFS_DEF_TCP_TIMEO;
22 static unsigned int dataserver_retrans;
24 static bool ff_layout_has_available_ds(struct pnfs_layout_segment *lseg);
26 void nfs4_ff_layout_put_deviceid(struct nfs4_ff_layout_ds *mirror_ds)
28 if (!IS_ERR_OR_NULL(mirror_ds))
29 nfs4_put_deviceid_node(&mirror_ds->id_node);
32 void nfs4_ff_layout_free_deviceid(struct nfs4_ff_layout_ds *mirror_ds)
34 nfs4_print_deviceid(&mirror_ds->id_node.deviceid);
35 nfs4_pnfs_ds_put(mirror_ds->ds);
36 kfree(mirror_ds->ds_versions);
37 kfree_rcu(mirror_ds, id_node.rcu);
40 /* Decode opaque device data and construct new_ds using it */
41 struct nfs4_ff_layout_ds *
42 nfs4_ff_alloc_deviceid_node(struct nfs_server *server, struct pnfs_device *pdev,
45 struct xdr_stream stream;
48 struct list_head dsaddrs;
49 struct nfs4_pnfs_ds_addr *da;
50 struct nfs4_ff_layout_ds *new_ds = NULL;
51 struct nfs4_ff_ds_version *ds_versions = NULL;
57 /* set up xdr stream */
58 scratch = alloc_page(gfp_flags);
62 new_ds = kzalloc(sizeof(struct nfs4_ff_layout_ds), gfp_flags);
66 nfs4_init_deviceid_node(&new_ds->id_node,
69 INIT_LIST_HEAD(&dsaddrs);
71 xdr_init_decode_pages(&stream, &buf, pdev->pages, pdev->pglen);
72 xdr_set_scratch_page(&stream, scratch);
75 p = xdr_inline_decode(&stream, 4);
77 goto out_err_drain_dsaddrs;
78 mp_count = be32_to_cpup(p);
79 dprintk("%s: multipath ds count %d\n", __func__, mp_count);
81 for (i = 0; i < mp_count; i++) {
83 da = nfs4_decode_mp_ds_addr(server->nfs_client->cl_net,
86 list_add_tail(&da->da_node, &dsaddrs);
88 if (list_empty(&dsaddrs)) {
89 dprintk("%s: no suitable DS addresses found\n",
92 goto out_err_drain_dsaddrs;
96 p = xdr_inline_decode(&stream, 4);
98 goto out_err_drain_dsaddrs;
99 version_count = be32_to_cpup(p);
100 dprintk("%s: version count %d\n", __func__, version_count);
102 ds_versions = kcalloc(version_count,
103 sizeof(struct nfs4_ff_ds_version),
108 for (i = 0; i < version_count; i++) {
109 /* 20 = version(4) + minor_version(4) + rsize(4) + wsize(4) +
110 * tightly_coupled(4) */
111 p = xdr_inline_decode(&stream, 20);
113 goto out_err_drain_dsaddrs;
114 ds_versions[i].version = be32_to_cpup(p++);
115 ds_versions[i].minor_version = be32_to_cpup(p++);
116 ds_versions[i].rsize = nfs_io_size(be32_to_cpup(p++),
117 server->nfs_client->cl_proto);
118 ds_versions[i].wsize = nfs_io_size(be32_to_cpup(p++),
119 server->nfs_client->cl_proto);
120 ds_versions[i].tightly_coupled = be32_to_cpup(p);
122 if (ds_versions[i].rsize > NFS_MAX_FILE_IO_SIZE)
123 ds_versions[i].rsize = NFS_MAX_FILE_IO_SIZE;
124 if (ds_versions[i].wsize > NFS_MAX_FILE_IO_SIZE)
125 ds_versions[i].wsize = NFS_MAX_FILE_IO_SIZE;
128 * check for valid major/minor combination.
129 * currently we support dataserver which talk:
130 * v3, v4.0, v4.1, v4.2
132 if (!((ds_versions[i].version == 3 && ds_versions[i].minor_version == 0) ||
133 (ds_versions[i].version == 4 && ds_versions[i].minor_version < 3))) {
134 dprintk("%s: [%d] unsupported ds version %d-%d\n", __func__,
135 i, ds_versions[i].version,
136 ds_versions[i].minor_version);
137 ret = -EPROTONOSUPPORT;
138 goto out_err_drain_dsaddrs;
141 dprintk("%s: [%d] vers %u minor_ver %u rsize %u wsize %u coupled %d\n",
142 __func__, i, ds_versions[i].version,
143 ds_versions[i].minor_version,
144 ds_versions[i].rsize,
145 ds_versions[i].wsize,
146 ds_versions[i].tightly_coupled);
149 new_ds->ds_versions = ds_versions;
150 new_ds->ds_versions_cnt = version_count;
152 new_ds->ds = nfs4_pnfs_ds_add(&dsaddrs, gfp_flags);
154 goto out_err_drain_dsaddrs;
156 /* If DS was already in cache, free ds addrs */
157 while (!list_empty(&dsaddrs)) {
158 da = list_first_entry(&dsaddrs,
159 struct nfs4_pnfs_ds_addr,
161 list_del_init(&da->da_node);
162 kfree(da->da_remotestr);
166 __free_page(scratch);
169 out_err_drain_dsaddrs:
170 while (!list_empty(&dsaddrs)) {
171 da = list_first_entry(&dsaddrs, struct nfs4_pnfs_ds_addr,
173 list_del_init(&da->da_node);
174 kfree(da->da_remotestr);
180 __free_page(scratch);
184 dprintk("%s ERROR: returning %d\n", __func__, ret);
188 static void extend_ds_error(struct nfs4_ff_layout_ds_err *err,
189 u64 offset, u64 length)
193 end = max_t(u64, pnfs_end_offset(err->offset, err->length),
194 pnfs_end_offset(offset, length));
195 err->offset = min_t(u64, err->offset, offset);
196 err->length = end - err->offset;
200 ff_ds_error_match(const struct nfs4_ff_layout_ds_err *e1,
201 const struct nfs4_ff_layout_ds_err *e2)
205 if (e1->opnum != e2->opnum)
206 return e1->opnum < e2->opnum ? -1 : 1;
207 if (e1->status != e2->status)
208 return e1->status < e2->status ? -1 : 1;
209 ret = memcmp(e1->stateid.data, e2->stateid.data,
210 sizeof(e1->stateid.data));
213 ret = memcmp(&e1->deviceid, &e2->deviceid, sizeof(e1->deviceid));
216 if (pnfs_end_offset(e1->offset, e1->length) < e2->offset)
218 if (e1->offset > pnfs_end_offset(e2->offset, e2->length))
220 /* If ranges overlap or are contiguous, they are the same */
225 ff_layout_add_ds_error_locked(struct nfs4_flexfile_layout *flo,
226 struct nfs4_ff_layout_ds_err *dserr)
228 struct nfs4_ff_layout_ds_err *err, *tmp;
229 struct list_head *head = &flo->error_list;
232 /* Do insertion sort w/ merges */
233 list_for_each_entry_safe(err, tmp, &flo->error_list, list) {
234 match = ff_ds_error_match(err, dserr);
238 /* Add entry "dserr" _before_ entry "err" */
242 /* Entries match, so merge "err" into "dserr" */
243 extend_ds_error(dserr, err->offset, err->length);
244 list_replace(&err->list, &dserr->list);
249 list_add_tail(&dserr->list, head);
252 int ff_layout_track_ds_error(struct nfs4_flexfile_layout *flo,
253 struct nfs4_ff_layout_mirror *mirror, u64 offset,
254 u64 length, int status, enum nfs_opnum4 opnum,
257 struct nfs4_ff_layout_ds_err *dserr;
262 if (IS_ERR_OR_NULL(mirror->mirror_ds))
265 dserr = kmalloc(sizeof(*dserr), gfp_flags);
269 INIT_LIST_HEAD(&dserr->list);
270 dserr->offset = offset;
271 dserr->length = length;
272 dserr->status = status;
273 dserr->opnum = opnum;
274 nfs4_stateid_copy(&dserr->stateid, &mirror->stateid);
275 memcpy(&dserr->deviceid, &mirror->mirror_ds->id_node.deviceid,
276 NFS4_DEVICEID4_SIZE);
278 spin_lock(&flo->generic_hdr.plh_inode->i_lock);
279 ff_layout_add_ds_error_locked(flo, dserr);
280 spin_unlock(&flo->generic_hdr.plh_inode->i_lock);
284 static const struct cred *
285 ff_layout_get_mirror_cred(struct nfs4_ff_layout_mirror *mirror, u32 iomode)
287 const struct cred *cred, __rcu **pcred;
289 if (iomode == IOMODE_READ)
290 pcred = &mirror->ro_cred;
292 pcred = &mirror->rw_cred;
296 cred = rcu_dereference(*pcred);
300 cred = get_cred_rcu(cred);
307 nfs4_ff_layout_select_ds_fh(struct nfs4_ff_layout_mirror *mirror)
309 /* FIXME: For now assume there is only 1 version available for the DS */
310 return &mirror->fh_versions[0];
314 nfs4_ff_layout_select_ds_stateid(const struct nfs4_ff_layout_mirror *mirror,
315 nfs4_stateid *stateid)
317 if (nfs4_ff_layout_ds_version(mirror) == 4)
318 nfs4_stateid_copy(stateid, &mirror->stateid);
322 ff_layout_init_mirror_ds(struct pnfs_layout_hdr *lo,
323 struct nfs4_ff_layout_mirror *mirror)
327 if (mirror->mirror_ds == NULL) {
328 struct nfs4_deviceid_node *node;
329 struct nfs4_ff_layout_ds *mirror_ds = ERR_PTR(-ENODEV);
331 node = nfs4_find_get_deviceid(NFS_SERVER(lo->plh_inode),
332 &mirror->devid, lo->plh_lc_cred,
335 mirror_ds = FF_LAYOUT_MIRROR_DS(node);
337 /* check for race with another call to this function */
338 if (cmpxchg(&mirror->mirror_ds, NULL, mirror_ds) &&
339 mirror_ds != ERR_PTR(-ENODEV))
340 nfs4_put_deviceid_node(node);
343 if (IS_ERR(mirror->mirror_ds))
352 * nfs4_ff_layout_prepare_ds - prepare a DS connection for an RPC call
353 * @lseg: the layout segment we're operating on
354 * @mirror: layout mirror describing the DS to use
355 * @fail_return: return layout on connect failure?
357 * Try to prepare a DS connection to accept an RPC call. This involves
358 * selecting a mirror to use and connecting the client to it if it's not
361 * Since we only need a single functioning mirror to satisfy a read, we don't
362 * want to return the layout if there is one. For writes though, any down
363 * mirror should result in a LAYOUTRETURN. @fail_return is how we distinguish
364 * between the two cases.
366 * Returns a pointer to a connected DS object on success or NULL on failure.
368 struct nfs4_pnfs_ds *
369 nfs4_ff_layout_prepare_ds(struct pnfs_layout_segment *lseg,
370 struct nfs4_ff_layout_mirror *mirror,
373 struct nfs4_pnfs_ds *ds = NULL;
374 struct inode *ino = lseg->pls_layout->plh_inode;
375 struct nfs_server *s = NFS_SERVER(ino);
376 unsigned int max_payload;
379 if (!ff_layout_init_mirror_ds(lseg->pls_layout, mirror))
382 ds = mirror->mirror_ds->ds;
383 if (READ_ONCE(ds->ds_clp))
385 /* matching smp_wmb() in _nfs4_pnfs_v3/4_ds_connect */
388 /* FIXME: For now we assume the server sent only one version of NFS
391 status = nfs4_pnfs_ds_connect(s, ds, &mirror->mirror_ds->id_node,
392 dataserver_timeo, dataserver_retrans,
393 mirror->mirror_ds->ds_versions[0].version,
394 mirror->mirror_ds->ds_versions[0].minor_version);
396 /* connect success, check rsize/wsize limit */
399 nfs_block_size(rpc_max_payload(ds->ds_clp->cl_rpcclient),
401 if (mirror->mirror_ds->ds_versions[0].rsize > max_payload)
402 mirror->mirror_ds->ds_versions[0].rsize = max_payload;
403 if (mirror->mirror_ds->ds_versions[0].wsize > max_payload)
404 mirror->mirror_ds->ds_versions[0].wsize = max_payload;
408 ff_layout_track_ds_error(FF_LAYOUT_FROM_HDR(lseg->pls_layout),
409 mirror, lseg->pls_range.offset,
410 lseg->pls_range.length, NFS4ERR_NXIO,
411 OP_ILLEGAL, GFP_NOIO);
412 ff_layout_send_layouterror(lseg);
413 if (fail_return || !ff_layout_has_available_ds(lseg))
414 pnfs_error_mark_layout_for_return(ino, lseg);
421 ff_layout_get_ds_cred(struct nfs4_ff_layout_mirror *mirror,
422 const struct pnfs_layout_range *range,
423 const struct cred *mdscred)
425 const struct cred *cred;
427 if (mirror && !mirror->mirror_ds->ds_versions[0].tightly_coupled) {
428 cred = ff_layout_get_mirror_cred(mirror, range->iomode);
430 cred = get_cred(mdscred);
432 cred = get_cred(mdscred);
438 * nfs4_ff_find_or_create_ds_client - Find or create a DS rpc client
439 * @mirror: pointer to the mirror
440 * @ds_clp: nfs_client for the DS
441 * @inode: pointer to inode
443 * Find or create a DS rpc client with th MDS server rpc client auth flavor
444 * in the nfs_client cl_ds_clients list.
447 nfs4_ff_find_or_create_ds_client(struct nfs4_ff_layout_mirror *mirror,
448 struct nfs_client *ds_clp, struct inode *inode)
450 switch (mirror->mirror_ds->ds_versions[0].version) {
452 /* For NFSv3 DS, flavor is set when creating DS connections */
453 return ds_clp->cl_rpcclient;
455 return nfs4_find_or_create_ds_client(ds_clp, inode);
461 void ff_layout_free_ds_ioerr(struct list_head *head)
463 struct nfs4_ff_layout_ds_err *err;
465 while (!list_empty(head)) {
466 err = list_first_entry(head,
467 struct nfs4_ff_layout_ds_err,
469 list_del(&err->list);
474 /* called with inode i_lock held */
475 int ff_layout_encode_ds_ioerr(struct xdr_stream *xdr, const struct list_head *head)
477 struct nfs4_ff_layout_ds_err *err;
480 list_for_each_entry(err, head, list) {
481 /* offset(8) + length(8) + stateid(NFS4_STATEID_SIZE)
482 * + array length + deviceid(NFS4_DEVICEID4_SIZE)
483 * + status(4) + opnum(4)
485 p = xdr_reserve_space(xdr,
486 28 + NFS4_STATEID_SIZE + NFS4_DEVICEID4_SIZE);
489 p = xdr_encode_hyper(p, err->offset);
490 p = xdr_encode_hyper(p, err->length);
491 p = xdr_encode_opaque_fixed(p, &err->stateid,
494 *p++ = cpu_to_be32(1);
495 p = xdr_encode_opaque_fixed(p, &err->deviceid,
496 NFS4_DEVICEID4_SIZE);
497 *p++ = cpu_to_be32(err->status);
498 *p++ = cpu_to_be32(err->opnum);
499 dprintk("%s: offset %llu length %llu status %d op %d\n",
500 __func__, err->offset, err->length, err->status,
508 unsigned int do_layout_fetch_ds_ioerr(struct pnfs_layout_hdr *lo,
509 const struct pnfs_layout_range *range,
510 struct list_head *head,
513 struct nfs4_flexfile_layout *flo = FF_LAYOUT_FROM_HDR(lo);
514 struct inode *inode = lo->plh_inode;
515 struct nfs4_ff_layout_ds_err *err, *n;
516 unsigned int ret = 0;
518 spin_lock(&inode->i_lock);
519 list_for_each_entry_safe(err, n, &flo->error_list, list) {
520 if (!pnfs_is_range_intersecting(err->offset,
521 pnfs_end_offset(err->offset, err->length),
523 pnfs_end_offset(range->offset, range->length)))
527 list_move(&err->list, head);
531 spin_unlock(&inode->i_lock);
535 unsigned int ff_layout_fetch_ds_ioerr(struct pnfs_layout_hdr *lo,
536 const struct pnfs_layout_range *range,
537 struct list_head *head,
542 ret = do_layout_fetch_ds_ioerr(lo, range, head, maxnum);
543 /* If we're over the max, discard all remaining entries */
546 do_layout_fetch_ds_ioerr(lo, range, &discard, -1);
547 ff_layout_free_ds_ioerr(&discard);
552 static bool ff_read_layout_has_available_ds(struct pnfs_layout_segment *lseg)
554 struct nfs4_ff_layout_mirror *mirror;
555 struct nfs4_deviceid_node *devid;
558 for (idx = 0; idx < FF_LAYOUT_MIRROR_COUNT(lseg); idx++) {
559 mirror = FF_LAYOUT_COMP(lseg, idx);
561 if (!mirror->mirror_ds)
563 if (IS_ERR(mirror->mirror_ds))
565 devid = &mirror->mirror_ds->id_node;
566 if (!nfs4_test_deviceid_unavailable(devid))
574 static bool ff_rw_layout_has_available_ds(struct pnfs_layout_segment *lseg)
576 struct nfs4_ff_layout_mirror *mirror;
577 struct nfs4_deviceid_node *devid;
580 for (idx = 0; idx < FF_LAYOUT_MIRROR_COUNT(lseg); idx++) {
581 mirror = FF_LAYOUT_COMP(lseg, idx);
582 if (!mirror || IS_ERR(mirror->mirror_ds))
584 if (!mirror->mirror_ds)
586 devid = &mirror->mirror_ds->id_node;
587 if (nfs4_test_deviceid_unavailable(devid))
591 return FF_LAYOUT_MIRROR_COUNT(lseg) != 0;
594 static bool ff_layout_has_available_ds(struct pnfs_layout_segment *lseg)
596 if (lseg->pls_range.iomode == IOMODE_READ)
597 return ff_read_layout_has_available_ds(lseg);
598 /* Note: RW layout needs all mirrors available */
599 return ff_rw_layout_has_available_ds(lseg);
602 bool ff_layout_avoid_mds_available_ds(struct pnfs_layout_segment *lseg)
604 return ff_layout_no_fallback_to_mds(lseg) ||
605 ff_layout_has_available_ds(lseg);
608 bool ff_layout_avoid_read_on_rw(struct pnfs_layout_segment *lseg)
610 return lseg->pls_range.iomode == IOMODE_RW &&
611 ff_layout_no_read_on_rw(lseg);
614 module_param(dataserver_retrans, uint, 0644);
615 MODULE_PARM_DESC(dataserver_retrans, "The number of times the NFSv4.1 client "
616 "retries a request before it attempts further "
617 " recovery action.");
618 module_param(dataserver_timeo, uint, 0644);
619 MODULE_PARM_DESC(dataserver_timeo, "The time (in tenths of a second) the "
620 "NFSv4.1 client waits for a response from a "
621 " data server before it retries an NFS request.");