nfs4_clnt.h revision d55e25c39b551e85cf934ffcd77b0a9a2e93a234
/*
* CDDL HEADER START
*
* The contents of this file are subject to the terms of the
* Common Development and Distribution License (the "License").
* You may not use this file except in compliance with the License.
*
* You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
* See the License for the specific language governing permissions
* and limitations under the License.
*
* When distributing Covered Code, include this CDDL HEADER in each
* file and include the License file at usr/src/OPENSOLARIS.LICENSE.
* If applicable, add the following below this CDDL HEADER, with the
* fields enclosed by brackets "[]" replaced with your own identifying
* information: Portions Copyright [yyyy] [name of copyright owner]
*
* CDDL HEADER END
*/
/*
* Copyright 2009 Sun Microsystems, Inc. All rights reserved.
* Use is subject to license terms.
*/
/* Copyright (c) 1984, 1986, 1987, 1988, 1989 AT&T */
/* All Rights Reserved */
/*
* Portions of this source code were derived from Berkeley 4.3 BSD
* under license from the Regents of the University of California.
*/
#ifndef _NFS4_CLNT_H
#define _NFS4_CLNT_H
#include <nfs/nfs4_kprot.h>
#ifdef __cplusplus
extern "C" {
#endif
/* Four states of nfs4_server's lease_valid */
#define NFS4_LEASE_INVALID 0
#define NFS4_LEASE_VALID 1
#define NFS4_LEASE_UNINITIALIZED 2
#define NFS4_LEASE_NOT_STARTED 3
/* flag to tell the renew thread it should exit */
#define NFS4_THREAD_EXIT 1
/* Default number of seconds to wait on GRACE and DELAY errors */
#define NFS4ERR_DELAY_TIME 10
/* Number of hash buckets for open owners for each nfs4_server */
#define NFS4_NUM_OO_BUCKETS 53
/* Number of freed open owners (per mntinfo4_t) to keep around */
#define NFS4_NUM_FREED_OPEN_OWNERS 8
/* Number of seconds to wait before retrying a SETCLIENTID(_CONFIRM) op */
#define NFS4_RETRY_SCLID_DELAY 10
/* Number of times we should retry a SETCLIENTID(_CONFIRM) op */
#define NFS4_NUM_SCLID_RETRIES 3
/* Number of times we should retry on open after getting NFS4ERR_BAD_SEQID */
#define NFS4_NUM_RETRY_BAD_SEQID 3
/*
* Is the attribute cache valid? If client holds a delegation, then attrs
* are by definition valid. If not, then check to see if attrs have timed out.
*/
/*
* Flags to indicate whether to purge the DNLC for non-directory vnodes
* in a call to nfs_purge_caches.
*/
#define NFS4_NOPURGE_DNLC 0
#define NFS4_PURGE_DNLC 1
/*
* Is cache valid?
* Swap is always valid, if no attributes (attrtime == 0) or
* if mtime matches cached mtime it is valid
* NOTE: mtime is now a timestruc_t.
* Caller should be holding the rnode r_statelock mutex.
*/
/*
* Macro to detect forced unmount or a zone shutdown.
*/
#define FS_OR_ZONE_GONE4(vfsp) \
/*
* Macro to help determine whether a request failed because the underlying
* filesystem has been forcibly unmounted or because of zone shutdown.
*/
/*
* Due to the way the address space callbacks are used to execute a delmap,
* we must keep track of how many times the same thread has called
* VOP_DELMAP()->nfs4_delmap(). This is done by having a list of
* nfs4_delmapcall_t's associated with each rnode4_t. This list is protected
* by the rnode4_t's r_statelock. The individual elements do not need to be
* protected as they will only ever be created, modified and destroyed by
* one thread (the call_id).
* See nfs4_delmap() for further explanation.
*/
typedef struct nfs4_delmapcall {
int error; /* error from delmap */
/*
* delmap address space callback args
*/
typedef struct nfs4_delmap_args {
/*
* client side statistics
*/
/*
* Per-zone counters
*/
struct clstat4 {
#ifdef DEBUG
#endif
};
#ifdef DEBUG
/*
* The following are statistics that describe the behavior of the system as a
* whole and don't correspond to any particular zone.
*/
struct clstat4_debug {
};
extern struct clstat4_debug clstat4_debug;
#endif
/*
* The NFS specific async_reqs structure.
*/
enum iotype4 {
};
struct nfs4_async_read_req {
void (*readahead)(); /* pointer to readahead function */
};
struct nfs4_pageio_req {
int (*pageio)(); /* pointer to pageio function */
int flags;
};
struct nfs4_readdir_req {
int (*readdir)(); /* pointer to readdir function */
};
struct nfs4_commit_req {
void (*commit)(); /* pointer to commit function */
};
struct nfs4_async_reqs {
#ifdef DEBUG
#endif
union {
struct nfs4_async_read_req a_read_args;
struct nfs4_pageio_req a_pageio_args;
struct nfs4_readdir_req a_readdir_args;
struct nfs4_commit_req a_commit_args;
} a_args;
};
/*
* Security information
*/
typedef struct sv_secinfo {
} sv_secinfo_t;
/*
* Hash bucket for the mi's open owner list (mi_oo_list).
*/
typedef struct nfs4_oo_hash_bucket {
/*
* Global array of ctags.
*/
extern ctag_t nfs4_ctags[];
typedef enum nfs4_tag_type {
#define NFS4_TAG_INITIALIZER { \
{TAG_NONE, "", \
{0x20202020, 0x20202020, 0x20202020}}, \
{TAG_ACCESS, "access", \
{0x61636365, 0x73732020, 0x20202020}}, \
{TAG_CLOSE, "close", \
{0x636c6f73, 0x65202020, 0x20202020}}, \
{TAG_CLOSE_LOST, "lost close", \
{0x6c6f7374, 0x20636c6f, 0x73652020}}, \
{TAG_CLOSE_UNDO, "undo close", \
{0x756e646f, 0x20636c6f, 0x73652020}}, \
{TAG_COMMIT, "commit", \
{0x636f6d6d, 0x69742020, 0x20202020}}, \
{TAG_DELEGRETURN, "delegreturn", \
{0x64656c65, 0x67726574, 0x75726e20}}, \
{TAG_FSINFO, "fsinfo", \
{0x6673696e, 0x666f2020, 0x20202020}}, \
{TAG_GET_SYMLINK, "get symlink text", \
{0x67657420, 0x736c6e6b, 0x20747874}}, \
{TAG_GETATTR, "getattr", \
{0x67657461, 0x74747220, 0x20202020}}, \
{TAG_INACTIVE, "inactive", \
{0x696e6163, 0x74697665, 0x20202020}}, \
{TAG_LINK, "link", \
{0x6c696e6b, 0x20202020, 0x20202020}}, \
{TAG_LOCK, "lock", \
{0x6c6f636b, 0x20202020, 0x20202020}}, \
{TAG_LOCK_RECLAIM, "reclaim lock", \
{0x7265636c, 0x61696d20, 0x6c6f636b}}, \
{TAG_LOCK_RESEND, "resend lock", \
{0x72657365, 0x6e64206c, 0x6f636b20}}, \
{TAG_LOCK_REINSTATE, "reinstate lock", \
{0x7265696e, 0x7374206c, 0x6f636b20}}, \
{TAG_LOCK_UNKNOWN, "unknown lock", \
{0x756e6b6e, 0x6f776e20, 0x6c6f636b}}, \
{TAG_LOCKT, "lock test", \
{0x6c6f636b, 0x5f746573, 0x74202020}}, \
{TAG_LOCKU, "unlock", \
{0x756e6c6f, 0x636b2020, 0x20202020}}, \
{TAG_LOCKU_RESEND, "resend locku", \
{0x72657365, 0x6e64206c, 0x6f636b75}}, \
{TAG_LOCKU_REINSTATE, "reinstate unlock", \
{0x7265696e, 0x73742075, 0x6e6c636b}}, \
{TAG_LOOKUP, "lookup", \
{0x6c6f6f6b, 0x75702020, 0x20202020}}, \
{TAG_LOOKUP_PARENT, "lookup parent", \
{0x6c6f6f6b, 0x75702070, 0x6172656e}}, \
{TAG_LOOKUP_VALID, "lookup valid", \
{0x6c6f6f6b, 0x75702076, 0x616c6964}}, \
{TAG_LOOKUP_VPARENT, "lookup valid parent", \
{0x6c6f6f6b, 0x766c6420, 0x7061726e}}, \
{TAG_MKDIR, "mkdir", \
{0x6d6b6469, 0x72202020, 0x20202020}}, \
{TAG_MKNOD, "mknod", \
{0x6d6b6e6f, 0x64202020, 0x20202020}}, \
{TAG_MOUNT, "mount", \
{0x6d6f756e, 0x74202020, 0x20202020}}, \
{TAG_OPEN, "open", \
{0x6f70656e, 0x20202020, 0x20202020}}, \
{TAG_OPEN_CONFIRM, "open confirm", \
{0x6f70656e, 0x5f636f6e, 0x6669726d}}, \
{TAG_OPEN_CONFIRM_LOST, "lost open confirm", \
{0x6c6f7374, 0x206f7065, 0x6e5f636f}}, \
{TAG_OPEN_DG, "open downgrade", \
{0x6f70656e, 0x20646772, 0x61646520}}, \
{TAG_OPEN_DG_LOST, "lost open downgrade", \
{0x6c737420, 0x6f70656e, 0x20646772}}, \
{TAG_OPEN_LOST, "lost open", \
{0x6c6f7374, 0x206f7065, 0x6e202020}}, \
{TAG_OPENATTR, "openattr", \
{0x6f70656e, 0x61747472, 0x20202020}}, \
{TAG_PATHCONF, "pathhconf", \
{0x70617468, 0x636f6e66, 0x20202020}}, \
{TAG_PUTROOTFH, "putrootfh", \
{0x70757472, 0x6f6f7466, 0x68202020}}, \
{TAG_READ, "read", \
{0x72656164, 0x20202020, 0x20202020}}, \
{TAG_READAHEAD, "readahead", \
{0x72656164, 0x61686561, 0x64202020}}, \
{TAG_READDIR, "readdir", \
{0x72656164, 0x64697220, 0x20202020}}, \
{TAG_READLINK, "readlink", \
{0x72656164, 0x6c696e6b, 0x20202020}}, \
{TAG_RELOCK, "relock", \
{0x72656c6f, 0x636b2020, 0x20202020}}, \
{TAG_REMAP_LOOKUP, "remap lookup", \
{0x72656d61, 0x70206c6f, 0x6f6b7570}}, \
{TAG_REMAP_LOOKUP_AD, "remap lookup attr dir", \
{0x72656d70, 0x206c6b75, 0x70206164}}, \
{TAG_REMAP_LOOKUP_NA, "remap lookup named attrs", \
{0x72656d70, 0x206c6b75, 0x70206e61}}, \
{TAG_REMAP_MOUNT, "remap mount", \
{0x72656d61, 0x70206d6f, 0x756e7420}}, \
{TAG_RMDIR, "rmdir", \
{0x726d6469, 0x72202020, 0x20202020}}, \
{TAG_REMOVE, "remove", \
{0x72656d6f, 0x76652020, 0x20202020}}, \
{TAG_RENAME, "rename", \
{0x72656e61, 0x6d652020, 0x20202020}}, \
{TAG_RENAME_VFH, "rename volatile fh", \
{0x72656e61, 0x6d652028, 0x76666829}}, \
{TAG_RENEW, "renew", \
{0x72656e65, 0x77202020, 0x20202020}}, \
{TAG_REOPEN, "reopen", \
{0x72656f70, 0x656e2020, 0x20202020}}, \
{TAG_REOPEN_LOST, "lost reopen", \
{0x6c6f7374, 0x2072656f, 0x70656e20}}, \
{TAG_SECINFO, "secinfo", \
{0x73656369, 0x6e666f20, 0x20202020}}, \
{TAG_SETATTR, "setattr", \
{0x73657461, 0x74747220, 0x20202020}}, \
{TAG_SETCLIENTID, "setclientid", \
{0x73657463, 0x6c69656e, 0x74696420}}, \
{TAG_SETCLIENTID_CF, "setclientid_confirm", \
{0x73636c6e, 0x7469645f, 0x636f6e66}}, \
{TAG_SYMLINK, "symlink", \
{0x73796d6c, 0x696e6b20, 0x20202020}}, \
{TAG_WRITE, "write", \
{0x77726974, 0x65202020, 0x20202020}} \
}
/*
* These flags are for differentiating the search criterian for
* find_open_owner(). The comparison is done with the open_owners's
* 'oo_just_created' flag.
*/
#define NFS4_PERM_CREATED 0x0
#define NFS4_JUST_CREATED 0x1
/*
* Hashed by the cr_uid and cr_ruid of credential 'oo_cred'. 'oo_cred_otw'
* is stored upon a successful OPEN. This is needed when the user's effective
* and real uid's don't match. The 'oo_cred_otw' overrides the credential
*
* The oo_ref_count keeps track the number of active references on this
* data structure + number of nfs4_open_streams point to this structure.
*
* 'oo_valid' tells whether this stuct is about to be freed or not.
*
* 'oo_just_created' tells us whether this struct has just been created but
* not been fully finalized (that is created upon an OPEN request and
* finalized upon the OPEN success).
*
* The 'oo_seqid_inuse' is for the open seqid synchronization. If a thread
* is currently using the open owner and it's open_seqid, then it sets the
* oo_seqid_inuse to true if it currently is not set. If it is set then it
* does a cv_wait on the oo_cv_seqid_sync condition variable. When the thread
* is done it unsets the oo_seqid_inuse and does a cv_signal to wake a process
* waiting on the condition variable.
*
* 'oo_last_good_seqid' is the last valid seqid this open owner sent OTW,
* and 'oo_last_good_op' is the operation that issued the last valid seqid.
*
* Lock ordering:
* mntinfo4_t::mi_lock > oo_lock (for searching mi_oo_list)
*
* oo_seqid_inuse > mntinfo4_t::mi_lock
* oo_seqid_inuse > rnode4_t::r_statelock
* oo_seqid_inuse > rnode4_t::r_statev4_lock
* oo_seqid_inuse > nfs4_open_stream_t::os_sync_lock
*
* The 'oo_seqid_inuse'/'oo_cv_seqid_sync' protects:
* oo_last_good_op
* oo_last_good_seqid
* oo_name
* oo_seqid
*
* The 'oo_lock' protects:
* oo_cred
* oo_cred_otw
* oo_foo_node
* oo_hash_node
* oo_just_created
* oo_ref_count
* oo_valid
*/
typedef struct nfs4_open_owner {
int oo_ref_count;
int oo_valid;
int oo_just_created;
unsigned oo_seqid_inuse:1;
/*
* Fix this to always be 8 bytes
*/
/*
* Static server information.
* These fields are read-only once they are initialized:
* sv_addr
* sv_dhsec
* sv_hostname
* sv_hostnamelen
* sv_knconf
* sv_next
* sv_origknconf
*
* These fields are protected by sv_lock:
* sv_currsec
* sv_fhandle
* sv_flags
* sv_fsid
* sv_path
* sv_pathlen
* sv_pfhandle
* sv_save_secinfo
* sv_savesec
* sv_secdata
* sv_secinfo
* sv_supp_attrs
*
* Lock ordering:
* nfs_rtable4_lock > sv_lock
* rnode4_t::r_statelock > sv_lock
*/
typedef struct servinfo4 {
int sv_pathlen; /* Length of server path */
char *sv_path; /* Path name on server */
/* points to one of the sec_data */
/* entries in sv_secinfo */
char *sv_hostname; /* server's hostname */
int sv_hostnamelen; /* server's hostname length */
} servinfo4_t;
/* sv_flags fields */
/*
* Lock call types. See nfs4frlock().
*/
typedef enum nfs4_lock_call_type {
/*
* that the recovery thread can release server state after a forced
* unmount.
* "lr_op" is 0 if the struct is uninitialized. Otherwise, it is set to
* the proper OP_* nfs_opnum4 number. The other fields contain information
* to reconstruct the call.
*
* lr_dvp is used for OPENs with CREATE, so that we can do a PUTFH of the
* parent directroy without relying on vtodv (since we may not have a vp
* for the file we wish to create).
*
* lr_putfirst means that the request should go to the front of the resend
* queue, rather than the end.
*/
typedef struct nfs4_lost_rqst {
struct nfs4_open_stream *lr_osp;
struct nfs4_lock_owner *lr_lop;
union {
struct {
} lru_lockargs; /* LOCK, LOCKU */
struct {
enum open_claim_type4 lru_oclaim;
struct {
} nfs4_lr_u;
/*
* Recovery actions. Some actions can imply further recovery using a
* different recovery action (e.g., recovering the clientid leads to
* recovering open files and locks).
*/
typedef enum {
} nfs4_recov_t;
/*
* Administrative and debug message framework.
*/
#define NFS4_MSG_MAX 100
extern int nfs4_msg_max;
typedef enum {
typedef enum {
typedef enum {
typedef enum {
typedef struct nfs4_rfact {
int rf_error;
char *rf_char1;
} nfs4_rfact_t;
typedef struct nfs4_revent {
char *re_char1;
char *re_char2;
typedef enum {
typedef struct nfs4_debug_msg {
char *msg_srv;
char *msg_mntpt;
union {
} rmsg_u;
/*
* NFS private data per mounted file system
* The mi_lock mutex protects the following fields:
* mi_flags
* mi_in_recovery
* mi_recovflags
* mi_recovthread
* mi_error
* mi_printed
* mi_down
* mi_stsize
* mi_curread
* mi_curwrite
* mi_timers
* mi_curr_serv
* mi_klmconfig
* mi_oo_list
* mi_foo_list
* mi_foo_num
* mi_foo_max
* mi_lost_state
* mi_bseqid_list
* mi_ephemeral
* mi_ephemeral_tree
*
* Normally the netconfig information for the mount comes from
* mi_curr_serv and mi_klmconfig is NULL. If NLM calls need to use a
* different transport, mi_klmconfig contains the necessary netconfig
* information.
*
* The mi_async_lock mutex protects the following fields:
* mi_async_reqs
* mi_async_req_count
* mi_async_tail
* mi_async_curr
* mi_async_clusters
* mi_async_init_clusters
* mi_threads
* mi_inactive_thread
* mi_manager_thread
*
* The nfs4_server_t::s_lock protects the following fields:
* mi_clientid
* mi_clientid_next
* mi_clientid_prev
* mi_open_files
*
* The mntinfo4_t::mi_recovlock protects the following fields:
* mi_srvsettime
* mi_srvset_cnt
* mi_srv
*
* Changing mi_srv from one nfs4_server_t to a different one requires
* holding the mi_recovlock as RW_WRITER.
* holding the mi_recovlock as RW_READER.
*
* Locking order:
* mi4_globals::mig_lock > mi_async_lock
* mi_async_lock > nfs4_server_t::s_lock > mi_lock
* mi_recovlock > mi_rename_lock > nfs_rtable4_lock
* nfs4_server_t::s_recovlock > mi_recovlock
* rnode4_t::r_rwlock > mi_rename_lock
* nfs_rtable4_lock > mi_lock
* nfs4_server_t::s_lock > mi_msg_list_lock
* mi_recovlock > nfs4_server_t::s_lock
* mi_recovlock > nfs4_server_lst_lock
*
* The 'mi_oo_list' represents the hash buckets that contain the
* nfs4_open_owenrs for this particular mntinfo4.
*
* The 'mi_foo_list' represents the freed nfs4_open_owners for this mntinfo4.
* 'mi_foo_num' is the current number of freed open owners on the list,
* 'mi_foo_max' is the maximum number of freed open owners that are allowable
* on the list.
*
* mi_rootfh and mi_srvparentfh are read-only once created, but that just
* refers to the pointer. The contents must be updated to keep in sync
* with mi_curr_serv.
*
* mi_msg_list, and also the updating/retrieving of mi_lease_period;
*
* 'mi_zone' is initialized at structure creation time, and never
* changes; it may be read without a lock.
*
* mi_zone_node is linkage into the mi4_globals.mig_list, and is
* protected by mi4_globals.mig_list_lock.
*
* If MI4_EPHEMERAL is set in mi_flags, then mi_ephemeral points to an
* ephemeral structure for this ephemeral mount point. It can not be
* NULL. Also, mi_ephemeral_tree points to the root of the ephemeral
* tree.
*
* If MI4_EPHEMERAL is not set in mi_flags, then mi_ephemeral has
* to be NULL. If mi_ephemeral_tree is non-NULL, then this node
* is the enclosing mntinfo4 for the ephemeral tree.
*/
struct zone;
struct nfs4_ephemeral;
struct nfs4_ephemeral_tree;
struct nfs4_server;
typedef struct mntinfo4 {
/* is set in mi_flags */
int mi_tsize; /* transfer size (bytes) */
/* really read size */
int mi_stsize; /* server's max transfer size (bytes) */
/* really write size */
int mi_timeo; /* inital timeout in 10th sec */
int mi_retrans; /* times to retry request */
int mi_curread; /* current read size */
int mi_curwrite; /* current write size */
/*
* async I/O management. There may be a pool of threads to handle
* async I/O requests, etc., plus there is always one thread that
* handles over-the-wire requests for VOP_INACTIVE. The async pool
* can also help out with VOP_INACTIVE.
*/
/*
* Other stuff
*/
char **mi_rfsnames; /* mapping to proc names */
/* when we switched nfs4_server_t - only for observability purposes */
/*
* Client Side Failover stats
*/
/*
* Kstat statistics
*/
struct kstat *mi_io_kstats;
struct kstat *mi_ro_kstats;
/*
* Volatile fh flags (nfsv4)
*/
/*
* Lease Management
*/
struct mntinfo4 *mi_clientid_next;
struct mntinfo4 *mi_clientid_prev;
int mi_open_files; /* count of open files */
int mi_in_recovery; /* count of recovery instances */
/*
* Open owner stuff.
*/
int mi_foo_num;
int mi_foo_max;
/*
* Shared filehandle pool.
*/
/*
* Debug message queue.
*/
int mi_msg_count;
/*
* not guaranteed to be accurate.
* only should be used by debug queue.
*/
/*
* Zones support.
*/
/*
* Links for unmounting ephemeral mounts.
*/
struct nfs4_ephemeral *mi_ephemeral;
struct nfs4_ephemeral_tree *mi_ephemeral_tree;
} mntinfo4_t;
/*
* The values for mi_flags.
*
* MI4_HARD hard or soft mount
* MI4_PRINTED responding message printed
* MI4_INT allow INTR on hard mount
* MI4_DOWN server is down
* MI4_NOAC don't cache attributes
* MI4_NOCTO no close-to-open consistency
* MI4_LLOCK local locking only (no lockmgr)
* MI4_GRPID System V group id inheritance
* MI4_SHUTDOWN System is rebooting or shutting down
* MI4_LINK server supports link
* MI4_SYMLINK server supports symlink
* MI4_EPHEMERAL_RECURSED an ephemeral mount being unmounted
* due to a recursive call - no need
* for additional recursion
* MI4_ACL server supports NFSv4 ACLs
* MI4_MIRRORMOUNT is a mirrormount
* MI4_NOPRINT don't print messages
* MI4_DIRECTIO do direct I/O
* MI4_RECOV_ACTIV filesystem has recovery a thread
* MI4_REMOVE_ON_LAST_CLOSE remove from server's list
* MI4_RECOV_FAIL client recovery failed
* MI4_MOUNTING mount in progress, don't failover
* MI4_POSIX_LOCK if server is using POSIX locking
* MI4_LOCK_DEBUG cmn_err'd posix lock err msg
* MI4_DEAD zone has released it
* MI4_INACTIVE_IDLE inactive thread idle
* MI4_BADOWNER_DEBUG badowner error msg per mount
* MI4_ASYNC_MGR_STOP tell async manager to die
* MI4_TIMEDOUT saw a timeout during zone shutdown
* MI4_EPHEMERAL is an ephemeral mount
*/
#define MI4_HARD 0x1
#define MI4_PRINTED 0x2
#define MI4_INT 0x4
#define MI4_DOWN 0x8
#define MI4_NOAC 0x10
#define MI4_NOCTO 0x20
#define MI4_LLOCK 0x80
#define MI4_GRPID 0x100
#define MI4_SHUTDOWN 0x200
#define MI4_LINK 0x400
#define MI4_SYMLINK 0x800
#define MI4_EPHEMERAL_RECURSED 0x1000
#define MI4_ACL 0x2000
/* MI4_MIRRORMOUNT is also defined in nfsstat.c */
#define MI4_MIRRORMOUNT 0x4000
/* 0x8000 is available */
/* 0x10000 is available */
#define MI4_NOPRINT 0x20000
#define MI4_DIRECTIO 0x40000
/* 0x80000 is available */
#define MI4_RECOV_ACTIV 0x100000
#define MI4_REMOVE_ON_LAST_CLOSE 0x200000
#define MI4_RECOV_FAIL 0x400000
#define MI4_PUBLIC 0x800000
#define MI4_MOUNTING 0x1000000
#define MI4_POSIX_LOCK 0x2000000
#define MI4_LOCK_DEBUG 0x4000000
#define MI4_DEAD 0x8000000
#define MI4_INACTIVE_IDLE 0x10000000
#define MI4_BADOWNER_DEBUG 0x20000000
#define MI4_ASYNC_MGR_STOP 0x40000000
#define MI4_TIMEDOUT 0x80000000
/*
* Note that when we add referrals, then MI4_EPHEMERAL
* will be MI4_MIRRORMOUNT | MI4_REFERRAL.
*/
#define MI4_EPHEMERAL MI4_MIRRORMOUNT
/*
* Recovery flags.
*
* MI4R_NEED_CLIENTID is sort of redundant (it's the nfs4_server_t flag
* that's important), but some flag is needed to indicate that recovery is
* going on for the filesystem.
*/
#define MI4R_NEED_CLIENTID 0x1
#define MI4R_REOPEN_FILES 0x2
#define MI4R_NEED_SECINFO 0x4
#define MI4R_NEED_NEW_SERVER 0x8
#define MI4R_REMAP_FILES 0x10
#define MI4R_LOST_STATE 0x40
#define MI4R_BAD_SEQID 0x80
}
}
/*
* vfs pointer to mount info
*/
/*
* vnode pointer to mount info
*/
/*
* Lease Management
*
* lease_valid is initially set to NFS4_LEASE_NOT_STARTED. This is when the
* nfs4_server is first created. lease_valid is then set to
* NFS4_LEASE_UNITIALIZED when the renew thread is started. The extra state of
* NFS4_LEASE_NOT_STARTED is needed for client recovery (so we know if a thread
* already exists when we do SETCLIENTID). lease_valid is then set to
* NFS4_LEASE_VALID (if it is at NFS4_LEASE_UNITIALIZED) when a state creating
* operation (OPEN) is done. lease_valid stays at NFS4_LEASE_VALID as long as
* the lease is renewed. It is set to NFS4_LEASE_INVALID when the lease
* expires. Client recovery is needed to set the lease back to
* NFS4_LEASE_VALID from NFS4_LEASE_INVALID.
*
* The s_cred is the credential used to mount the first file system for this
* server. It used as the credential for the renew thread's calls to the
* server.
*
* The renew thread waits on the condition variable cv_thread_exit. If the cv
* is signalled, then the thread knows it must check s_thread_exit to see if
* it should exit. The cv is signaled when the last file system is unmounted
* from a particular server. s_thread_exit is set to 0 upon thread startup,
* and set to NFS4_THREAD_EXIT, when the last file system is unmounted thereby
* telling the thread to exit. s_thread_exit is needed to avoid spurious
* wakeups.
*
* state_ref_count is incremented every time a new file is opened and
* decremented every time a file is closed otw. This keeps track of whether
* the nfs4_server has state associated with it or not.
*
* s_refcnt is the reference count for storage management of the struct
* itself.
*
* mntinfo4_list points to the doubly linked list of mntinfo4s that share
* this nfs4_server (ie: <clientid, saddr> pair) in the current zone. This is
* needed for a nfs4_server to get a mntinfo4 for use in rfs4call.
*
* s_recovlock is used to synchronize recovery operations. The thread
* that is recovering the client must acquire it as a writer. If the
* thread is using the clientid (including recovery operations on other
* state), acquire it as a reader.
*
* The 's_otw_call_count' keeps track of the number of outstanding over the
* wire requests for this structure. The struct will not go away as long
* as this is non-zero (or s_refcnt is non-zero).
*
* The 's_cv_otw_count' is used in conjuntion with the 's_otw_call_count'
* variable to let the renew thread when an outstanding otw request has
* finished.
*
* 'zoneid' and 'zone_globals' are set at creation of this structure
* and are read-only after that; no lock is required to read them.
*
* s_lock protects: everything except cv_thread_exit and s_recovlock.
*
* s_program is used as the index into the nfs4_callback_globals's
* nfs4prog2server table. When a callback request comes in, we can
* use that request's program number (minus NFS4_CALLBACK) as an index
* into the nfs4prog2server. That entry will hold the nfs4_server_t ptr.
* We can then access that nfs4_server_t and its 's_deleg_list' (its list of
* delegated rnode4_ts).
*
* Lock order:
* nfs4_server::s_lock > mntinfo4::mi_lock
* nfs_rtable4_lock > s_lock
* nfs4_server_lst_lock > s_lock
* s_recovlock > s_lock
*/
struct nfs4_callback_globals;
typedef struct nfs4_server {
struct nfs4_server *forw;
struct nfs4_server *back;
int lease_valid;
int s_thread_exit;
int state_ref_count;
int s_otw_call_count;
/* nfs4_server flags */
struct lease_time_arg {
};
enum nfs4_delegreturn_policy {
};
/*
* Operation hints for the recovery framework (mostly).
*
* EXCEPTIONS:
* OH_ACCESS, OH_GETACL, OH_GETATTR, OH_LOOKUP, OH_READDIR
* (dir represents the root of a server fs that has not yet been
* mounted at client)
*/
typedef enum {
/*
* This data structure is used to track ephemeral mounts for both
* mirror mounts and referrals.
*
* Note that each nfs4_ephemeral can only have one other nfs4_ephemeral
* pointing at it. So we don't need two backpointers to walk
* back up the tree.
*
* An ephemeral tree is pointed to by an enclosing non-ephemeral
* mntinfo4. The root is also pointed to by its ephemeral
* mntinfo4. ne_child will get us back to it, while ne_prior
* will get us back to the non-ephemeral mntinfo4. This is an
* edge case we will need to be wary of when walking back up the
* tree.
*
* The way we handle this edge case is to have ne_prior be NULL
* for the root nfs4_ephemeral node.
*/
typedef struct nfs4_ephemeral {
int ne_state; /* used to traverse */
/*
* State for the node (set in ne_state):
*/
#define NFS4_EPHEMERAL_OK 0x0
#define NFS4_EPHEMERAL_VISIT_CHILD 0x1
#define NFS4_EPHEMERAL_VISIT_SIBLING 0x2
#define NFS4_EPHEMERAL_PROCESS_ME 0x4
#define NFS4_EPHEMERAL_CHILD_ERROR 0x8
#define NFS4_EPHEMERAL_PEER_ERROR 0x10
/*
* These are the locks used in processing ephemeral data:
*
* mi->mi_lock
*
* net->net_tree_lock
* This lock is used to gate all tree operations.
* If it is held, then no other process may
* traverse the tree. This allows us to not
* throw a hold on each vfs_t in the tree.
* Can be held for a "long" time.
*
* net->net_cnt_lock
* Used to protect refcnt and status.
* Must be held for a really short time.
*
* nfs4_ephemeral_thread_lock
* Is only held to create the harvester for the zone.
* There is no ordering imposed on it.
* Held for a really short time.
*
* Some further detail on the interactions:
*
* net_tree_lock controls access to net_root. Access needs to first be
* attempted in a non-blocking check.
*
* net_cnt_lock controls access to net_refcnt and net_status. It must only be
* held for very short periods of time, unless the refcnt is 0 and the status
* is INVALID.
*
* Before a caller can grab net_tree_lock, it must first grab net_cnt_lock
* to bump the net_refcnt. It then releases it and does the action specific
* algorithm to get the net_tree_lock. Once it has that, then it is okay to
* grab the net_cnt_lock and change the status. The status can only be
* changed if the caller has the net_tree_lock held as well.
*
* Note that the initial grab of net_cnt_lock must occur whilst
* mi_lock is being held. This prevents stale data in that if the
* ephemeral tree is non-NULL, then the harvester can not remove
* the tree from the mntinfo node until it grabs that lock. I.e.,
* we get the pointer to the tree and hold the lock atomically
* with respect to being in mi_lock.
*
* When a caller is done with net_tree_lock, it can decrement the net_refcnt
* either before it releases net_tree_lock or after.
*
* In either event, to decrement net_refcnt, it must hold net_cnt_lock.
*
* Note that the overall locking scheme for the nodes is to control access
* via the tree. The current scheme could easily be extended such that
* the enclosing root referenced a "forest" of trees. The underlying trees
* would be autonomous with respect to locks.
*
* Note that net_next is controlled by external locks
* particular to the data structure that the tree is being added to.
*/
typedef struct nfs4_ephemeral_tree {
struct nfs4_ephemeral_tree *net_next;
/*
* State for the tree (set in net_status):
*/
#define NFS4_EPHEMERAL_TREE_OK 0x0
#define NFS4_EPHEMERAL_TREE_BUILDING 0x1
#define NFS4_EPHEMERAL_TREE_DEROOTING 0x2
#define NFS4_EPHEMERAL_TREE_INVALID 0x4
#define NFS4_EPHEMERAL_TREE_MOUNTING 0x8
#define NFS4_EPHEMERAL_TREE_UMOUNTING 0x10
#define NFS4_EPHEMERAL_TREE_LOCKED 0x20
/*
* This macro evaluates to non-zero if the given op releases state at the
* server.
*/
(op) == OH_DELEGRETURN)
#ifdef _KERNEL
extern void nfs4_async_manager(struct vfs *);
extern void nfs4_async_manager_stop(struct vfs *);
extern void nfs4_async_stop(struct vfs *);
extern int nfs4_async_stop_sig(struct vfs *);
void (*)(vnode_t *, u_offset_t,
extern void nfs4_mnt_kstat_init(struct vfs *);
struct COMPOUND4res_clnt *, cred_t *, int *, int,
nfs4_error_t *);
change_info4 *);
extern void nfs4_purge_rddir_cache(vnode_t *);
vnode_t *);
extern void nfs4args_lookup_free(nfs_argop4 *, int);
extern void nfs4args_copen_free(OPEN4cargs *);
extern void nfs4_printfhandle(nfs4_fhandle_t *);
extern void nfs_free_mi4(mntinfo4_t *);
extern void sv4_free(servinfo4_t *);
extern void nfs4_mi_zonelist_add(mntinfo4_t *);
extern int nfs4_mi_zonelist_remove(mntinfo4_t *);
extern void nfs4_secinfo_init(void);
extern void nfs4_secinfo_fini(void);
extern void secinfo_free(sv_secinfo_t *);
extern void save_mnt_secinfo(servinfo4_t *);
int, cred_t *);
extern void nfs4_lockcompletion(vnode_t *, int);
nfs4_error_t *, int *);
extern void nfs4_error_zinit(nfs4_error_t *);
extern void nfs4_error_init(nfs4_error_t *, int);
extern void nfs4_free_args(struct nfs_args *);
extern void mi_hold(mntinfo4_t *);
extern void mi_rele(mntinfo4_t *);
#ifdef DEBUG
extern int nfs4_consistent_type(vnode_t *);
#endif
extern void nfs4_init_dot_entries(void);
extern void nfs4_destroy_dot_entries(void);
extern struct nfs4_callback_globals *nfs4_get_callback_globals(void);
extern struct nfs4_server nfs4_server_lst;
extern clock_t nfs_write_error_interval;
#endif /* _KERNEL */
/*
* Flags for nfs4getfh_otw.
*/
#define NFS4_GETFH_PUBLIC 0x01
#define NFS4_GETFH_NEEDSOP 0x02
/*
* Found through rnodes.
*
* The os_open_ref_count keeps track the number of open file descriptor
* refernces on this data structure. It will be bumped for any successful
* OTW OPEN call and any OPEN call that determines the OTW call is not
* necessary and the open stream hasn't just been created (see
* nfs4_is_otw_open_necessary).
*
* os_mapcnt is a count of the number of mmapped pages for a particular
* open stream; this in conjunction w/ os_open_ref_count is used to
* determine when to do a close to the server. This is necessary because
* of the semantics of doing open, mmap, close; the OTW close must be wait
* until all open and mmap references have vanished.
*
* 'os_valid' tells us whether this structure is about to be freed or not,
* if it is then don't return it in find_open_stream().
*
* 'os_final_close' is set when a CLOSE OTW was attempted. This is needed
* so we can properly count the os_open_ref_count in cases where we VOP_CLOSE
* without a VOP_OPEN, and have nfs4_inactive() drive the OTW CLOSE. It
* that tried to close OTW but failed, and left the state cleanup to
*
* 'os_force_close' is used to let us know if an intervening thread came
* and reopened the open stream after we decided to issue a CLOSE_FORCE,
* but before we could actually process the CLOSE_FORCE.
*
* 'os_pending_close' is set when an over-the-wire CLOSE is deferred to the
* lost state queue.
*
* 'open_stateid' is set the last open stateid returned by the server unless
* 'os_delegation' is 1, in which case 'open_stateid' refers to the
* delegation stateid returned by the server. This is used in cases where the
* client tries to OPEN a file but already has a suitable delegation, so we
* just stick the delegation stateid in the open stream.
*
* os_dc_openacc are open access bits which have been granted to the
* open stream by virtue of a delegation, but which have not been seen
* by the server. This applies even if the open stream does not have
* os_delegation set. These bits are used when setting file locks to
* determine whether an open with CLAIM_DELEGATE_CUR needs to be done
* before the lock request can be sent to the server. See
* nfs4frlock_check_deleg().
*
* 'os_mmap_read/write' keep track of the read and write access our memory
* maps require. We need to keep track of this so we can provide the proper
*
* 'os_failed_reopen' tells us that we failed to successfully reopen this
* open stream; therefore, we should not use this open stateid as it is
* not valid anymore. This flag is also used to indicate an unsuccessful
* attempt to reopen a delegation open stream with CLAIM_DELEGATE_CUR.
*
* If 'os_orig_oo_name' is different than os_open_owner's oo_name
* then this tells us that this open stream's open owner used a
* bad seqid (that is, got NFS4ERR_BAD_SEQID). If different, this open
* stream will no longer be used for future OTW state releasing calls.
*
* Lock ordering:
* rnode4_t::r_os_lock > os_sync_lock
* os_sync_lock > rnode4_t::r_statelock
* os_sync_lock > rnode4_t::r_statev4_lock
* os_sync_lock > mntinfo4_t::mi_lock (via hold over rfs4call)
*
* The 'os_sync_lock' protects:
* open_stateid
* os_dc_openacc
* os_delegation
* os_failed_reopen
* os_final_close
* os_force_close
* os_mapcnt
* os_mmap_read
* os_mmap_write
* os_open_ref_count
* os_pending_close
* os_share_acc_read
* os_share_acc_write
* os_share_deny_none
* os_share_deny_read
* os_share_deny_write
* os_ref_count
* os_valid
*
* The rnode4_t::r_os_lock protects:
* os_node
*
* These fields are set at creation time and
* read only after that:
* os_open_owner
* os_orig_oo_name
*/
typedef struct nfs4_open_stream {
int os_dc_openacc;
int os_ref_count;
unsigned os_valid:1;
unsigned os_delegation:1;
unsigned os_final_close:1;
unsigned os_pending_close:1;
unsigned os_failed_reopen:1;
unsigned os_force_close:1;
int os_open_ref_count;
long os_mapcnt;
struct nfs4_open_owner *os_open_owner;
/*
* This structure describes the format of the lock_owner_name
* field of the lock owner.
*/
typedef struct nfs4_lo_name {
/*
* Flags for lo_flags.
*/
#define NFS4_LOCK_SEQID_INUSE 0x1
#define NFS4_BAD_SEQID_LOCK 0x2
/*
* The lo_prev_rnode and lo_next_rnode are for a circular list that hangs
* off the rnode. If the links are NULL it means this object is not on the
* list.
*
* 'lo_pending_rqsts' is non-zero if we ever tried to send a request and
* didn't get a response back. This is used to figure out if we have
* possible remote v4 locks, so that we can clean up at process exit. In
* theory, the client should be able to figure out if the server received
* the request (based on what seqid works), so maybe we can get rid of this
* flag someday.
*
* structure. The rnode's list accounts for one reference.
*
* 'lo_just_created' is set to NFS4_JUST_CREATED when we first create the
* data structure. It is then set to NFS4_PERM_CREATED when a lock request
* is successful using this lock owner structure. We need to keep 'temporary'
* lock owners around so we can properly keep the lock seqid synchronization
* first time (especially with the DENIED error case). Once
* 'lo_just_created' is set to NFS4_PERM_CREATED, it doesn't change.
*
* 'lo_valid' tells us whether this structure is about to be freed or not,
* if it is then don't return it from find_lock_owner().
*
* Retrieving and setting of 'lock_seqid' is protected by the
* NFS4_LOCK_SEQID_INUSE flag. Waiters for NFS4_LOCK_SEQID_INUSE should
* use 'lo_cv_seqid_sync'.
*
* The setting of 'lock_stateid' is protected by the
* NFS4_LOCK_SEQID_INUSE flag and 'lo_lock'. The retrieving of the
* 'lock_stateid' is protected by 'lo_lock', with the additional
* requirement that the calling function can handle NFS4ERR_OLD_STATEID and
* NFS4ERR_BAD_STATEID as appropiate.
*
* The setting of NFS4_BAD_SEQID_LOCK to lo_flags tells us whether this lock
* owner used a bad seqid (that is, got NFS4ERR_BAD_SEQID). With this set,
* this lock owner will no longer be used for future OTW calls. Once set,
* it is never unset.
*
* Lock ordering:
* rnode4_t::r_statev4_lock > lo_lock
*/
typedef struct nfs4_lock_owner {
struct nfs4_lock_owner *lo_next_rnode;
struct nfs4_lock_owner *lo_prev_rnode;
int lo_pid;
/*
* Fix this to always be 12 bytes
*/
int lo_ref_count;
int lo_valid;
int lo_pending_rqsts;
int lo_just_created;
int lo_flags;
/* for nfs4_lock_owner_t lookups */
/* Number of times to retry a call that fails with state independent error */
#define NFS4_NUM_RECOV_RETRIES 3
typedef enum {
typedef struct nfs4_stateid_types {
/*
* Per-zone data for dealing with callbacks. Included here solely for the
* benefit of MDB.
*/
struct nfs4_callback_stats {
};
struct nfs4_callback_globals {
int nfs4_program_hint;
/* this table maps the program number to the nfs4_server structure */
struct nfs4_server **nfs4prog2server;
#ifdef DEBUG
int nfs4_dlistadd_c;
int nfs4_dlistclean_c;
#endif
};
typedef enum {
/*
* Structure to hold the bad seqid information that is passed
* to the recovery framework.
*/
typedef struct nfs4_bseqid_entry {
#ifdef _KERNEL
extern void open_owner_hold(nfs4_open_owner_t *);
extern void open_owner_rele(nfs4_open_owner_t *);
struct rnode4 *, int *);
struct rnode4 *);
extern void open_stream_hold(nfs4_open_stream_t *);
extern void lock_owner_hold(nfs4_lock_owner_t *);
extern void lock_owner_rele(nfs4_lock_owner_t *);
extern void nfs4_rnode_remove_lock_owner(struct rnode4 *,
extern void nfs4_flush_lock_owners(struct rnode4 *);
extern void nfs4_get_and_set_next_open_seqid(nfs4_open_owner_t *,
extern void nfs4_end_open_seqid_sync(nfs4_open_owner_t *);
extern void nfs4_end_lock_seqid_sync(nfs4_lock_owner_t *);
extern void nfs4_destroy_open_owner(nfs4_open_owner_t *);
extern void nfs4_renew_lease_thread(nfs4_server_t *);
extern void nfs4_mark_srv_dead(nfs4_server_t *);
extern void nfs4_inc_state_ref_count(mntinfo4_t *);
extern void nfs4_inc_state_ref_count_nolock(nfs4_server_t *,
mntinfo4_t *);
extern void nfs4_dec_state_ref_count(mntinfo4_t *);
extern void nfs4_dec_state_ref_count_nolock(nfs4_server_t *,
mntinfo4_t *);
extern int nfs4_server_in_recovery(nfs4_server_t *);
extern uint64_t nfs4_get_new_oo_name(void);
nfs4_lost_rqst_t *, int *);
extern void nfs4open_dg_save_lost_rqst(int, nfs4_lost_rqst_t *,
vnode_t *, int, int);
extern void nfs4_open_downgrade(int, int, nfs4_open_owner_t *,
extern void nfs4_init_stateid_types(nfs4_stateid_types_t *);
extern kmutex_t nfs4_server_lst_lock;
extern void nfs4callback_destroy(nfs4_server_t *);
extern void nfs4_callback_init(void);
extern void nfs4_callback_fini(void);
SETCLIENTID4args *);
extern enum nfs4_delegreturn_policy nfs4_delegreturn_policy;
extern void nfs4_server_rele(nfs4_server_t *);
#endif /* _KERNEL */
/*
* Client State Recovery
*/
/*
* The following defines are used for rs_flags in
* a nfs4_recov_state_t structure.
*
* NFS4_RS_RENAME_HELD Indicates that the mi_rename_lock was held.
* NFS4_RS_GRACE_MSG Set once we have uprintf'ed a grace message.
* NFS4_RS_DELAY_MSG Set once we have uprintf'ed a delay message.
* NFS4_RS_RECALL_HELD1 r_deleg_recall_lock for vp1 was held.
* NFS4_RS_RECALL_HELD2 r_deleg_recall_lock for vp2 was held.
*/
#define NFS4_RS_RENAME_HELD 0x000000001
#define NFS4_RS_GRACE_MSG 0x000000002
#define NFS4_RS_DELAY_MSG 0x000000004
#define NFS4_RS_RECALL_HELD1 0x000000008
#define NFS4_RS_RECALL_HELD2 0x000000010
/*
* Information that is retrieved from nfs4_start_op() and that is
* passed into nfs4_end_op().
*
* rs_sp is a reference to the nfs4_server that was found, or NULL.
*
* rs_num_retry_despite_err is the number times client retried an
* OTW op despite a recovery error. It is only incremented for hints
* exempt to normal R4RECOVERR processing
* (OH_CLOSE/OH_LOCKU/OH_DELEGRETURN). (XXX this special-case code
* needs review for possible removal.)
* It is initialized wherever nfs4_recov_state_t is declared -- usually
* very near initialization of rs_flags.
*/
typedef struct {
int rs_flags;
/*
* Flags for nfs4_check_remap, nfs4_remap_file and nfs4_remap_root.
*/
#define NFS4_REMAP_CKATTRS 1
#define NFS4_REMAP_NEEDSOP 2
#ifdef _KERNEL
extern int nfs4_is_otw_open_necessary(nfs4_open_owner_t *, int,
vnode_t *, int, int *, int, nfs4_recov_state_t *);
nfs4_error_t *);
nfs4_error_t *);
nfs4_error_t *);
extern int nfs4_recov_marks_dead(nfsstat4);
nfs4_recov_state_t *, bool_t);
extern char *nfs4_recov_action_to_str(nfs4_recov_t);
/*
* In sequence, code desiring to unmount an ephemeral tree must
* call nfs4_ephemeral_umount, nfs4_ephemeral_umount_activate,
* and nfs4_ephemeral_umount_unlock. The _unlock must also be
* called on all error paths that occur before it would naturally
* be invoked.
*
* The caller must also provde a pointer to a boolean to keep track
* of whether or not the code in _unlock is to be ran.
*/
extern void nfs4_ephemeral_umount_activate(mntinfo4_t *,
int, nfsstat4);
extern time_t nfs4err_delay_time;
extern void nfs4_set_grace_wait(mntinfo4_t *);
extern void nfs4_set_delay_wait(vnode_t *);
seqid4);
nfs4_error_t *);
nfs4_server_t *);
extern int nfs4_rpc_retry_error(int);
extern int nfs4_try_failover(nfs4_error_t *);
extern void nfs4_free_msg(nfs4_debug_msg_t *);
extern void nfs4_mnt_recov_kstat_init(vfs_t *);
extern void nfs4_mi_kstat_inc_delay(mntinfo4_t *);
extern void nfs4_mi_kstat_inc_no_grace(mntinfo4_t *);
extern char *nfs4_stat_to_str(nfsstat4);
extern char *nfs4_op_to_str(nfs_opnum4);
#pragma rarely_called(nfs4_queue_event)
#pragma rarely_called(nfs4_queue_fact)
/* Used for preformed "." and ".." dirents */
extern char *nfs4_dot_entries;
extern char *nfs4_dot_dot_entry;
#ifdef DEBUG
extern uint_t nfs4_tsd_key;
#endif
#endif /* _KERNEL */
/*
* Filehandle management.
*
* Filehandles can change in v4, so rather than storing the filehandle
* directly in the rnode, etc., we manage the filehandle through one of
* these objects.
* Locking: sfh_fh and sfh_tree is protected by the filesystem's
* mi_fh_lock. The reference count and flags are protected by sfh_lock.
* sfh_mi is read-only.
*
* mntinfo4_t::mi_fh_lock > sfh_lock.
*/
typedef struct nfs4_sharedfh {
/*
* Flags.
*/
#ifdef _KERNEL
extern void sfh4_createtab(avl_tree_t *);
nfs4_sharedfh_t *);
extern void sfh4_hold(nfs4_sharedfh_t *);
extern void sfh4_rele(nfs4_sharedfh_t **);
extern void sfh4_printfhandle(const nfs4_sharedfh_t *);
#endif
/*
* Path and file name management.
*
* This type stores the name of an entry in the filesystem and keeps enough
* information that it can provide a complete path. All fields are
* protected by fn_lock, except for the reference count, which is managed
*
* Additionally shared filehandle for this fname is stored.
* Normally, fn_get() when it creates this fname stores the passed in
* shared fh in fn_sfh by doing sfh_hold. Similarly the path which
* destroys this fname releases the reference on this fh by doing sfh_rele.
*
* fn_get uses the fn_sfh to refine the comparision in cases
* where we have matched the name but have differing file handles,
* this normally happens due to
*
*
* Differing names but same filehandle is possible as in the case of hardlinks,
* but differing filehandles with same name component will later confuse
* the client and can cause various panics.
*
* Lock order: child and then parent.
*/
typedef struct nfs4_fname {
char *fn_name; /* the actual name */
} nfs4_fname_t;
#ifdef _KERNEL
extern vnode_t nfs4_xattr_notsupp_vnode;
extern void fn_hold(nfs4_fname_t *);
extern void fn_rele(nfs4_fname_t **);
extern char *fn_name(nfs4_fname_t *);
extern char *fn_path(nfs4_fname_t *);
#endif
/*
* Per-zone data for managing client handles, included in this file for the
* benefit of MDB.
*/
struct nfs4_clnt {
struct chhead *nfscl_chtable4;
struct clstat4 nfscl_stat;
};
#ifdef __cplusplus
}
#endif
#endif /* _NFS4_CLNT_H */