kernfs.h revision 1.37 1 /* $NetBSD: kernfs.h,v 1.37 2012/03/22 20:34:38 drochner Exp $ */
2
3 /*
4 * Copyright (c) 1992, 1993
5 * The Regents of the University of California. All rights reserved.
6 *
7 * This code is derived from software donated to Berkeley by
8 * Jan-Simon Pendry.
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. Neither the name of the University nor the names of its contributors
19 * may be used to endorse or promote products derived from this software
20 * without specific prior written permission.
21 *
22 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
23 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
26 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32 * SUCH DAMAGE.
33 *
34 * @(#)kernfs.h 8.6 (Berkeley) 3/29/95
35 */
36
37 #define _PATH_KERNFS "/kern" /* Default mountpoint */
38
39 #ifdef _KERNEL
40 #include <sys/queue.h>
41 #include <sys/tree.h>
42
43 /*
44 * The different types of node in a kernfs filesystem
45 */
46 typedef enum {
47 KFSkern, /* the filesystem itself (.) */
48 KFSroot, /* the filesystem root (..) */
49 KFSnull, /* none aplicable */
50 KFStime, /* boottime */
51 KFSint, /* integer */
52 KFSstring, /* string */
53 KFShostname, /* hostname */
54 KFSavenrun, /* loadavg */
55 KFSdevice, /* device file (rootdev/rrootdev) */
56 KFSmsgbuf, /* msgbuf */
57 KFSsubdir, /* directory */
58 KFSlasttype, /* last used type */
59 KFSmaxtype = (1<<6) - 1 /* last possible type */
60 } kfstype;
61
62 /*
63 * Control data for the kern file system.
64 */
65 struct kern_target {
66 u_char kt_type;
67 u_char kt_namlen;
68 const char *kt_name;
69 void *kt_data;
70 kfstype kt_tag;
71 u_char kt_vtype;
72 mode_t kt_mode;
73 };
74
75 struct dyn_kern_target {
76 struct kern_target dkt_kt;
77 SIMPLEQ_ENTRY(dyn_kern_target) dkt_queue;
78 };
79
80 struct kernfs_subdir {
81 SIMPLEQ_HEAD(,dyn_kern_target) ks_entries;
82 unsigned int ks_nentries;
83 unsigned int ks_dirs;
84 const struct kern_target *ks_parent;
85 };
86
87 struct kernfs_node {
88 LIST_ENTRY(kernfs_node) kfs_hash; /* hash chain */
89 TAILQ_ENTRY(kernfs_node) kfs_list; /* flat list */
90 struct vnode *kfs_vnode; /* vnode associated with this kernfs_node */
91 kfstype kfs_type; /* type of kernfs node */
92 mode_t kfs_mode; /* mode bits for stat() */
93 long kfs_fileno; /* unique file id */
94 u_int32_t kfs_value; /* SA id or SP id (KFSint) */
95 const struct kern_target *kfs_kt;
96 void *kfs_v; /* pointer to secasvar/secpolicy/mbuf */
97 long kfs_cookie; /* fileno cookie */
98 };
99
100 struct kernfs_mount {
101 TAILQ_HEAD(, kernfs_node) nodelist;
102 long fileno_cookie;
103 };
104
105 #define UIO_MX 32
106
107 #define KERNFS_FILENO(kt, typ, cookie) \
108 ((kt >= &kern_targets[0] && kt < &kern_targets[static_nkern_targets]) \
109 ? 2 + ((kt) - &kern_targets[0]) \
110 : (((cookie + 1) << 6) | (typ)))
111 #define KERNFS_TYPE_FILENO(typ, cookie) \
112 (((cookie + 1) << 6) | (typ))
113
114 #define VFSTOKERNFS(mp) ((struct kernfs_mount *)((mp)->mnt_data))
115 #define VTOKERN(vp) ((struct kernfs_node *)(vp)->v_data)
116 #define KERNFSTOV(kfs) ((kfs)->kfs_vnode)
117
118 #define KERNFS_MAXNAMLEN 255
119
120 extern const struct kern_target kern_targets[];
121 extern int nkern_targets;
122 extern const int static_nkern_targets;
123 extern int (**kernfs_vnodeop_p)(void *);
124 extern struct vfsops kernfs_vfsops;
125 extern dev_t rrootdev;
126
127 struct secasvar;
128 struct secpolicy;
129
130 int kernfs_root(struct mount *, struct vnode **);
131
132 void kernfs_hashinit(void);
133 void kernfs_hashreinit(void);
134 void kernfs_hashdone(void);
135 int kernfs_freevp(struct vnode *);
136 int kernfs_allocvp(struct mount *, struct vnode **, kfstype,
137 const struct kern_target *, u_int32_t);
138
139 void kernfs_revoke_sa(struct secasvar *);
140 void kernfs_revoke_sp(struct secpolicy *);
141
142 /*
143 * Data types for the kernfs file operations.
144 */
145 typedef enum {
146 KERNFS_XREAD,
147 KERNFS_XWRITE,
148 KERNFS_FILEOP_CLOSE,
149 KERNFS_FILEOP_GETATTR,
150 KERNFS_FILEOP_IOCTL,
151 KERNFS_FILEOP_OPEN,
152 KERNFS_FILEOP_READ,
153 KERNFS_FILEOP_WRITE,
154 } kfsfileop;
155
156 struct kernfs_fileop {
157 kfstype kf_type;
158 kfsfileop kf_fileop;
159 union {
160 int (*_kf_vop)(void *);
161 int (*_kf_xread)
162 (const struct kernfs_node *, char **, size_t);
163 int (*_kf_xwrite)
164 (const struct kernfs_node *, char *, size_t);
165 } _kf_opfn;
166 SPLAY_ENTRY(kernfs_fileop) kf_node;
167 };
168
169 #define kf_vop _kf_opfn._kf_vop
170 #define kf_xread _kf_opfn._kf_xread
171 #define kf_xwrite _kf_opfn._kf_xwrite
172
173 typedef struct kern_target kernfs_parentdir_t;
174 typedef struct dyn_kern_target kernfs_entry_t;
175
176 /*
177 * Functions for adding kernfs datatypes and nodes.
178 */
179 kfstype kernfs_alloctype(int, const struct kernfs_fileop *);
180 #define KERNFS_ALLOCTYPE(kf) kernfs_alloctype(sizeof((kf)) / \
181 sizeof((kf)[0]), (kf))
182 #define KERNFS_ALLOCENTRY(dkt, m_type, m_flags) \
183 dkt = (struct dyn_kern_target *)malloc( \
184 sizeof(struct dyn_kern_target), (m_type), (m_flags))
185 #define KERNFS_INITENTRY(dkt, type, name, data, tag, vtype, mode) do { \
186 (dkt)->dkt_kt.kt_type = (type); \
187 (dkt)->dkt_kt.kt_namlen = strlen((name)); \
188 (dkt)->dkt_kt.kt_name = (name); \
189 (dkt)->dkt_kt.kt_data = (data); \
190 (dkt)->dkt_kt.kt_tag = (tag); \
191 (dkt)->dkt_kt.kt_vtype = (vtype); \
192 (dkt)->dkt_kt.kt_mode = (mode); \
193 } while (/*CONSTCOND*/0)
194 #define KERNFS_ENTOPARENTDIR(dkt) &(dkt)->dkt_kt
195 int kernfs_addentry(kernfs_parentdir_t *, kernfs_entry_t *);
196
197 #ifdef IPSEC
198 __weak_extern(key_freesp)
199 __weak_extern(key_getspbyid)
200 __weak_extern(key_setdumpsa_spi)
201 __weak_extern(key_setdumpsp)
202 __weak_extern(satailq)
203 __weak_extern(sptailq)
204 #endif
205
206 #endif /* _KERNEL */
207