nfsnode.h revision 1.77 1 /* $NetBSD: nfsnode.h,v 1.77 2024/12/07 02:05:55 riastradh Exp $ */
2
3 /*
4 * Copyright (c) 1989, 1993
5 * The Regents of the University of California. All rights reserved.
6 *
7 * This code is derived from software contributed to Berkeley by
8 * Rick Macklem at The University of Guelph.
9 *
10 * Redistribution and use in source and binary forms, with or without
11 * modification, are permitted provided that the following conditions
12 * are met:
13 * 1. Redistributions of source code must retain the above copyright
14 * notice, this list of conditions and the following disclaimer.
15 * 2. Redistributions in binary form must reproduce the above copyright
16 * notice, this list of conditions and the following disclaimer in the
17 * documentation and/or other materials provided with the distribution.
18 * 3. Neither the name of the University nor the names of its contributors
19 * may be used to endorse or promote products derived from this software
20 * without specific prior written permission.
21 *
22 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
23 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
26 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32 * SUCH DAMAGE.
33 *
34 * @(#)nfsnode.h 8.9 (Berkeley) 5/14/95
35 */
36
37
38 #ifndef _NFS_NFSNODE_H_
39 #define _NFS_NFSNODE_H_
40
41 #include <sys/types.h>
42
43 #include <sys/condvar.h>
44 #include <sys/mutex.h>
45 #include <sys/queue.h>
46 #include <sys/timespec.h>
47
48 #include <nfs/nfs.h>
49 #include <nfs/nfsproto.h>
50
51 #include <miscfs/genfs/genfs.h>
52 #include <miscfs/genfs/genfs_node.h>
53
54 /*
55 * Definitions for the directory cache. Because directory cookies
56 * are an opaque 64 bit entity, we need to provide some sort of
57 * mapping between cookies and logical blocknumbers. Also,
58 * we should store the cookies from the server somewhere,
59 * to be able to satisfy VOP_READDIR requests for cookies.
60 * We can't store the cookies in the dirent structure, as some
61 * other systems.
62 *
63 * Each offset is hashed into a per-nfsnode hashtable. An entry
64 * found therein contains information about the (faked up)
65 * logical blocknumber, and also a pointer to a buffer where
66 * the cookies are stored.
67 */
68
69 LIST_HEAD(nfsdirhashhead, nfsdircache);
70 TAILQ_HEAD(nfsdirchainhead, nfsdircache);
71
72 struct nfsdircache {
73 off_t dc_cookie; /* Own offset (key) */
74 off_t dc_blkcookie; /* Offset of block we're in */
75 LIST_ENTRY(nfsdircache) dc_hash; /* Hash chain */
76 TAILQ_ENTRY(nfsdircache) dc_chain; /* Least recently entered chn */
77 u_int32_t dc_cookie32; /* Key for 64<->32 xlate case */
78 int dc_entry; /* Entry number within block */
79 int dc_refcnt; /* Reference count */
80 int dc_flags; /* NFSDC_ flags */
81 };
82
83 #define NFSDC_INVALID 1
84
85 /*
86 * NFSDC_BLKNO: get buffer cache index
87 */
88 #define NFSDC_BLKNO(ndp) ((daddr_t)(ndp)->dc_blkcookie)
89
90 /*
91 * The nfsnode is the nfs equivalent to ufs's inode. Any similarity
92 * is purely coincidental.
93 * There is a unique nfsnode allocated for each active file,
94 * each current directory, each mounted-on file, text file, and the root.
95 * An nfsnode is 'named' by its file handle. (nget/nfs_node.c)
96 */
97
98 struct nfsnode_spec {
99 struct timespec nspec_mtim; /* local mtime */
100 struct timespec nspec_atim; /* local atime */
101 };
102
103 struct nfsnode_reg {
104 off_t nreg_pushedlo; /* 1st blk in committed range */
105 off_t nreg_pushedhi; /* Last block in range */
106 off_t nreg_pushlo; /* 1st block in commit range */
107 off_t nreg_pushhi; /* Last block in range */
108 kmutex_t nreg_commitlock; /* Serialize commits XXX */
109 int nreg_commitflags;
110 int nreg_error; /* Save write error value */
111 };
112
113 struct nfsnode_dir {
114 off_t ndir_direof; /* EOF offset cache */
115 nfsuint64 ndir_cookieverf; /* Cookie verifier */
116 struct nfsdirhashhead *ndir_dircache; /* offset -> cache hash heads */
117 struct nfsdirchainhead ndir_dirchain; /* Chain of dir cookies */
118 struct timespec ndir_nctime; /* Last name cache entry */
119 unsigned ndir_dircachesize; /* Size of dir cookie cache */
120 };
121
122 struct nfsnode {
123 struct genfs_node n_gnode;
124 u_quad_t n_size; /* Current size of file */
125
126 union {
127 struct nfsnode_spec nu_spec;
128 struct nfsnode_reg nu_reg;
129 struct nfsnode_dir nu_dir;
130 } n_un1;
131
132 #define n_mtim n_un1.nu_spec.nspec_mtim
133 #define n_atim n_un1.nu_spec.nspec_atim
134
135 #define n_pushedlo n_un1.nu_reg.nreg_pushedlo
136 #define n_pushedhi n_un1.nu_reg.nreg_pushedhi
137 #define n_pushlo n_un1.nu_reg.nreg_pushlo
138 #define n_pushhi n_un1.nu_reg.nreg_pushhi
139 #define n_commitlock n_un1.nu_reg.nreg_commitlock
140 #define n_commitflags n_un1.nu_reg.nreg_commitflags
141 #define n_error n_un1.nu_reg.nreg_error
142
143 #define n_direofoffset n_un1.nu_dir.ndir_direof
144 #define n_cookieverf n_un1.nu_dir.ndir_cookieverf
145 #define n_dircache n_un1.nu_dir.ndir_dircache
146 #define n_dirchain n_un1.nu_dir.ndir_dirchain
147 #define n_nctime n_un1.nu_dir.ndir_nctime
148 #define n_dircachesize n_un1.nu_dir.ndir_dircachesize
149
150 union {
151 struct sillyrename *nf_silly; /* !VDIR: silly rename struct */
152 unsigned *ndir_dirgens; /* 32<->64bit xlate gen. no. */
153 } n_un2;
154
155 #define n_sillyrename n_un2.nf_silly
156 #define n_dirgens n_un2.ndir_dirgens
157
158 nfsfh_t *n_fhp; /* NFS File Handle */
159 struct vattr *n_vattr; /* Vnode attribute cache */
160 struct vnode *n_vnode; /* associated vnode */
161 struct lockf *n_lockf; /* Locking record of file */
162 time_t n_attrstamp; /* Attr. cache timestamp */
163 struct timespec n_mtime; /* Prev modify time. */
164 time_t n_ctime; /* Prev create time. */
165 short n_fhsize; /* size in bytes, of fh */
166 short n_flag; /* Flag for locking.. */
167 nfsfh_t n_fh; /* Small File Handle */
168 time_t n_accstamp; /* Access cache timestamp */
169 uid_t n_accuid; /* Last access requester */
170 int n_accmode; /* Mode last requested */
171 int n_accerror; /* Error last returned */
172 kauth_cred_t n_rcred;
173 kauth_cred_t n_wcred;
174 };
175
176 /*
177 * Values for n_commitflags
178 */
179 #define NFS_COMMIT_PUSH_VALID 0x0001 /* push range valid */
180 #define NFS_COMMIT_PUSHED_VALID 0x0002 /* pushed range valid */
181
182 /*
183 * Flags for n_flag
184 */
185 #define NFLUSHWANT 0x0001 /* Want wakeup from a flush in prog. */
186 #define NFLUSHINPROG 0x0002 /* Avoid multiple calls to vinvalbuf() */
187 #define NMODIFIED 0x0004 /* Might have a modified buffer in bio */
188 #define NWRITEERR 0x0008 /* Flag write errors so close will know */
189 #define NACC 0x0100 /* Special file accessed */
190 #define NUPD 0x0200 /* Special file updated */
191 #define NCHG 0x0400 /* Special file times changed */
192 #define NTRUNCDELAYED 0x1000 /* Should be truncated later;
193 implies stale cache */
194 #define NREMOVED 0x2000 /* Has been removed */
195 #define NUSEOPENCRED 0x4000 /* Try open cred first rather than owner's */
196 #define NEOFVALID 0x8000 /* dir: n_direofoffset is valid */
197
198 #define NFS_EOFVALID(ndp) ((ndp)->n_flag & NEOFVALID)
199
200 /*
201 * Convert between nfsnode pointers and vnode pointers
202 */
203 #define VTONFS(vp) ((struct nfsnode *)(vp)->v_data)
204 #define NFSTOV(np) ((np)->n_vnode)
205
206 #ifdef _KERNEL
207
208 #include <sys/workqueue.h>
209 /*
210 * Silly rename structure that hangs off the nfsnode until the name
211 * can be removed by nfs_inactive()
212 */
213 struct sillyrename {
214 struct work s_work;
215 kauth_cred_t s_cred;
216 struct vnode *s_dvp;
217 long s_namlen;
218 char s_name[20];
219 };
220
221 /*
222 * Per-nfsiod datas
223 */
224 struct nfs_iod {
225 kmutex_t nid_lock;
226 kcondvar_t nid_cv;
227 LIST_ENTRY(nfs_iod) nid_idle;
228 struct nfsmount *nid_mount;
229 bool nid_exiting;
230
231 LIST_ENTRY(nfs_iod) nid_all;
232 };
233
234 LIST_HEAD(nfs_iodlist, nfs_iod);
235 extern kmutex_t nfs_iodlist_lock;
236 extern struct nfs_iodlist nfs_iodlist_idle;
237 extern struct nfs_iodlist nfs_iodlist_all;
238 extern u_long nfsdirhashmask;
239
240 /*
241 * Prototypes for NFS vnode operations
242 */
243 int nfs_lookup(void *);
244 int nfs_create(void *);
245 int nfs_mknod(void *);
246 int nfs_open(void *);
247 int nfs_close(void *);
248 int nfsspec_close(void *);
249 int nfsfifo_close(void *);
250 int nfs_access(void *);
251 int nfsspec_access(void *);
252 int nfs_getattr(void *);
253 int nfs_setattr(void *);
254 int nfs_read(void *);
255 int nfs_write(void *);
256 int nfsspec_read(void *);
257 int nfsspec_write(void *);
258 int nfsfifo_read(void *);
259 int nfsfifo_write(void *);
260 int nfs_fsync(void *);
261 int nfs_remove(void *);
262 int nfs_link(void *);
263 int nfs_rename(void *);
264 int nfs_mkdir(void *);
265 int nfs_rmdir(void *);
266 int nfs_symlink(void *);
267 int nfs_readdir(void *);
268 int nfs_readlink(void *);
269 int nfs_inactive(void *);
270 int nfs_reclaim(void *);
271 int nfs_unlock(void *);
272 int nfs_bmap(void *);
273 int nfs_strategy(void *);
274 int nfs_print(void *);
275 int nfs_pathconf(void *);
276 int nfs_advlock(void *);
277 int nfs_getpages(void *);
278 int nfs_kqfilter(void *);
279
280 extern int (**nfsv2_vnodeop_p)(void *);
281
282 #define NFS_INVALIDATE_ATTRCACHE(np) (np)->n_attrstamp = 0
283
284 #endif /* _KERNEL */
285
286 #endif /* _NFS_NFSNODE_H_ */
287