mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2026-04-08 12:02:33 +02:00
43c1b51442
[ Upstream commitb33f7dec3a] Also update Documentation/filesystems/nfs/localio.rst accordingly and reduce the technical documentation debt that was previously captured in that document. Signed-off-by: Mike Snitzer <snitzer@kernel.org> Reviewed-by: Jeff Layton <jlayton@kernel.org> Acked-by: Chuck Lever <chuck.lever@oracle.com> Signed-off-by: Anna Schumaker <anna.schumaker@oracle.com> Stable-dep-of:df8d829bba("nfsd: fix memory leak in nfsd_create_serv error paths") Signed-off-by: Sasha Levin <sashal@kernel.org>
103 lines
2.9 KiB
C
103 lines
2.9 KiB
C
/* SPDX-License-Identifier: GPL-2.0 */
|
|
/*
|
|
* Copyright (C) 2024 Mike Snitzer <snitzer@hammerspace.com>
|
|
* Copyright (C) 2024 NeilBrown <neilb@suse.de>
|
|
*/
|
|
#ifndef __LINUX_NFSLOCALIO_H
|
|
#define __LINUX_NFSLOCALIO_H
|
|
|
|
/* nfsd_file structure is purposely kept opaque to NFS client */
|
|
struct nfsd_file;
|
|
|
|
#if IS_ENABLED(CONFIG_NFS_LOCALIO)
|
|
|
|
#include <linux/module.h>
|
|
#include <linux/list.h>
|
|
#include <linux/uuid.h>
|
|
#include <linux/sunrpc/clnt.h>
|
|
#include <linux/sunrpc/svcauth.h>
|
|
#include <linux/nfs.h>
|
|
#include <net/net_namespace.h>
|
|
|
|
/*
|
|
* Useful to allow a client to negotiate if localio
|
|
* possible with its server.
|
|
*
|
|
* See Documentation/filesystems/nfs/localio.rst for more detail.
|
|
*/
|
|
typedef struct {
|
|
uuid_t uuid;
|
|
struct list_head list;
|
|
struct net __rcu *net; /* nfsd's network namespace */
|
|
struct auth_domain *dom; /* auth_domain for localio */
|
|
} nfs_uuid_t;
|
|
|
|
void nfs_uuid_init(nfs_uuid_t *);
|
|
bool nfs_uuid_begin(nfs_uuid_t *);
|
|
void nfs_uuid_end(nfs_uuid_t *);
|
|
void nfs_uuid_is_local(const uuid_t *, struct list_head *,
|
|
struct net *, struct auth_domain *, struct module *);
|
|
void nfs_uuid_invalidate_clients(struct list_head *list);
|
|
void nfs_uuid_invalidate_one_client(nfs_uuid_t *nfs_uuid);
|
|
|
|
/* localio needs to map filehandle -> struct nfsd_file */
|
|
extern struct nfsd_file *
|
|
nfsd_open_local_fh(struct net *, struct auth_domain *, struct rpc_clnt *,
|
|
const struct cred *, const struct nfs_fh *,
|
|
const fmode_t) __must_hold(rcu);
|
|
|
|
struct nfsd_localio_operations {
|
|
bool (*nfsd_net_try_get)(struct net *);
|
|
void (*nfsd_net_put)(struct net *);
|
|
struct nfsd_file *(*nfsd_open_local_fh)(struct net *,
|
|
struct auth_domain *,
|
|
struct rpc_clnt *,
|
|
const struct cred *,
|
|
const struct nfs_fh *,
|
|
const fmode_t);
|
|
struct net *(*nfsd_file_put_local)(struct nfsd_file *);
|
|
struct file *(*nfsd_file_file)(struct nfsd_file *);
|
|
} ____cacheline_aligned;
|
|
|
|
extern void nfsd_localio_ops_init(void);
|
|
extern const struct nfsd_localio_operations *nfs_to;
|
|
|
|
struct nfsd_file *nfs_open_local_fh(nfs_uuid_t *,
|
|
struct rpc_clnt *, const struct cred *,
|
|
const struct nfs_fh *, const fmode_t);
|
|
|
|
static inline void nfs_to_nfsd_net_put(struct net *net)
|
|
{
|
|
/*
|
|
* Once reference to net (and associated nfsd_serv) is dropped, NFSD
|
|
* could be unloaded, so ensure safe return from nfsd_net_put() by
|
|
* always taking RCU.
|
|
*/
|
|
rcu_read_lock();
|
|
nfs_to->nfsd_net_put(net);
|
|
rcu_read_unlock();
|
|
}
|
|
|
|
static inline void nfs_to_nfsd_file_put_local(struct nfsd_file *localio)
|
|
{
|
|
/*
|
|
* Must not hold RCU otherwise nfsd_file_put() can easily trigger:
|
|
* "Voluntary context switch within RCU read-side critical section!"
|
|
* by scheduling deep in underlying filesystem (e.g. XFS).
|
|
*/
|
|
struct net *net = nfs_to->nfsd_file_put_local(localio);
|
|
|
|
nfs_to_nfsd_net_put(net);
|
|
}
|
|
|
|
#else /* CONFIG_NFS_LOCALIO */
|
|
static inline void nfsd_localio_ops_init(void)
|
|
{
|
|
}
|
|
static inline void nfs_to_nfsd_file_put_local(struct nfsd_file *localio)
|
|
{
|
|
}
|
|
#endif /* CONFIG_NFS_LOCALIO */
|
|
|
|
#endif /* __LINUX_NFSLOCALIO_H */
|