xref: /freebsd/sys/kern/vfs_lookup.c (revision 77a0943ded95b9e6438f7db70c4a28e4d93946d4)
1 /*
2  * Copyright (c) 1982, 1986, 1989, 1993
3  *	The Regents of the University of California.  All rights reserved.
4  * (c) UNIX System Laboratories, Inc.
5  * All or some portions of this file are derived from material licensed
6  * to the University of California by American Telephone and Telegraph
7  * Co. or Unix System Laboratories, Inc. and are reproduced herein with
8  * the permission of UNIX System Laboratories, Inc.
9  *
10  * Redistribution and use in source and binary forms, with or without
11  * modification, are permitted provided that the following conditions
12  * are met:
13  * 1. Redistributions of source code must retain the above copyright
14  *    notice, this list of conditions and the following disclaimer.
15  * 2. Redistributions in binary form must reproduce the above copyright
16  *    notice, this list of conditions and the following disclaimer in the
17  *    documentation and/or other materials provided with the distribution.
18  * 3. All advertising materials mentioning features or use of this software
19  *    must display the following acknowledgement:
20  *	This product includes software developed by the University of
21  *	California, Berkeley and its contributors.
22  * 4. Neither the name of the University nor the names of its contributors
23  *    may be used to endorse or promote products derived from this software
24  *    without specific prior written permission.
25  *
26  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
27  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
28  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
29  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
30  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
31  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
32  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
33  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
34  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
35  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
36  * SUCH DAMAGE.
37  *
38  *	@(#)vfs_lookup.c	8.4 (Berkeley) 2/16/94
39  * $FreeBSD$
40  */
41 
42 #include "opt_ktrace.h"
43 
44 #include <sys/param.h>
45 #include <sys/systm.h>
46 #include <sys/namei.h>
47 #include <sys/vnode.h>
48 #include <sys/mount.h>
49 #include <sys/filedesc.h>
50 #include <sys/proc.h>
51 
52 #ifdef KTRACE
53 #include <sys/ktrace.h>
54 #endif
55 
56 #include <vm/vm_zone.h>
57 
58 /*
59  * Convert a pathname into a pointer to a locked inode.
60  *
61  * The FOLLOW flag is set when symbolic links are to be followed
62  * when they occur at the end of the name translation process.
63  * Symbolic links are always followed for all other pathname
64  * components other than the last.
65  *
66  * The segflg defines whether the name is to be copied from user
67  * space or kernel space.
68  *
69  * Overall outline of namei:
70  *
71  *	copy in name
72  *	get starting directory
73  *	while (!done && !error) {
74  *		call lookup to search path.
75  *		if symbolic link, massage name in buffer and continue
76  *	}
77  */
78 int
79 namei(ndp)
80 	register struct nameidata *ndp;
81 {
82 	register struct filedesc *fdp;	/* pointer to file descriptor state */
83 	register char *cp;		/* pointer into pathname argument */
84 	register struct vnode *dp;	/* the directory we are searching */
85 	struct iovec aiov;		/* uio for reading symbolic links */
86 	struct uio auio;
87 	int error, linklen;
88 	struct componentname *cnp = &ndp->ni_cnd;
89 	struct proc *p = cnp->cn_proc;
90 
91 	ndp->ni_cnd.cn_cred = ndp->ni_cnd.cn_proc->p_ucred;
92 	KASSERT(cnp->cn_cred && cnp->cn_proc, ("namei: bad cred/proc"));
93 	KASSERT((cnp->cn_nameiop & (~OPMASK)) == 0,
94 	    ("namei: nameiop contaminated with flags"));
95 	KASSERT((cnp->cn_flags & OPMASK) == 0,
96 	    ("namei: flags contaminated with nameiops"));
97 	fdp = cnp->cn_proc->p_fd;
98 
99 	/*
100 	 * Get a buffer for the name to be translated, and copy the
101 	 * name into the buffer.
102 	 */
103 	if ((cnp->cn_flags & HASBUF) == 0)
104 		cnp->cn_pnbuf = zalloc(namei_zone);
105 	if (ndp->ni_segflg == UIO_SYSSPACE)
106 		error = copystr(ndp->ni_dirp, cnp->cn_pnbuf,
107 			    MAXPATHLEN, (size_t *)&ndp->ni_pathlen);
108 	else
109 		error = copyinstr(ndp->ni_dirp, cnp->cn_pnbuf,
110 			    MAXPATHLEN, (size_t *)&ndp->ni_pathlen);
111 
112 	/*
113 	 * Don't allow empty pathnames.
114 	 */
115 	if (!error && *cnp->cn_pnbuf == '\0')
116 		error = ENOENT;
117 
118 	if (error) {
119 		zfree(namei_zone, cnp->cn_pnbuf);
120 		ndp->ni_vp = NULL;
121 		return (error);
122 	}
123 	ndp->ni_loopcnt = 0;
124 #ifdef KTRACE
125 	if (KTRPOINT(cnp->cn_proc, KTR_NAMEI))
126 		ktrnamei(cnp->cn_proc->p_tracep, cnp->cn_pnbuf);
127 #endif
128 
129 	/*
130 	 * Get starting point for the translation.
131 	 */
132 	ndp->ni_rootdir = fdp->fd_rdir;
133 	ndp->ni_topdir = fdp->fd_jdir;
134 
135 	dp = fdp->fd_cdir;
136 	VREF(dp);
137 	for (;;) {
138 		/*
139 		 * Check if root directory should replace current directory.
140 		 * Done at start of translation and after symbolic link.
141 		 */
142 		cnp->cn_nameptr = cnp->cn_pnbuf;
143 		if (*(cnp->cn_nameptr) == '/') {
144 			vrele(dp);
145 			while (*(cnp->cn_nameptr) == '/') {
146 				cnp->cn_nameptr++;
147 				ndp->ni_pathlen--;
148 			}
149 			dp = ndp->ni_rootdir;
150 			VREF(dp);
151 		}
152 		ndp->ni_startdir = dp;
153 		error = lookup(ndp);
154 		if (error) {
155 			zfree(namei_zone, cnp->cn_pnbuf);
156 			return (error);
157 		}
158 		/*
159 		 * Check for symbolic link
160 		 */
161 		if ((cnp->cn_flags & ISSYMLINK) == 0) {
162 			if ((cnp->cn_flags & (SAVENAME | SAVESTART)) == 0)
163 				zfree(namei_zone, cnp->cn_pnbuf);
164 			else
165 				cnp->cn_flags |= HASBUF;
166 
167 			if (vn_canvmio(ndp->ni_vp) == TRUE &&
168 				(cnp->cn_nameiop != DELETE) &&
169 				((cnp->cn_flags & (NOOBJ|LOCKLEAF)) ==
170 				 LOCKLEAF))
171 				vfs_object_create(ndp->ni_vp,
172 					ndp->ni_cnd.cn_proc,
173 					ndp->ni_cnd.cn_cred);
174 
175 			return (0);
176 		}
177 		if ((cnp->cn_flags & LOCKPARENT) && ndp->ni_pathlen == 1)
178 			VOP_UNLOCK(ndp->ni_dvp, 0, p);
179 		if (ndp->ni_loopcnt++ >= MAXSYMLINKS) {
180 			error = ELOOP;
181 			break;
182 		}
183 		if (ndp->ni_pathlen > 1)
184 			cp = zalloc(namei_zone);
185 		else
186 			cp = cnp->cn_pnbuf;
187 		aiov.iov_base = cp;
188 		aiov.iov_len = MAXPATHLEN;
189 		auio.uio_iov = &aiov;
190 		auio.uio_iovcnt = 1;
191 		auio.uio_offset = 0;
192 		auio.uio_rw = UIO_READ;
193 		auio.uio_segflg = UIO_SYSSPACE;
194 		auio.uio_procp = (struct proc *)0;
195 		auio.uio_resid = MAXPATHLEN;
196 		error = VOP_READLINK(ndp->ni_vp, &auio, cnp->cn_cred);
197 		if (error) {
198 			if (ndp->ni_pathlen > 1)
199 				zfree(namei_zone, cp);
200 			break;
201 		}
202 		linklen = MAXPATHLEN - auio.uio_resid;
203 		if (linklen + ndp->ni_pathlen >= MAXPATHLEN) {
204 			if (ndp->ni_pathlen > 1)
205 				zfree(namei_zone, cp);
206 			error = ENAMETOOLONG;
207 			break;
208 		}
209 		if (ndp->ni_pathlen > 1) {
210 			bcopy(ndp->ni_next, cp + linklen, ndp->ni_pathlen);
211 			zfree(namei_zone, cnp->cn_pnbuf);
212 			cnp->cn_pnbuf = cp;
213 		} else
214 			cnp->cn_pnbuf[linklen] = '\0';
215 		ndp->ni_pathlen += linklen;
216 		vput(ndp->ni_vp);
217 		dp = ndp->ni_dvp;
218 	}
219 	zfree(namei_zone, cnp->cn_pnbuf);
220 	vrele(ndp->ni_dvp);
221 	vput(ndp->ni_vp);
222 	ndp->ni_vp = NULL;
223 	return (error);
224 }
225 
226 /*
227  * Search a pathname.
228  * This is a very central and rather complicated routine.
229  *
230  * The pathname is pointed to by ni_ptr and is of length ni_pathlen.
231  * The starting directory is taken from ni_startdir. The pathname is
232  * descended until done, or a symbolic link is encountered. The variable
233  * ni_more is clear if the path is completed; it is set to one if a
234  * symbolic link needing interpretation is encountered.
235  *
236  * The flag argument is LOOKUP, CREATE, RENAME, or DELETE depending on
237  * whether the name is to be looked up, created, renamed, or deleted.
238  * When CREATE, RENAME, or DELETE is specified, information usable in
239  * creating, renaming, or deleting a directory entry may be calculated.
240  * If flag has LOCKPARENT or'ed into it, the parent directory is returned
241  * locked. If flag has WANTPARENT or'ed into it, the parent directory is
242  * returned unlocked. Otherwise the parent directory is not returned. If
243  * the target of the pathname exists and LOCKLEAF is or'ed into the flag
244  * the target is returned locked, otherwise it is returned unlocked.
245  * When creating or renaming and LOCKPARENT is specified, the target may not
246  * be ".".  When deleting and LOCKPARENT is specified, the target may be ".".
247  *
248  * Overall outline of lookup:
249  *
250  * dirloop:
251  *	identify next component of name at ndp->ni_ptr
252  *	handle degenerate case where name is null string
253  *	if .. and crossing mount points and on mounted filesys, find parent
254  *	call VOP_LOOKUP routine for next component name
255  *	    directory vnode returned in ni_dvp, unlocked unless LOCKPARENT set
256  *	    component vnode returned in ni_vp (if it exists), locked.
257  *	if result vnode is mounted on and crossing mount points,
258  *	    find mounted on vnode
259  *	if more components of name, do next level at dirloop
260  *	return the answer in ni_vp, locked if LOCKLEAF set
261  *	    if LOCKPARENT set, return locked parent in ni_dvp
262  *	    if WANTPARENT set, return unlocked parent in ni_dvp
263  */
264 int
265 lookup(ndp)
266 	register struct nameidata *ndp;
267 {
268 	register char *cp;		/* pointer into pathname argument */
269 	register struct vnode *dp = 0;	/* the directory we are searching */
270 	struct vnode *tdp;		/* saved dp */
271 	struct mount *mp;		/* mount table entry */
272 	int docache;			/* == 0 do not cache last component */
273 	int wantparent;			/* 1 => wantparent or lockparent flag */
274 	int rdonly;			/* lookup read-only flag bit */
275 	int trailing_slash;
276 	int error = 0;
277 	int dpunlocked = 0;		/* dp has already been unlocked */
278 	struct componentname *cnp = &ndp->ni_cnd;
279 	struct proc *p = cnp->cn_proc;
280 
281 	/*
282 	 * Setup: break out flag bits into variables.
283 	 */
284 	wantparent = cnp->cn_flags & (LOCKPARENT | WANTPARENT);
285 	docache = (cnp->cn_flags & NOCACHE) ^ NOCACHE;
286 	if (cnp->cn_nameiop == DELETE ||
287 	    (wantparent && cnp->cn_nameiop != CREATE &&
288 	     cnp->cn_nameiop != LOOKUP))
289 		docache = 0;
290 	rdonly = cnp->cn_flags & RDONLY;
291 	ndp->ni_dvp = NULL;
292 	cnp->cn_flags &= ~ISSYMLINK;
293 	dp = ndp->ni_startdir;
294 	ndp->ni_startdir = NULLVP;
295 	vn_lock(dp, LK_EXCLUSIVE | LK_RETRY, p);
296 
297 dirloop:
298 	/*
299 	 * Search a new directory.
300 	 *
301 	 * The last component of the filename is left accessible via
302 	 * cnp->cn_nameptr for callers that need the name. Callers needing
303 	 * the name set the SAVENAME flag. When done, they assume
304 	 * responsibility for freeing the pathname buffer.
305 	 */
306 	cnp->cn_consume = 0;
307 	for (cp = cnp->cn_nameptr; *cp != 0 && *cp != '/'; cp++)
308 		continue;
309 	cnp->cn_namelen = cp - cnp->cn_nameptr;
310 	if (cnp->cn_namelen > NAME_MAX) {
311 		error = ENAMETOOLONG;
312 		goto bad;
313 	}
314 #ifdef NAMEI_DIAGNOSTIC
315 	{ char c = *cp;
316 	*cp = '\0';
317 	printf("{%s}: ", cnp->cn_nameptr);
318 	*cp = c; }
319 #endif
320 	ndp->ni_pathlen -= cnp->cn_namelen;
321 	ndp->ni_next = cp;
322 
323 	/*
324 	 * Replace multiple slashes by a single slash and trailing slashes
325 	 * by a null.  This must be done before VOP_LOOKUP() because some
326 	 * fs's don't know about trailing slashes.  Remember if there were
327 	 * trailing slashes to handle symlinks, existing non-directories
328 	 * and non-existing files that won't be directories specially later.
329 	 */
330 	trailing_slash = 0;
331 	while (*cp == '/' && (cp[1] == '/' || cp[1] == '\0')) {
332 		cp++;
333 		ndp->ni_pathlen--;
334 		if (*cp == '\0') {
335 			trailing_slash = 1;
336 			*ndp->ni_next = '\0';	/* XXX for direnter() ... */
337 		}
338 	}
339 	ndp->ni_next = cp;
340 
341 	cnp->cn_flags |= MAKEENTRY;
342 	if (*cp == '\0' && docache == 0)
343 		cnp->cn_flags &= ~MAKEENTRY;
344 	if (cnp->cn_namelen == 2 &&
345 	    cnp->cn_nameptr[1] == '.' && cnp->cn_nameptr[0] == '.')
346 		cnp->cn_flags |= ISDOTDOT;
347 	else
348 		cnp->cn_flags &= ~ISDOTDOT;
349 	if (*ndp->ni_next == 0)
350 		cnp->cn_flags |= ISLASTCN;
351 	else
352 		cnp->cn_flags &= ~ISLASTCN;
353 
354 
355 	/*
356 	 * Check for degenerate name (e.g. / or "")
357 	 * which is a way of talking about a directory,
358 	 * e.g. like "/." or ".".
359 	 */
360 	if (cnp->cn_nameptr[0] == '\0') {
361 		if (dp->v_type != VDIR) {
362 			error = ENOTDIR;
363 			goto bad;
364 		}
365 		if (cnp->cn_nameiop != LOOKUP) {
366 			error = EISDIR;
367 			goto bad;
368 		}
369 		if (wantparent) {
370 			ndp->ni_dvp = dp;
371 			VREF(dp);
372 		}
373 		ndp->ni_vp = dp;
374 		if (!(cnp->cn_flags & (LOCKPARENT | LOCKLEAF)))
375 			VOP_UNLOCK(dp, 0, p);
376 		/* XXX This should probably move to the top of function. */
377 		if (cnp->cn_flags & SAVESTART)
378 			panic("lookup: SAVESTART");
379 		return (0);
380 	}
381 
382 	/*
383 	 * Handle "..": two special cases.
384 	 * 1. If at root directory (e.g. after chroot)
385 	 *    or at absolute root directory
386 	 *    then ignore it so can't get out.
387 	 * 2. If this vnode is the root of a mounted
388 	 *    filesystem, then replace it with the
389 	 *    vnode which was mounted on so we take the
390 	 *    .. in the other file system.
391 	 * 3. If the vnode is the top directory of
392 	 *    the jail or chroot, don't let them out.
393 	 */
394 	if (cnp->cn_flags & ISDOTDOT) {
395 		for (;;) {
396 			if (dp == ndp->ni_rootdir ||
397 			    dp == ndp->ni_topdir ||
398 			    dp == rootvnode) {
399 				ndp->ni_dvp = dp;
400 				ndp->ni_vp = dp;
401 				VREF(dp);
402 				goto nextname;
403 			}
404 			if ((dp->v_flag & VROOT) == 0 ||
405 			    (cnp->cn_flags & NOCROSSMOUNT))
406 				break;
407 			tdp = dp;
408 			dp = dp->v_mount->mnt_vnodecovered;
409 			vput(tdp);
410 			VREF(dp);
411 			vn_lock(dp, LK_EXCLUSIVE | LK_RETRY, p);
412 		}
413 	}
414 
415 	/*
416 	 * We now have a segment name to search for, and a directory to search.
417 	 */
418 unionlookup:
419 	ndp->ni_dvp = dp;
420 	ndp->ni_vp = NULL;
421 	cnp->cn_flags &= ~PDIRUNLOCK;
422 	ASSERT_VOP_LOCKED(dp, "lookup");
423 	if ((error = VOP_LOOKUP(dp, &ndp->ni_vp, cnp)) != 0) {
424 		KASSERT(ndp->ni_vp == NULL, ("leaf should be empty"));
425 #ifdef NAMEI_DIAGNOSTIC
426 		printf("not found\n");
427 #endif
428 		if ((error == ENOENT) &&
429 		    (dp->v_flag & VROOT) &&
430 		    (dp->v_mount->mnt_flag & MNT_UNION)) {
431 			tdp = dp;
432 			dp = dp->v_mount->mnt_vnodecovered;
433 			if (cnp->cn_flags & PDIRUNLOCK)
434 				vrele(tdp);
435 			else
436 				vput(tdp);
437 			VREF(dp);
438 			vn_lock(dp, LK_EXCLUSIVE | LK_RETRY, p);
439 			goto unionlookup;
440 		}
441 
442 		if (error != EJUSTRETURN)
443 			goto bad;
444 		/*
445 		 * If creating and at end of pathname, then can consider
446 		 * allowing file to be created.
447 		 */
448 		if (rdonly) {
449 			error = EROFS;
450 			goto bad;
451 		}
452 		if (*cp == '\0' && trailing_slash &&
453 		     !(cnp->cn_flags & WILLBEDIR)) {
454 			error = ENOENT;
455 			goto bad;
456 		}
457 		/*
458 		 * We return with ni_vp NULL to indicate that the entry
459 		 * doesn't currently exist, leaving a pointer to the
460 		 * (possibly locked) directory inode in ndp->ni_dvp.
461 		 */
462 		if (cnp->cn_flags & SAVESTART) {
463 			ndp->ni_startdir = ndp->ni_dvp;
464 			VREF(ndp->ni_startdir);
465 		}
466 		return (0);
467 	}
468 #ifdef NAMEI_DIAGNOSTIC
469 	printf("found\n");
470 #endif
471 
472 	ASSERT_VOP_LOCKED(ndp->ni_vp, "lookup");
473 
474 	/*
475 	 * Take into account any additional components consumed by
476 	 * the underlying filesystem.
477 	 */
478 	if (cnp->cn_consume > 0) {
479 		cnp->cn_nameptr += cnp->cn_consume;
480 		ndp->ni_next += cnp->cn_consume;
481 		ndp->ni_pathlen -= cnp->cn_consume;
482 		cnp->cn_consume = 0;
483 	}
484 
485 	dp = ndp->ni_vp;
486 
487 	/*
488 	 * Check to see if the vnode has been mounted on;
489 	 * if so find the root of the mounted file system.
490 	 */
491 	while (dp->v_type == VDIR && (mp = dp->v_mountedhere) &&
492 	       (cnp->cn_flags & NOCROSSMOUNT) == 0) {
493 		if (vfs_busy(mp, 0, 0, p))
494 			continue;
495 		VOP_UNLOCK(dp, 0, p);
496 		error = VFS_ROOT(mp, &tdp);
497 		vfs_unbusy(mp, p);
498 		if (error) {
499 			dpunlocked = 1;
500 			goto bad2;
501 		}
502 		vrele(dp);
503 		ndp->ni_vp = dp = tdp;
504 	}
505 
506 	/*
507 	 * Check for symbolic link
508 	 */
509 	if ((dp->v_type == VLNK) &&
510 	    ((cnp->cn_flags & FOLLOW) || trailing_slash ||
511 	     *ndp->ni_next == '/')) {
512 		cnp->cn_flags |= ISSYMLINK;
513 		if (dp->v_mount->mnt_flag & MNT_NOSYMFOLLOW) {
514 			error = EACCES;
515 			goto bad2;
516 		}
517 		return (0);
518 	}
519 
520 	/*
521 	 * Check for bogus trailing slashes.
522 	 */
523 	if (trailing_slash && dp->v_type != VDIR) {
524 		error = ENOTDIR;
525 		goto bad2;
526 	}
527 
528 nextname:
529 	/*
530 	 * Not a symbolic link.  If more pathname,
531 	 * continue at next component, else return.
532 	 */
533 	if (*ndp->ni_next == '/') {
534 		cnp->cn_nameptr = ndp->ni_next;
535 		while (*cnp->cn_nameptr == '/') {
536 			cnp->cn_nameptr++;
537 			ndp->ni_pathlen--;
538 		}
539 		if (ndp->ni_dvp != ndp->ni_vp)
540 			ASSERT_VOP_UNLOCKED(ndp->ni_dvp, "lookup");
541 		vrele(ndp->ni_dvp);
542 		goto dirloop;
543 	}
544 	/*
545 	 * Disallow directory write attempts on read-only file systems.
546 	 */
547 	if (rdonly &&
548 	    (cnp->cn_nameiop == DELETE || cnp->cn_nameiop == RENAME)) {
549 		error = EROFS;
550 		goto bad2;
551 	}
552 	if (cnp->cn_flags & SAVESTART) {
553 		ndp->ni_startdir = ndp->ni_dvp;
554 		VREF(ndp->ni_startdir);
555 	}
556 	if (!wantparent)
557 		vrele(ndp->ni_dvp);
558 
559 	if ((cnp->cn_flags & LOCKLEAF) == 0)
560 		VOP_UNLOCK(dp, 0, p);
561 	return (0);
562 
563 bad2:
564 	if ((cnp->cn_flags & (LOCKPARENT | PDIRUNLOCK)) == LOCKPARENT &&
565 	    *ndp->ni_next == '\0')
566 		VOP_UNLOCK(ndp->ni_dvp, 0, p);
567 	vrele(ndp->ni_dvp);
568 bad:
569 	if (dpunlocked)
570 		vrele(dp);
571 	else
572 		vput(dp);
573 	ndp->ni_vp = NULL;
574 	return (error);
575 }
576 
577 /*
578  * relookup - lookup a path name component
579  *    Used by lookup to re-aquire things.
580  */
581 int
582 relookup(dvp, vpp, cnp)
583 	struct vnode *dvp, **vpp;
584 	struct componentname *cnp;
585 {
586 	struct proc *p = cnp->cn_proc;
587 	struct vnode *dp = 0;		/* the directory we are searching */
588 	int docache;			/* == 0 do not cache last component */
589 	int wantparent;			/* 1 => wantparent or lockparent flag */
590 	int rdonly;			/* lookup read-only flag bit */
591 	int error = 0;
592 #ifdef NAMEI_DIAGNOSTIC
593 	int newhash;			/* DEBUG: check name hash */
594 	char *cp;			/* DEBUG: check name ptr/len */
595 #endif
596 
597 	/*
598 	 * Setup: break out flag bits into variables.
599 	 */
600 	wantparent = cnp->cn_flags & (LOCKPARENT|WANTPARENT);
601 	docache = (cnp->cn_flags & NOCACHE) ^ NOCACHE;
602 	if (cnp->cn_nameiop == DELETE ||
603 	    (wantparent && cnp->cn_nameiop != CREATE))
604 		docache = 0;
605 	rdonly = cnp->cn_flags & RDONLY;
606 	cnp->cn_flags &= ~ISSYMLINK;
607 	dp = dvp;
608 	vn_lock(dp, LK_EXCLUSIVE | LK_RETRY, p);
609 
610 /* dirloop: */
611 	/*
612 	 * Search a new directory.
613 	 *
614 	 * The last component of the filename is left accessible via
615 	 * cnp->cn_nameptr for callers that need the name. Callers needing
616 	 * the name set the SAVENAME flag. When done, they assume
617 	 * responsibility for freeing the pathname buffer.
618 	 */
619 #ifdef NAMEI_DIAGNOSTIC
620 	if (cnp->cn_namelen != cp - cnp->cn_nameptr)
621 		panic ("relookup: bad len");
622 	if (*cp != 0)
623 		panic("relookup: not last component");
624 	printf("{%s}: ", cnp->cn_nameptr);
625 #endif
626 
627 	/*
628 	 * Check for degenerate name (e.g. / or "")
629 	 * which is a way of talking about a directory,
630 	 * e.g. like "/." or ".".
631 	 */
632 	if (cnp->cn_nameptr[0] == '\0') {
633 		if (cnp->cn_nameiop != LOOKUP || wantparent) {
634 			error = EISDIR;
635 			goto bad;
636 		}
637 		if (dp->v_type != VDIR) {
638 			error = ENOTDIR;
639 			goto bad;
640 		}
641 		if (!(cnp->cn_flags & LOCKLEAF))
642 			VOP_UNLOCK(dp, 0, p);
643 		*vpp = dp;
644 		/* XXX This should probably move to the top of function. */
645 		if (cnp->cn_flags & SAVESTART)
646 			panic("lookup: SAVESTART");
647 		return (0);
648 	}
649 
650 	if (cnp->cn_flags & ISDOTDOT)
651 		panic ("relookup: lookup on dot-dot");
652 
653 	/*
654 	 * We now have a segment name to search for, and a directory to search.
655 	 */
656 	if ((error = VOP_LOOKUP(dp, vpp, cnp)) != 0) {
657 		KASSERT(*vpp == NULL, ("leaf should be empty"));
658 		if (error != EJUSTRETURN)
659 			goto bad;
660 		/*
661 		 * If creating and at end of pathname, then can consider
662 		 * allowing file to be created.
663 		 */
664 		if (rdonly) {
665 			error = EROFS;
666 			goto bad;
667 		}
668 		/* ASSERT(dvp == ndp->ni_startdir) */
669 		if (cnp->cn_flags & SAVESTART)
670 			VREF(dvp);
671 		/*
672 		 * We return with ni_vp NULL to indicate that the entry
673 		 * doesn't currently exist, leaving a pointer to the
674 		 * (possibly locked) directory inode in ndp->ni_dvp.
675 		 */
676 		return (0);
677 	}
678 	dp = *vpp;
679 
680 	/*
681 	 * Check for symbolic link
682 	 */
683 	KASSERT(dp->v_type != VLNK || !(cnp->cn_flags & FOLLOW),
684 	    ("relookup: symlink found.\n"));
685 
686 	/*
687 	 * Disallow directory write attempts on read-only file systems.
688 	 */
689 	if (rdonly &&
690 	    (cnp->cn_nameiop == DELETE || cnp->cn_nameiop == RENAME)) {
691 		error = EROFS;
692 		goto bad2;
693 	}
694 	/* ASSERT(dvp == ndp->ni_startdir) */
695 	if (cnp->cn_flags & SAVESTART)
696 		VREF(dvp);
697 
698 	if (!wantparent)
699 		vrele(dvp);
700 
701 	if (vn_canvmio(dp) == TRUE &&
702 		((cnp->cn_flags & (NOOBJ|LOCKLEAF)) == LOCKLEAF))
703 		vfs_object_create(dp, cnp->cn_proc, cnp->cn_cred);
704 
705 	if ((cnp->cn_flags & LOCKLEAF) == 0)
706 		VOP_UNLOCK(dp, 0, p);
707 	return (0);
708 
709 bad2:
710 	if ((cnp->cn_flags & LOCKPARENT) && (cnp->cn_flags & ISLASTCN))
711 		VOP_UNLOCK(dvp, 0, p);
712 	vrele(dvp);
713 bad:
714 	vput(dp);
715 	*vpp = NULL;
716 	return (error);
717 }
718