1 /*- 2 * SPDX-License-Identifier: BSD-2-Clause-FreeBSD 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 * $FreeBSD$ 29 */ 30 31 #ifndef _NFS_NFSCLSTATE_H_ 32 #define _NFS_NFSCLSTATE_H_ 33 34 /* 35 * Definitions for NFS V4 client state handling. 36 */ 37 LIST_HEAD(nfsclopenhead, nfsclopen); 38 LIST_HEAD(nfscllockownerhead, nfscllockowner); 39 SLIST_HEAD(nfscllockownerfhhead, nfscllockownerfh); 40 LIST_HEAD(nfscllockhead, nfscllock); 41 LIST_HEAD(nfsclhead, nfsclclient); 42 LIST_HEAD(nfsclownerhead, nfsclowner); 43 TAILQ_HEAD(nfscldeleghead, nfscldeleg); 44 LIST_HEAD(nfscldeleghash, nfscldeleg); 45 LIST_HEAD(nfsclopenhash, nfsclopen); 46 TAILQ_HEAD(nfscllayouthead, nfscllayout); 47 LIST_HEAD(nfscllayouthash, nfscllayout); 48 LIST_HEAD(nfsclflayouthead, nfsclflayout); 49 LIST_HEAD(nfscldevinfohead, nfscldevinfo); 50 LIST_HEAD(nfsclrecalllayouthead, nfsclrecalllayout); 51 #define NFSCLDELEGHASHSIZE 256 52 #define NFSCLDELEGHASH(c, f, l) \ 53 (&((c)->nfsc_deleghash[ncl_hash((f), (l)) % NFSCLDELEGHASHSIZE])) 54 #define NFSCLOPENHASHSIZE 256 55 #define NFSCLOPENHASHFUNC(f, l) (ncl_hash((f), (l)) % NFSCLOPENHASHSIZE) 56 #define NFSCLOPENHASH(c, f, l) \ 57 (&((c)->nfsc_openhash[NFSCLOPENHASHFUNC((f), (l))])) 58 #define NFSCLLAYOUTHASHSIZE 256 59 #define NFSCLLAYOUTHASH(c, f, l) \ 60 (&((c)->nfsc_layouthash[ncl_hash((f), (l)) % NFSCLLAYOUTHASHSIZE])) 61 62 /* Structure for NFSv4.1 session stuff. */ 63 struct nfsclsession { 64 struct mtx nfsess_mtx; 65 struct nfsslot nfsess_cbslots[NFSV4_CBSLOTS]; 66 nfsquad_t nfsess_clientid; 67 SVCXPRT *nfsess_xprt; /* For backchannel callback */ 68 uint32_t nfsess_slotseq[64]; /* Max for 64bit nm_slots */ 69 uint64_t nfsess_slots; 70 uint32_t nfsess_sequenceid; 71 uint32_t nfsess_maxcache; /* Max size for cached reply. */ 72 uint32_t nfsess_maxreq; /* Max request size. */ 73 uint32_t nfsess_maxresp; /* Max reply size. */ 74 uint16_t nfsess_foreslots; 75 uint16_t nfsess_backslots; 76 uint8_t nfsess_sessionid[NFSX_V4SESSIONID]; 77 uint8_t nfsess_defunct; /* Non-zero for old sessions */ 78 }; 79 80 /* 81 * This structure holds the session, clientid and related information 82 * needed for an NFSv4.1 or NFSv4.2 Meta Data Server (MDS) or Data Server (DS). 83 * It is malloc'd to the correct length. 84 */ 85 struct nfsclds { 86 TAILQ_ENTRY(nfsclds) nfsclds_list; 87 struct nfsclsession nfsclds_sess; 88 struct mtx nfsclds_mtx; 89 struct nfssockreq *nfsclds_sockp; 90 time_t nfsclds_expire; 91 uint16_t nfsclds_flags; 92 uint16_t nfsclds_servownlen; 93 uint8_t nfsclds_verf[NFSX_VERF]; 94 uint8_t nfsclds_serverown[0]; 95 }; 96 97 /* 98 * Flags for nfsclds_flags. 99 */ 100 #define NFSCLDS_HASWRITEVERF 0x0001 101 #define NFSCLDS_MDS 0x0002 102 #define NFSCLDS_DS 0x0004 103 #define NFSCLDS_CLOSED 0x0008 104 #define NFSCLDS_SAMECONN 0x0010 105 #define NFSCLDS_MINORV2 0x0020 106 107 struct nfsclclient { 108 LIST_ENTRY(nfsclclient) nfsc_list; 109 struct nfsclownerhead nfsc_owner; 110 struct nfscldeleghead nfsc_deleg; 111 struct nfscldeleghash nfsc_deleghash[NFSCLDELEGHASHSIZE]; 112 struct nfsclopenhash nfsc_openhash[NFSCLOPENHASHSIZE]; 113 struct nfscllayouthead nfsc_layout; 114 struct nfscllayouthash nfsc_layouthash[NFSCLLAYOUTHASHSIZE]; 115 struct nfscldevinfohead nfsc_devinfo; 116 struct nfsv4lock nfsc_lock; 117 struct proc *nfsc_renewthread; 118 struct nfsmount *nfsc_nmp; 119 time_t nfsc_expire; 120 u_int32_t nfsc_clientidrev; 121 u_int32_t nfsc_rev; 122 u_int32_t nfsc_renew; 123 u_int32_t nfsc_cbident; 124 u_int16_t nfsc_flags; 125 u_int16_t nfsc_idlen; 126 u_int8_t nfsc_id[1]; /* Malloc'd to correct length */ 127 }; 128 129 /* 130 * Bits for nfsc_flags. 131 */ 132 #define NFSCLFLAGS_INITED 0x0001 133 #define NFSCLFLAGS_HASCLIENTID 0x0002 134 #define NFSCLFLAGS_RECOVER 0x0004 135 #define NFSCLFLAGS_UMOUNT 0x0008 136 #define NFSCLFLAGS_HASTHREAD 0x0010 137 #define NFSCLFLAGS_AFINET6 0x0020 138 #define NFSCLFLAGS_EXPIREIT 0x0040 139 #define NFSCLFLAGS_FIRSTDELEG 0x0080 140 #define NFSCLFLAGS_GOTDELEG 0x0100 141 #define NFSCLFLAGS_RECVRINPROG 0x0200 142 143 struct nfsclowner { 144 LIST_ENTRY(nfsclowner) nfsow_list; 145 struct nfsclopenhead nfsow_open; 146 struct nfsclclient *nfsow_clp; 147 u_int32_t nfsow_seqid; 148 u_int32_t nfsow_defunct; 149 struct nfsv4lock nfsow_rwlock; 150 u_int8_t nfsow_owner[NFSV4CL_LOCKNAMELEN]; 151 }; 152 153 /* 154 * MALLOC'd to the correct length to accommodate the file handle. 155 */ 156 struct nfscldeleg { 157 TAILQ_ENTRY(nfscldeleg) nfsdl_list; 158 LIST_ENTRY(nfscldeleg) nfsdl_hash; 159 struct nfsclownerhead nfsdl_owner; /* locally issued state */ 160 struct nfscllockownerhead nfsdl_lock; 161 nfsv4stateid_t nfsdl_stateid; 162 struct acl_entry nfsdl_ace; /* Delegation ace */ 163 struct nfsclclient *nfsdl_clp; 164 struct nfsv4lock nfsdl_rwlock; /* for active I/O ops */ 165 struct nfscred nfsdl_cred; /* Cred. used for Open */ 166 time_t nfsdl_timestamp; /* used for stale cleanup */ 167 u_int64_t nfsdl_sizelimit; /* Limit for file growth */ 168 u_int64_t nfsdl_size; /* saved copy of file size */ 169 u_int64_t nfsdl_change; /* and change attribute */ 170 struct timespec nfsdl_modtime; /* local modify time */ 171 u_int16_t nfsdl_fhlen; 172 u_int8_t nfsdl_flags; 173 u_int8_t nfsdl_fh[1]; /* must be last */ 174 }; 175 176 /* 177 * nfsdl_flags bits. 178 */ 179 #define NFSCLDL_READ 0x01 180 #define NFSCLDL_WRITE 0x02 181 #define NFSCLDL_RECALL 0x04 182 #define NFSCLDL_NEEDRECLAIM 0x08 183 #define NFSCLDL_ZAPPED 0x10 184 #define NFSCLDL_MODTIMESET 0x20 185 #define NFSCLDL_DELEGRET 0x40 186 187 /* 188 * MALLOC'd to the correct length to accommodate the file handle. 189 */ 190 struct nfsclopen { 191 LIST_ENTRY(nfsclopen) nfso_list; 192 LIST_ENTRY(nfsclopen) nfso_hash; 193 struct nfscllockownerhead nfso_lock; 194 nfsv4stateid_t nfso_stateid; 195 struct nfsclowner *nfso_own; 196 struct nfscred nfso_cred; /* Cred. used for Open */ 197 u_int32_t nfso_mode; 198 u_int32_t nfso_opencnt; 199 u_int16_t nfso_fhlen; 200 u_int8_t nfso_posixlock; /* 1 for POSIX type locking */ 201 u_int8_t nfso_fh[1]; /* must be last */ 202 }; 203 204 /* 205 * Return values for nfscl_open(). NFSCLOPEN_OK must == 0. 206 */ 207 #define NFSCLOPEN_OK 0 208 #define NFSCLOPEN_DOOPEN 1 209 #define NFSCLOPEN_DOOPENDOWNGRADE 2 210 #define NFSCLOPEN_SETCRED 3 211 212 struct nfscllockowner { 213 LIST_ENTRY(nfscllockowner) nfsl_list; 214 struct nfscllockhead nfsl_lock; 215 struct nfsclopen *nfsl_open; 216 NFSPROC_T *nfsl_inprog; 217 nfsv4stateid_t nfsl_stateid; 218 int nfsl_lockflags; 219 u_int32_t nfsl_seqid; 220 struct nfsv4lock nfsl_rwlock; 221 u_int8_t nfsl_owner[NFSV4CL_LOCKNAMELEN]; 222 u_int8_t nfsl_openowner[NFSV4CL_LOCKNAMELEN]; 223 }; 224 225 /* 226 * Byte range entry for the above lock owner. 227 */ 228 struct nfscllock { 229 LIST_ENTRY(nfscllock) nfslo_list; 230 u_int64_t nfslo_first; 231 u_int64_t nfslo_end; 232 short nfslo_type; 233 }; 234 235 /* This structure is used to collect a list of lockowners to free up. */ 236 struct nfscllockownerfh { 237 SLIST_ENTRY(nfscllockownerfh) nfslfh_list; 238 struct nfscllockownerhead nfslfh_lock; 239 int nfslfh_len; 240 uint8_t nfslfh_fh[NFSX_V4FHMAX]; 241 }; 242 243 /* 244 * MALLOC'd to the correct length to accommodate the file handle. 245 */ 246 struct nfscllayout { 247 TAILQ_ENTRY(nfscllayout) nfsly_list; 248 LIST_ENTRY(nfscllayout) nfsly_hash; 249 nfsv4stateid_t nfsly_stateid; 250 struct nfsv4lock nfsly_lock; 251 uint64_t nfsly_filesid[2]; 252 uint64_t nfsly_lastbyte; 253 struct nfsclflayouthead nfsly_flayread; 254 struct nfsclflayouthead nfsly_flayrw; 255 struct nfsclrecalllayouthead nfsly_recall; 256 time_t nfsly_timestamp; 257 struct nfsclclient *nfsly_clp; 258 uint16_t nfsly_flags; 259 uint16_t nfsly_fhlen; 260 uint8_t nfsly_fh[1]; 261 }; 262 263 /* 264 * Flags for nfsly_flags. 265 */ 266 #define NFSLY_FILES 0x0001 267 #define NFSLY_BLOCK 0x0002 268 #define NFSLY_OBJECT 0x0004 269 #define NFSLY_RECALL 0x0008 270 #define NFSLY_RECALLFILE 0x0010 271 #define NFSLY_RECALLFSID 0x0020 272 #define NFSLY_RECALLALL 0x0040 273 #define NFSLY_RETONCLOSE 0x0080 274 #define NFSLY_WRITTEN 0x0100 /* Has been used to write to a DS. */ 275 #define NFSLY_FLEXFILE 0x0200 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