1/*
2 * Copyright (c) 2016 Apple Inc. All rights reserved.
3 *
4 * @APPLE_LICENSE_HEADER_START@
5 *
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. Please obtain a copy of the License at
10 * http://www.opensource.apple.com/apsl/ and read it before using this
11 * file.
12 *
13 * The Original Code and all software distributed under the License are
14 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
15 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
16 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
17 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
18 * Please see the License for the specific language governing rights and
19 * limitations under the License.
20 *
21 * @APPLE_LICENSE_HEADER_END@
22 */
23
24/*-
25 * Portions Copyright (c) 1992, 1993
26 * The Regents of the University of California. All rights reserved.
27 *
28 * This code is derived from software donated to Berkeley by
29 * Jan-Simon Pendry.
30 *
31 * Redistribution and use in source and binary forms, with or without
32 * modification, are permitted provided that the following conditions
33 * are met:
34 * 1. Redistributions of source code must retain the above copyright
35 * notice, this list of conditions and the following disclaimer.
36 * 2. Redistributions in binary form must reproduce the above copyright
37 * notice, this list of conditions and the following disclaimer in the
38 * documentation and/or other materials provided with the distribution.
39 * 4. Neither the name of the University nor the names of its contributors
40 * may be used to endorse or promote products derived from this software
41 * without specific prior written permission.
42 *
43 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
44 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
45 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
46 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
47 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
48 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
49 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
50 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
51 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
52 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
53 * SUCH DAMAGE.
54 *
55 * @(#)null.h 8.3 (Berkeley) 8/20/94
56 *
57 * $FreeBSD$
58 */
59
60#ifndef FS_NULL_H
61#define FS_NULL_H
62
63#include <sys/appleapiopts.h>
64#include <libkern/libkern.h>
65#include <sys/vnode.h>
66#include <sys/vnode_if.h>
67#include <sys/ubc.h>
68#include <vfs/vfs_support.h>
69#include <sys/lock.h>
70
71#include <sys/cdefs.h>
72#include <sys/types.h>
73#include <sys/syslimits.h>
74
75#if KERNEL
76#include <libkern/tree.h>
77#else
78#include <System/libkern/tree.h>
79#endif
80
81//#define NULLFS_DEBUG 0
82
83#define NULLM_CACHE 0x0001
84#define NULLM_CASEINSENSITIVE 0x0000000000000002
85
86typedef int (*vop_t)(void *);
87
88struct null_mount {
89 struct vnode * nullm_rootvp; /* Reference to root null_node (inode 1) */
90 struct vnode * nullm_secondvp; /* Reference to virtual directory vnode to wrap app
91 bundles (inode 2) */
92 struct vnode * nullm_thirdcovervp; /* Reference to vnode that covers
93 lowerrootvp (inode 3) */
94 struct vnode * nullm_lowerrootvp; /* reference to the root of the tree we are
95 relocating (in the other file system) */
96 uint32_t nullm_lowerrootvid; /* store the lower root vid so we can check
97 before we build the shadow vnode lazily*/
98 lck_mtx_t nullm_lock; /* lock to protect vps above */
99 uint64_t nullm_flags;
100};
101
102#ifdef KERNEL
103
104#define NULL_FLAG_HASHED 0x000000001
105
106/*
107 * A cache of vnode references
108 */
109struct null_node {
110 LIST_ENTRY(null_node) null_hash; /* Hash list */
111 struct vnode * null_lowervp; /* VREFed once */
112 struct vnode * null_vnode; /* Back pointer */
113 uint32_t null_lowervid; /* vid for lowervp to detect lowervp getting recycled out
114 from under us */
115 uint32_t null_myvid;
116 uint32_t null_flags;
117};
118
119struct vnodeop_desc_fake {
120 int vdesc_offset;
121 const char * vdesc_name;
122 /* other stuff */
123};
124
125#define NULLV_NOUNLOCK 0x0001
126#define NULLV_DROP 0x0002
127
128#define MOUNTTONULLMOUNT(mp) ((struct null_mount *)(vfs_fsprivate(mp)))
129#define VTONULL(vp) ((struct null_node *)vnode_fsnode(vp))
130#define NULLTOV(xp) ((xp)->null_vnode)
131
132__BEGIN_DECLS
133
134int nullfs_init(struct vfsconf * vfsp);
135int nullfs_init_lck(lck_mtx_t * lck);
136int nullfs_destroy_lck(lck_mtx_t * lck);
137int nullfs_uninit(void);
138int null_nodeget(
139 struct mount * mp, struct vnode * lowervp, struct vnode * dvp, struct vnode ** vpp, struct componentname * cnp, int root);
140int null_hashget(struct mount * mp, struct vnode * lowervp, struct vnode ** vpp);
141int null_getnewvnode(
142 struct mount * mp, struct vnode * lowervp, struct vnode * dvp, struct vnode ** vpp, struct componentname * cnp, int root);
143void null_hashrem(struct null_node * xp);
144
145int nullfs_getbackingvnode(vnode_t in_vp, vnode_t* out_vpp);
146
147#define NULLVPTOLOWERVP(vp) (VTONULL(vp)->null_lowervp)
148#define NULLVPTOLOWERVID(vp) (VTONULL(vp)->null_lowervid)
149#define NULLVPTOMYVID(vp) (VTONULL(vp)->null_myvid)
150
151extern struct vnodeopv_desc nullfs_vnodeop_opv_desc;
152
153extern vop_t * nullfs_vnodeop_p;
154
155__END_DECLS
156
157#ifdef NULLFS_DEBUG
158#define NULLFSDEBUG(format, args...) printf(format, ##args)
159#else
160#define NULLFSDEBUG(format, args...)
161#endif /* NULLFS_DEBUG */
162
163#endif /* KERNEL */
164
165#endif
166