specdev.h revision 1.49 1 /* $NetBSD: specdev.h,v 1.49 2022/03/28 12:36:51 riastradh Exp $ */
2
3 /*-
4 * Copyright (c) 2008 The NetBSD Foundation, Inc.
5 * All rights reserved.
6 *
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
9 * are met:
10 * 1. Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
12 * 2. Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the distribution.
15 *
16 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
17 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
18 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
19 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
20 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
21 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
22 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
23 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
24 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
25 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
26 * POSSIBILITY OF SUCH DAMAGE.
27 */
28
29 /*
30 * Copyright (c) 1990, 1993
31 * The Regents of the University of California. All rights reserved.
32 *
33 * Redistribution and use in source and binary forms, with or without
34 * modification, are permitted provided that the following conditions
35 * are met:
36 * 1. Redistributions of source code must retain the above copyright
37 * notice, this list of conditions and the following disclaimer.
38 * 2. Redistributions in binary form must reproduce the above copyright
39 * notice, this list of conditions and the following disclaimer in the
40 * documentation and/or other materials provided with the distribution.
41 * 3. Neither the name of the University nor the names of its contributors
42 * may be used to endorse or promote products derived from this software
43 * without specific prior written permission.
44 *
45 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
46 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
47 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
48 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
49 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
50 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
51 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
52 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
53 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
54 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
55 * SUCH DAMAGE.
56 *
57 * @(#)specdev.h 8.6 (Berkeley) 5/21/95
58 */
59
60 #ifndef _MISCFS_SPECFS_SPECDEV_H_
61 #define _MISCFS_SPECFS_SPECDEV_H_
62
63 #include <sys/mutex.h>
64 #include <sys/vnode.h>
65
66 typedef struct specnode {
67 vnode_t *sn_next;
68 struct specdev *sn_dev;
69 u_int sn_opencnt; /* # of opens, share of sd_opencnt */
70 dev_t sn_rdev;
71 bool sn_gone;
72 } specnode_t;
73
74 typedef struct specdev {
75 struct mount *sd_mountpoint;
76 struct lockf *sd_lockf;
77 vnode_t *sd_bdevvp;
78 u_int sd_opencnt; /* # of opens; close when ->0 */
79 u_int sd_refcnt; /* # of specnodes referencing this */
80 dev_t sd_rdev;
81 volatile u_int sd_iocnt; /* # bdev/cdev_* operations active */
82 bool sd_opened; /* true if successfully opened */
83 } specdev_t;
84
85 /*
86 * Exported shorthand
87 */
88 #define v_specnext v_specnode->sn_next
89 #define v_rdev v_specnode->sn_rdev
90 #define v_speclockf v_specnode->sn_dev->sd_lockf
91
92 /*
93 * Special device management
94 */
95 void spec_node_init(vnode_t *, dev_t);
96 void spec_node_destroy(vnode_t *);
97 int spec_node_lookup_by_dev(enum vtype, dev_t, vnode_t **);
98 int spec_node_lookup_by_mount(struct mount *, vnode_t **);
99 struct mount *spec_node_getmountedfs(vnode_t *);
100 void spec_node_setmountedfs(vnode_t *, struct mount *);
101 void spec_node_revoke(vnode_t *);
102
103 /*
104 * Prototypes for special file operations on vnodes.
105 */
106 extern int (**spec_vnodeop_p)(void *);
107 struct nameidata;
108 struct componentname;
109 struct flock;
110 struct buf;
111 struct uio;
112
113 int spec_lookup(void *);
114 int spec_open(void *);
115 int spec_close(void *);
116 int spec_read(void *);
117 int spec_write(void *);
118 int spec_fdiscard(void *);
119 int spec_ioctl(void *);
120 int spec_poll(void *);
121 int spec_kqfilter(void *);
122 int spec_mmap(void *);
123 int spec_fsync(void *);
124 #define spec_seek genfs_nullop /* XXX should query device */
125 int spec_inactive(void *);
126 int spec_reclaim(void *);
127 int spec_bmap(void *);
128 int spec_strategy(void *);
129 int spec_print(void *);
130 int spec_pathconf(void *);
131 int spec_advlock(void *);
132
133 /*
134 * This macro provides an initializer list for the fs-independent part
135 * of a filesystem's special file vnode ops descriptor table. We still
136 * need such a table in every filesystem, but we can at least avoid
137 * the cutpaste.
138 *
139 * This contains these ops:
140 * parsepath lookup
141 * create whiteout mknod open fallocate fdiscard ioctl poll kqfilter
142 * revoke mmap seek remove link rename mkdir rmdir symlink readdir
143 * readlink abortop bmap strategy pathconf advlock getpages putpages
144 *
145 * The filesystem should provide these ops that need to be its own:
146 * access and accessx
147 * getattr
148 * setattr
149 * fcntl
150 * inactive
151 * reclaim
152 * lock
153 * unlock
154 * print (should probably also call spec_print)
155 * islocked
156 * bwrite (normally vn_bwrite)
157 * openextattr
158 * closeextattr
159 * getextattr
160 * setextattr
161 * listextattr
162 * deleteextattr
163 * getacl
164 * setacl
165 * aclcheck
166 *
167 * The filesystem should also provide these ops that some filesystems
168 * do their own things with:
169 * close
170 * read
171 * write
172 * fsync
173 * In most cases "their own things" means adjust timestamps and call
174 * spec_foo. For fsync it varies, but should always also call spec_fsync.
175 *
176 * Note that because the op descriptor tables are unordered it does not
177 * matter where in the table this macro goes (except I think default
178 * still needs to be first...)
179 */
180 #define GENFS_SPECOP_ENTRIES \
181 { &vop_parsepath_desc, genfs_badop }, /* parsepath */ \
182 { &vop_lookup_desc, spec_lookup }, /* lookup */ \
183 { &vop_create_desc, genfs_badop }, /* create */ \
184 { &vop_whiteout_desc, genfs_badop }, /* whiteout */ \
185 { &vop_mknod_desc, genfs_badop }, /* mknod */ \
186 { &vop_open_desc, spec_open }, /* open */ \
187 { &vop_fallocate_desc, genfs_eopnotsupp }, /* fallocate */ \
188 { &vop_fdiscard_desc, spec_fdiscard }, /* fdiscard */ \
189 { &vop_ioctl_desc, spec_ioctl }, /* ioctl */ \
190 { &vop_poll_desc, spec_poll }, /* poll */ \
191 { &vop_kqfilter_desc, spec_kqfilter }, /* kqfilter */ \
192 { &vop_revoke_desc, genfs_revoke }, /* revoke */ \
193 { &vop_mmap_desc, spec_mmap }, /* mmap */ \
194 { &vop_seek_desc, spec_seek }, /* seek */ \
195 { &vop_remove_desc, genfs_badop }, /* remove */ \
196 { &vop_link_desc, genfs_badop }, /* link */ \
197 { &vop_rename_desc, genfs_badop }, /* rename */ \
198 { &vop_mkdir_desc, genfs_badop }, /* mkdir */ \
199 { &vop_rmdir_desc, genfs_badop }, /* rmdir */ \
200 { &vop_symlink_desc, genfs_badop }, /* symlink */ \
201 { &vop_readdir_desc, genfs_badop }, /* readdir */ \
202 { &vop_readlink_desc, genfs_badop }, /* readlink */ \
203 { &vop_abortop_desc, genfs_badop }, /* abortop */ \
204 { &vop_bmap_desc, spec_bmap }, /* bmap */ \
205 { &vop_strategy_desc, spec_strategy }, /* strategy */ \
206 { &vop_pathconf_desc, spec_pathconf }, /* pathconf */ \
207 { &vop_advlock_desc, spec_advlock }, /* advlock */ \
208 { &vop_getpages_desc, genfs_getpages }, /* getpages */ \
209 { &vop_putpages_desc, genfs_putpages } /* putpages */
210
211
212 bool iskmemvp(struct vnode *);
213 void spec_init(void);
214
215 #endif /* _MISCFS_SPECFS_SPECDEV_H_ */
216