flexfiles: add kerneldoc header to nfs4_ff_layout_prepare_ds
Signed-off-by: Jeff Layton <jeff.layton@primarydata.com> Signed-off-by: Anna Schumaker <Anna.Schumaker@Netapp.com>
This commit is contained in:
parent
094069f1d9
commit
95e2b7e95d
|
@ -343,7 +343,23 @@ out:
|
|||
return fh;
|
||||
}
|
||||
|
||||
/* Upon return, either ds is connected, or ds is NULL */
|
||||
/**
|
||||
* nfs4_ff_layout_prepare_ds - prepare a DS connection for an RPC call
|
||||
* @lseg: the layout segment we're operating on
|
||||
* @ds_idx: index of the DS to use
|
||||
* @fail_return: return layout on connect failure?
|
||||
*
|
||||
* Try to prepare a DS connection to accept an RPC call. This involves
|
||||
* selecting a mirror to use and connecting the client to it if it's not
|
||||
* already connected.
|
||||
*
|
||||
* Since we only need a single functioning mirror to satisfy a read, we don't
|
||||
* want to return the layout if there is one. For writes though, any down
|
||||
* mirror should result in a LAYOUTRETURN. @fail_return is how we distinguish
|
||||
* between the two cases.
|
||||
*
|
||||
* Returns a pointer to a connected DS object on success or NULL on failure.
|
||||
*/
|
||||
struct nfs4_pnfs_ds *
|
||||
nfs4_ff_layout_prepare_ds(struct pnfs_layout_segment *lseg, u32 ds_idx,
|
||||
bool fail_return)
|
||||
|
|
Loading…
Reference in a new issue