Home | History | Annotate | Line # | Download | only in kern
vfs_lookup.c revision 1.212.4.3
      1 /*	$NetBSD: vfs_lookup.c,v 1.212.4.3 2020/01/17 22:26:25 ad Exp $	*/
      2 
      3 /*
      4  * Copyright (c) 1982, 1986, 1989, 1993
      5  *	The Regents of the University of California.  All rights reserved.
      6  * (c) UNIX System Laboratories, Inc.
      7  * All or some portions of this file are derived from material licensed
      8  * to the University of California by American Telephone and Telegraph
      9  * Co. or Unix System Laboratories, Inc. and are reproduced herein with
     10  * the permission of UNIX System Laboratories, Inc.
     11  *
     12  * Redistribution and use in source and binary forms, with or without
     13  * modification, are permitted provided that the following conditions
     14  * are met:
     15  * 1. Redistributions of source code must retain the above copyright
     16  *    notice, this list of conditions and the following disclaimer.
     17  * 2. Redistributions in binary form must reproduce the above copyright
     18  *    notice, this list of conditions and the following disclaimer in the
     19  *    documentation and/or other materials provided with the distribution.
     20  * 3. Neither the name of the University nor the names of its contributors
     21  *    may be used to endorse or promote products derived from this software
     22  *    without specific prior written permission.
     23  *
     24  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
     25  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
     26  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
     27  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
     28  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
     29  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
     30  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     31  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
     32  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
     33  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
     34  * SUCH DAMAGE.
     35  *
     36  *	@(#)vfs_lookup.c	8.10 (Berkeley) 5/27/95
     37  */
     38 
     39 #include <sys/cdefs.h>
     40 __KERNEL_RCSID(0, "$NetBSD: vfs_lookup.c,v 1.212.4.3 2020/01/17 22:26:25 ad Exp $");
     41 
     42 #ifdef _KERNEL_OPT
     43 #include "opt_magiclinks.h"
     44 #endif
     45 
     46 #include <sys/param.h>
     47 #include <sys/systm.h>
     48 #include <sys/kernel.h>
     49 #include <sys/syslimits.h>
     50 #include <sys/time.h>
     51 #include <sys/namei.h>
     52 #include <sys/vnode.h>
     53 #include <sys/vnode_impl.h>
     54 #include <sys/mount.h>
     55 #include <sys/errno.h>
     56 #include <sys/filedesc.h>
     57 #include <sys/hash.h>
     58 #include <sys/proc.h>
     59 #include <sys/syslog.h>
     60 #include <sys/kauth.h>
     61 #include <sys/ktrace.h>
     62 #include <sys/dirent.h>
     63 
     64 #ifndef MAGICLINKS
     65 #define MAGICLINKS 0
     66 #endif
     67 
     68 int vfs_magiclinks = MAGICLINKS;
     69 
     70 __CTASSERT(MAXNAMLEN == NAME_MAX);
     71 
     72 /*
     73  * Substitute replacement text for 'magic' strings in symlinks.
     74  * Returns 0 if successful, and returns non-zero if an error
     75  * occurs.  (Currently, the only possible error is running out
     76  * of temporary pathname space.)
     77  *
     78  * Looks for "@<string>" and "@<string>/", where <string> is a
     79  * recognized 'magic' string.  Replaces the "@<string>" with the
     80  * appropriate replacement text.  (Note that in some cases the
     81  * replacement text may have zero length.)
     82  *
     83  * This would have been table driven, but the variance in
     84  * replacement strings (and replacement string lengths) made
     85  * that impractical.
     86  */
     87 #define	VNL(x)							\
     88 	(sizeof(x) - 1)
     89 
     90 #define	VO	'{'
     91 #define	VC	'}'
     92 
     93 #define	MATCH(str)						\
     94 	((termchar == '/' && i + VNL(str) == *len) ||		\
     95 	 (i + VNL(str) < *len &&				\
     96 	  cp[i + VNL(str)] == termchar)) &&			\
     97 	!strncmp((str), &cp[i], VNL(str))
     98 
     99 #define	SUBSTITUTE(m, s, sl)					\
    100 	if ((newlen + (sl)) >= MAXPATHLEN)			\
    101 		return 1;					\
    102 	i += VNL(m);						\
    103 	if (termchar != '/')					\
    104 		i++;						\
    105 	(void)memcpy(&tmp[newlen], (s), (sl));			\
    106 	newlen += (sl);						\
    107 	change = 1;						\
    108 	termchar = '/';
    109 
    110 static int
    111 symlink_magic(struct proc *p, char *cp, size_t *len)
    112 {
    113 	char *tmp;
    114 	size_t change, i, newlen, slen;
    115 	char termchar = '/';
    116 	char idtmp[11]; /* enough for 32 bit *unsigned* integer */
    117 
    118 
    119 	tmp = PNBUF_GET();
    120 	for (change = i = newlen = 0; i < *len; ) {
    121 		if (cp[i] != '@') {
    122 			tmp[newlen++] = cp[i++];
    123 			continue;
    124 		}
    125 
    126 		i++;
    127 
    128 		/* Check for @{var} syntax. */
    129 		if (cp[i] == VO) {
    130 			termchar = VC;
    131 			i++;
    132 		}
    133 
    134 		/*
    135 		 * The following checks should be ordered according
    136 		 * to frequency of use.
    137 		 */
    138 		if (MATCH("machine_arch")) {
    139 			slen = VNL(MACHINE_ARCH);
    140 			SUBSTITUTE("machine_arch", MACHINE_ARCH, slen);
    141 		} else if (MATCH("machine")) {
    142 			slen = VNL(MACHINE);
    143 			SUBSTITUTE("machine", MACHINE, slen);
    144 		} else if (MATCH("hostname")) {
    145 			SUBSTITUTE("hostname", hostname, hostnamelen);
    146 		} else if (MATCH("osrelease")) {
    147 			slen = strlen(osrelease);
    148 			SUBSTITUTE("osrelease", osrelease, slen);
    149 		} else if (MATCH("emul")) {
    150 			slen = strlen(p->p_emul->e_name);
    151 			SUBSTITUTE("emul", p->p_emul->e_name, slen);
    152 		} else if (MATCH("kernel_ident")) {
    153 			slen = strlen(kernel_ident);
    154 			SUBSTITUTE("kernel_ident", kernel_ident, slen);
    155 		} else if (MATCH("domainname")) {
    156 			SUBSTITUTE("domainname", domainname, domainnamelen);
    157 		} else if (MATCH("ostype")) {
    158 			slen = strlen(ostype);
    159 			SUBSTITUTE("ostype", ostype, slen);
    160 		} else if (MATCH("uid")) {
    161 			slen = snprintf(idtmp, sizeof(idtmp), "%u",
    162 			    kauth_cred_geteuid(kauth_cred_get()));
    163 			SUBSTITUTE("uid", idtmp, slen);
    164 		} else if (MATCH("ruid")) {
    165 			slen = snprintf(idtmp, sizeof(idtmp), "%u",
    166 			    kauth_cred_getuid(kauth_cred_get()));
    167 			SUBSTITUTE("ruid", idtmp, slen);
    168 		} else if (MATCH("gid")) {
    169 			slen = snprintf(idtmp, sizeof(idtmp), "%u",
    170 			    kauth_cred_getegid(kauth_cred_get()));
    171 			SUBSTITUTE("gid", idtmp, slen);
    172 		} else if (MATCH("rgid")) {
    173 			slen = snprintf(idtmp, sizeof(idtmp), "%u",
    174 			    kauth_cred_getgid(kauth_cred_get()));
    175 			SUBSTITUTE("rgid", idtmp, slen);
    176 		} else {
    177 			tmp[newlen++] = '@';
    178 			if (termchar == VC)
    179 				tmp[newlen++] = VO;
    180 		}
    181 	}
    182 
    183 	if (change) {
    184 		(void)memcpy(cp, tmp, newlen);
    185 		*len = newlen;
    186 	}
    187 	PNBUF_PUT(tmp);
    188 
    189 	return 0;
    190 }
    191 
    192 #undef VNL
    193 #undef VO
    194 #undef VC
    195 #undef MATCH
    196 #undef SUBSTITUTE
    197 
    198 ////////////////////////////////////////////////////////////
    199 
    200 /*
    201  * Determine the namei hash (for the namecache) for name.
    202  * If *ep != NULL, hash from name to ep-1.
    203  * If *ep == NULL, hash from name until the first NUL or '/', and
    204  * return the location of this termination character in *ep.
    205  *
    206  * This function returns an equivalent hash to the MI hash32_strn().
    207  * The latter isn't used because in the *ep == NULL case, determining
    208  * the length of the string to the first NUL or `/' and then calling
    209  * hash32_strn() involves unnecessary double-handling of the data.
    210  */
    211 uint32_t
    212 namei_hash(const char *name, const char **ep)
    213 {
    214 	uint32_t	hash;
    215 
    216 	hash = HASH32_STR_INIT;
    217 	if (*ep != NULL) {
    218 		for (; name < *ep; name++)
    219 			hash = hash * 33 + *(const uint8_t *)name;
    220 	} else {
    221 		for (; *name != '\0' && *name != '/'; name++)
    222 			hash = hash * 33 + *(const uint8_t *)name;
    223 		*ep = name;
    224 	}
    225 	return (hash + (hash >> 5));
    226 }
    227 
    228 /*
    229  * Find the end of the first path component in NAME and return its
    230  * length.
    231  */
    232 static size_t
    233 namei_getcomponent(const char *name)
    234 {
    235 	size_t pos;
    236 
    237 	pos = 0;
    238 	while (name[pos] != '\0' && name[pos] != '/') {
    239 		pos++;
    240 	}
    241 	return pos;
    242 }
    243 
    244 ////////////////////////////////////////////////////////////
    245 
    246 /*
    247  * Sealed abstraction for pathnames.
    248  *
    249  * System-call-layer level code that is going to call namei should
    250  * first create a pathbuf and adjust all the bells and whistles on it
    251  * as needed by context.
    252  */
    253 
    254 struct pathbuf {
    255 	char *pb_path;
    256 	char *pb_pathcopy;
    257 	unsigned pb_pathcopyuses;
    258 };
    259 
    260 static struct pathbuf *
    261 pathbuf_create_raw(void)
    262 {
    263 	struct pathbuf *pb;
    264 
    265 	pb = kmem_alloc(sizeof(*pb), KM_SLEEP);
    266 	pb->pb_path = PNBUF_GET();
    267 	if (pb->pb_path == NULL) {
    268 		kmem_free(pb, sizeof(*pb));
    269 		return NULL;
    270 	}
    271 	pb->pb_pathcopy = NULL;
    272 	pb->pb_pathcopyuses = 0;
    273 	return pb;
    274 }
    275 
    276 void
    277 pathbuf_destroy(struct pathbuf *pb)
    278 {
    279 	KASSERT(pb->pb_pathcopyuses == 0);
    280 	KASSERT(pb->pb_pathcopy == NULL);
    281 	PNBUF_PUT(pb->pb_path);
    282 	kmem_free(pb, sizeof(*pb));
    283 }
    284 
    285 struct pathbuf *
    286 pathbuf_assimilate(char *pnbuf)
    287 {
    288 	struct pathbuf *pb;
    289 
    290 	pb = kmem_alloc(sizeof(*pb), KM_SLEEP);
    291 	pb->pb_path = pnbuf;
    292 	pb->pb_pathcopy = NULL;
    293 	pb->pb_pathcopyuses = 0;
    294 	return pb;
    295 }
    296 
    297 struct pathbuf *
    298 pathbuf_create(const char *path)
    299 {
    300 	struct pathbuf *pb;
    301 	int error;
    302 
    303 	pb = pathbuf_create_raw();
    304 	if (pb == NULL) {
    305 		return NULL;
    306 	}
    307 	error = copystr(path, pb->pb_path, PATH_MAX, NULL);
    308 	if (error != 0) {
    309 		KASSERT(!"kernel path too long in pathbuf_create");
    310 		/* make sure it's null-terminated, just in case */
    311 		pb->pb_path[PATH_MAX-1] = '\0';
    312 	}
    313 	return pb;
    314 }
    315 
    316 int
    317 pathbuf_copyin(const char *userpath, struct pathbuf **ret)
    318 {
    319 	struct pathbuf *pb;
    320 	int error;
    321 
    322 	pb = pathbuf_create_raw();
    323 	if (pb == NULL) {
    324 		return ENOMEM;
    325 	}
    326 	error = copyinstr(userpath, pb->pb_path, PATH_MAX, NULL);
    327 	if (error) {
    328 		pathbuf_destroy(pb);
    329 		return error;
    330 	}
    331 	*ret = pb;
    332 	return 0;
    333 }
    334 
    335 /*
    336  * XXX should not exist:
    337  *   1. whether a pointer is kernel or user should be statically checkable.
    338  *   2. copyin should be handled by the upper part of the syscall layer,
    339  *      not in here.
    340  */
    341 int
    342 pathbuf_maybe_copyin(const char *path, enum uio_seg seg, struct pathbuf **ret)
    343 {
    344 	if (seg == UIO_USERSPACE) {
    345 		return pathbuf_copyin(path, ret);
    346 	} else {
    347 		*ret = pathbuf_create(path);
    348 		if (*ret == NULL) {
    349 			return ENOMEM;
    350 		}
    351 		return 0;
    352 	}
    353 }
    354 
    355 /*
    356  * Get a copy of the path buffer as it currently exists. If this is
    357  * called after namei starts the results may be arbitrary.
    358  */
    359 void
    360 pathbuf_copystring(const struct pathbuf *pb, char *buf, size_t maxlen)
    361 {
    362 	strlcpy(buf, pb->pb_path, maxlen);
    363 }
    364 
    365 /*
    366  * These two functions allow access to a saved copy of the original
    367  * path string. The first copy should be gotten before namei is
    368  * called. Each copy that is gotten should be put back.
    369  */
    370 
    371 const char *
    372 pathbuf_stringcopy_get(struct pathbuf *pb)
    373 {
    374 	if (pb->pb_pathcopyuses == 0) {
    375 		pb->pb_pathcopy = PNBUF_GET();
    376 		strcpy(pb->pb_pathcopy, pb->pb_path);
    377 	}
    378 	pb->pb_pathcopyuses++;
    379 	return pb->pb_pathcopy;
    380 }
    381 
    382 void
    383 pathbuf_stringcopy_put(struct pathbuf *pb, const char *str)
    384 {
    385 	KASSERT(str == pb->pb_pathcopy);
    386 	KASSERT(pb->pb_pathcopyuses > 0);
    387 	pb->pb_pathcopyuses--;
    388 	if (pb->pb_pathcopyuses == 0) {
    389 		PNBUF_PUT(pb->pb_pathcopy);
    390 		pb->pb_pathcopy = NULL;
    391 	}
    392 }
    393 
    394 
    395 ////////////////////////////////////////////////////////////
    396 
    397 /*
    398  * namei: convert a pathname into a pointer to a (maybe-locked) vnode,
    399  * and maybe also its parent directory vnode, and assorted other guff.
    400  * See namei(9) for the interface documentation.
    401  *
    402  *
    403  * The FOLLOW flag is set when symbolic links are to be followed
    404  * when they occur at the end of the name translation process.
    405  * Symbolic links are always followed for all other pathname
    406  * components other than the last.
    407  *
    408  * The segflg defines whether the name is to be copied from user
    409  * space or kernel space.
    410  *
    411  * Overall outline of namei:
    412  *
    413  *	copy in name
    414  *	get starting directory
    415  *	while (!done && !error) {
    416  *		call lookup to search path.
    417  *		if symbolic link, massage name in buffer and continue
    418  *	}
    419  */
    420 
    421 /*
    422  * Search a pathname.
    423  * This is a very central and rather complicated routine.
    424  *
    425  * The pathname is pointed to by ni_ptr and is of length ni_pathlen.
    426  * The starting directory is passed in. The pathname is descended
    427  * until done, or a symbolic link is encountered. The variable ni_more
    428  * is clear if the path is completed; it is set to one if a symbolic
    429  * link needing interpretation is encountered.
    430  *
    431  * The flag argument is LOOKUP, CREATE, RENAME, or DELETE depending on
    432  * whether the name is to be looked up, created, renamed, or deleted.
    433  * When CREATE, RENAME, or DELETE is specified, information usable in
    434  * creating, renaming, or deleting a directory entry may be calculated.
    435  * If flag has LOCKPARENT or'ed into it, the parent directory is returned
    436  * locked.  Otherwise the parent directory is not returned. If the target
    437  * of the pathname exists and LOCKLEAF is or'ed into the flag the target
    438  * is returned locked, otherwise it is returned unlocked.  When creating
    439  * or renaming and LOCKPARENT is specified, the target may not be ".".
    440  * When deleting and LOCKPARENT is specified, the target may be ".".
    441  *
    442  * Overall outline of lookup:
    443  *
    444  * dirloop:
    445  *	identify next component of name at ndp->ni_ptr
    446  *	handle degenerate case where name is null string
    447  *	if .. and crossing mount points and on mounted filesys, find parent
    448  *	call VOP_LOOKUP routine for next component name
    449  *	    directory vnode returned in ni_dvp, locked.
    450  *	    component vnode returned in ni_vp (if it exists), locked.
    451  *	if result vnode is mounted on and crossing mount points,
    452  *	    find mounted on vnode
    453  *	if more components of name, do next level at dirloop
    454  *	return the answer in ni_vp, locked if LOCKLEAF set
    455  *	    if LOCKPARENT set, return locked parent in ni_dvp
    456  */
    457 
    458 
    459 /*
    460  * Internal state for a namei operation.
    461  *
    462  * cnp is always equal to &ndp->ni_cnp.
    463  */
    464 struct namei_state {
    465 	struct nameidata *ndp;
    466 	struct componentname *cnp;
    467 
    468 	int docache;			/* == 0 do not cache last component */
    469 	int rdonly;			/* lookup read-only flag bit */
    470 	int slashes;
    471 
    472 	unsigned attempt_retry:1;	/* true if error allows emul retry */
    473 	unsigned root_referenced:1;	/* true if ndp->ni_rootdir and
    474 					     ndp->ni_erootdir were referenced */
    475 };
    476 
    477 
    478 /*
    479  * Initialize the namei working state.
    480  */
    481 static void
    482 namei_init(struct namei_state *state, struct nameidata *ndp)
    483 {
    484 
    485 	state->ndp = ndp;
    486 	state->cnp = &ndp->ni_cnd;
    487 
    488 	state->docache = 0;
    489 	state->rdonly = 0;
    490 	state->slashes = 0;
    491 
    492 	state->root_referenced = 0;
    493 
    494 	KASSERTMSG((state->cnp->cn_cred != NULL), "namei: bad cred/proc");
    495 	KASSERTMSG(((state->cnp->cn_nameiop & (~OPMASK)) == 0),
    496 	    "namei: nameiop contaminated with flags: %08"PRIx32,
    497 	    state->cnp->cn_nameiop);
    498 	KASSERTMSG(((state->cnp->cn_flags & OPMASK) == 0),
    499 	    "name: flags contaminated with nameiops: %08"PRIx32,
    500 	    state->cnp->cn_flags);
    501 
    502 	/*
    503 	 * The buffer for name translation shall be the one inside the
    504 	 * pathbuf.
    505 	 */
    506 	state->ndp->ni_pnbuf = state->ndp->ni_pathbuf->pb_path;
    507 }
    508 
    509 /*
    510  * Clean up the working namei state, leaving things ready for return
    511  * from namei.
    512  */
    513 static void
    514 namei_cleanup(struct namei_state *state)
    515 {
    516 	KASSERT(state->cnp == &state->ndp->ni_cnd);
    517 
    518 	if (state->root_referenced) {
    519 		if (state->ndp->ni_rootdir != NULL)
    520 			vrele(state->ndp->ni_rootdir);
    521 		if (state->ndp->ni_erootdir != NULL)
    522 			vrele(state->ndp->ni_erootdir);
    523 	}
    524 }
    525 
    526 //////////////////////////////
    527 
    528 /*
    529  * Get the directory context.
    530  * Initializes the rootdir and erootdir state and returns a reference
    531  * to the starting dir.
    532  */
    533 static struct vnode *
    534 namei_getstartdir(struct namei_state *state)
    535 {
    536 	struct nameidata *ndp = state->ndp;
    537 	struct componentname *cnp = state->cnp;
    538 	struct cwdinfo *cwdi;		/* pointer to cwd state */
    539 	struct lwp *self = curlwp;	/* thread doing namei() */
    540 	struct vnode *rootdir, *erootdir, *curdir, *startdir;
    541 
    542 	if (state->root_referenced) {
    543 		if (state->ndp->ni_rootdir != NULL)
    544 			vrele(state->ndp->ni_rootdir);
    545 		if (state->ndp->ni_erootdir != NULL)
    546 			vrele(state->ndp->ni_erootdir);
    547 		state->root_referenced = 0;
    548 	}
    549 
    550 	cwdi = self->l_proc->p_cwdi;
    551 	rw_enter(&cwdi->cwdi_lock, RW_READER);
    552 
    553 	/* root dir */
    554 	if (cwdi->cwdi_rdir == NULL || (cnp->cn_flags & NOCHROOT)) {
    555 		rootdir = rootvnode;
    556 	} else {
    557 		rootdir = cwdi->cwdi_rdir;
    558 	}
    559 
    560 	/* emulation root dir, if any */
    561 	if ((cnp->cn_flags & TRYEMULROOT) == 0) {
    562 		/* if we don't want it, don't fetch it */
    563 		erootdir = NULL;
    564 	} else if (cnp->cn_flags & EMULROOTSET) {
    565 		/* explicitly set emulroot; "/../" doesn't override this */
    566 		erootdir = ndp->ni_erootdir;
    567 	} else if (!strncmp(ndp->ni_pnbuf, "/../", 4)) {
    568 		/* explicit reference to real rootdir */
    569 		erootdir = NULL;
    570 	} else {
    571 		/* may be null */
    572 		erootdir = cwdi->cwdi_edir;
    573 	}
    574 
    575 	/* current dir */
    576 	curdir = cwdi->cwdi_cdir;
    577 
    578 	if (ndp->ni_pnbuf[0] != '/') {
    579 		if (ndp->ni_atdir != NULL) {
    580 			startdir = ndp->ni_atdir;
    581 		} else {
    582 			startdir = curdir;
    583 		}
    584 		erootdir = NULL;
    585 	} else if (cnp->cn_flags & TRYEMULROOT && erootdir != NULL) {
    586 		startdir = erootdir;
    587 	} else {
    588 		startdir = rootdir;
    589 		erootdir = NULL;
    590 	}
    591 
    592 	state->ndp->ni_rootdir = rootdir;
    593 	state->ndp->ni_erootdir = erootdir;
    594 
    595 	/*
    596 	 * Get a reference to the start dir so we can safely unlock cwdi.
    597 	 *
    598 	 * Must hold references to rootdir and erootdir while we're running.
    599 	 * A multithreaded process may chroot during namei.
    600 	 */
    601 	if (startdir != NULL)
    602 		vref(startdir);
    603 	if (state->ndp->ni_rootdir != NULL)
    604 		vref(state->ndp->ni_rootdir);
    605 	if (state->ndp->ni_erootdir != NULL)
    606 		vref(state->ndp->ni_erootdir);
    607 	state->root_referenced = 1;
    608 
    609 	rw_exit(&cwdi->cwdi_lock);
    610 	return startdir;
    611 }
    612 
    613 /*
    614  * Get the directory context for the nfsd case, in parallel to
    615  * getstartdir. Initializes the rootdir and erootdir state and
    616  * returns a reference to the passed-in starting dir.
    617  */
    618 static struct vnode *
    619 namei_getstartdir_for_nfsd(struct namei_state *state)
    620 {
    621 	KASSERT(state->ndp->ni_atdir != NULL);
    622 
    623 	/* always use the real root, and never set an emulation root */
    624 	if (rootvnode == NULL) {
    625 		return NULL;
    626 	}
    627 	state->ndp->ni_rootdir = rootvnode;
    628 	state->ndp->ni_erootdir = NULL;
    629 
    630 	vref(state->ndp->ni_atdir);
    631 	KASSERT(! state->root_referenced);
    632 	vref(state->ndp->ni_rootdir);
    633 	state->root_referenced = 1;
    634 	return state->ndp->ni_atdir;
    635 }
    636 
    637 
    638 /*
    639  * Ktrace the namei operation.
    640  */
    641 static void
    642 namei_ktrace(struct namei_state *state)
    643 {
    644 	struct nameidata *ndp = state->ndp;
    645 	struct componentname *cnp = state->cnp;
    646 	struct lwp *self = curlwp;	/* thread doing namei() */
    647 	const char *emul_path;
    648 
    649 	if (ktrpoint(KTR_NAMEI)) {
    650 		if (ndp->ni_erootdir != NULL) {
    651 			/*
    652 			 * To make any sense, the trace entry need to have the
    653 			 * text of the emulation path prepended.
    654 			 * Usually we can get this from the current process,
    655 			 * but when called from emul_find_interp() it is only
    656 			 * in the exec_package - so we get it passed in ni_next
    657 			 * (this is a hack).
    658 			 */
    659 			if (cnp->cn_flags & EMULROOTSET)
    660 				emul_path = ndp->ni_next;
    661 			else
    662 				emul_path = self->l_proc->p_emul->e_path;
    663 			ktrnamei2(emul_path, strlen(emul_path),
    664 			    ndp->ni_pnbuf, ndp->ni_pathlen);
    665 		} else
    666 			ktrnamei(ndp->ni_pnbuf, ndp->ni_pathlen);
    667 	}
    668 }
    669 
    670 /*
    671  * Start up namei. Find the root dir and cwd, establish the starting
    672  * directory for lookup, and lock it. Also calls ktrace when
    673  * appropriate.
    674  */
    675 static int
    676 namei_start(struct namei_state *state, int isnfsd,
    677 	    struct vnode **startdir_ret)
    678 {
    679 	struct nameidata *ndp = state->ndp;
    680 	struct vnode *startdir;
    681 
    682 	/* length includes null terminator (was originally from copyinstr) */
    683 	ndp->ni_pathlen = strlen(ndp->ni_pnbuf) + 1;
    684 
    685 	/*
    686 	 * POSIX.1 requirement: "" is not a valid file name.
    687 	 */
    688 	if (ndp->ni_pathlen == 1) {
    689 		ndp->ni_erootdir = NULL;
    690 		return ENOENT;
    691 	}
    692 
    693 	ndp->ni_loopcnt = 0;
    694 
    695 	/* Get starting directory, set up root, and ktrace. */
    696 	if (isnfsd) {
    697 		startdir = namei_getstartdir_for_nfsd(state);
    698 		/* no ktrace */
    699 	} else {
    700 		startdir = namei_getstartdir(state);
    701 		namei_ktrace(state);
    702 	}
    703 
    704 	if (startdir == NULL) {
    705 		return ENOENT;
    706 	}
    707 
    708 	/* NDAT may feed us with a non directory namei_getstartdir */
    709 	if (startdir->v_type != VDIR) {
    710 		vrele(startdir);
    711 		return ENOTDIR;
    712 	}
    713 
    714 	*startdir_ret = startdir;
    715 	return 0;
    716 }
    717 
    718 /*
    719  * Check for being at a symlink that we're going to follow.
    720  */
    721 static inline int
    722 namei_atsymlink(struct namei_state *state, struct vnode *foundobj)
    723 {
    724 	return (foundobj->v_type == VLNK) &&
    725 		(state->cnp->cn_flags & (FOLLOW|REQUIREDIR));
    726 }
    727 
    728 /*
    729  * Follow a symlink.
    730  *
    731  * Updates searchdir. inhibitmagic causes magic symlinks to not be
    732  * interpreted; this is used by nfsd.
    733  *
    734  * Unlocks foundobj on success (ugh)
    735  */
    736 static inline int
    737 namei_follow(struct namei_state *state, int inhibitmagic,
    738 	     struct vnode *searchdir, struct vnode *foundobj,
    739 	     struct vnode **newsearchdir_ret)
    740 {
    741 	struct nameidata *ndp = state->ndp;
    742 	struct componentname *cnp = state->cnp;
    743 
    744 	struct lwp *self = curlwp;	/* thread doing namei() */
    745 	struct iovec aiov;		/* uio for reading symbolic links */
    746 	struct uio auio;
    747 	char *cp;			/* pointer into pathname argument */
    748 	size_t linklen;
    749 	int error;
    750 
    751 	if (ndp->ni_loopcnt++ >= MAXSYMLINKS) {
    752 		return ELOOP;
    753 	}
    754 
    755 	vn_lock(foundobj, LK_EXCLUSIVE | LK_RETRY);
    756 	if (foundobj->v_mount->mnt_flag & MNT_SYMPERM) {
    757 		error = VOP_ACCESS(foundobj, VEXEC, cnp->cn_cred);
    758 		if (error != 0) {
    759 			VOP_UNLOCK(foundobj);
    760 			return error;
    761 		}
    762 	}
    763 
    764 	/* FUTURE: fix this to not use a second buffer */
    765 	cp = PNBUF_GET();
    766 	aiov.iov_base = cp;
    767 	aiov.iov_len = MAXPATHLEN;
    768 	auio.uio_iov = &aiov;
    769 	auio.uio_iovcnt = 1;
    770 	auio.uio_offset = 0;
    771 	auio.uio_rw = UIO_READ;
    772 	auio.uio_resid = MAXPATHLEN;
    773 	UIO_SETUP_SYSSPACE(&auio);
    774 	error = VOP_READLINK(foundobj, &auio, cnp->cn_cred);
    775 	VOP_UNLOCK(foundobj);
    776 	if (error) {
    777 		PNBUF_PUT(cp);
    778 		return error;
    779 	}
    780 	linklen = MAXPATHLEN - auio.uio_resid;
    781 	if (linklen == 0) {
    782 		PNBUF_PUT(cp);
    783 		return ENOENT;
    784 	}
    785 
    786 	/*
    787 	 * Do symlink substitution, if appropriate, and
    788 	 * check length for potential overflow.
    789 	 *
    790 	 * Inhibit symlink substitution for nfsd.
    791 	 * XXX: This is how it was before; is that a bug or a feature?
    792 	 */
    793 	if ((!inhibitmagic && vfs_magiclinks &&
    794 	     symlink_magic(self->l_proc, cp, &linklen)) ||
    795 	    (linklen + ndp->ni_pathlen >= MAXPATHLEN)) {
    796 		PNBUF_PUT(cp);
    797 		return ENAMETOOLONG;
    798 	}
    799 	if (ndp->ni_pathlen > 1) {
    800 		/* includes a null-terminator */
    801 		memcpy(cp + linklen, ndp->ni_next, ndp->ni_pathlen);
    802 	} else {
    803 		cp[linklen] = '\0';
    804 	}
    805 	ndp->ni_pathlen += linklen;
    806 	memcpy(ndp->ni_pnbuf, cp, ndp->ni_pathlen);
    807 	PNBUF_PUT(cp);
    808 
    809 	/* we're now starting from the beginning of the buffer again */
    810 	cnp->cn_nameptr = ndp->ni_pnbuf;
    811 
    812 	/*
    813 	 * Check if root directory should replace current directory.
    814 	 */
    815 	if (ndp->ni_pnbuf[0] == '/') {
    816 		vrele(searchdir);
    817 		/* Keep absolute symbolic links inside emulation root */
    818 		searchdir = ndp->ni_erootdir;
    819 		if (searchdir == NULL ||
    820 		    (ndp->ni_pnbuf[1] == '.'
    821 		     && ndp->ni_pnbuf[2] == '.'
    822 		     && ndp->ni_pnbuf[3] == '/')) {
    823 			ndp->ni_erootdir = NULL;
    824 			searchdir = ndp->ni_rootdir;
    825 		}
    826 		vref(searchdir);
    827 		while (cnp->cn_nameptr[0] == '/') {
    828 			cnp->cn_nameptr++;
    829 			ndp->ni_pathlen--;
    830 		}
    831 	}
    832 
    833 	*newsearchdir_ret = searchdir;
    834 	return 0;
    835 }
    836 
    837 //////////////////////////////
    838 
    839 /*
    840  * Inspect the leading path component and update the state accordingly.
    841  */
    842 static int
    843 lookup_parsepath(struct namei_state *state)
    844 {
    845 	const char *cp;			/* pointer into pathname argument */
    846 
    847 	struct componentname *cnp = state->cnp;
    848 	struct nameidata *ndp = state->ndp;
    849 
    850 	KASSERT(cnp == &ndp->ni_cnd);
    851 
    852 	/*
    853 	 * Search a new directory.
    854 	 *
    855 	 * The last component of the filename is left accessible via
    856 	 * cnp->cn_nameptr for callers that need the name. Callers needing
    857 	 * the name set the SAVENAME flag. When done, they assume
    858 	 * responsibility for freeing the pathname buffer.
    859 	 *
    860 	 * At this point, our only vnode state is that the search dir
    861 	 * is held.
    862 	 */
    863 	cnp->cn_consume = 0;
    864 	cnp->cn_namelen = namei_getcomponent(cnp->cn_nameptr);
    865 	cp = cnp->cn_nameptr + cnp->cn_namelen;
    866 	if (cnp->cn_namelen > KERNEL_NAME_MAX) {
    867 		return ENAMETOOLONG;
    868 	}
    869 #ifdef NAMEI_DIAGNOSTIC
    870 	{ char c = *cp;
    871 	*(char *)cp = '\0';
    872 	printf("{%s}: ", cnp->cn_nameptr);
    873 	*(char *)cp = c; }
    874 #endif /* NAMEI_DIAGNOSTIC */
    875 	ndp->ni_pathlen -= cnp->cn_namelen;
    876 	ndp->ni_next = cp;
    877 	/*
    878 	 * If this component is followed by a slash, then move the pointer to
    879 	 * the next component forward, and remember that this component must be
    880 	 * a directory.
    881 	 */
    882 	if (*cp == '/') {
    883 		do {
    884 			cp++;
    885 		} while (*cp == '/');
    886 		state->slashes = cp - ndp->ni_next;
    887 		ndp->ni_pathlen -= state->slashes;
    888 		ndp->ni_next = cp;
    889 		cnp->cn_flags |= REQUIREDIR;
    890 	} else {
    891 		state->slashes = 0;
    892 		cnp->cn_flags &= ~REQUIREDIR;
    893 	}
    894 	/*
    895 	 * We do special processing on the last component, whether or not it's
    896 	 * a directory.  Cache all intervening lookups, but not the final one.
    897 	 */
    898 	if (*cp == '\0') {
    899 		if (state->docache)
    900 			cnp->cn_flags |= MAKEENTRY;
    901 		else
    902 			cnp->cn_flags &= ~MAKEENTRY;
    903 		cnp->cn_flags |= ISLASTCN;
    904 	} else {
    905 		cnp->cn_flags |= MAKEENTRY;
    906 		cnp->cn_flags &= ~ISLASTCN;
    907 	}
    908 	if (cnp->cn_namelen == 2 &&
    909 	    cnp->cn_nameptr[1] == '.' && cnp->cn_nameptr[0] == '.')
    910 		cnp->cn_flags |= ISDOTDOT;
    911 	else
    912 		cnp->cn_flags &= ~ISDOTDOT;
    913 
    914 	return 0;
    915 }
    916 
    917 /*
    918  * Take care of crossing a mounted-on vnode.  On error, foundobj_ret will be
    919  * vrele'd, but searchdir is left alone.
    920  */
    921 static int
    922 lookup_crossmount(struct namei_state *state,
    923 		  struct vnode **searchdir_ret,
    924 		  struct vnode **foundobj_ret,
    925 		  bool searchdir_locked)
    926 {
    927 	struct componentname *cnp = state->cnp;
    928 	struct vnode *foundobj;
    929 	struct vnode *searchdir;
    930 	struct mount *mp;
    931 	int error;
    932 
    933 	searchdir = *searchdir_ret;
    934 	foundobj = *foundobj_ret;
    935 
    936 	KASSERT((cnp->cn_flags & NOCROSSMOUNT) == 0);
    937 	KASSERT(searchdir != NULL);
    938 
    939 	/*
    940 	 * Check to see if the vnode has been mounted on;
    941 	 * if so find the root of the mounted file system.
    942 	 */
    943 	error = vn_lock(foundobj, LK_SHARED);
    944 	if (error != 0) {
    945 		vrele(foundobj);
    946 		*foundobj_ret = NULL;
    947 		return error;
    948 	}
    949 	while (foundobj->v_type == VDIR &&
    950 	    (mp = foundobj->v_mountedhere) != NULL &&
    951 	    (cnp->cn_flags & NOCROSSMOUNT) == 0) {
    952 		KASSERTMSG(searchdir != foundobj, "same vn %p", searchdir);
    953 
    954 		error = vfs_busy(mp);
    955 		if (error != 0) {
    956 			vput(foundobj);
    957 			*foundobj_ret = NULL;
    958 			return error;
    959 		}
    960 		if (searchdir_locked) {
    961 			VOP_UNLOCK(searchdir);
    962 		}
    963 		vput(foundobj);
    964 		error = VFS_ROOT(mp, LK_SHARED, &foundobj);
    965 		vfs_unbusy(mp);
    966 		if (error) {
    967 			if (searchdir_locked) {
    968 				vn_lock(searchdir, LK_EXCLUSIVE | LK_RETRY);
    969 			}
    970 			*foundobj_ret = NULL;
    971 			return error;
    972 		}
    973 		/*
    974 		 * Avoid locking vnodes from two filesystems because
    975 		 * it's prone to deadlock, e.g. when using puffs.
    976 		 * Also, it isn't a good idea to propagate slowness of
    977 		 * a filesystem up to the root directory. For now,
    978 		 * only handle the common case, where foundobj is
    979 		 * VDIR.
    980 		 *
    981 		 * In this case set searchdir to null to avoid using
    982 		 * it again. It is not correct to set searchdir ==
    983 		 * foundobj here as that will confuse the caller.
    984 		 * (See PR 40740.)
    985 		 */
    986 		if (searchdir == NULL) {
    987 			/* already been here once; do nothing further */
    988 		} else if (foundobj->v_type == VDIR) {
    989 			vrele(searchdir);
    990 			*searchdir_ret = searchdir = NULL;
    991 			*foundobj_ret = foundobj;
    992 		} else if (searchdir_locked) {
    993 			VOP_UNLOCK(foundobj);
    994 			vn_lock(searchdir, LK_EXCLUSIVE | LK_RETRY);
    995 			vn_lock(foundobj, LK_SHARED | LK_RETRY);
    996 		}
    997 	}
    998 	VOP_UNLOCK(foundobj);
    999 	return 0;
   1000 }
   1001 
   1002 /*
   1003  * Call VOP_LOOKUP for a single lookup; return a new search directory
   1004  * (used when crossing mountpoints up or searching union mounts down) and
   1005  * the found object, which for create operations may be NULL on success.
   1006  *
   1007  * Note that the new search directory may be null, which means the
   1008  * searchdir was unlocked and released. This happens in the common case
   1009  * when crossing a mount point downwards, in order to avoid coupling
   1010  * locks between different file system volumes. Importantly, this can
   1011  * happen even if the call fails. (XXX: this is gross and should be
   1012  * tidied somehow.)
   1013  */
   1014 static int
   1015 lookup_once(struct namei_state *state,
   1016 	    struct vnode *searchdir,
   1017 	    struct vnode **newsearchdir_ret,
   1018 	    struct vnode **foundobj_ret,
   1019 	    bool *newsearchdir_locked_ret)
   1020 {
   1021 	struct vnode *tmpvn;		/* scratch vnode */
   1022 	struct vnode *foundobj;		/* result */
   1023 	struct lwp *l = curlwp;
   1024 	bool searchdir_locked = false;
   1025 	int error;
   1026 
   1027 	struct componentname *cnp = state->cnp;
   1028 	struct nameidata *ndp = state->ndp;
   1029 
   1030 	KASSERT(cnp == &ndp->ni_cnd);
   1031 	*newsearchdir_ret = searchdir;
   1032 
   1033 	/*
   1034 	 * Handle "..": two special cases.
   1035 	 * 1. If at root directory (e.g. after chroot)
   1036 	 *    or at absolute root directory
   1037 	 *    then ignore it so can't get out.
   1038 	 * 1a. If at the root of the emulation filesystem go to the real
   1039 	 *    root. So "/../<path>" is always absolute.
   1040 	 * 1b. If we have somehow gotten out of a jail, warn
   1041 	 *    and also ignore it so we can't get farther out.
   1042 	 * 2. If this vnode is the root of a mounted
   1043 	 *    filesystem, then replace it with the
   1044 	 *    vnode which was mounted on so we take the
   1045 	 *    .. in the other file system.
   1046 	 */
   1047 	if (cnp->cn_flags & ISDOTDOT) {
   1048 		struct proc *p = l->l_proc;
   1049 
   1050 		for (;;) {
   1051 			if (searchdir == ndp->ni_rootdir ||
   1052 			    searchdir == rootvnode) {
   1053 				foundobj = searchdir;
   1054 				vref(foundobj);
   1055 				*foundobj_ret = foundobj;
   1056 				error = 0;
   1057 				goto done;
   1058 			}
   1059 			if (ndp->ni_rootdir != rootvnode) {
   1060 				int retval;
   1061 
   1062 				retval = vn_isunder(searchdir, ndp->ni_rootdir, l);
   1063 				if (!retval) {
   1064 				    /* Oops! We got out of jail! */
   1065 				    log(LOG_WARNING,
   1066 					"chrooted pid %d uid %d (%s) "
   1067 					"detected outside of its chroot\n",
   1068 					p->p_pid, kauth_cred_geteuid(l->l_cred),
   1069 					p->p_comm);
   1070 				    /* Put us at the jail root. */
   1071 				    vrele(searchdir);
   1072 				    searchdir = NULL;
   1073 				    foundobj = ndp->ni_rootdir;
   1074 				    vref(foundobj);
   1075 				    vref(foundobj);
   1076 				    *newsearchdir_ret = foundobj;
   1077 				    *foundobj_ret = foundobj;
   1078 				    error = 0;
   1079 				    goto done;
   1080 				}
   1081 			}
   1082 			if ((searchdir->v_vflag & VV_ROOT) == 0 ||
   1083 			    (cnp->cn_flags & NOCROSSMOUNT))
   1084 				break;
   1085 			tmpvn = searchdir;
   1086 			searchdir = searchdir->v_mount->mnt_vnodecovered;
   1087 			vref(searchdir);
   1088 			vrele(tmpvn);
   1089 			*newsearchdir_ret = searchdir;
   1090 		}
   1091 	}
   1092 
   1093 	/*
   1094 	 * We now have a segment name to search for, and a directory to search.
   1095 	 * Our vnode state here is that "searchdir" is held.
   1096 	 */
   1097 unionlookup:
   1098 	foundobj = NULL;
   1099 	vn_lock(searchdir, LK_EXCLUSIVE | LK_RETRY);
   1100 	searchdir_locked = true;
   1101 	error = VOP_LOOKUP(searchdir, &foundobj, cnp);
   1102 
   1103 	if (error != 0) {
   1104 		KASSERTMSG((foundobj == NULL),
   1105 		    "leaf `%s' should be empty but is %p",
   1106 		    cnp->cn_nameptr, foundobj);
   1107 #ifdef NAMEI_DIAGNOSTIC
   1108 		printf("not found\n");
   1109 #endif /* NAMEI_DIAGNOSTIC */
   1110 		if ((error == ENOENT) &&
   1111 		    (searchdir->v_vflag & VV_ROOT) &&
   1112 		    (searchdir->v_mount->mnt_flag & MNT_UNION)) {
   1113 			tmpvn = searchdir;
   1114 			searchdir = searchdir->v_mount->mnt_vnodecovered;
   1115 			vref(searchdir);
   1116 			vput(tmpvn);
   1117 			searchdir_locked = false;
   1118 			*newsearchdir_ret = searchdir;
   1119 			goto unionlookup;
   1120 		}
   1121 
   1122 		if (error != EJUSTRETURN)
   1123 			goto done;
   1124 
   1125 		/*
   1126 		 * If this was not the last component, or there were trailing
   1127 		 * slashes, and we are not going to create a directory,
   1128 		 * then the name must exist.
   1129 		 */
   1130 		if ((cnp->cn_flags & (REQUIREDIR | CREATEDIR)) == REQUIREDIR) {
   1131 			error = ENOENT;
   1132 			goto done;
   1133 		}
   1134 
   1135 		/*
   1136 		 * If creating and at end of pathname, then can consider
   1137 		 * allowing file to be created.
   1138 		 */
   1139 		if (state->rdonly) {
   1140 			error = EROFS;
   1141 			goto done;
   1142 		}
   1143 
   1144 		/*
   1145 		 * We return success and a NULL foundobj to indicate
   1146 		 * that the entry doesn't currently exist, leaving a
   1147 		 * pointer to the (normally, locked) directory vnode
   1148 		 * as searchdir.
   1149 		 */
   1150 		*foundobj_ret = NULL;
   1151 		error = 0;
   1152 		goto done;
   1153 	}
   1154 #ifdef NAMEI_DIAGNOSTIC
   1155 	printf("found\n");
   1156 #endif /* NAMEI_DIAGNOSTIC */
   1157 
   1158 	/*
   1159 	 * Take into account any additional components consumed by the
   1160 	 * underlying filesystem.  This will include any trailing slashes after
   1161 	 * the last component consumed.
   1162 	 */
   1163 	if (cnp->cn_consume > 0) {
   1164 		ndp->ni_pathlen -= cnp->cn_consume - state->slashes;
   1165 		ndp->ni_next += cnp->cn_consume - state->slashes;
   1166 		cnp->cn_consume = 0;
   1167 		if (ndp->ni_next[0] == '\0')
   1168 			cnp->cn_flags |= ISLASTCN;
   1169 	}
   1170 
   1171 	/* Unlock, unless the caller needs the parent locked. */
   1172 	if (searchdir != NULL) {
   1173 		KASSERT(searchdir_locked);
   1174 		if ((cnp->cn_flags & (ISLASTCN | LOCKPARENT)) !=
   1175 		    (ISLASTCN | LOCKPARENT)) {
   1176 		    	VOP_UNLOCK(searchdir);
   1177 		    	searchdir_locked = false;
   1178 		}
   1179 	} else {
   1180 		KASSERT(!searchdir_locked);
   1181 	}
   1182 
   1183 	*foundobj_ret = foundobj;
   1184 	error = 0;
   1185 done:
   1186 	*newsearchdir_locked_ret = searchdir_locked;
   1187 	return error;
   1188 }
   1189 
   1190 /*
   1191  * Parse out the first path name component that we need to to consider.
   1192  *
   1193  * While doing this, attempt to use the name cache to fastforward through as
   1194  * many "easy" to find components of the path as possible.
   1195  *
   1196  * We use the namecache's node locks to form a chain, and avoid as many
   1197  * vnode references and locks as possible.  In the most ideal case, only the
   1198  * final vnode will have its reference count adjusted and lock taken.
   1199  */
   1200 static int
   1201 lookup_fastforward(struct namei_state *state, struct vnode **searchdir,
   1202 		   struct vnode **foundobj)
   1203 {
   1204 	struct componentname *cnp = state->cnp;
   1205 	struct nameidata *ndp = state->ndp;
   1206 	krwlock_t *plock;
   1207 	struct vnode *vp, *origsearchdir;
   1208 	int error, error2;
   1209 	size_t oldpathlen;
   1210 	const char *oldnameptr;
   1211 
   1212 	/*
   1213 	 * Eat as many path name components as possible before giving up and
   1214 	 * letting lookup_once() handle it.  Remember the starting point in
   1215 	 * case we can't get vnode references and need to roll back.
   1216 	 */
   1217 	plock = NULL;
   1218 	origsearchdir = *searchdir;
   1219 	oldnameptr = cnp->cn_nameptr;
   1220 	oldpathlen = ndp->ni_pathlen;
   1221 	for (;;) {
   1222 		/*
   1223 		 * Get the next component name.  There should be no slashes
   1224 		 * here, and we shouldn't have looped around if we were
   1225 		 * done.
   1226 		 */
   1227 		KASSERT(cnp->cn_nameptr[0] != '/');
   1228 		KASSERT(cnp->cn_nameptr[0] != '\0');
   1229 		if ((error = lookup_parsepath(state)) != 0) {
   1230 			break;
   1231 		}
   1232 
   1233 		/*
   1234 		 * Can't deal with dotdot lookups, because it means lock
   1235 		 * order reversal, and there are checks in lookup_once()
   1236 		 * that need to be made.  Also check for missing mountpoints
   1237 		 * (XXX racy).
   1238 		 */
   1239 		if ((cnp->cn_flags & ISDOTDOT) != 0 ||
   1240 		    (*searchdir)->v_mount == NULL) {
   1241 			error = EOPNOTSUPP;
   1242 			break;
   1243 		}
   1244 
   1245 		/*
   1246 		 * Can't deal with last component when modifying; this needs
   1247 		 * the directory vnode locked and VOP_LOOKUP() called (which
   1248 		 * can and does modify state, despite the name).
   1249 		 */
   1250 		if ((cnp->cn_flags & ISLASTCN) != 0) {
   1251 			if (cnp->cn_nameiop != LOOKUP ||
   1252 			    (cnp->cn_flags & LOCKPARENT) != 0) {
   1253 				error = EOPNOTSUPP;
   1254 				break;
   1255 			}
   1256 		}
   1257 
   1258 		/*
   1259 		 * Good, now look for it in cache.  cache_lookup_linked()
   1260 		 * will fail if there's nothing there, or if there's not
   1261 		 * ownership info for the directory, or if the user doesn't
   1262 		 * have permission to look up files in this directory.
   1263 		 */
   1264 		if (!cache_lookup_linked(*searchdir, cnp->cn_nameptr,
   1265 		    cnp->cn_namelen, &vp, &plock, cnp->cn_cred)) {
   1266 			error = EOPNOTSUPP;
   1267 			break;
   1268 		}
   1269 		KASSERT(plock != NULL && rw_lock_held(plock));
   1270 
   1271 		/* Scored a hit.  Negative is good too (ENOENT). */
   1272 		if (vp == NULL) {
   1273 			*foundobj = vp;
   1274 			error = ENOENT;
   1275 			break;
   1276 		}
   1277 
   1278 		/* Stop if we've reached the last component: get vnode. */
   1279 		if (cnp->cn_flags & ISLASTCN) {
   1280 			mutex_enter(vp->v_interlock);
   1281 			error = vcache_tryvget(vp);
   1282 			/* v_interlock now released */
   1283 			if (error == 0) {
   1284 				*foundobj = vp;
   1285 			}
   1286 			vp = NULL;
   1287 			break;
   1288 		}
   1289 
   1290 		/*
   1291 		 * Not the last component.  If we found something other than
   1292 		 * a directory, or it's a directory with a filesystem
   1293 		 * mounted on it, bail out.
   1294 		 */
   1295 		if (vp->v_type != VDIR || vp->v_mountedhere != NULL) {
   1296 			error = EOPNOTSUPP;
   1297 			vp = NULL;
   1298 			break;
   1299 		}
   1300 
   1301 		/*
   1302 		 * Otherwise, we're still in business.  Set the found VDIR
   1303 		 * vnode as the search dir for the next component and
   1304 		 * continue on to it.
   1305 		 */
   1306 		cnp->cn_nameptr = ndp->ni_next;
   1307 		*searchdir = vp;
   1308 	}
   1309 
   1310 	/*
   1311 	 * If we ended up with a new search dir, ref it before dropping the
   1312 	 * namecache's lock.  The lock prevents both searchdir and foundobj
   1313 	 * from disappearing.  If we can't ref the new searchdir, we have a
   1314 	 * bit of a problem.  Roll back the fastforward to the beginning and
   1315 	 * let lookup_once() take care of it.
   1316 	 */
   1317 	if (*searchdir != origsearchdir) {
   1318 		mutex_enter((*searchdir)->v_interlock);
   1319 		error2 = vcache_tryvget(*searchdir);
   1320 		/* v_interlock now unheld */
   1321 		if (plock != NULL) {
   1322 			rw_exit(plock);
   1323 		}
   1324 		if (__predict_true(error2 == 0)) {
   1325 			vrele(origsearchdir);
   1326 		} else {
   1327 			if (error == 0) {
   1328 				vrele_async(*foundobj);
   1329 				*foundobj = NULL;
   1330 			}
   1331 			*searchdir = origsearchdir;
   1332 			cnp->cn_nameptr = oldnameptr;
   1333 			ndp->ni_pathlen = oldpathlen;
   1334 			error = lookup_parsepath(state);
   1335 		}
   1336 	} else if (plock != NULL) {
   1337 		/* Drop any namecache lock still held. */
   1338 		rw_exit(plock);
   1339 	}
   1340 
   1341 	return error;
   1342 }
   1343 
   1344 //////////////////////////////
   1345 
   1346 /*
   1347  * Do a complete path search from a single root directory.
   1348  * (This is called up to twice if TRYEMULROOT is in effect.)
   1349  */
   1350 static int
   1351 namei_oneroot(struct namei_state *state,
   1352 	 int neverfollow, int inhibitmagic, int isnfsd)
   1353 {
   1354 	struct nameidata *ndp = state->ndp;
   1355 	struct componentname *cnp = state->cnp;
   1356 	struct vnode *searchdir, *foundobj;
   1357 	bool searchdir_locked = false;
   1358 	int error;
   1359 
   1360 	error = namei_start(state, isnfsd, &searchdir);
   1361 	if (error) {
   1362 		ndp->ni_dvp = NULL;
   1363 		ndp->ni_vp = NULL;
   1364 		return error;
   1365 	}
   1366 	KASSERT(searchdir->v_type == VDIR);
   1367 
   1368 	/*
   1369 	 * Setup: break out flag bits into variables.
   1370 	 */
   1371 	state->docache = (cnp->cn_flags & NOCACHE) ^ NOCACHE;
   1372 	if (cnp->cn_nameiop == DELETE)
   1373 		state->docache = 0;
   1374 	state->rdonly = cnp->cn_flags & RDONLY;
   1375 
   1376 	/*
   1377 	 * Keep going until we run out of path components.
   1378 	 */
   1379 	cnp->cn_nameptr = ndp->ni_pnbuf;
   1380 
   1381 	/* drop leading slashes (already used them to choose startdir) */
   1382 	while (cnp->cn_nameptr[0] == '/') {
   1383 		cnp->cn_nameptr++;
   1384 		ndp->ni_pathlen--;
   1385 	}
   1386 	/* was it just "/"? */
   1387 	if (cnp->cn_nameptr[0] == '\0') {
   1388 		foundobj = searchdir;
   1389 		searchdir = NULL;
   1390 		cnp->cn_flags |= ISLASTCN;
   1391 
   1392 		/* bleh */
   1393 		goto skiploop;
   1394 	}
   1395 
   1396 	for (;;) {
   1397 		KASSERT(searchdir != NULL);
   1398 		KASSERT(!searchdir_locked);
   1399 
   1400 		/*
   1401 		 * Parse out the first path name component that we need to
   1402 		 * to consider.  While doing this, attempt to use the name
   1403 		 * cache to fastforward through as many "easy" to find
   1404 		 * components of the path as possible.
   1405 		 */
   1406 		error = lookup_fastforward(state, &searchdir, &foundobj);
   1407 
   1408 		/*
   1409 		 * If we didn't get a good answer from the namecache, then
   1410 		 * go directly to the file system.
   1411 		 */
   1412 		if (error != 0 && error != ENOENT) {
   1413 			error = lookup_once(state, searchdir, &searchdir,
   1414 			    &foundobj, &searchdir_locked);
   1415 		}
   1416 
   1417 		/*
   1418 		 * If the vnode we found is mounted on, then cross the mount
   1419 		 * and get the root vnode in foundobj.  If this encounters
   1420 		 * an error, it will dispose of foundobj, but searchdir is
   1421 		 * untouched.
   1422 		 */
   1423 		if (error == 0 && foundobj != NULL &&
   1424 		    foundobj->v_type == VDIR &&
   1425 		    foundobj->v_mountedhere != NULL &&
   1426 		    (cnp->cn_flags & NOCROSSMOUNT) == 0) {
   1427 		    	error = lookup_crossmount(state, &searchdir,
   1428 		    	    &foundobj, searchdir_locked);
   1429 		}
   1430 
   1431 		if (error) {
   1432 			if (searchdir != NULL) {
   1433 				if (searchdir_locked) {
   1434 					searchdir_locked = false;
   1435 					vput(searchdir);
   1436 				} else {
   1437 					vrele(searchdir);
   1438 				}
   1439 			}
   1440 			ndp->ni_dvp = NULL;
   1441 			ndp->ni_vp = NULL;
   1442 			/*
   1443 			 * Note that if we're doing TRYEMULROOT we can
   1444 			 * retry with the normal root. Where this is
   1445 			 * currently set matches previous practice,
   1446 			 * but the previous practice didn't make much
   1447 			 * sense and somebody should sit down and
   1448 			 * figure out which cases should cause retry
   1449 			 * and which shouldn't. XXX.
   1450 			 */
   1451 			state->attempt_retry = 1;
   1452 			return (error);
   1453 		}
   1454 
   1455 		if (foundobj == NULL) {
   1456 			/*
   1457 			 * Success with no object returned means we're
   1458 			 * creating something and it isn't already
   1459 			 * there. Break out of the main loop now so
   1460 			 * the code below doesn't have to test for
   1461 			 * foundobj == NULL.
   1462 			 */
   1463 			/* lookup_once can't have dropped the searchdir */
   1464 			KASSERT(searchdir != NULL);
   1465 			break;
   1466 		}
   1467 
   1468 		/*
   1469 		 * Check for symbolic link. If we've reached one,
   1470 		 * follow it, unless we aren't supposed to. Back up
   1471 		 * over any slashes that we skipped, as we will need
   1472 		 * them again.
   1473 		 */
   1474 		if (namei_atsymlink(state, foundobj)) {
   1475 			/* Don't need searchdir locked any more. */
   1476 			if (searchdir_locked) {
   1477 				searchdir_locked = false;
   1478 				VOP_UNLOCK(searchdir);
   1479 			}
   1480 			ndp->ni_pathlen += state->slashes;
   1481 			ndp->ni_next -= state->slashes;
   1482 			if (neverfollow) {
   1483 				error = EINVAL;
   1484 			} else if (searchdir == NULL) {
   1485 				/*
   1486 				 * dholland 20160410: lookup_once only
   1487 				 * drops searchdir if it crossed a
   1488 				 * mount point. Therefore, if we get
   1489 				 * here it means we crossed a mount
   1490 				 * point to a mounted filesystem whose
   1491 				 * root vnode is a symlink. In theory
   1492 				 * we could continue at this point by
   1493 				 * using the pre-crossing searchdir
   1494 				 * (e.g. just take out an extra
   1495 				 * reference on it before calling
   1496 				 * lookup_once so we still have it),
   1497 				 * but this will make an ugly mess and
   1498 				 * it should never happen in practice
   1499 				 * as only badly broken filesystems
   1500 				 * have non-directory root vnodes. (I
   1501 				 * have seen this sort of thing with
   1502 				 * NFS occasionally but even then it
   1503 				 * means something's badly wrong.)
   1504 				 */
   1505 				error = ENOTDIR;
   1506 			} else {
   1507 				/*
   1508 				 * dholland 20110410: if we're at a
   1509 				 * union mount it might make sense to
   1510 				 * use the top of the union stack here
   1511 				 * rather than the layer we found the
   1512 				 * symlink in. (FUTURE)
   1513 				 */
   1514 				error = namei_follow(state, inhibitmagic,
   1515 						     searchdir, foundobj,
   1516 						     &searchdir);
   1517 			}
   1518 			if (error) {
   1519 				KASSERT(searchdir != foundobj);
   1520 				if (searchdir != NULL) {
   1521 					vrele(searchdir);
   1522 				}
   1523 				vrele(foundobj);
   1524 				ndp->ni_dvp = NULL;
   1525 				ndp->ni_vp = NULL;
   1526 				return error;
   1527 			}
   1528 			vrele(foundobj);
   1529 			foundobj = NULL;
   1530 
   1531 			/*
   1532 			 * If we followed a symlink to `/' and there
   1533 			 * are no more components after the symlink,
   1534 			 * we're done with the loop and what we found
   1535 			 * is the searchdir.
   1536 			 */
   1537 			if (cnp->cn_nameptr[0] == '\0') {
   1538 				KASSERT(searchdir != NULL);
   1539 				foundobj = searchdir;
   1540 				searchdir = NULL;
   1541 				cnp->cn_flags |= ISLASTCN;
   1542 				break;
   1543 			}
   1544 
   1545 			continue;
   1546 		}
   1547 
   1548 		/*
   1549 		 * Not a symbolic link.
   1550 		 *
   1551 		 * Check for directory, if the component was
   1552 		 * followed by a series of slashes.
   1553 		 */
   1554 		if ((foundobj->v_type != VDIR) &&
   1555 		    (cnp->cn_flags & REQUIREDIR)) {
   1556 			KASSERT(foundobj != searchdir);
   1557 			if (searchdir) {
   1558 				if (searchdir_locked) {
   1559 					searchdir_locked = false;
   1560 					vput(searchdir);
   1561 				} else {
   1562 					vrele(searchdir);
   1563 				}
   1564 			} else {
   1565 				KASSERT(!searchdir_locked);
   1566 			}
   1567 			vrele(foundobj);
   1568 			ndp->ni_dvp = NULL;
   1569 			ndp->ni_vp = NULL;
   1570 			state->attempt_retry = 1;
   1571 			return ENOTDIR;
   1572 		}
   1573 
   1574 		/*
   1575 		 * Stop if we've reached the last component.
   1576 		 */
   1577 		if (cnp->cn_flags & ISLASTCN) {
   1578 			break;
   1579 		}
   1580 
   1581 		/*
   1582 		 * Continue with the next component.
   1583 		 */
   1584 		cnp->cn_nameptr = ndp->ni_next;
   1585 		if (searchdir != NULL) {
   1586 			if (searchdir_locked) {
   1587 				searchdir_locked = false;
   1588 				vput(searchdir);
   1589 			} else {
   1590 				vrele(searchdir);
   1591 			}
   1592 		}
   1593 		searchdir = foundobj;
   1594 		foundobj = NULL;
   1595 	}
   1596 
   1597 	KASSERT((cnp->cn_flags & LOCKPARENT) == 0 || searchdir == NULL ||
   1598 	    VOP_ISLOCKED(searchdir) == LK_EXCLUSIVE);
   1599 
   1600  skiploop:
   1601 
   1602 	if (foundobj != NULL) {
   1603 		if (foundobj == ndp->ni_erootdir) {
   1604 			/*
   1605 			 * We are about to return the emulation root.
   1606 			 * This isn't a good idea because code might
   1607 			 * repeatedly lookup ".." until the file
   1608 			 * matches that returned for "/" and loop
   1609 			 * forever.  So convert it to the real root.
   1610 			 */
   1611 			if (searchdir != NULL) {
   1612 				if ((cnp->cn_flags & LOCKPARENT) != 0) {
   1613 					VOP_UNLOCK(searchdir);
   1614 				}
   1615 				vrele(searchdir);
   1616 				searchdir = NULL;
   1617 			}
   1618 			vrele(foundobj);
   1619 			foundobj = ndp->ni_rootdir;
   1620 			vref(foundobj);
   1621 		}
   1622 
   1623 		/*
   1624 		 * If the caller requested the parent node (i.e. it's
   1625 		 * a CREATE, DELETE, or RENAME), and we don't have one
   1626 		 * (because this is the root directory, or we crossed
   1627 		 * a mount point), then we must fail.
   1628 		 */
   1629 		if (cnp->cn_nameiop != LOOKUP &&
   1630 		    (searchdir == NULL ||
   1631 		     searchdir->v_mount != foundobj->v_mount)) {
   1632 			if (searchdir) {
   1633 				if ((cnp->cn_flags & LOCKPARENT) != 0) {
   1634 					VOP_UNLOCK(searchdir);
   1635 				}
   1636 				vrele(searchdir);
   1637 			}
   1638 			vrele(foundobj);
   1639 			foundobj = NULL;
   1640 			ndp->ni_dvp = NULL;
   1641 			ndp->ni_vp = NULL;
   1642 			state->attempt_retry = 1;
   1643 
   1644 			switch (cnp->cn_nameiop) {
   1645 			    case CREATE:
   1646 				return EEXIST;
   1647 			    case DELETE:
   1648 			    case RENAME:
   1649 				return EBUSY;
   1650 			    default:
   1651 				break;
   1652 			}
   1653 			panic("Invalid nameiop\n");
   1654 		}
   1655 
   1656 		/*
   1657 		 * Disallow directory write attempts on read-only lookups.
   1658 		 * Prefers EEXIST over EROFS for the CREATE case.
   1659 		 */
   1660 		if (state->rdonly &&
   1661 		    (cnp->cn_nameiop == DELETE || cnp->cn_nameiop == RENAME)) {
   1662 			if (searchdir) {
   1663 				if ((cnp->cn_flags & LOCKPARENT) != 0) {
   1664 					VOP_UNLOCK(searchdir);
   1665 				}
   1666 				vrele(searchdir);
   1667 				searchdir = NULL;
   1668 			}
   1669 			vrele(foundobj);
   1670 			foundobj = NULL;
   1671 			ndp->ni_dvp = NULL;
   1672 			ndp->ni_vp = NULL;
   1673 			state->attempt_retry = 1;
   1674 			return EROFS;
   1675 		}
   1676 
   1677 		/* Lock the leaf node if requested. */
   1678 		if ((cnp->cn_flags & (LOCKLEAF | LOCKPARENT)) == LOCKPARENT &&
   1679 		    searchdir == foundobj) {
   1680 			/*
   1681 			 * Note: if LOCKPARENT but not LOCKLEAF is
   1682 			 * set, and searchdir == foundobj, this code
   1683 			 * necessarily unlocks the parent as well as
   1684 			 * the leaf. That is, just because you specify
   1685 			 * LOCKPARENT doesn't mean you necessarily get
   1686 			 * a locked parent vnode. The code in
   1687 			 * vfs_syscalls.c, and possibly elsewhere,
   1688 			 * that uses this combination "knows" this, so
   1689 			 * it can't be safely changed. Feh. XXX
   1690 			 */
   1691 		    	VOP_UNLOCK(searchdir);
   1692 		} else if ((cnp->cn_flags & LOCKLEAF) != 0 &&
   1693 		    (searchdir != foundobj ||
   1694 		    (cnp->cn_flags & LOCKPARENT) == 0)) {
   1695 			vn_lock(foundobj, LK_EXCLUSIVE | LK_RETRY);
   1696 		}
   1697 	}
   1698 
   1699 	/*
   1700 	 * Done.
   1701 	 */
   1702 
   1703 	/*
   1704 	 * If LOCKPARENT is not set, the parent directory isn't returned.
   1705 	 */
   1706 	if ((cnp->cn_flags & LOCKPARENT) == 0 && searchdir != NULL) {
   1707 		vrele(searchdir);
   1708 		searchdir = NULL;
   1709 	}
   1710 
   1711 	ndp->ni_dvp = searchdir;
   1712 	ndp->ni_vp = foundobj;
   1713 	return 0;
   1714 }
   1715 
   1716 /*
   1717  * Do namei; wrapper layer that handles TRYEMULROOT.
   1718  */
   1719 static int
   1720 namei_tryemulroot(struct namei_state *state,
   1721 	 int neverfollow, int inhibitmagic, int isnfsd)
   1722 {
   1723 	int error;
   1724 
   1725 	struct nameidata *ndp = state->ndp;
   1726 	struct componentname *cnp = state->cnp;
   1727 	const char *savepath = NULL;
   1728 
   1729 	KASSERT(cnp == &ndp->ni_cnd);
   1730 
   1731 	if (cnp->cn_flags & TRYEMULROOT) {
   1732 		savepath = pathbuf_stringcopy_get(ndp->ni_pathbuf);
   1733 	}
   1734 
   1735     emul_retry:
   1736 	state->attempt_retry = 0;
   1737 
   1738 	error = namei_oneroot(state, neverfollow, inhibitmagic, isnfsd);
   1739 	if (error) {
   1740 		/*
   1741 		 * Once namei has started up, the existence of ni_erootdir
   1742 		 * tells us whether we're working from an emulation root.
   1743 		 * The TRYEMULROOT flag isn't necessarily authoritative.
   1744 		 */
   1745 		if (ndp->ni_erootdir != NULL && state->attempt_retry) {
   1746 			/* Retry the whole thing using the normal root */
   1747 			cnp->cn_flags &= ~TRYEMULROOT;
   1748 			state->attempt_retry = 0;
   1749 
   1750 			/* kinda gross */
   1751 			strcpy(ndp->ni_pathbuf->pb_path, savepath);
   1752 			pathbuf_stringcopy_put(ndp->ni_pathbuf, savepath);
   1753 			savepath = NULL;
   1754 
   1755 			goto emul_retry;
   1756 		}
   1757 	}
   1758 	if (savepath != NULL) {
   1759 		pathbuf_stringcopy_put(ndp->ni_pathbuf, savepath);
   1760 	}
   1761 	return error;
   1762 }
   1763 
   1764 /*
   1765  * External interface.
   1766  */
   1767 int
   1768 namei(struct nameidata *ndp)
   1769 {
   1770 	struct namei_state state;
   1771 	int error;
   1772 
   1773 	namei_init(&state, ndp);
   1774 	error = namei_tryemulroot(&state,
   1775 				  0/*!neverfollow*/, 0/*!inhibitmagic*/,
   1776 				  0/*isnfsd*/);
   1777 	namei_cleanup(&state);
   1778 
   1779 	if (error) {
   1780 		/* make sure no stray refs leak out */
   1781 		KASSERT(ndp->ni_dvp == NULL);
   1782 		KASSERT(ndp->ni_vp == NULL);
   1783 	}
   1784 
   1785 	return error;
   1786 }
   1787 
   1788 ////////////////////////////////////////////////////////////
   1789 
   1790 /*
   1791  * External interface used by nfsd. This is basically different from
   1792  * namei only in that it has the ability to pass in the "current
   1793  * directory", and uses an extra flag "neverfollow" for which there's
   1794  * no physical flag defined in namei.h. (There used to be a cut&paste
   1795  * copy of about half of namei in nfsd to allow these minor
   1796  * adjustments to exist.)
   1797  *
   1798  * XXX: the namei interface should be adjusted so nfsd can just use
   1799  * ordinary namei().
   1800  */
   1801 int
   1802 lookup_for_nfsd(struct nameidata *ndp, struct vnode *forcecwd, int neverfollow)
   1803 {
   1804 	struct namei_state state;
   1805 	int error;
   1806 
   1807 	KASSERT(ndp->ni_atdir == NULL);
   1808 	ndp->ni_atdir = forcecwd;
   1809 
   1810 	namei_init(&state, ndp);
   1811 	error = namei_tryemulroot(&state,
   1812 				  neverfollow, 1/*inhibitmagic*/, 1/*isnfsd*/);
   1813 	namei_cleanup(&state);
   1814 
   1815 	if (error) {
   1816 		/* make sure no stray refs leak out */
   1817 		KASSERT(ndp->ni_dvp == NULL);
   1818 		KASSERT(ndp->ni_vp == NULL);
   1819 	}
   1820 
   1821 	return error;
   1822 }
   1823 
   1824 /*
   1825  * A second external interface used by nfsd. This turns out to be a
   1826  * single lookup used by the WebNFS code (ha!) to get "index.html" or
   1827  * equivalent when asked for a directory. It should eventually evolve
   1828  * into some kind of namei_once() call; for the time being it's kind
   1829  * of a mess. XXX.
   1830  *
   1831  * dholland 20110109: I don't think it works, and I don't think it
   1832  * worked before I started hacking and slashing either, and I doubt
   1833  * anyone will ever notice.
   1834  */
   1835 
   1836 /*
   1837  * Internals. This calls lookup_once() after setting up the assorted
   1838  * pieces of state the way they ought to be.
   1839  */
   1840 static int
   1841 do_lookup_for_nfsd_index(struct namei_state *state)
   1842 {
   1843 	int error = 0;
   1844 	struct componentname *cnp = state->cnp;
   1845 	struct nameidata *ndp = state->ndp;
   1846 	struct vnode *startdir;
   1847 	struct vnode *foundobj;
   1848 	bool startdir_locked;
   1849 	const char *cp;			/* pointer into pathname argument */
   1850 
   1851 	KASSERT(cnp == &ndp->ni_cnd);
   1852 
   1853 	startdir = state->ndp->ni_atdir;
   1854 
   1855 	cnp->cn_nameptr = ndp->ni_pnbuf;
   1856 	state->docache = 1;
   1857 	state->rdonly = cnp->cn_flags & RDONLY;
   1858 	ndp->ni_dvp = NULL;
   1859 
   1860 	cnp->cn_consume = 0;
   1861 	cnp->cn_namelen = namei_getcomponent(cnp->cn_nameptr);
   1862 	cp = cnp->cn_nameptr + cnp->cn_namelen;
   1863 	KASSERT(cnp->cn_namelen <= KERNEL_NAME_MAX);
   1864 	ndp->ni_pathlen -= cnp->cn_namelen;
   1865 	ndp->ni_next = cp;
   1866 	state->slashes = 0;
   1867 	cnp->cn_flags &= ~REQUIREDIR;
   1868 	cnp->cn_flags |= MAKEENTRY|ISLASTCN;
   1869 
   1870 	if (cnp->cn_namelen == 2 &&
   1871 	    cnp->cn_nameptr[1] == '.' && cnp->cn_nameptr[0] == '.')
   1872 		cnp->cn_flags |= ISDOTDOT;
   1873 	else
   1874 		cnp->cn_flags &= ~ISDOTDOT;
   1875 
   1876 	/*
   1877 	 * Because lookup_once can change the startdir, we need our
   1878 	 * own reference to it to avoid consuming the caller's.
   1879 	 */
   1880 	vref(startdir);
   1881 	error = lookup_once(state, startdir, &startdir, &foundobj,
   1882 	    &startdir_locked);
   1883 	KASSERT(!startdir_locked);
   1884 	if (error == 0 && startdir == foundobj) {
   1885 		vrele(startdir);
   1886 	} else if (startdir != NULL) {
   1887 		if (startdir_locked) {
   1888 			vput(startdir);
   1889 		} else {
   1890 			vrele(startdir);
   1891 		}
   1892 	}
   1893 	if (error) {
   1894 		goto bad;
   1895 	}
   1896 	ndp->ni_vp = foundobj;
   1897 
   1898 	if (foundobj == NULL) {
   1899 		return 0;
   1900 	}
   1901 
   1902 	if ((cnp->cn_flags & LOCKLEAF) != 0) {
   1903 		vn_lock(foundobj, LK_EXCLUSIVE | LK_RETRY);
   1904 	}
   1905 	return (0);
   1906 
   1907 bad:
   1908 	ndp->ni_vp = NULL;
   1909 	return (error);
   1910 }
   1911 
   1912 /*
   1913  * External interface. The partitioning between this function and the
   1914  * above isn't very clear - the above function exists mostly so code
   1915  * that uses "state->" can be shuffled around without having to change
   1916  * it to "state.".
   1917  */
   1918 int
   1919 lookup_for_nfsd_index(struct nameidata *ndp, struct vnode *startdir)
   1920 {
   1921 	struct namei_state state;
   1922 	int error;
   1923 
   1924 	KASSERT(ndp->ni_atdir == NULL);
   1925 	ndp->ni_atdir = startdir;
   1926 
   1927 	/*
   1928 	 * Note: the name sent in here (is not|should not be) allowed
   1929 	 * to contain a slash.
   1930 	 */
   1931 	if (strlen(ndp->ni_pathbuf->pb_path) > KERNEL_NAME_MAX) {
   1932 		return ENAMETOOLONG;
   1933 	}
   1934 	if (strchr(ndp->ni_pathbuf->pb_path, '/')) {
   1935 		return EINVAL;
   1936 	}
   1937 
   1938 	ndp->ni_pathlen = strlen(ndp->ni_pathbuf->pb_path) + 1;
   1939 	ndp->ni_pnbuf = NULL;
   1940 	ndp->ni_cnd.cn_nameptr = NULL;
   1941 
   1942 	namei_init(&state, ndp);
   1943 	error = do_lookup_for_nfsd_index(&state);
   1944 	namei_cleanup(&state);
   1945 
   1946 	return error;
   1947 }
   1948 
   1949 ////////////////////////////////////////////////////////////
   1950 
   1951 /*
   1952  * Reacquire a path name component.
   1953  * dvp is locked on entry and exit.
   1954  * *vpp is locked on exit unless it's NULL.
   1955  */
   1956 int
   1957 relookup(struct vnode *dvp, struct vnode **vpp, struct componentname *cnp, int dummy)
   1958 {
   1959 	int rdonly;			/* lookup read-only flag bit */
   1960 	int error = 0;
   1961 #ifdef DEBUG
   1962 	size_t newlen;			/* DEBUG: check name len */
   1963 	const char *cp;			/* DEBUG: check name ptr */
   1964 #endif /* DEBUG */
   1965 
   1966 	(void)dummy;
   1967 
   1968 	/*
   1969 	 * Setup: break out flag bits into variables.
   1970 	 */
   1971 	rdonly = cnp->cn_flags & RDONLY;
   1972 
   1973 	/*
   1974 	 * Search a new directory.
   1975 	 *
   1976 	 * The cn_hash value is for use by vfs_cache.
   1977 	 * The last component of the filename is left accessible via
   1978 	 * cnp->cn_nameptr for callers that need the name. Callers needing
   1979 	 * the name set the SAVENAME flag. When done, they assume
   1980 	 * responsibility for freeing the pathname buffer.
   1981 	 */
   1982 #ifdef DEBUG
   1983 #if 0
   1984 	cp = NULL;
   1985 	newhash = namei_hash(cnp->cn_nameptr, &cp);
   1986 	if ((uint32_t)newhash != (uint32_t)cnp->cn_hash)
   1987 		panic("relookup: bad hash");
   1988 #endif
   1989 	newlen = namei_getcomponent(cnp->cn_nameptr);
   1990 	if (cnp->cn_namelen != newlen)
   1991 		panic("relookup: bad len");
   1992 	cp = cnp->cn_nameptr + cnp->cn_namelen;
   1993 	while (*cp == '/')
   1994 		cp++;
   1995 	if (*cp != 0)
   1996 		panic("relookup: not last component");
   1997 #endif /* DEBUG */
   1998 
   1999 	/*
   2000 	 * Check for degenerate name (e.g. / or "")
   2001 	 * which is a way of talking about a directory,
   2002 	 * e.g. like "/." or ".".
   2003 	 */
   2004 	if (cnp->cn_nameptr[0] == '\0')
   2005 		panic("relookup: null name");
   2006 
   2007 	if (cnp->cn_flags & ISDOTDOT)
   2008 		panic("relookup: lookup on dot-dot");
   2009 
   2010 	/*
   2011 	 * We now have a segment name to search for, and a directory to search.
   2012 	 */
   2013 	*vpp = NULL;
   2014 	error = VOP_LOOKUP(dvp, vpp, cnp);
   2015 	if ((error) != 0) {
   2016 		KASSERTMSG((*vpp == NULL),
   2017 		    "leaf `%s' should be empty but is %p",
   2018 		    cnp->cn_nameptr, *vpp);
   2019 		if (error != EJUSTRETURN)
   2020 			goto bad;
   2021 	}
   2022 
   2023 	/*
   2024 	 * Check for symbolic link
   2025 	 */
   2026 	KASSERTMSG((*vpp == NULL || (*vpp)->v_type != VLNK ||
   2027 		(cnp->cn_flags & FOLLOW) == 0),
   2028 	    "relookup: symlink found");
   2029 
   2030 	/*
   2031 	 * Check for read-only lookups.
   2032 	 */
   2033 	if (rdonly && cnp->cn_nameiop != LOOKUP) {
   2034 		error = EROFS;
   2035 		if (*vpp) {
   2036 			vrele(*vpp);
   2037 		}
   2038 		goto bad;
   2039 	}
   2040 	/*
   2041 	 * Lock result.
   2042 	 */
   2043 	if (*vpp && *vpp != dvp) {
   2044 		error = vn_lock(*vpp, LK_EXCLUSIVE);
   2045 		if (error != 0) {
   2046 			vrele(*vpp);
   2047 			goto bad;
   2048 		}
   2049 	}
   2050 	return (0);
   2051 
   2052 bad:
   2053 	*vpp = NULL;
   2054 	return (error);
   2055 }
   2056 
   2057 /*
   2058  * namei_simple - simple forms of namei.
   2059  *
   2060  * These are wrappers to allow the simple case callers of namei to be
   2061  * left alone while everything else changes under them.
   2062  */
   2063 
   2064 /* Flags */
   2065 struct namei_simple_flags_type {
   2066 	int dummy;
   2067 };
   2068 static const struct namei_simple_flags_type ns_nn, ns_nt, ns_fn, ns_ft;
   2069 const namei_simple_flags_t NSM_NOFOLLOW_NOEMULROOT = &ns_nn;
   2070 const namei_simple_flags_t NSM_NOFOLLOW_TRYEMULROOT = &ns_nt;
   2071 const namei_simple_flags_t NSM_FOLLOW_NOEMULROOT = &ns_fn;
   2072 const namei_simple_flags_t NSM_FOLLOW_TRYEMULROOT = &ns_ft;
   2073 
   2074 static
   2075 int
   2076 namei_simple_convert_flags(namei_simple_flags_t sflags)
   2077 {
   2078 	if (sflags == NSM_NOFOLLOW_NOEMULROOT)
   2079 		return NOFOLLOW | 0;
   2080 	if (sflags == NSM_NOFOLLOW_TRYEMULROOT)
   2081 		return NOFOLLOW | TRYEMULROOT;
   2082 	if (sflags == NSM_FOLLOW_NOEMULROOT)
   2083 		return FOLLOW | 0;
   2084 	if (sflags == NSM_FOLLOW_TRYEMULROOT)
   2085 		return FOLLOW | TRYEMULROOT;
   2086 	panic("namei_simple_convert_flags: bogus sflags\n");
   2087 	return 0;
   2088 }
   2089 
   2090 int
   2091 namei_simple_kernel(const char *path, namei_simple_flags_t sflags,
   2092 	struct vnode **vp_ret)
   2093 {
   2094 	return nameiat_simple_kernel(NULL, path, sflags, vp_ret);
   2095 }
   2096 
   2097 int
   2098 nameiat_simple_kernel(struct vnode *dvp, const char *path,
   2099 	namei_simple_flags_t sflags, struct vnode **vp_ret)
   2100 {
   2101 	struct nameidata nd;
   2102 	struct pathbuf *pb;
   2103 	int err;
   2104 
   2105 	pb = pathbuf_create(path);
   2106 	if (pb == NULL) {
   2107 		return ENOMEM;
   2108 	}
   2109 
   2110 	NDINIT(&nd,
   2111 		LOOKUP,
   2112 		namei_simple_convert_flags(sflags),
   2113 		pb);
   2114 
   2115 	if (dvp != NULL)
   2116 		NDAT(&nd, dvp);
   2117 
   2118 	err = namei(&nd);
   2119 	if (err != 0) {
   2120 		pathbuf_destroy(pb);
   2121 		return err;
   2122 	}
   2123 	*vp_ret = nd.ni_vp;
   2124 	pathbuf_destroy(pb);
   2125 	return 0;
   2126 }
   2127 
   2128 int
   2129 namei_simple_user(const char *path, namei_simple_flags_t sflags,
   2130 	struct vnode **vp_ret)
   2131 {
   2132 	return nameiat_simple_user(NULL, path, sflags, vp_ret);
   2133 }
   2134 
   2135 int
   2136 nameiat_simple_user(struct vnode *dvp, const char *path,
   2137 	namei_simple_flags_t sflags, struct vnode **vp_ret)
   2138 {
   2139 	struct pathbuf *pb;
   2140 	struct nameidata nd;
   2141 	int err;
   2142 
   2143 	err = pathbuf_copyin(path, &pb);
   2144 	if (err) {
   2145 		return err;
   2146 	}
   2147 
   2148 	NDINIT(&nd,
   2149 		LOOKUP,
   2150 		namei_simple_convert_flags(sflags),
   2151 		pb);
   2152 
   2153 	if (dvp != NULL)
   2154 		NDAT(&nd, dvp);
   2155 
   2156 	err = namei(&nd);
   2157 	if (err != 0) {
   2158 		pathbuf_destroy(pb);
   2159 		return err;
   2160 	}
   2161 	*vp_ret = nd.ni_vp;
   2162 	pathbuf_destroy(pb);
   2163 	return 0;
   2164 }
   2165