1 /*- 2 * SPDX-License-Identifier: BSD-2-Clause 3 * 4 * Copyright (c) 2009 Rick Macklem, University of Guelph 5 * All rights reserved. 6 * 7 * Redistribution and use in source and binary forms, with or without 8 * modification, are permitted provided that the following conditions 9 * are met: 10 * 1. Redistributions of source code must retain the above copyright 11 * notice, this list of conditions and the following disclaimer. 12 * 2. Redistributions in binary form must reproduce the above copyright 13 * notice, this list of conditions and the following disclaimer in the 14 * documentation and/or other materials provided with the distribution. 15 * 16 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 17 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 18 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 19 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 20 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 21 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 22 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 23 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 24 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 25 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 26 * SUCH DAMAGE. 27 */ 28 29 #ifndef _NFS_NFSCLSTATE_H_ 30 #define _NFS_NFSCLSTATE_H_ 31 32 /* 33 * Definitions for NFS V4 client state handling. 34 */ 35 LIST_HEAD(nfsclopenhead, nfsclopen); 36 LIST_HEAD(nfscllockownerhead, nfscllockowner); 37 SLIST_HEAD(nfscllockownerfhhead, nfscllockownerfh); 38 LIST_HEAD(nfscllockhead, nfscllock); 39 LIST_HEAD(nfsclhead, nfsclclient); 40 LIST_HEAD(nfsclownerhead, nfsclowner); 41 TAILQ_HEAD(nfscldeleghead, nfscldeleg); 42 LIST_HEAD(nfscldeleghash, nfscldeleg); 43 LIST_HEAD(nfsclopenhash, nfsclopen); 44 TAILQ_HEAD(nfscllayouthead, nfscllayout); 45 LIST_HEAD(nfscllayouthash, nfscllayout); 46 LIST_HEAD(nfsclflayouthead, nfsclflayout); 47 LIST_HEAD(nfscldevinfohead, nfscldevinfo); 48 LIST_HEAD(nfsclrecalllayouthead, nfsclrecalllayout); 49 #define NFSCLDELEGHASHSIZE 256 50 #define NFSCLDELEGHASH(c, f, l) \ 51 (&((c)->nfsc_deleghash[ncl_hash((f), (l)) % NFSCLDELEGHASHSIZE])) 52 #define NFSCLOPENHASHSIZE 256 53 #define NFSCLOPENHASHFUNC(f, l) (ncl_hash((f), (l)) % NFSCLOPENHASHSIZE) 54 #define NFSCLOPENHASH(c, f, l) \ 55 (&((c)->nfsc_openhash[NFSCLOPENHASHFUNC((f), (l))])) 56 #define NFSCLLAYOUTHASHSIZE 256 57 #define NFSCLLAYOUTHASH(c, f, l) \ 58 (&((c)->nfsc_layouthash[ncl_hash((f), (l)) % NFSCLLAYOUTHASHSIZE])) 59 60 /* Structure for NFSv4.1 session stuff. */ 61 struct nfsclsession { 62 struct mtx nfsess_mtx; 63 struct nfsslot nfsess_cbslots[NFSV4_CBSLOTS]; 64 nfsquad_t nfsess_clientid; 65 SVCXPRT *nfsess_xprt; /* For backchannel callback */ 66 uint32_t nfsess_slotseq[64]; /* Max for 64bit nm_slots */ 67 uint64_t nfsess_slots; 68 uint64_t nfsess_badslots; /* Slots possibly broken */ 69 uint32_t nfsess_sequenceid; 70 uint32_t nfsess_maxcache; /* Max size for cached reply. */ 71 uint32_t nfsess_maxreq; /* Max request size. */ 72 uint32_t nfsess_maxresp; /* Max reply size. */ 73 uint16_t nfsess_foreslots; 74 uint16_t nfsess_backslots; 75 uint8_t nfsess_sessionid[NFSX_V4SESSIONID]; 76 uint8_t nfsess_defunct; /* Non-zero for old sessions */ 77 }; 78 79 /* 80 * This structure holds the session, clientid and related information 81 * needed for an NFSv4.1 or NFSv4.2 Meta Data Server (MDS) or Data Server (DS). 82 * It is malloc'd to the correct length. 83 */ 84 struct nfsclds { 85 TAILQ_ENTRY(nfsclds) nfsclds_list; 86 struct nfsclsession nfsclds_sess; 87 struct mtx nfsclds_mtx; 88 struct nfssockreq *nfsclds_sockp; 89 time_t nfsclds_expire; 90 uint16_t nfsclds_flags; 91 uint16_t nfsclds_servownlen; 92 uint8_t nfsclds_verf[NFSX_VERF]; 93 uint8_t nfsclds_serverown[0]; 94 }; 95 96 /* 97 * Flags for nfsclds_flags. 98 */ 99 #define NFSCLDS_HASWRITEVERF 0x0001 100 #define NFSCLDS_MDS 0x0002 101 #define NFSCLDS_DS 0x0004 102 #define NFSCLDS_CLOSED 0x0008 103 #define NFSCLDS_SAMECONN 0x0010 104 #define NFSCLDS_MINORV2 0x0020 105 106 struct nfsclclient { 107 LIST_ENTRY(nfsclclient) nfsc_list; 108 struct nfsclownerhead nfsc_owner; 109 struct nfscldeleghead nfsc_deleg; 110 struct nfscldeleghash nfsc_deleghash[NFSCLDELEGHASHSIZE]; 111 struct nfsclopenhash nfsc_openhash[NFSCLOPENHASHSIZE]; 112 struct nfscllayouthead nfsc_layout; 113 struct nfscllayouthash nfsc_layouthash[NFSCLLAYOUTHASHSIZE]; 114 struct nfscldevinfohead nfsc_devinfo; 115 struct nfsv4lock nfsc_lock; 116 struct proc *nfsc_renewthread; 117 struct nfsmount *nfsc_nmp; 118 time_t nfsc_expire; 119 u_int32_t nfsc_clientidrev; 120 u_int32_t nfsc_rev; 121 u_int32_t nfsc_renew; 122 u_int32_t nfsc_cbident; 123 u_int16_t nfsc_flags; 124 u_int16_t nfsc_idlen; 125 u_int8_t nfsc_id[1]; /* Malloc'd to correct length */ 126 }; 127 128 /* 129 * Bits for nfsc_flags. 130 */ 131 #define NFSCLFLAGS_INITED 0x0001 132 #define NFSCLFLAGS_HASCLIENTID 0x0002 133 #define NFSCLFLAGS_RECOVER 0x0004 134 #define NFSCLFLAGS_UMOUNT 0x0008 135 #define NFSCLFLAGS_HASTHREAD 0x0010 136 #define NFSCLFLAGS_AFINET6 0x0020 137 #define NFSCLFLAGS_EXPIREIT 0x0040 138 #define NFSCLFLAGS_FIRSTDELEG 0x0080 139 #define NFSCLFLAGS_GOTDELEG 0x0100 140 #define NFSCLFLAGS_RECVRINPROG 0x0200 141 142 struct nfsclowner { 143 LIST_ENTRY(nfsclowner) nfsow_list; 144 struct nfsclopenhead nfsow_open; 145 struct nfsclclient *nfsow_clp; 146 u_int32_t nfsow_seqid; 147 u_int32_t nfsow_defunct; 148 struct nfsv4lock nfsow_rwlock; 149 u_int8_t nfsow_owner[NFSV4CL_LOCKNAMELEN]; 150 }; 151 152 /* 153 * MALLOC'd to the correct length to accommodate the file handle. 154 */ 155 struct nfscldeleg { 156 TAILQ_ENTRY(nfscldeleg) nfsdl_list; 157 LIST_ENTRY(nfscldeleg) nfsdl_hash; 158 struct nfsclownerhead nfsdl_owner; /* locally issued state */ 159 struct nfscllockownerhead nfsdl_lock; 160 nfsv4stateid_t nfsdl_stateid; 161 struct acl_entry nfsdl_ace; /* Delegation ace */ 162 struct nfsclclient *nfsdl_clp; 163 struct nfsv4lock nfsdl_rwlock; /* for active I/O ops */ 164 struct nfscred nfsdl_cred; /* Cred. used for Open */ 165 time_t nfsdl_timestamp; /* used for stale cleanup */ 166 u_int64_t nfsdl_sizelimit; /* Limit for file growth */ 167 u_int64_t nfsdl_size; /* saved copy of file size */ 168 u_int64_t nfsdl_change; /* and change attribute */ 169 struct timespec nfsdl_modtime; /* local modify time */ 170 u_int16_t nfsdl_fhlen; 171 u_int8_t nfsdl_flags; 172 u_int8_t nfsdl_fh[1]; /* must be last */ 173 }; 174 175 /* 176 * nfsdl_flags bits. 177 */ 178 #define NFSCLDL_READ 0x01 179 #define NFSCLDL_WRITE 0x02 180 #define NFSCLDL_RECALL 0x04 181 #define NFSCLDL_NEEDRECLAIM 0x08 182 #define NFSCLDL_ZAPPED 0x10 183 #define NFSCLDL_MODTIMESET 0x20 184 #define NFSCLDL_DELEGRET 0x40 185 186 /* 187 * MALLOC'd to the correct length to accommodate the file handle. 188 */ 189 struct nfsclopen { 190 LIST_ENTRY(nfsclopen) nfso_list; 191 LIST_ENTRY(nfsclopen) nfso_hash; 192 struct nfscllockownerhead nfso_lock; 193 nfsv4stateid_t nfso_stateid; 194 struct nfsclowner *nfso_own; 195 struct nfscred nfso_cred; /* Cred. used for Open */ 196 u_int32_t nfso_mode; 197 u_int32_t nfso_opencnt; 198 u_int16_t nfso_fhlen; 199 u_int8_t nfso_posixlock; /* 1 for POSIX type locking */ 200 u_int8_t nfso_fh[1]; /* must be last */ 201 }; 202 203 /* 204 * Return values for nfscl_open(). NFSCLOPEN_OK must == 0. 205 */ 206 #define NFSCLOPEN_OK 0 207 #define NFSCLOPEN_DOOPEN 1 208 #define NFSCLOPEN_DOOPENDOWNGRADE 2 209 #define NFSCLOPEN_SETCRED 3 210 211 struct nfscllockowner { 212 LIST_ENTRY(nfscllockowner) nfsl_list; 213 struct nfscllockhead nfsl_lock; 214 struct nfsclopen *nfsl_open; 215 NFSPROC_T *nfsl_inprog; 216 nfsv4stateid_t nfsl_stateid; 217 int nfsl_lockflags; 218 u_int32_t nfsl_seqid; 219 struct nfsv4lock nfsl_rwlock; 220 u_int8_t nfsl_owner[NFSV4CL_LOCKNAMELEN]; 221 u_int8_t nfsl_openowner[NFSV4CL_LOCKNAMELEN]; 222 }; 223 224 /* 225 * Byte range entry for the above lock owner. 226 */ 227 struct nfscllock { 228 LIST_ENTRY(nfscllock) nfslo_list; 229 u_int64_t nfslo_first; 230 u_int64_t nfslo_end; 231 short nfslo_type; 232 }; 233 234 /* This structure is used to collect a list of lockowners to free up. */ 235 struct nfscllockownerfh { 236 SLIST_ENTRY(nfscllockownerfh) nfslfh_list; 237 struct nfscllockownerhead nfslfh_lock; 238 int nfslfh_len; 239 uint8_t nfslfh_fh[NFSX_V4FHMAX]; 240 }; 241 242 /* 243 * MALLOC'd to the correct length to accommodate the file handle. 244 */ 245 struct nfscllayout { 246 TAILQ_ENTRY(nfscllayout) nfsly_list; 247 LIST_ENTRY(nfscllayout) nfsly_hash; 248 nfsv4stateid_t nfsly_stateid; 249 struct nfsv4lock nfsly_lock; 250 uint64_t nfsly_filesid[2]; 251 uint64_t nfsly_lastbyte; 252 struct nfsclflayouthead nfsly_flayread; 253 struct nfsclflayouthead nfsly_flayrw; 254 struct nfsclrecalllayouthead nfsly_recall; 255 time_t nfsly_timestamp; 256 struct nfsclclient *nfsly_clp; 257 uint16_t nfsly_flags; 258 uint16_t nfsly_fhlen; 259 uint8_t nfsly_fh[1]; 260 }; 261 262 /* 263 * Flags for nfsly_flags. 264 */ 265 #define NFSLY_FILES 0x0001 266 #define NFSLY_BLOCK 0x0002 267 #define NFSLY_OBJECT 0x0004 268 #define NFSLY_RECALL 0x0008 269 #define NFSLY_RECALLFILE 0x0010 270 #define NFSLY_RECALLFSID 0x0020 271 #define NFSLY_RECALLALL 0x0040 272 #define NFSLY_RETONCLOSE 0x0080 273 #define NFSLY_WRITTEN 0x0100 /* Has been used to write to a DS. */ 274 #define NFSLY_FLEXFILE 0x0200 275 #define NFSLY_RETURNED 0x0400 276 277 /* 278 * Flex file layout mirror specific stuff for nfsclflayout. 279 */ 280 struct nfsffm { 281 nfsv4stateid_t st; 282 struct nfscldevinfo *devp; 283 char dev[NFSX_V4DEVICEID]; 284 uint32_t eff; 285 uid_t user; 286 gid_t group; 287 struct nfsfh *fh[NFSDEV_MAXVERS]; 288 uint16_t fhcnt; 289 }; 290 291 /* 292 * MALLOC'd to the correct length to accommodate the file handle list for File 293 * layout and the list of mirrors for the Flex File Layout. 294 * These hang off of nfsly_flayread and nfsly_flayrw, sorted in increasing 295 * offset order. 296 * The nfsly_flayread list holds the ones with iomode == NFSLAYOUTIOMODE_READ, 297 * whereas the nfsly_flayrw holds the ones with iomode == NFSLAYOUTIOMODE_RW. 298 */ 299 struct nfsclflayout { 300 LIST_ENTRY(nfsclflayout) nfsfl_list; 301 uint64_t nfsfl_off; 302 uint64_t nfsfl_end; 303 uint32_t nfsfl_iomode; 304 uint16_t nfsfl_flags; 305 union { 306 struct { 307 uint64_t patoff; 308 uint32_t util; 309 uint32_t stripe1; 310 uint8_t dev[NFSX_V4DEVICEID]; 311 uint16_t fhcnt; 312 struct nfscldevinfo *devp; 313 } fl; 314 struct { 315 uint64_t stripeunit; 316 uint32_t fflags; 317 uint32_t statshint; 318 uint16_t mirrorcnt; 319 } ff; 320 } nfsfl_un; 321 union { 322 struct nfsfh *fh[0]; /* FH list for DS File layout */ 323 struct nfsffm ffm[0]; /* Mirror list for Flex File */ 324 } nfsfl_un2; /* Must be last. Malloc'd to correct array length */ 325 }; 326 #define nfsfl_patoff nfsfl_un.fl.patoff 327 #define nfsfl_util nfsfl_un.fl.util 328 #define nfsfl_stripe1 nfsfl_un.fl.stripe1 329 #define nfsfl_dev nfsfl_un.fl.dev 330 #define nfsfl_fhcnt nfsfl_un.fl.fhcnt 331 #define nfsfl_devp nfsfl_un.fl.devp 332 #define nfsfl_stripeunit nfsfl_un.ff.stripeunit 333 #define nfsfl_fflags nfsfl_un.ff.fflags 334 #define nfsfl_statshint nfsfl_un.ff.statshint 335 #define nfsfl_mirrorcnt nfsfl_un.ff.mirrorcnt 336 #define nfsfl_fh nfsfl_un2.fh 337 #define nfsfl_ffm nfsfl_un2.ffm 338 339 /* 340 * Flags for nfsfl_flags. 341 */ 342 #define NFSFL_RECALL 0x0001 /* File layout has been recalled */ 343 #define NFSFL_FILE 0x0002 /* File layout */ 344 #define NFSFL_FLEXFILE 0x0004 /* Flex File layout */ 345 346 /* 347 * Structure that is used to store a LAYOUTRECALL. 348 */ 349 struct nfsclrecalllayout { 350 LIST_ENTRY(nfsclrecalllayout) nfsrecly_list; 351 uint64_t nfsrecly_off; 352 uint64_t nfsrecly_len; 353 int nfsrecly_recalltype; 354 uint32_t nfsrecly_iomode; 355 uint32_t nfsrecly_stateseqid; 356 uint32_t nfsrecly_stat; 357 uint32_t nfsrecly_op; 358 char nfsrecly_devid[NFSX_V4DEVICEID]; 359 }; 360 361 /* 362 * Stores the NFSv4.1 Device Info. Malloc'd to the correct length to 363 * store the list of network connections and list of indices. 364 * nfsdi_data[] is allocated the following way: 365 * - nfsdi_addrcnt * struct nfsclds 366 * - stripe indices, each stored as one byte, since there can be many 367 * of them. (This implies a limit of 256 on nfsdi_addrcnt, since the 368 * indices select which address.) 369 * For Flex File, the addrcnt is always one and no stripe indices exist. 370 */ 371 struct nfscldevinfo { 372 LIST_ENTRY(nfscldevinfo) nfsdi_list; 373 uint8_t nfsdi_deviceid[NFSX_V4DEVICEID]; 374 struct nfsclclient *nfsdi_clp; 375 uint32_t nfsdi_refcnt; 376 uint32_t nfsdi_layoutrefs; 377 union { 378 struct { 379 uint16_t stripecnt; 380 } fl; 381 struct { 382 int versindex; 383 uint32_t vers; 384 uint32_t minorvers; 385 uint32_t rsize; 386 uint32_t wsize; 387 } ff; 388 } nfsdi_un; 389 uint16_t nfsdi_addrcnt; 390 uint16_t nfsdi_flags; 391 struct nfsclds *nfsdi_data[0]; 392 }; 393 #define nfsdi_stripecnt nfsdi_un.fl.stripecnt 394 #define nfsdi_versindex nfsdi_un.ff.versindex 395 #define nfsdi_vers nfsdi_un.ff.vers 396 #define nfsdi_minorvers nfsdi_un.ff.minorvers 397 #define nfsdi_rsize nfsdi_un.ff.rsize 398 #define nfsdi_wsize nfsdi_un.ff.wsize 399 400 /* Flags for nfsdi_flags. */ 401 #define NFSDI_FILELAYOUT 0x0001 402 #define NFSDI_FLEXFILE 0x0002 403 #define NFSDI_TIGHTCOUPLED 0X0004 404 405 /* These inline functions return values from nfsdi_data[]. */ 406 /* 407 * Return a pointer to the address at "pos". 408 */ 409 static __inline struct nfsclds ** 410 nfsfldi_addr(struct nfscldevinfo *ndi, int pos) 411 { 412 413 if (pos >= ndi->nfsdi_addrcnt) 414 return (NULL); 415 return (&ndi->nfsdi_data[pos]); 416 } 417 418 /* 419 * Return the Nth ("pos") stripe index. 420 */ 421 static __inline int 422 nfsfldi_stripeindex(struct nfscldevinfo *ndi, int pos) 423 { 424 uint8_t *valp; 425 426 if (pos >= ndi->nfsdi_stripecnt) 427 return (-1); 428 valp = (uint8_t *)&ndi->nfsdi_data[ndi->nfsdi_addrcnt]; 429 valp += pos; 430 return ((int)*valp); 431 } 432 433 /* 434 * Set the Nth ("pos") stripe index to "val". 435 */ 436 static __inline void 437 nfsfldi_setstripeindex(struct nfscldevinfo *ndi, int pos, uint8_t val) 438 { 439 uint8_t *valp; 440 441 if (pos >= ndi->nfsdi_stripecnt) 442 return; 443 valp = (uint8_t *)&ndi->nfsdi_data[ndi->nfsdi_addrcnt]; 444 valp += pos; 445 *valp = val; 446 } 447 448 /* 449 * Macro for incrementing the seqid#. 450 */ 451 #define NFSCL_INCRSEQID(s, n) do { \ 452 if (((n)->nd_flag & ND_INCRSEQID)) \ 453 (s)++; \ 454 } while (0) 455 456 #endif /* _NFS_NFSCLSTATE_H_ */ 457