2 * Copyright (c) 2000-2012 Apple Inc. All rights reserved.
4 * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
6 * This file contains Original Code and/or Modifications of Original Code
7 * as defined in and that are subject to the Apple Public Source License
8 * Version 2.0 (the 'License'). You may not use this file except in
9 * compliance with the License. The rights granted to you under the License
10 * may not be used to create, or enable the creation or redistribution of,
11 * unlawful or unlicensed copies of an Apple operating system, or to
12 * circumvent, violate, or enable the circumvention or violation of, any
13 * terms of an Apple operating system software license agreement.
15 * Please obtain a copy of the License at
16 * http://www.opensource.apple.com/apsl/ and read it before using this file.
18 * The Original Code and all software distributed under the License are
19 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
20 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
21 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
22 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
23 * Please see the License for the specific language governing rights and
24 * limitations under the License.
26 * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
28 /* Copyright (c) 1995 NeXT Computer, Inc. All Rights Reserved */
30 * Copyright (c) 1989, 1993, 1995
31 * The Regents of the University of California. All rights reserved.
33 * This code is derived from software contributed to Berkeley by
34 * Poul-Henning Kamp of the FreeBSD Project.
36 * Redistribution and use in source and binary forms, with or without
37 * modification, are permitted provided that the following conditions
39 * 1. Redistributions of source code must retain the above copyright
40 * notice, this list of conditions and the following disclaimer.
41 * 2. Redistributions in binary form must reproduce the above copyright
42 * notice, this list of conditions and the following disclaimer in the
43 * documentation and/or other materials provided with the distribution.
44 * 3. All advertising materials mentioning features or use of this software
45 * must display the following acknowledgement:
46 * This product includes software developed by the University of
47 * California, Berkeley and its contributors.
48 * 4. Neither the name of the University nor the names of its contributors
49 * may be used to endorse or promote products derived from this software
50 * without specific prior written permission.
52 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
53 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
54 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
55 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
56 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
57 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
58 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
59 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
60 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
61 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
65 * @(#)vfs_cache.c 8.5 (Berkeley) 3/22/95
68 * NOTICE: This file was modified by SPARTA, Inc. in 2005 to introduce
69 * support for mandatory and extensible security protections. This notice
70 * is included in support of clause 2.2 (b) of the Apple Public License,
73 #include <sys/param.h>
74 #include <sys/systm.h>
76 #include <sys/mount_internal.h>
77 #include <sys/vnode_internal.h>
78 #include <miscfs/specfs/specdev.h>
79 #include <sys/namei.h>
80 #include <sys/errno.h>
81 #include <sys/malloc.h>
82 #include <sys/kauth.h>
84 #include <sys/paths.h>
87 #include <security/mac_framework.h>
91 * Name caching works as follows:
93 * Names found by directory scans are retained in a cache
94 * for future reference. It is managed LRU, so frequently
95 * used names will hang around. Cache is indexed by hash value
96 * obtained from (vp, name) where vp refers to the directory
99 * If it is a "negative" entry, (i.e. for a name that is known NOT to
100 * exist) the vnode pointer will be NULL.
102 * Upon reaching the last segment of a path, if the reference
103 * is for DELETE, or NOCACHE is set (rewrite), and the
104 * name is located in the cache, it will be dropped.
108 * Structures associated with name cacheing.
111 LIST_HEAD(nchashhead
, namecache
) *nchashtbl
; /* Hash Table */
113 u_long nchash
; /* size of hash table - 1 */
114 long numcache
; /* number of cache entries allocated */
119 TAILQ_HEAD(, namecache
) nchead
; /* chain of all name cache entries */
120 TAILQ_HEAD(, namecache
) neghead
; /* chain of only negative cache entries */
125 struct nchstats nchstats
; /* cache effectiveness statistics */
127 #define NCHSTAT(v) { \
130 #define NAME_CACHE_LOCK() name_cache_lock()
131 #define NAME_CACHE_UNLOCK() name_cache_unlock()
132 #define NAME_CACHE_LOCK_SHARED() name_cache_lock()
137 #define NAME_CACHE_LOCK() name_cache_lock()
138 #define NAME_CACHE_UNLOCK() name_cache_unlock()
139 #define NAME_CACHE_LOCK_SHARED() name_cache_lock_shared()
144 /* vars for name cache list lock */
145 lck_grp_t
* namecache_lck_grp
;
146 lck_grp_attr_t
* namecache_lck_grp_attr
;
147 lck_attr_t
* namecache_lck_attr
;
149 lck_grp_t
* strcache_lck_grp
;
150 lck_grp_attr_t
* strcache_lck_grp_attr
;
151 lck_attr_t
* strcache_lck_attr
;
153 lck_rw_t
* namecache_rw_lock
;
154 lck_rw_t
* strtable_rw_lock
;
156 #define NUM_STRCACHE_LOCKS 1024
158 lck_mtx_t strcache_mtx_locks
[NUM_STRCACHE_LOCKS
];
161 static vnode_t
cache_lookup_locked(vnode_t dvp
, struct componentname
*cnp
);
162 static const char *add_name_internal(const char *, uint32_t, u_int
, boolean_t
, u_int
);
163 static void init_string_table(void);
164 static void cache_delete(struct namecache
*, int);
165 static void cache_enter_locked(vnode_t dvp
, vnode_t vp
, struct componentname
*cnp
, const char *strname
);
167 #ifdef DUMP_STRING_TABLE
169 * Internal dump function used for debugging
171 void dump_string_table(void);
172 #endif /* DUMP_STRING_TABLE */
174 static void init_crc32(void);
175 static unsigned int crc32tab
[256];
178 #define NCHHASH(dvp, hash_val) \
179 (&nchashtbl[(dvp->v_id ^ (hash_val)) & nchashmask])
184 * This function builds the path to a filename in "buff". The
185 * length of the buffer *INCLUDING* the trailing zero byte is
186 * returned in outlen. NOTE: the length includes the trailing
187 * zero byte and thus the length is one greater than what strlen
188 * would return. This is important and lots of code elsewhere
189 * in the kernel assumes this behavior.
191 * This function can call vnop in file system if the parent vnode
192 * does not exist or when called for hardlinks via volfs path.
193 * If BUILDPATH_NO_FS_ENTER is set in flags, it only uses values present
194 * in the name cache and does not enter the file system.
196 * If BUILDPATH_CHECK_MOVED is set in flags, we return EAGAIN when
197 * we encounter ENOENT during path reconstruction. ENOENT means that
198 * one of the parents moved while we were building the path. The
199 * caller can special handle this case by calling build_path again.
201 * If BUILDPATH_VOLUME_RELATIVE is set in flags, we return path
202 * that is relative to the nearest mount point, i.e. do not
203 * cross over mount points during building the path.
205 * passed in vp must have a valid io_count reference
208 build_path(vnode_t first_vp
, char *buff
, int buflen
, int *outlen
, int flags
, vfs_context_t ctx
)
211 vnode_t vp_with_iocount
;
212 vnode_t proc_root_dir_vp
;
219 if (first_vp
== NULLVP
)
226 * Grab the process fd so we can evaluate fd_rdir.
228 if (vfs_context_proc(ctx
)->p_fd
)
229 proc_root_dir_vp
= vfs_context_proc(ctx
)->p_fd
->fd_rdir
;
231 proc_root_dir_vp
= NULL
;
233 vp_with_iocount
= NULLVP
;
237 end
= &buff
[buflen
-1];
241 * holding the NAME_CACHE_LOCK in shared mode is
242 * sufficient to stabilize both the vp->v_parent chain
243 * and the 'vp->v_mount->mnt_vnodecovered' chain
245 * if we need to drop this lock, we must first grab the v_id
246 * from the vnode we're currently working with... if that
247 * vnode doesn't already have an io_count reference (the vp
248 * passed in comes with one), we must grab a reference
249 * after we drop the NAME_CACHE_LOCK via vnode_getwithvid...
250 * deadlocks may result if you call vnode_get while holding
251 * the NAME_CACHE_LOCK... we lazily release the reference
252 * we pick up the next time we encounter a need to drop
253 * the NAME_CACHE_LOCK or before we return from this routine
255 NAME_CACHE_LOCK_SHARED();
258 * Check if this is the root of a file system.
260 while (vp
&& vp
->v_flag
& VROOT
) {
261 if (vp
->v_mount
== NULL
) {
265 if ((vp
->v_mount
->mnt_flag
& MNT_ROOTFS
) || (vp
== proc_root_dir_vp
)) {
267 * It's the root of the root file system, so it's
275 * This the root of the volume and the caller does not
276 * want to cross mount points. Therefore just return
277 * '/' as the relative path.
279 if (flags
& BUILDPATH_VOLUME_RELATIVE
) {
283 vp
= vp
->v_mount
->mnt_vnodecovered
;
288 while ((vp
!= NULLVP
) && (vp
->v_parent
!= vp
)) {
292 * For hardlinks the v_name may be stale, so if its OK
293 * to enter a file system, ask the file system for the
294 * name and parent (below).
296 fixhardlink
= (vp
->v_flag
& VISHARDLINK
) &&
297 (vp
->v_mount
->mnt_kern_flag
& MNTK_PATH_FROM_ID
) &&
298 !(flags
& BUILDPATH_NO_FS_ENTER
);
303 if (str
== NULL
|| *str
== '\0') {
304 if (vp
->v_parent
!= NULL
)
312 * Check that there's enough space (including space for the '/')
314 if ((end
- buff
) < (len
+ 1)) {
319 * Copy the name backwards.
323 for (; len
> 0; len
--)
326 * Add a path separator.
332 * Walk up the parent chain.
334 if (((vp
->v_parent
!= NULLVP
) && !fixhardlink
) ||
335 (flags
& BUILDPATH_NO_FS_ENTER
)) {
338 * In this if () block we are not allowed to enter the filesystem
339 * to conclusively get the most accurate parent identifier.
340 * As a result, if 'vp' does not identify '/' and it
341 * does not have a valid v_parent, then error out
342 * and disallow further path construction
344 if ((vp
->v_parent
== NULLVP
) && (rootvnode
!= vp
)) {
345 /* Only '/' is allowed to have a NULL parent pointer */
348 /* The code below will exit early if 'tvp = vp' == NULL */
353 * if the vnode we have in hand isn't a directory and it
354 * has a v_parent, then we started with the resource fork
355 * so skip up to avoid getting a duplicate copy of the
356 * file name in the path.
358 if (vp
&& !vnode_isdir(vp
) && vp
->v_parent
) {
363 * No parent, go get it if supported.
365 struct vnode_attr va
;
369 * Make sure file system supports obtaining a path from id.
371 if (!(vp
->v_mount
->mnt_kern_flag
& MNTK_PATH_FROM_ID
)) {
379 if (vp
!= first_vp
&& vp
!= vp_with_iocount
) {
380 if (vp_with_iocount
) {
381 vnode_put(vp_with_iocount
);
382 vp_with_iocount
= NULLVP
;
384 if (vnode_getwithvid(vp
, vid
))
386 vp_with_iocount
= vp
;
389 VATTR_WANTED(&va
, va_parentid
);
392 VATTR_WANTED(&va
, va_name
);
393 MALLOC_ZONE(va
.va_name
, caddr_t
, MAXPATHLEN
, M_NAMEI
, M_WAITOK
);
398 * Ask the file system for its parent id and for its name (optional).
400 ret
= vnode_getattr(vp
, &va
, ctx
);
403 if ((ret
== 0) && (VATTR_IS_SUPPORTED(&va
, va_name
))) {
405 vnode_update_identity(vp
, NULL
, str
, strlen(str
), 0, VNODE_UPDATE_NAME
);
406 } else if (vp
->v_name
) {
416 * Check that there's enough space.
418 if ((end
- buff
) < (len
+ 1)) {
421 /* Copy the name backwards. */
424 for (; len
> 0; len
--) {
428 * Add a path separator.
433 FREE_ZONE(va
.va_name
, MAXPATHLEN
, M_NAMEI
);
435 if (ret
|| !VATTR_IS_SUPPORTED(&va
, va_parentid
)) {
440 * Ask the file system for the parent vnode.
442 if ((ret
= VFS_VGET(vp
->v_mount
, (ino64_t
)va
.va_parentid
, &dvp
, ctx
)))
445 if (!fixhardlink
&& (vp
->v_parent
!= dvp
))
446 vnode_update_identity(vp
, dvp
, NULL
, 0, 0, VNODE_UPDATE_PARENT
);
449 vnode_put(vp_with_iocount
);
451 vp_with_iocount
= vp
;
453 NAME_CACHE_LOCK_SHARED();
456 * if the vnode we have in hand isn't a directory and it
457 * has a v_parent, then we started with the resource fork
458 * so skip up to avoid getting a duplicate copy of the
459 * file name in the path.
461 if (vp
&& !vnode_isdir(vp
) && vp
->v_parent
)
466 * When a mount point is crossed switch the vp.
467 * Continue until we find the root or we find
468 * a vnode that's not the root of a mounted
474 if (tvp
== proc_root_dir_vp
)
475 goto out_unlock
; /* encountered the root */
477 if (!(tvp
->v_flag
& VROOT
) || !tvp
->v_mount
)
478 break; /* not the root of a mounted FS */
480 if (flags
& BUILDPATH_VOLUME_RELATIVE
) {
481 /* Do not cross over mount points */
484 tvp
= tvp
->v_mount
->mnt_vnodecovered
;
491 if (vp
&& (flags
& BUILDPATH_CHECKACCESS
)) {
496 if (vp
!= first_vp
&& vp
!= vp_with_iocount
) {
497 if (vp_with_iocount
) {
498 vnode_put(vp_with_iocount
);
499 vp_with_iocount
= NULLVP
;
501 if (vnode_getwithvid(vp
, vid
))
503 vp_with_iocount
= vp
;
505 if ((ret
= vnode_authorize(vp
, NULL
, KAUTH_VNODE_SEARCH
, ctx
)))
506 goto out
; /* no peeking */
508 NAME_CACHE_LOCK_SHARED();
515 vnode_put(vp_with_iocount
);
517 * Slide the name down to the beginning of the buffer.
519 memmove(buff
, end
, &buff
[buflen
] - end
);
522 * length includes the trailing zero byte
524 *outlen
= &buff
[buflen
] - end
;
526 /* One of the parents was moved during path reconstruction.
527 * The caller is interested in knowing whether any of the
528 * parents moved via BUILDPATH_CHECK_MOVED, so return EAGAIN.
530 if ((ret
== ENOENT
) && (flags
& BUILDPATH_CHECK_MOVED
)) {
539 * return NULLVP if vp's parent doesn't
540 * exist, or we can't get a valid iocount
541 * else return the parent of vp
544 vnode_getparent(vnode_t vp
)
546 vnode_t pvp
= NULLVP
;
549 NAME_CACHE_LOCK_SHARED();
551 * v_parent is stable behind the name_cache lock
552 * however, the only thing we can really guarantee
553 * is that we've grabbed a valid iocount on the
554 * parent of 'vp' at the time we took the name_cache lock...
555 * once we drop the lock, vp could get re-parented
557 if ( (pvp
= vp
->v_parent
) != NULLVP
) {
562 if (vnode_getwithvid(pvp
, pvid
) != 0)
570 vnode_getname(vnode_t vp
)
572 const char *name
= NULL
;
574 NAME_CACHE_LOCK_SHARED();
577 name
= vfs_addname(vp
->v_name
, strlen(vp
->v_name
), 0, 0);
584 vnode_putname(const char *name
)
586 vfs_removename(name
);
589 static const char unknown_vnodename
[] = "(unknown vnode name)";
592 vnode_getname_printable(vnode_t vp
)
594 const char *name
= vnode_getname(vp
);
598 switch (vp
->v_type
) {
603 * Create an artificial dev name from
604 * major and minor device number
607 (void) snprintf(dev_name
, sizeof(dev_name
),
608 "%c(%u, %u)", VCHR
== vp
->v_type
? 'c':'b',
609 major(vp
->v_rdev
), minor(vp
->v_rdev
));
611 * Add the newly created dev name to the name
612 * cache to allow easier cleanup. Also,
613 * vfs_addname allocates memory for the new name
616 NAME_CACHE_LOCK_SHARED();
617 name
= vfs_addname(dev_name
, strlen(dev_name
), 0, 0);
622 return unknown_vnodename
;
627 vnode_putname_printable(const char *name
)
629 if (name
== unknown_vnodename
)
636 * if VNODE_UPDATE_PARENT, and we can take
637 * a reference on dvp, then update vp with
638 * it's new parent... if vp already has a parent,
639 * then drop the reference vp held on it
641 * if VNODE_UPDATE_NAME,
642 * then drop string ref on v_name if it exists, and if name is non-NULL
643 * then pick up a string reference on name and record it in v_name...
644 * optionally pass in the length and hashval of name if known
646 * if VNODE_UPDATE_CACHE, flush the name cache entries associated with vp
649 vnode_update_identity(vnode_t vp
, vnode_t dvp
, const char *name
, int name_len
, uint32_t name_hashval
, int flags
)
651 struct namecache
*ncp
;
652 vnode_t old_parentvp
= NULLVP
;
654 int isstream
= (vp
->v_flag
& VISNAMEDSTREAM
);
655 int kusecountbumped
= 0;
657 kauth_cred_t tcred
= NULL
;
658 const char *vname
= NULL
;
659 const char *tname
= NULL
;
661 if (flags
& VNODE_UPDATE_PARENT
) {
662 if (dvp
&& vnode_ref(dvp
) != 0) {
666 /* Don't count a stream's parent ref during unmounts */
667 if (isstream
&& dvp
&& (dvp
!= vp
) && (dvp
!= vp
->v_parent
) && (dvp
->v_type
== VREG
)) {
668 vnode_lock_spin(dvp
);
677 if ( (flags
& VNODE_UPDATE_NAME
) ) {
678 if (name
!= vp
->v_name
) {
681 name_len
= strlen(name
);
682 tname
= vfs_addname(name
, name_len
, name_hashval
, 0);
685 flags
&= ~VNODE_UPDATE_NAME
;
687 if ( (flags
& (VNODE_UPDATE_PURGE
| VNODE_UPDATE_PARENT
| VNODE_UPDATE_CACHE
| VNODE_UPDATE_NAME
)) ) {
691 if ( (flags
& VNODE_UPDATE_PURGE
) ) {
694 vp
->v_parent
->v_nc_generation
++;
696 while ( (ncp
= LIST_FIRST(&vp
->v_nclinks
)) )
697 cache_delete(ncp
, 1);
699 while ( (ncp
= LIST_FIRST(&vp
->v_ncchildren
)) )
700 cache_delete(ncp
, 1);
703 * Use a temp variable to avoid kauth_cred_unref() while NAME_CACHE_LOCK is held
707 vp
->v_authorized_actions
= 0;
709 if ( (flags
& VNODE_UPDATE_NAME
) ) {
713 if (flags
& VNODE_UPDATE_PARENT
) {
714 if (dvp
!= vp
&& dvp
!= vp
->v_parent
) {
715 old_parentvp
= vp
->v_parent
;
720 flags
|= VNODE_UPDATE_CACHE
;
723 if (flags
& VNODE_UPDATE_CACHE
) {
724 while ( (ncp
= LIST_FIRST(&vp
->v_nclinks
)) )
725 cache_delete(ncp
, 1);
730 vfs_removename(vname
);
732 if (IS_VALID_CRED(tcred
))
733 kauth_cred_unref(&tcred
);
737 /* Back-out the ref we took if we lost a race for vp->v_parent. */
738 if (kusecountbumped
) {
739 vnode_lock_spin(dvp
);
740 if (dvp
->v_kusecount
> 0)
752 vnode_lock_spin(old_parentvp
);
753 if ((old_parentvp
->v_type
!= VDIR
) && (old_parentvp
->v_kusecount
> 0))
754 --old_parentvp
->v_kusecount
;
755 vnode_unlock(old_parentvp
);
758 ut
= get_bsdthread_info(current_thread());
761 * indicated to vnode_rele that it shouldn't do a
762 * vnode_reclaim at this time... instead it will
763 * chain the vnode to the uu_vreclaims list...
764 * we'll be responsible for calling vnode_reclaim
765 * on each of the vnodes in this list...
767 ut
->uu_defer_reclaims
= 1;
768 ut
->uu_vreclaims
= NULLVP
;
770 while ( (vp
= old_parentvp
) != NULLVP
) {
773 vnode_rele_internal(vp
, 0, 0, 1);
776 * check to see if the vnode is now in the state
777 * that would have triggered a vnode_reclaim in vnode_rele
778 * if it is, we save it's parent pointer and then NULL
779 * out the v_parent field... we'll drop the reference
780 * that was held on the next iteration of this loop...
781 * this short circuits a potential deep recursion if we
782 * have a long chain of parents in this state...
783 * we'll sit in this loop until we run into
784 * a parent in this chain that is not in this state
786 * make our check and the vnode_rele atomic
787 * with respect to the current vnode we're working on
788 * by holding the vnode lock
789 * if vnode_rele deferred the vnode_reclaim and has put
790 * this vnode on the list to be reaped by us, than
791 * it has left this vnode with an iocount == 1
793 if ( (vp
->v_iocount
== 1) && (vp
->v_usecount
== 0) &&
794 ((vp
->v_lflag
& (VL_MARKTERM
| VL_TERMINATE
| VL_DEAD
)) == VL_MARKTERM
)) {
796 * vnode_rele wanted to do a vnode_reclaim on this vnode
797 * it should be sitting on the head of the uu_vreclaims chain
798 * pull the parent pointer now so that when we do the
799 * vnode_reclaim for each of the vnodes in the uu_vreclaims
800 * list, we won't recurse back through here
802 * need to do a convert here in case vnode_rele_internal
803 * returns with the lock held in the spin mode... it
804 * can drop and retake the lock under certain circumstances
806 vnode_lock_convert(vp
);
809 old_parentvp
= vp
->v_parent
;
810 vp
->v_parent
= NULLVP
;
814 * we're done... we ran into a vnode that isn't
817 old_parentvp
= NULLVP
;
821 ut
->uu_defer_reclaims
= 0;
823 while ( (vp
= ut
->uu_vreclaims
) != NULLVP
) {
824 ut
->uu_vreclaims
= vp
->v_defer_reclaimlist
;
827 * vnode_put will drive the vnode_reclaim if
828 * we are still the only reference on this vnode
837 * Mark a vnode as having multiple hard links. HFS makes use of this
838 * because it keeps track of each link separately, and wants to know
839 * which link was actually used.
841 * This will cause the name cache to force a VNOP_LOOKUP on the vnode
842 * so that HFS can post-process the lookup. Also, volfs will call
843 * VNOP_GETATTR2 to determine the parent, instead of using v_parent.
845 void vnode_setmultipath(vnode_t vp
)
850 * In theory, we're changing the vnode's identity as far as the
851 * name cache is concerned, so we ought to grab the name cache lock
852 * here. However, there is already a race, and grabbing the name
853 * cache lock only makes the race window slightly smaller.
855 * The race happens because the vnode already exists in the name
856 * cache, and could be found by one thread before another thread
857 * can set the hard link flag.
860 vp
->v_flag
|= VISHARDLINK
;
868 * backwards compatibility
870 void vnode_uncache_credentials(vnode_t vp
)
872 vnode_uncache_authorized_action(vp
, KAUTH_INVALIDATE_CACHED_RIGHTS
);
877 * use the exclusive form of NAME_CACHE_LOCK to protect the update of the
878 * following fields in the vnode: v_cred_timestamp, v_cred, v_authorized_actions
879 * we use this lock so that we can look at the v_cred and v_authorized_actions
880 * atomically while behind the NAME_CACHE_LOCK in shared mode in 'cache_lookup_path',
881 * which is the super-hot path... if we are updating the authorized actions for this
882 * vnode, we are already in the super-slow and far less frequented path so its not
883 * that bad that we take the lock exclusive for this case... of course we strive
884 * to hold it for the minimum amount of time possible
887 void vnode_uncache_authorized_action(vnode_t vp
, kauth_action_t action
)
889 kauth_cred_t tcred
= NOCRED
;
893 vp
->v_authorized_actions
&= ~action
;
895 if (action
== KAUTH_INVALIDATE_CACHED_RIGHTS
&&
896 IS_VALID_CRED(vp
->v_cred
)) {
898 * Use a temp variable to avoid kauth_cred_unref() while NAME_CACHE_LOCK is held
906 kauth_cred_unref(&tcred
);
910 extern int bootarg_vnode_cache_defeat
; /* default = 0, from bsd_init.c */
913 vnode_cache_is_authorized(vnode_t vp
, vfs_context_t ctx
, kauth_action_t action
)
916 boolean_t retval
= FALSE
;
918 /* Boot argument to defeat rights caching */
919 if (bootarg_vnode_cache_defeat
)
922 if ( (vp
->v_mount
->mnt_kern_flag
& (MNTK_AUTH_OPAQUE
| MNTK_AUTH_CACHE_TTL
)) ) {
924 * a TTL is enabled on the rights cache... handle it here
925 * a TTL of 0 indicates that no rights should be cached
927 if (vp
->v_mount
->mnt_authcache_ttl
) {
928 if ( !(vp
->v_mount
->mnt_kern_flag
& MNTK_AUTH_CACHE_TTL
) ) {
930 * For filesystems marked only MNTK_AUTH_OPAQUE (generally network ones),
931 * we will only allow a SEARCH right on a directory to be cached...
932 * that cached right always has a default TTL associated with it
934 if (action
!= KAUTH_VNODE_SEARCH
|| vp
->v_type
!= VDIR
)
937 if (vp
!= NULLVP
&& vnode_cache_is_stale(vp
) == TRUE
) {
938 vnode_uncache_authorized_action(vp
, vp
->v_authorized_actions
);
945 ucred
= vfs_context_ucred(ctx
);
947 NAME_CACHE_LOCK_SHARED();
949 if (vp
->v_cred
== ucred
&& (vp
->v_authorized_actions
& action
) == action
)
958 void vnode_cache_authorized_action(vnode_t vp
, vfs_context_t ctx
, kauth_action_t action
)
960 kauth_cred_t tcred
= NOCRED
;
963 boolean_t ttl_active
= FALSE
;
965 ucred
= vfs_context_ucred(ctx
);
967 if (!IS_VALID_CRED(ucred
) || action
== 0)
970 if ( (vp
->v_mount
->mnt_kern_flag
& (MNTK_AUTH_OPAQUE
| MNTK_AUTH_CACHE_TTL
)) ) {
972 * a TTL is enabled on the rights cache... handle it here
973 * a TTL of 0 indicates that no rights should be cached
975 if (vp
->v_mount
->mnt_authcache_ttl
== 0)
978 if ( !(vp
->v_mount
->mnt_kern_flag
& MNTK_AUTH_CACHE_TTL
) ) {
980 * only cache SEARCH action for filesystems marked
981 * MNTK_AUTH_OPAQUE on VDIRs...
982 * the lookup_path code will time these out
984 if ( (action
& ~KAUTH_VNODE_SEARCH
) || vp
->v_type
!= VDIR
)
993 if (vp
->v_cred
!= ucred
) {
994 kauth_cred_ref(ucred
);
996 * Use a temp variable to avoid kauth_cred_unref() while NAME_CACHE_LOCK is held
1000 vp
->v_authorized_actions
= 0;
1002 if (ttl_active
== TRUE
&& vp
->v_authorized_actions
== 0) {
1004 * only reset the timestamnp on the
1005 * first authorization cached after the previous
1006 * timer has expired or we're switching creds...
1007 * 'vnode_cache_is_authorized' will clear the
1008 * authorized actions if the TTL is active and
1011 vp
->v_cred_timestamp
= tv
.tv_sec
;
1013 vp
->v_authorized_actions
|= action
;
1015 NAME_CACHE_UNLOCK();
1017 if (IS_VALID_CRED(tcred
))
1018 kauth_cred_unref(&tcred
);
1022 boolean_t
vnode_cache_is_stale(vnode_t vp
)
1029 if ((tv
.tv_sec
- vp
->v_cred_timestamp
) > vp
->v_mount
->mnt_authcache_ttl
)
1040 * Returns: 0 Success
1041 * ERECYCLE vnode was recycled from underneath us. Force lookup to be re-driven from namei.
1042 * This errno value should not be seen by anyone outside of the kernel.
1045 cache_lookup_path(struct nameidata
*ndp
, struct componentname
*cnp
, vnode_t dp
,
1046 vfs_context_t ctx
, int *dp_authorized
, vnode_t last_dp
)
1048 char *cp
; /* pointer into pathname argument */
1050 int vvid
= 0; /* protected by vp != NULLVP */
1051 vnode_t vp
= NULLVP
;
1052 vnode_t tdp
= NULLVP
;
1054 boolean_t ttl_enabled
= FALSE
;
1062 #endif /* CONFIG_TRIGGERS */
1064 ucred
= vfs_context_ucred(ctx
);
1065 ndp
->ni_flag
&= ~(NAMEI_TRAILINGSLASH
);
1067 NAME_CACHE_LOCK_SHARED();
1069 if ( dp
->v_mount
&& (dp
->v_mount
->mnt_kern_flag
& (MNTK_AUTH_OPAQUE
| MNTK_AUTH_CACHE_TTL
)) ) {
1075 * Search a directory.
1077 * The cn_hash value is for use by cache_lookup
1078 * The last component of the filename is left accessible via
1079 * cnp->cn_nameptr for callers that need the name.
1082 cp
= cnp
->cn_nameptr
;
1084 while (*cp
&& (*cp
!= '/')) {
1085 hash
= crc32tab
[((hash
>> 24) ^ (unsigned char)*cp
++)] ^ hash
<< 8;
1088 * the crc generator can legitimately generate
1089 * a 0... however, 0 for us means that we
1090 * haven't computed a hash, so use 1 instead
1094 cnp
->cn_hash
= hash
;
1095 cnp
->cn_namelen
= cp
- cnp
->cn_nameptr
;
1097 ndp
->ni_pathlen
-= cnp
->cn_namelen
;
1101 * Replace multiple slashes by a single slash and trailing slashes
1102 * by a null. This must be done before VNOP_LOOKUP() because some
1103 * fs's don't know about trailing slashes. Remember if there were
1104 * trailing slashes to handle symlinks, existing non-directories
1105 * and non-existing files that won't be directories specially later.
1107 while (*cp
== '/' && (cp
[1] == '/' || cp
[1] == '\0')) {
1112 ndp
->ni_flag
|= NAMEI_TRAILINGSLASH
;
1113 *ndp
->ni_next
= '\0';
1118 cnp
->cn_flags
&= ~(MAKEENTRY
| ISLASTCN
| ISDOTDOT
);
1121 cnp
->cn_flags
|= ISLASTCN
;
1123 if (cnp
->cn_namelen
== 2 && cnp
->cn_nameptr
[1] == '.' && cnp
->cn_nameptr
[0] == '.')
1124 cnp
->cn_flags
|= ISDOTDOT
;
1129 * Process a request for a file's resource fork.
1131 * Consume the _PATH_RSRCFORKSPEC suffix and tag the path.
1133 if ((ndp
->ni_pathlen
== sizeof(_PATH_RSRCFORKSPEC
)) &&
1134 (cp
[1] == '.' && cp
[2] == '.') &&
1135 bcmp(cp
, _PATH_RSRCFORKSPEC
, sizeof(_PATH_RSRCFORKSPEC
)) == 0) {
1136 /* Skip volfs file systems that don't support native streams. */
1137 if ((dp
->v_mount
!= NULL
) &&
1138 (dp
->v_mount
->mnt_flag
& MNT_DOVOLFS
) &&
1139 (dp
->v_mount
->mnt_kern_flag
& MNTK_NAMED_STREAMS
) == 0) {
1142 cnp
->cn_flags
|= CN_WANTSRSRCFORK
;
1143 cnp
->cn_flags
|= ISLASTCN
;
1144 ndp
->ni_next
[0] = '\0';
1145 ndp
->ni_pathlen
= 1;
1153 * Name cache provides authorization caching (see below)
1154 * that will short circuit MAC checks in lookup().
1155 * We must perform MAC check here. On denial
1156 * dp_authorized will remain 0 and second check will
1157 * be perfomed in lookup().
1159 if (!(cnp
->cn_flags
& DONOTAUTH
)) {
1160 error
= mac_vnode_check_lookup(ctx
, dp
, cnp
);
1162 NAME_CACHE_UNLOCK();
1167 if (ttl_enabled
&& ((tv
.tv_sec
- dp
->v_cred_timestamp
) > dp
->v_mount
->mnt_authcache_ttl
))
1171 * NAME_CACHE_LOCK holds these fields stable
1173 if ((dp
->v_cred
!= ucred
|| !(dp
->v_authorized_actions
& KAUTH_VNODE_SEARCH
)) &&
1174 !(dp
->v_authorized_actions
& KAUTH_VNODE_SEARCHBYANYONE
))
1178 * indicate that we're allowed to traverse this directory...
1179 * even if we fail the cache lookup or decide to bail for
1180 * some other reason, this information is valid and is used
1181 * to avoid doing a vnode_authorize before the call to VNOP_LOOKUP
1185 if ( (cnp
->cn_flags
& (ISLASTCN
| ISDOTDOT
)) ) {
1186 if (cnp
->cn_nameiop
!= LOOKUP
)
1188 if (cnp
->cn_flags
& LOCKPARENT
)
1190 if (cnp
->cn_flags
& NOCACHE
)
1192 if (cnp
->cn_flags
& ISDOTDOT
) {
1194 * Force directory hardlinks to go to
1195 * file system for ".." requests.
1197 if (dp
&& (dp
->v_flag
& VISHARDLINK
)) {
1201 * Quit here only if we can't use
1202 * the parent directory pointer or
1203 * don't have one. Otherwise, we'll
1206 if ((dp
->v_flag
& VROOT
) ||
1207 dp
== ndp
->ni_rootdir
||
1208 dp
->v_parent
== NULLVP
)
1213 if ((cnp
->cn_flags
& CN_SKIPNAMECACHE
)) {
1215 * Force lookup to go to the filesystem with
1216 * all cnp fields set up.
1222 * "." and ".." aren't supposed to be cached, so check
1223 * for them before checking the cache.
1225 if (cnp
->cn_namelen
== 1 && cnp
->cn_nameptr
[0] == '.')
1227 else if ( (cnp
->cn_flags
& ISDOTDOT
) )
1230 if ( (vp
= cache_lookup_locked(dp
, cnp
)) == NULLVP
)
1233 if ( (vp
->v_flag
& VISHARDLINK
) ) {
1235 * The file system wants a VNOP_LOOKUP on this vnode
1241 if ( (cnp
->cn_flags
& ISLASTCN
) )
1244 if (vp
->v_type
!= VDIR
) {
1245 if (vp
->v_type
!= VLNK
)
1250 if ( (mp
= vp
->v_mountedhere
) && ((cnp
->cn_flags
& NOCROSSMOUNT
) == 0)) {
1252 if (mp
->mnt_realrootvp
== NULLVP
|| mp
->mnt_generation
!= mount_generation
||
1253 mp
->mnt_realrootvp_vid
!= mp
->mnt_realrootvp
->v_id
)
1255 vp
= mp
->mnt_realrootvp
;
1260 * After traversing all mountpoints stacked here, if we have a
1261 * trigger in hand, resolve it. Note that we don't need to
1262 * leave the fast path if the mount has already happened.
1264 if ((vp
->v_resolve
!= NULL
) &&
1265 (vp
->v_resolve
->vr_resolve_func
!= NULL
)) {
1268 #endif /* CONFIG_TRIGGERS */
1274 cnp
->cn_nameptr
= ndp
->ni_next
+ 1;
1276 while (*cnp
->cn_nameptr
== '/') {
1285 NAME_CACHE_UNLOCK();
1287 if ((vp
!= NULLVP
) && (vp
->v_type
!= VLNK
) &&
1288 ((cnp
->cn_flags
& (ISLASTCN
| LOCKPARENT
| WANTPARENT
| SAVESTART
)) == ISLASTCN
)) {
1290 * if we've got a child and it's the last component, and
1291 * the lookup doesn't need to return the parent then we
1292 * can skip grabbing an iocount on the parent, since all
1293 * we're going to do with it is a vnode_put just before
1294 * we return from 'lookup'. If it's a symbolic link,
1295 * we need the parent in case the link happens to be
1296 * a relative pathname.
1303 * return the last directory we looked at
1304 * with an io reference held. If it was the one passed
1305 * in as a result of the last iteration of VNOP_LOOKUP,
1306 * it should already hold an io ref. No need to increase ref.
1310 if (dp
== ndp
->ni_usedvp
) {
1312 * if this vnode matches the one passed in via USEDVP
1313 * than this context already holds an io_count... just
1314 * use vnode_get to get an extra ref for lookup to play
1315 * with... can't use the getwithvid variant here because
1316 * it will block behind a vnode_drain which would result
1317 * in a deadlock (since we already own an io_count that the
1318 * vnode_drain is waiting on)... vnode_get grabs the io_count
1319 * immediately w/o waiting... it always succeeds
1322 } else if ((error
= vnode_getwithvid_drainok(dp
, vid
))) {
1324 * failure indicates the vnode
1325 * changed identity or is being
1326 * TERMINATED... in either case
1329 * don't necessarily return ENOENT, though, because
1330 * we really want to go back to disk and make sure it's
1331 * there or not if someone else is changing this
1332 * vnode. That being said, the one case where we do want
1333 * to return ENOENT is when the vnode's mount point is
1334 * in the process of unmounting and we might cause a deadlock
1335 * in our attempt to take an iocount. An ENODEV error return
1336 * is from vnode_get* is an indication this but we change that
1337 * ENOENT for upper layers.
1339 if (error
== ENODEV
) {
1349 if ( (vnode_getwithvid_drainok(vp
, vvid
)) ) {
1353 * can't get reference on the vp we'd like
1354 * to return... if we didn't grab a reference
1355 * on the directory (due to fast path bypass),
1356 * then we need to do it now... we can't return
1357 * with both ni_dvp and ni_vp NULL, and no
1371 trigger_vp
= vp
? vp
: dp
;
1372 if ((error
== 0) && (trigger_vp
!= NULLVP
) && vnode_isdir(trigger_vp
)) {
1373 error
= vnode_trigger_resolve(trigger_vp
, ndp
, ctx
);
1382 #endif /* CONFIG_TRIGGERS */
1386 * If we came into cache_lookup_path after an iteration of the lookup loop that
1387 * resulted in a call to VNOP_LOOKUP, then VNOP_LOOKUP returned a vnode with a io ref
1388 * on it. It is now the job of cache_lookup_path to drop the ref on this vnode
1389 * when it is no longer needed. If we get to this point, and last_dp is not NULL
1390 * and it is ALSO not the dvp we want to return to caller of this function, it MUST be
1391 * the case that we got to a subsequent path component and this previous vnode is
1392 * no longer needed. We can then drop the io ref on it.
1394 if ((last_dp
!= NULLVP
) && (last_dp
!= ndp
->ni_dvp
)){
1398 //initialized to 0, should be the same if no error cases occurred.
1404 cache_lookup_locked(vnode_t dvp
, struct componentname
*cnp
)
1406 struct namecache
*ncp
;
1407 struct nchashhead
*ncpp
;
1408 long namelen
= cnp
->cn_namelen
;
1409 unsigned int hashval
= cnp
->cn_hash
;
1415 ncpp
= NCHHASH(dvp
, cnp
->cn_hash
);
1416 LIST_FOREACH(ncp
, ncpp
, nc_hash
) {
1417 if ((ncp
->nc_dvp
== dvp
) && (ncp
->nc_hashval
== hashval
)) {
1418 if (memcmp(ncp
->nc_name
, cnp
->cn_nameptr
, namelen
) == 0 && ncp
->nc_name
[namelen
] == 0)
1424 * We failed to find an entry
1429 NCHSTAT(ncs_goodhits
);
1431 return (ncp
->nc_vp
);
1435 unsigned int hash_string(const char *cp
, int len
);
1437 // Have to take a len argument because we may only need to
1438 // hash part of a componentname.
1441 hash_string(const char *cp
, int len
)
1447 hash
= crc32tab
[((hash
>> 24) ^ (unsigned char)*cp
++)] ^ hash
<< 8;
1450 while (*cp
!= '\0') {
1451 hash
= crc32tab
[((hash
>> 24) ^ (unsigned char)*cp
++)] ^ hash
<< 8;
1455 * the crc generator can legitimately generate
1456 * a 0... however, 0 for us means that we
1457 * haven't computed a hash, so use 1 instead
1466 * Lookup an entry in the cache
1468 * We don't do this if the segment name is long, simply so the cache
1469 * can avoid holding long names (which would either waste space, or
1470 * add greatly to the complexity).
1472 * Lookup is called with dvp pointing to the directory to search,
1473 * cnp pointing to the name of the entry being sought. If the lookup
1474 * succeeds, the vnode is returned in *vpp, and a status of -1 is
1475 * returned. If the lookup determines that the name does not exist
1476 * (negative cacheing), a status of ENOENT is returned. If the lookup
1477 * fails, a status of zero is returned.
1481 cache_lookup(struct vnode
*dvp
, struct vnode
**vpp
, struct componentname
*cnp
)
1483 struct namecache
*ncp
;
1484 struct nchashhead
*ncpp
;
1485 long namelen
= cnp
->cn_namelen
;
1486 unsigned int hashval
;
1487 boolean_t have_exclusive
= FALSE
;
1491 if (cnp
->cn_hash
== 0)
1492 cnp
->cn_hash
= hash_string(cnp
->cn_nameptr
, cnp
->cn_namelen
);
1493 hashval
= cnp
->cn_hash
;
1499 NAME_CACHE_LOCK_SHARED();
1502 ncpp
= NCHHASH(dvp
, cnp
->cn_hash
);
1503 LIST_FOREACH(ncp
, ncpp
, nc_hash
) {
1504 if ((ncp
->nc_dvp
== dvp
) && (ncp
->nc_hashval
== hashval
)) {
1505 if (memcmp(ncp
->nc_name
, cnp
->cn_nameptr
, namelen
) == 0 && ncp
->nc_name
[namelen
] == 0)
1509 /* We failed to find an entry */
1512 NAME_CACHE_UNLOCK();
1516 /* We don't want to have an entry, so dump it */
1517 if ((cnp
->cn_flags
& MAKEENTRY
) == 0) {
1518 if (have_exclusive
== TRUE
) {
1519 NCHSTAT(ncs_badhits
);
1520 cache_delete(ncp
, 1);
1521 NAME_CACHE_UNLOCK();
1524 NAME_CACHE_UNLOCK();
1526 have_exclusive
= TRUE
;
1531 /* We found a "positive" match, return the vnode */
1533 NCHSTAT(ncs_goodhits
);
1536 NAME_CACHE_UNLOCK();
1538 if (vnode_getwithvid(vp
, vid
)) {
1541 NCHSTAT(ncs_badvid
);
1542 NAME_CACHE_UNLOCK();
1550 /* We found a negative match, and want to create it, so purge */
1551 if (cnp
->cn_nameiop
== CREATE
|| cnp
->cn_nameiop
== RENAME
) {
1552 if (have_exclusive
== TRUE
) {
1553 NCHSTAT(ncs_badhits
);
1554 cache_delete(ncp
, 1);
1555 NAME_CACHE_UNLOCK();
1558 NAME_CACHE_UNLOCK();
1560 have_exclusive
= TRUE
;
1565 * We found a "negative" match, ENOENT notifies client of this match.
1567 NCHSTAT(ncs_neghits
);
1569 NAME_CACHE_UNLOCK();
1574 cache_enter_create(vnode_t dvp
, vnode_t vp
, struct componentname
*cnp
)
1576 const char *strname
;
1578 if (cnp
->cn_hash
== 0)
1579 cnp
->cn_hash
= hash_string(cnp
->cn_nameptr
, cnp
->cn_namelen
);
1582 * grab 2 references on the string entered
1583 * one for the cache_enter_locked to consume
1584 * and the second to be consumed by v_name (vnode_create call point)
1586 strname
= add_name_internal(cnp
->cn_nameptr
, cnp
->cn_namelen
, cnp
->cn_hash
, TRUE
, 0);
1590 cache_enter_locked(dvp
, vp
, cnp
, strname
);
1592 NAME_CACHE_UNLOCK();
1599 * Add an entry to the cache...
1600 * but first check to see if the directory
1601 * that this entry is to be associated with has
1602 * had any cache_purges applied since we took
1603 * our identity snapshot... this check needs to
1604 * be done behind the name cache lock
1607 cache_enter_with_gen(struct vnode
*dvp
, struct vnode
*vp
, struct componentname
*cnp
, int gen
)
1610 if (cnp
->cn_hash
== 0)
1611 cnp
->cn_hash
= hash_string(cnp
->cn_nameptr
, cnp
->cn_namelen
);
1615 if (dvp
->v_nc_generation
== gen
)
1616 (void)cache_enter_locked(dvp
, vp
, cnp
, NULL
);
1618 NAME_CACHE_UNLOCK();
1623 * Add an entry to the cache.
1626 cache_enter(struct vnode
*dvp
, struct vnode
*vp
, struct componentname
*cnp
)
1628 const char *strname
;
1630 if (cnp
->cn_hash
== 0)
1631 cnp
->cn_hash
= hash_string(cnp
->cn_nameptr
, cnp
->cn_namelen
);
1634 * grab 1 reference on the string entered
1635 * for the cache_enter_locked to consume
1637 strname
= add_name_internal(cnp
->cn_nameptr
, cnp
->cn_namelen
, cnp
->cn_hash
, FALSE
, 0);
1641 cache_enter_locked(dvp
, vp
, cnp
, strname
);
1643 NAME_CACHE_UNLOCK();
1648 cache_enter_locked(struct vnode
*dvp
, struct vnode
*vp
, struct componentname
*cnp
, const char *strname
)
1650 struct namecache
*ncp
, *negp
;
1651 struct nchashhead
*ncpp
;
1657 * if the entry is for -ve caching vp is null
1659 if ((vp
!= NULLVP
) && (LIST_FIRST(&vp
->v_nclinks
))) {
1661 * someone beat us to the punch..
1662 * this vnode is already in the cache
1664 if (strname
!= NULL
)
1665 vfs_removename(strname
);
1669 * We allocate a new entry if we are less than the maximum
1670 * allowed and the one at the front of the list is in use.
1671 * Otherwise we use the one at the front of the list.
1673 if (numcache
< desiredNodes
&&
1674 ((ncp
= nchead
.tqh_first
) == NULL
||
1675 ncp
->nc_hash
.le_prev
!= 0)) {
1677 * Allocate one more entry
1679 ncp
= (struct namecache
*)_MALLOC_ZONE(sizeof(*ncp
), M_CACHE
, M_WAITOK
);
1683 * reuse an old entry
1685 ncp
= TAILQ_FIRST(&nchead
);
1686 TAILQ_REMOVE(&nchead
, ncp
, nc_entry
);
1688 if (ncp
->nc_hash
.le_prev
!= 0) {
1690 * still in use... we need to
1691 * delete it before re-using it
1693 NCHSTAT(ncs_stolen
);
1694 cache_delete(ncp
, 0);
1697 NCHSTAT(ncs_enters
);
1700 * Fill in cache info, if vp is NULL this is a "negative" cache entry.
1704 ncp
->nc_hashval
= cnp
->cn_hash
;
1706 if (strname
== NULL
)
1707 ncp
->nc_name
= add_name_internal(cnp
->cn_nameptr
, cnp
->cn_namelen
, cnp
->cn_hash
, FALSE
, 0);
1709 ncp
->nc_name
= strname
;
1711 * make us the newest entry in the cache
1712 * i.e. we'll be the last to be stolen
1714 TAILQ_INSERT_TAIL(&nchead
, ncp
, nc_entry
);
1716 ncpp
= NCHHASH(dvp
, cnp
->cn_hash
);
1719 struct namecache
*p
;
1721 for (p
= ncpp
->lh_first
; p
!= 0; p
= p
->nc_hash
.le_next
)
1723 panic("cache_enter: duplicate");
1727 * make us available to be found via lookup
1729 LIST_INSERT_HEAD(ncpp
, ncp
, nc_hash
);
1733 * add to the list of name cache entries
1736 LIST_INSERT_HEAD(&vp
->v_nclinks
, ncp
, nc_un
.nc_link
);
1739 * this is a negative cache entry (vp == NULL)
1740 * stick it on the negative cache list.
1742 TAILQ_INSERT_TAIL(&neghead
, ncp
, nc_un
.nc_negentry
);
1746 if (ncs_negtotal
> desiredNegNodes
) {
1748 * if we've reached our desired limit
1749 * of negative cache entries, delete
1752 negp
= TAILQ_FIRST(&neghead
);
1753 cache_delete(negp
, 1);
1757 * add us to the list of name cache entries that
1758 * are children of dvp
1760 LIST_INSERT_HEAD(&dvp
->v_ncchildren
, ncp
, nc_child
);
1765 * Initialize CRC-32 remainder table.
1767 static void init_crc32(void)
1770 * the CRC-32 generator polynomial is:
1771 * x^32 + x^26 + x^23 + x^22 + x^16 + x^12 + x^10
1772 * + x^8 + x^7 + x^5 + x^4 + x^2 + x + 1
1774 unsigned int crc32_polynomial
= 0x04c11db7;
1778 * pre-calculate the CRC-32 remainder for each possible octet encoding
1780 for (i
= 0; i
< 256; i
++) {
1781 unsigned int crc_rem
= i
<< 24;
1783 for (j
= 0; j
< 8; j
++) {
1784 if (crc_rem
& 0x80000000)
1785 crc_rem
= (crc_rem
<< 1) ^ crc32_polynomial
;
1787 crc_rem
= (crc_rem
<< 1);
1789 crc32tab
[i
] = crc_rem
;
1795 * Name cache initialization, from vfs_init() when we are booting
1802 desiredNegNodes
= (desiredvnodes
/ 10);
1803 desiredNodes
= desiredvnodes
+ desiredNegNodes
;
1805 TAILQ_INIT(&nchead
);
1806 TAILQ_INIT(&neghead
);
1810 nchashtbl
= hashinit(MAX(CONFIG_NC_HASH
, (2 *desiredNodes
)), M_CACHE
, &nchash
);
1811 nchashmask
= nchash
;
1814 init_string_table();
1816 /* Allocate name cache lock group attribute and group */
1817 namecache_lck_grp_attr
= lck_grp_attr_alloc_init();
1819 namecache_lck_grp
= lck_grp_alloc_init("Name Cache", namecache_lck_grp_attr
);
1821 /* Allocate name cache lock attribute */
1822 namecache_lck_attr
= lck_attr_alloc_init();
1824 /* Allocate name cache lock */
1825 namecache_rw_lock
= lck_rw_alloc_init(namecache_lck_grp
, namecache_lck_attr
);
1828 /* Allocate string cache lock group attribute and group */
1829 strcache_lck_grp_attr
= lck_grp_attr_alloc_init();
1831 strcache_lck_grp
= lck_grp_alloc_init("String Cache", strcache_lck_grp_attr
);
1833 /* Allocate string cache lock attribute */
1834 strcache_lck_attr
= lck_attr_alloc_init();
1836 /* Allocate string cache lock */
1837 strtable_rw_lock
= lck_rw_alloc_init(strcache_lck_grp
, strcache_lck_attr
);
1839 for (i
= 0; i
< NUM_STRCACHE_LOCKS
; i
++)
1840 lck_mtx_init(&strcache_mtx_locks
[i
], strcache_lck_grp
, strcache_lck_attr
);
1844 name_cache_lock_shared(void)
1846 lck_rw_lock_shared(namecache_rw_lock
);
1850 name_cache_lock(void)
1852 lck_rw_lock_exclusive(namecache_rw_lock
);
1856 name_cache_unlock(void)
1858 lck_rw_done(namecache_rw_lock
);
1863 resize_namecache(u_int newsize
)
1865 struct nchashhead
*new_table
;
1866 struct nchashhead
*old_table
;
1867 struct nchashhead
*old_head
, *head
;
1868 struct namecache
*entry
, *next
;
1869 uint32_t i
, hashval
;
1870 int dNodes
, dNegNodes
;
1871 u_long new_size
, old_size
;
1873 dNegNodes
= (newsize
/ 10);
1874 dNodes
= newsize
+ dNegNodes
;
1876 // we don't support shrinking yet
1877 if (dNodes
<= desiredNodes
) {
1880 new_table
= hashinit(2 * dNodes
, M_CACHE
, &nchashmask
);
1881 new_size
= nchashmask
+ 1;
1883 if (new_table
== NULL
) {
1889 old_table
= nchashtbl
;
1890 nchashtbl
= new_table
;
1894 // walk the old table and insert all the entries into
1897 for(i
=0; i
< old_size
; i
++) {
1898 old_head
= &old_table
[i
];
1899 for (entry
=old_head
->lh_first
; entry
!= NULL
; entry
=next
) {
1901 // XXXdbg - Beware: this assumes that hash_string() does
1902 // the same thing as what happens in
1903 // lookup() over in vfs_lookup.c
1904 hashval
= hash_string(entry
->nc_name
, 0);
1905 entry
->nc_hashval
= hashval
;
1906 head
= NCHHASH(entry
->nc_dvp
, hashval
);
1908 next
= entry
->nc_hash
.le_next
;
1909 LIST_INSERT_HEAD(head
, entry
, nc_hash
);
1912 desiredNodes
= dNodes
;
1913 desiredNegNodes
= dNegNodes
;
1915 NAME_CACHE_UNLOCK();
1916 FREE(old_table
, M_CACHE
);
1922 cache_delete(struct namecache
*ncp
, int age_entry
)
1924 NCHSTAT(ncs_deletes
);
1927 LIST_REMOVE(ncp
, nc_un
.nc_link
);
1929 TAILQ_REMOVE(&neghead
, ncp
, nc_un
.nc_negentry
);
1932 LIST_REMOVE(ncp
, nc_child
);
1934 LIST_REMOVE(ncp
, nc_hash
);
1936 * this field is used to indicate
1937 * that the entry is in use and
1938 * must be deleted before it can
1941 ncp
->nc_hash
.le_prev
= NULL
;
1945 * make it the next one available
1946 * for cache_enter's use
1948 TAILQ_REMOVE(&nchead
, ncp
, nc_entry
);
1949 TAILQ_INSERT_HEAD(&nchead
, ncp
, nc_entry
);
1951 vfs_removename(ncp
->nc_name
);
1952 ncp
->nc_name
= NULL
;
1957 * purge the entry associated with the
1958 * specified vnode from the name cache
1961 cache_purge(vnode_t vp
)
1963 struct namecache
*ncp
;
1964 kauth_cred_t tcred
= NULL
;
1966 if ((LIST_FIRST(&vp
->v_nclinks
) == NULL
) &&
1967 (LIST_FIRST(&vp
->v_ncchildren
) == NULL
) &&
1968 (vp
->v_cred
== NOCRED
) &&
1969 (vp
->v_parent
== NULLVP
))
1975 vp
->v_parent
->v_nc_generation
++;
1977 while ( (ncp
= LIST_FIRST(&vp
->v_nclinks
)) )
1978 cache_delete(ncp
, 1);
1980 while ( (ncp
= LIST_FIRST(&vp
->v_ncchildren
)) )
1981 cache_delete(ncp
, 1);
1984 * Use a temp variable to avoid kauth_cred_unref() while NAME_CACHE_LOCK is held
1987 vp
->v_cred
= NOCRED
;
1988 vp
->v_authorized_actions
= 0;
1990 NAME_CACHE_UNLOCK();
1992 if (IS_VALID_CRED(tcred
))
1993 kauth_cred_unref(&tcred
);
1997 * Purge all negative cache entries that are children of the
1998 * given vnode. A case-insensitive file system (or any file
1999 * system that has multiple equivalent names for the same
2000 * directory entry) can use this when creating or renaming
2001 * to remove negative entries that may no longer apply.
2004 cache_purge_negatives(vnode_t vp
)
2006 struct namecache
*ncp
, *next_ncp
;
2010 LIST_FOREACH_SAFE(ncp
, &vp
->v_ncchildren
, nc_child
, next_ncp
)
2011 if (ncp
->nc_vp
== NULL
)
2012 cache_delete(ncp
, 1);
2014 NAME_CACHE_UNLOCK();
2018 * Flush all entries referencing a particular filesystem.
2020 * Since we need to check it anyway, we will flush all the invalid
2021 * entries at the same time.
2024 cache_purgevfs(struct mount
*mp
)
2026 struct nchashhead
*ncpp
;
2027 struct namecache
*ncp
;
2030 /* Scan hash tables for applicable entries */
2031 for (ncpp
= &nchashtbl
[nchash
- 1]; ncpp
>= nchashtbl
; ncpp
--) {
2033 for (ncp
= ncpp
->lh_first
; ncp
!= 0; ncp
= ncp
->nc_hash
.le_next
) {
2034 if (ncp
->nc_dvp
->v_mount
== mp
) {
2035 cache_delete(ncp
, 0);
2040 NAME_CACHE_UNLOCK();
2046 // String ref routines
2048 static LIST_HEAD(stringhead
, string_t
) *string_ref_table
;
2049 static u_long string_table_mask
;
2050 static uint32_t filled_buckets
=0;
2053 typedef struct string_t
{
2054 LIST_ENTRY(string_t
) hash_chain
;
2061 resize_string_ref_table(void)
2063 struct stringhead
*new_table
;
2064 struct stringhead
*old_table
;
2065 struct stringhead
*old_head
, *head
;
2066 string_t
*entry
, *next
;
2067 uint32_t i
, hashval
;
2068 u_long new_mask
, old_mask
;
2071 * need to hold the table lock exclusively
2072 * in order to grow the table... need to recheck
2073 * the need to resize again after we've taken
2074 * the lock exclusively in case some other thread
2075 * beat us to the punch
2077 lck_rw_lock_exclusive(strtable_rw_lock
);
2079 if (4 * filled_buckets
< ((string_table_mask
+ 1) * 3)) {
2080 lck_rw_done(strtable_rw_lock
);
2083 new_table
= hashinit((string_table_mask
+ 1) * 2, M_CACHE
, &new_mask
);
2085 if (new_table
== NULL
) {
2086 printf("failed to resize the hash table.\n");
2087 lck_rw_done(strtable_rw_lock
);
2092 old_table
= string_ref_table
;
2093 string_ref_table
= new_table
;
2094 old_mask
= string_table_mask
;
2095 string_table_mask
= new_mask
;
2098 // walk the old table and insert all the entries into
2101 for (i
= 0; i
<= old_mask
; i
++) {
2102 old_head
= &old_table
[i
];
2103 for (entry
= old_head
->lh_first
; entry
!= NULL
; entry
= next
) {
2104 hashval
= hash_string((const char *)entry
->str
, 0);
2105 head
= &string_ref_table
[hashval
& string_table_mask
];
2106 if (head
->lh_first
== NULL
) {
2109 next
= entry
->hash_chain
.le_next
;
2110 LIST_INSERT_HEAD(head
, entry
, hash_chain
);
2113 lck_rw_done(strtable_rw_lock
);
2115 FREE(old_table
, M_CACHE
);
2120 init_string_table(void)
2122 string_ref_table
= hashinit(CONFIG_VFS_NAMES
, M_CACHE
, &string_table_mask
);
2127 vfs_addname(const char *name
, uint32_t len
, u_int hashval
, u_int flags
)
2129 return (add_name_internal(name
, len
, hashval
, FALSE
, flags
));
2134 add_name_internal(const char *name
, uint32_t len
, u_int hashval
, boolean_t need_extra_ref
, __unused u_int flags
)
2136 struct stringhead
*head
;
2138 uint32_t chain_len
= 0;
2139 uint32_t hash_index
;
2140 uint32_t lock_index
;
2144 * if the length already accounts for the null-byte, then
2145 * subtract one so later on we don't index past the end
2148 if (len
> 0 && name
[len
-1] == '\0') {
2152 hashval
= hash_string(name
, len
);
2156 * take this lock 'shared' to keep the hash stable
2157 * if someone else decides to grow the pool they
2158 * will take this lock exclusively
2160 lck_rw_lock_shared(strtable_rw_lock
);
2163 * If the table gets more than 3/4 full, resize it
2165 if (4 * filled_buckets
>= ((string_table_mask
+ 1) * 3)) {
2166 lck_rw_done(strtable_rw_lock
);
2168 resize_string_ref_table();
2170 lck_rw_lock_shared(strtable_rw_lock
);
2172 hash_index
= hashval
& string_table_mask
;
2173 lock_index
= hash_index
% NUM_STRCACHE_LOCKS
;
2175 head
= &string_ref_table
[hash_index
];
2177 lck_mtx_lock_spin(&strcache_mtx_locks
[lock_index
]);
2179 for (entry
= head
->lh_first
; entry
!= NULL
; chain_len
++, entry
= entry
->hash_chain
.le_next
) {
2180 if (memcmp(entry
->str
, name
, len
) == 0 && entry
->str
[len
] == 0) {
2185 if (entry
== NULL
) {
2186 lck_mtx_convert_spin(&strcache_mtx_locks
[lock_index
]);
2188 * it wasn't already there so add it.
2190 MALLOC(entry
, string_t
*, sizeof(string_t
) + len
+ 1, M_TEMP
, M_WAITOK
);
2192 if (head
->lh_first
== NULL
) {
2193 OSAddAtomic(1, &filled_buckets
);
2195 ptr
= (char *)((char *)entry
+ sizeof(string_t
));
2196 strncpy(ptr
, name
, len
);
2199 entry
->refcount
= 1;
2200 LIST_INSERT_HEAD(head
, entry
, hash_chain
);
2202 if (need_extra_ref
== TRUE
)
2205 lck_mtx_unlock(&strcache_mtx_locks
[lock_index
]);
2206 lck_rw_done(strtable_rw_lock
);
2208 return (const char *)entry
->str
;
2213 vfs_removename(const char *nameref
)
2215 struct stringhead
*head
;
2218 uint32_t hash_index
;
2219 uint32_t lock_index
;
2220 int retval
= ENOENT
;
2222 hashval
= hash_string(nameref
, 0);
2225 * take this lock 'shared' to keep the hash stable
2226 * if someone else decides to grow the pool they
2227 * will take this lock exclusively
2229 lck_rw_lock_shared(strtable_rw_lock
);
2231 * must compute the head behind the table lock
2232 * since the size and location of the table
2233 * can change on the fly
2235 hash_index
= hashval
& string_table_mask
;
2236 lock_index
= hash_index
% NUM_STRCACHE_LOCKS
;
2238 head
= &string_ref_table
[hash_index
];
2240 lck_mtx_lock_spin(&strcache_mtx_locks
[lock_index
]);
2242 for (entry
= head
->lh_first
; entry
!= NULL
; entry
= entry
->hash_chain
.le_next
) {
2243 if (entry
->str
== nameref
) {
2246 if (entry
->refcount
== 0) {
2247 LIST_REMOVE(entry
, hash_chain
);
2249 if (head
->lh_first
== NULL
) {
2250 OSAddAtomic(-1, &filled_buckets
);
2259 lck_mtx_unlock(&strcache_mtx_locks
[lock_index
]);
2260 lck_rw_done(strtable_rw_lock
);
2263 FREE(entry
, M_TEMP
);
2269 #ifdef DUMP_STRING_TABLE
2271 dump_string_table(void)
2273 struct stringhead
*head
;
2277 lck_rw_lock_shared(strtable_rw_lock
);
2279 for (i
= 0; i
<= string_table_mask
; i
++) {
2280 head
= &string_ref_table
[i
];
2281 for (entry
=head
->lh_first
; entry
!= NULL
; entry
=entry
->hash_chain
.le_next
) {
2282 printf("%6d - %s\n", entry
->refcount
, entry
->str
);
2285 lck_rw_done(strtable_rw_lock
);
2287 #endif /* DUMP_STRING_TABLE */