puffs.h revision 1.66 1 /* $NetBSD: puffs.h,v 1.66 2007/06/24 22:25:49 pooka Exp $ */
2
3 /*
4 * Copyright (c) 2005, 2006, 2007 Antti Kantee. All Rights Reserved.
5 *
6 * Development of this software was supported by the
7 * Google Summer of Code program and the Ulla Tuominen Foundation.
8 * The Google SoC project was mentored by Bill Studenmund.
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 *
19 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS
20 * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
21 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
22 * DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
23 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
24 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
25 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
26 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
27 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
28 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29 * SUCH DAMAGE.
30 */
31
32 #ifndef _PUFFS_H_
33 #define _PUFFS_H_
34
35 #include <sys/param.h>
36 #include <sys/types.h>
37 #include <sys/mount.h>
38 #include <sys/stat.h>
39 #include <sys/statvfs.h>
40 #include <sys/time.h>
41 #include <sys/vnode.h>
42
43 #include <fs/puffs/puffs_msgif.h>
44
45 #include <mntopts.h>
46 #include <string.h>
47
48 /* forwards */
49 struct puffs_cc;
50
51 struct puffs_getreq;
52 struct puffs_putreq;
53
54 /* paths */
55 struct puffs_pathobj {
56 void *po_path;
57 size_t po_len;
58 uint32_t po_hash;
59 };
60
61 /* for prefix rename */
62 struct puffs_pathinfo {
63 struct puffs_pathobj *pi_old;
64 struct puffs_pathobj *pi_new;
65 };
66
67 /* describes one segment cached in the kernel */
68 struct puffs_kcache {
69 off_t pkc_start;
70 off_t pkc_end;
71
72 LIST_ENTRY(puffs_kcache) pkc_entries;
73 };
74
75 /* XXX: might disappear from here into a private header */
76 struct puffs_node {
77 off_t pn_size;
78 int pn_flags;
79 struct vattr pn_va;
80
81 void *pn_data; /* private data */
82
83 struct puffs_pathobj pn_po; /* PUFFS_FLAG_BUILDPATH */
84
85 struct puffs_usermount *pn_mnt;
86 LIST_ENTRY(puffs_node) pn_entries;
87
88 LIST_HEAD(,puffs_kcache)pn_cacheinfo; /* PUFFS_KFLAG_CACHE */
89 };
90 #define PUFFS_NODE_REMOVED 0x01 /* not on entry list */
91
92
93 struct puffs_usermount;
94
95 /*
96 * megaXXX: these are values from inside _KERNEL
97 * need to work on the translation for ALL the necessary values.
98 */
99 #define PUFFS_VNOVAL (-1)
100 #define PUFFS_IO_APPEND 0x20
101 #define PUFFS_VEXEC 01
102 #define PUFFS_VWRITE 02
103 #define PUFFS_VREAD 04
104
105 #define PUFFS_FSYNC_DATAONLY 0x0002
106 #define PUFFS_FSYNC_CACHE 0x0100
107
108 /*
109 * Magic constants
110 */
111 #define PUFFS_CC_STACKSIZE_DEFAULT (1024*1024)
112
113 struct puffs_cn {
114 struct puffs_kcn *pcn_pkcnp; /* kernel input */
115 struct puffs_pathobj pcn_po_full; /* PUFFS_FLAG_BUILDPATH */
116 };
117 #define pcn_nameiop pcn_pkcnp->pkcn_nameiop
118 #define pcn_flags pcn_pkcnp->pkcn_flags
119 #define pcn_pid pcn_pkcnp->pkcn_pid
120 #define pcn_cred pcn_pkcnp->pkcn_cred
121 #define pcn_name pcn_pkcnp->pkcn_name
122 #define pcn_namelen pcn_pkcnp->pkcn_namelen
123
124 /*
125 * Puffs options to mount
126 */
127 /* kernel */
128 #define PUFFSMOPT_NAMECACHE { "namecache", 1, PUFFS_KFLAG_NOCACHE_NAME, 1 }
129 #define PUFFSMOPT_PAGECACHE { "pagecache", 1, PUFFS_KFLAG_NOCACHE_PAGE, 1 }
130 #define PUFFSMOPT_CACHE { "cache", 1, PUFFS_KFLAG_NOCACHE, 1 }
131 #define PUFFSMOPT_ALLOPS { "allops", 0, PUFFS_KFLAG_ALLOPS, 1 }
132
133 /* libpuffs */
134 #define PUFFSMOPT_DUMP { "dump", 0, PUFFS_FLAG_OPDUMP, 1 }
135
136 #define PUFFSMOPT_STD \
137 PUFFSMOPT_NAMECACHE, \
138 PUFFSMOPT_PAGECACHE, \
139 PUFFSMOPT_CACHE, \
140 PUFFSMOPT_ALLOPS, \
141 PUFFSMOPT_DUMP
142
143 extern const struct mntopt puffsmopts[]; /* puffs.c */
144
145 /* callbacks for operations */
146 struct puffs_ops {
147 int (*puffs_fs_unmount)(struct puffs_cc *, int, pid_t);
148 int (*puffs_fs_statvfs)(struct puffs_cc *,
149 struct statvfs *, pid_t);
150 int (*puffs_fs_sync)(struct puffs_cc *, int,
151 const struct puffs_cred *, pid_t);
152 int (*puffs_fs_fhtonode)(struct puffs_cc *, void *, size_t,
153 void **, enum vtype *, voff_t *, dev_t *);
154 int (*puffs_fs_nodetofh)(struct puffs_cc *, void *cookie,
155 void *, size_t *);
156 void (*puffs_fs_suspend)(struct puffs_cc *, int);
157
158 int (*puffs_node_lookup)(struct puffs_cc *,
159 void *, void **, enum vtype *, voff_t *, dev_t *,
160 const struct puffs_cn *);
161 int (*puffs_node_create)(struct puffs_cc *,
162 void *, void **, const struct puffs_cn *, const struct vattr *);
163 int (*puffs_node_mknod)(struct puffs_cc *,
164 void *, void **, const struct puffs_cn *, const struct vattr *);
165 int (*puffs_node_open)(struct puffs_cc *,
166 void *, int, const struct puffs_cred *, pid_t);
167 int (*puffs_node_close)(struct puffs_cc *,
168 void *, int, const struct puffs_cred *, pid_t);
169 int (*puffs_node_access)(struct puffs_cc *,
170 void *, int, const struct puffs_cred *, pid_t);
171 int (*puffs_node_getattr)(struct puffs_cc *,
172 void *, struct vattr *, const struct puffs_cred *, pid_t);
173 int (*puffs_node_setattr)(struct puffs_cc *,
174 void *, const struct vattr *, const struct puffs_cred *, pid_t);
175 int (*puffs_node_poll)(struct puffs_cc *, void *, int *, pid_t);
176 int (*puffs_node_mmap)(struct puffs_cc *,
177 void *, int, const struct puffs_cred *, pid_t);
178 int (*puffs_node_fsync)(struct puffs_cc *,
179 void *, const struct puffs_cred *, int, off_t, off_t, pid_t);
180 int (*puffs_node_seek)(struct puffs_cc *,
181 void *, off_t, off_t, const struct puffs_cred *);
182 int (*puffs_node_remove)(struct puffs_cc *,
183 void *, void *, const struct puffs_cn *);
184 int (*puffs_node_link)(struct puffs_cc *,
185 void *, void *, const struct puffs_cn *);
186 int (*puffs_node_rename)(struct puffs_cc *,
187 void *, void *, const struct puffs_cn *, void *, void *,
188 const struct puffs_cn *);
189 int (*puffs_node_mkdir)(struct puffs_cc *,
190 void *, void **, const struct puffs_cn *, const struct vattr *);
191 int (*puffs_node_rmdir)(struct puffs_cc *,
192 void *, void *, const struct puffs_cn *);
193 int (*puffs_node_symlink)(struct puffs_cc *,
194 void *, void **, const struct puffs_cn *, const struct vattr *,
195 const char *);
196 int (*puffs_node_readdir)(struct puffs_cc *,
197 void *, struct dirent *, off_t *, size_t *,
198 const struct puffs_cred *, int *, off_t *, size_t *);
199 int (*puffs_node_readlink)(struct puffs_cc *,
200 void *, const struct puffs_cred *, char *, size_t *);
201 int (*puffs_node_reclaim)(struct puffs_cc *,
202 void *, pid_t);
203 int (*puffs_node_inactive)(struct puffs_cc *,
204 void *, pid_t, int *);
205 int (*puffs_node_print)(struct puffs_cc *,
206 void *);
207 int (*puffs_node_pathconf)(struct puffs_cc *,
208 void *, int, int *);
209 int (*puffs_node_advlock)(struct puffs_cc *,
210 void *, void *, int, struct flock *, int);
211 int (*puffs_node_getextattr)(struct puffs_cc *,
212 void *, struct puffs_vnreq_getextattr *);
213 int (*puffs_node_setextattr)(struct puffs_cc *,
214 void *, struct puffs_vnreq_setextattr *);
215 int (*puffs_node_listextattr)(struct puffs_cc *,
216 void *, struct puffs_vnreq_listextattr *);
217 int (*puffs_node_read)(struct puffs_cc *, void *,
218 uint8_t *, off_t, size_t *, const struct puffs_cred *, int);
219 int (*puffs_node_write)(struct puffs_cc *, void *,
220 uint8_t *, off_t, size_t *, const struct puffs_cred *, int);
221
222 int (*puffs_cache_write)(struct puffs_usermount *,
223 void *, size_t, struct puffs_cacherun *);
224 };
225
226 typedef int (*pu_pathbuild_fn)(struct puffs_usermount *,
227 const struct puffs_pathobj *,
228 const struct puffs_pathobj *, size_t,
229 struct puffs_pathobj *);
230 typedef int (*pu_pathtransform_fn)(struct puffs_usermount *,
231 const struct puffs_pathobj *,
232 const struct puffs_cn *,
233 struct puffs_pathobj *);
234 typedef int (*pu_pathcmp_fn)(struct puffs_usermount *, struct puffs_pathobj *,
235 struct puffs_pathobj *, size_t, int);
236 typedef void (*pu_pathfree_fn)(struct puffs_usermount *,
237 struct puffs_pathobj *);
238 typedef int (*pu_namemod_fn)(struct puffs_usermount *,
239 struct puffs_pathobj *, struct puffs_cn *);
240
241 enum {
242 PUFFS_STATE_BEFOREMOUNT, PUFFS_STATE_RUNNING,
243 PUFFS_STATE_UNMOUNTING, PUFFS_STATE_UNMOUNTED
244 };
245
246 #define PUFFS_FLAG_BUILDPATH 0x80000000 /* node paths in pnode */
247 #define PUFFS_FLAG_OPDUMP 0x40000000 /* dump all operations */
248 #define PUFFS_FLAG_HASHPATH 0x20000000 /* speedup: hash paths */
249 #define PUFFS_FLAG_MASK 0xe0000000
250
251 #define PUFFS_FLAG_KERN(a) ((a) & PUFFS_KFLAG_MASK)
252 #define PUFFS_FLAG_LIB(a) ((a) & PUFFS_FLAG_MASK)
253
254 /* blocking mode argument */
255 #define PUFFSDEV_BLOCK 0
256 #define PUFFSDEV_NONBLOCK 1
257
258 /* mainloop flags */
259 #define PUFFSLOOP_NODAEMON 0x01
260
261 #define DENT_DOT 0
262 #define DENT_DOTDOT 1
263 #define DENT_ADJ(a) ((a)-2) /* nth request means dir's n-2th */
264
265
266 /*
267 * protos
268 */
269
270 #define PUFFSOP_PROTOS(fsname) \
271 int fsname##_fs_mount(struct puffs_usermount *, void **, \
272 struct statvfs *); \
273 int fsname##_fs_unmount(struct puffs_cc *, int, pid_t); \
274 int fsname##_fs_statvfs(struct puffs_cc *, \
275 struct statvfs *, pid_t); \
276 int fsname##_fs_sync(struct puffs_cc *, int, \
277 const struct puffs_cred *cred, pid_t); \
278 int fsname##_fs_fhtonode(struct puffs_cc *, void *, size_t, \
279 void **, enum vtype *, voff_t *, dev_t *); \
280 int fsname##_fs_nodetofh(struct puffs_cc *, void *cookie, \
281 void *, size_t *); \
282 void fsname##_fs_suspend(struct puffs_cc *, int); \
283 \
284 int fsname##_node_lookup(struct puffs_cc *, \
285 void *, void **, enum vtype *, voff_t *, dev_t *, \
286 const struct puffs_cn *); \
287 int fsname##_node_create(struct puffs_cc *, \
288 void *, void **, const struct puffs_cn *, \
289 const struct vattr *); \
290 int fsname##_node_mknod(struct puffs_cc *, \
291 void *, void **, const struct puffs_cn *, \
292 const struct vattr *); \
293 int fsname##_node_open(struct puffs_cc *, \
294 void *, int, const struct puffs_cred *, pid_t); \
295 int fsname##_node_close(struct puffs_cc *, \
296 void *, int, const struct puffs_cred *, pid_t); \
297 int fsname##_node_access(struct puffs_cc *, \
298 void *, int, const struct puffs_cred *, pid_t); \
299 int fsname##_node_getattr(struct puffs_cc *, \
300 void *, struct vattr *, const struct puffs_cred *, pid_t); \
301 int fsname##_node_setattr(struct puffs_cc *, \
302 void *, const struct vattr *, const struct puffs_cred *, \
303 pid_t); \
304 int fsname##_node_poll(struct puffs_cc *, void *, int *,pid_t); \
305 int fsname##_node_mmap(struct puffs_cc *, \
306 void *, int, const struct puffs_cred *, pid_t); \
307 int fsname##_node_fsync(struct puffs_cc *, \
308 void *, const struct puffs_cred *, int, off_t, off_t, \
309 pid_t); \
310 int fsname##_node_seek(struct puffs_cc *, \
311 void *, off_t, off_t, const struct puffs_cred *); \
312 int fsname##_node_remove(struct puffs_cc *, \
313 void *, void *, const struct puffs_cn *); \
314 int fsname##_node_link(struct puffs_cc *, \
315 void *, void *, const struct puffs_cn *); \
316 int fsname##_node_rename(struct puffs_cc *, \
317 void *, void *, const struct puffs_cn *, void *, void *, \
318 const struct puffs_cn *); \
319 int fsname##_node_mkdir(struct puffs_cc *, \
320 void *, void **, const struct puffs_cn *, \
321 const struct vattr *); \
322 int fsname##_node_rmdir(struct puffs_cc *, \
323 void *, void *, const struct puffs_cn *); \
324 int fsname##_node_symlink(struct puffs_cc *, \
325 void *, void **, const struct puffs_cn *, \
326 const struct vattr *, const char *); \
327 int fsname##_node_readdir(struct puffs_cc *, \
328 void *, struct dirent *, off_t *, size_t *, \
329 const struct puffs_cred *, int *, off_t *, size_t *); \
330 int fsname##_node_readlink(struct puffs_cc *, \
331 void *, const struct puffs_cred *, char *, size_t *); \
332 int fsname##_node_reclaim(struct puffs_cc *, \
333 void *, pid_t); \
334 int fsname##_node_inactive(struct puffs_cc *, \
335 void *, pid_t, int *); \
336 int fsname##_node_print(struct puffs_cc *, \
337 void *); \
338 int fsname##_node_pathconf(struct puffs_cc *, \
339 void *, int, int *); \
340 int fsname##_node_advlock(struct puffs_cc *, \
341 void *, void *, int, struct flock *, int); \
342 int fsname##_node_getextattr(struct puffs_cc *, \
343 void *, struct puffs_vnreq_getextattr *); \
344 int fsname##_node_setextattr(struct puffs_cc *, \
345 void *, struct puffs_vnreq_setextattr *); \
346 int fsname##_node_listextattr(struct puffs_cc *, \
347 void *, struct puffs_vnreq_listextattr *); \
348 int fsname##_node_read(struct puffs_cc *, void *, \
349 uint8_t *, off_t, size_t *, const struct puffs_cred *, int);\
350 int fsname##_node_write(struct puffs_cc *, void *, \
351 uint8_t *, off_t, size_t *, const struct puffs_cred *, int);\
352 \
353 int fsname##_cache_write(struct puffs_usermount *, void *, \
354 size_t, struct puffs_cacheinfo *);
355
356 #define PUFFSOP_INIT(ops) \
357 ops = malloc(sizeof(struct puffs_ops)); \
358 memset(ops, 0, sizeof(struct puffs_ops))
359 #define PUFFSOP_SET(ops, fsname, fsornode, opname) \
360 (ops)->puffs_##fsornode##_##opname = fsname##_##fsornode##_##opname
361 #define PUFFSOP_SETFSNOP(ops, opname) \
362 (ops)->puffs_fs_##opname = puffs_fsnop_##opname
363
364 PUFFSOP_PROTOS(puffs_null) /* XXX */
365
366 #define PUFFS_DEVEL_LIBVERSION 20
367 #define puffs_init(a,b,c,d) \
368 _puffs_init(PUFFS_DEVEL_LIBVERSION,a,b,c,d)
369
370
371 #define PNPATH(pnode) ((pnode)->pn_po.po_path)
372 #define PNPLEN(pnode) ((pnode)->pn_po.po_len)
373 #define PCNPATH(pcnode) ((pcnode)->pcn_po_full.po_path)
374 #define PCNPLEN(pcnode) ((pcnode)->pcn_po_full.po_len)
375 #define PCNISDOTDOT(pcnode) \
376 ((pcnode)->pcn_namelen == 2 && strcmp((pcnode)->pcn_name, "..") == 0)
377
378 #define PUFFS_STORE_DCOOKIE(cp, ncp, off) \
379 if (cp) { \
380 *((cp)++) = off; \
381 (*(ncp))++; \
382 }
383
384 /* mainloop */
385 typedef void (*puffs_ml_loop_fn)(struct puffs_usermount *);
386
387 /* framebuf stuff */
388 struct puffs_framebuf;
389 typedef int (*puffs_framev_readframe_fn)(struct puffs_usermount *,
390 struct puffs_framebuf *,
391 int, int *);
392 typedef int (*puffs_framev_writeframe_fn)(struct puffs_usermount *,
393 struct puffs_framebuf *,
394 int, int *);
395 typedef int (*puffs_framev_cmpframe_fn)(struct puffs_usermount *,
396 struct puffs_framebuf *,
397 struct puffs_framebuf *);
398 typedef void (*puffs_framev_fdnotify_fn)(struct puffs_usermount *, int, int);
399 typedef void (*puffs_framev_cb)(struct puffs_usermount *,
400 struct puffs_framebuf *,
401 void *, int);
402 #define PUFFS_FBGONE_READ 0x01
403 #define PUFFS_FBGONE_WRITE 0x02
404 #define PUFFS_FBGONE_BOTH(a) ((a)==(PUFFS_FBGONE_READ|PUFFS_FBGONE_WRITE))
405
406
407 __BEGIN_DECLS
408
409 struct puffs_usermount *_puffs_init(int, struct puffs_ops *pops, const char *,
410 void *, uint32_t);
411 int puffs_mount(struct puffs_usermount *, const char *, int, void*);
412 int puffs_exit(struct puffs_usermount *, int);
413 int puffs_mainloop(struct puffs_usermount *, int);
414
415
416 int puffs_getselectable(struct puffs_usermount *);
417 int puffs_setblockingmode(struct puffs_usermount *, int);
418 int puffs_getstate(struct puffs_usermount *);
419 void puffs_setstacksize(struct puffs_usermount *, size_t);
420
421 void puffs_ml_setloopfn(struct puffs_usermount *, puffs_ml_loop_fn);
422 void puffs_ml_settimeout(struct puffs_usermount *, struct timespec *);
423
424 void puffs_setroot(struct puffs_usermount *,
425 struct puffs_node *);
426 struct puffs_node *puffs_getroot(struct puffs_usermount *);
427 void puffs_setrootinfo(struct puffs_usermount *,
428 enum vtype, vsize_t, dev_t);
429
430 void *puffs_getspecific(struct puffs_usermount *);
431 void puffs_setmaxreqlen(struct puffs_usermount *, size_t);
432 size_t puffs_getmaxreqlen(struct puffs_usermount *);
433 void puffs_setfhsize(struct puffs_usermount *, size_t, int);
434
435 void puffs_setncookiehash(struct puffs_usermount *, int);
436
437 struct puffs_pathobj *puffs_getrootpathobj(struct puffs_usermount *);
438
439 void puffs_setback(struct puffs_cc *, int);
440
441 struct puffs_node *puffs_pn_new(struct puffs_usermount *, void *);
442 void puffs_pn_remove(struct puffs_node *);
443 void puffs_pn_put(struct puffs_node *);
444
445 void *puffs_pn_getmntspecific(struct puffs_node *);
446
447 typedef void * (*puffs_nodewalk_fn)(struct puffs_usermount *,
448 struct puffs_node *, void *);
449 void *puffs_pn_nodewalk(struct puffs_usermount *,
450 puffs_nodewalk_fn, void *);
451
452 void puffs_setvattr(struct vattr *, const struct vattr *);
453 void puffs_vattr_null(struct vattr *);
454
455 void puffs_null_setops(struct puffs_ops *);
456
457 /*
458 * generic/dummy routines applicable for some file systems
459 */
460 int puffs_fsnop_unmount(struct puffs_cc *, int, pid_t);
461 int puffs_fsnop_statvfs(struct puffs_cc *, struct statvfs *, pid_t);
462 void puffs_zerostatvfs(struct statvfs *);
463 int puffs_fsnop_sync(struct puffs_cc *, int waitfor,
464 const struct puffs_cred *, pid_t);
465 int puffs_genfs_node_reclaim(struct puffs_cc *, void *, pid_t);
466
467 /*
468 * Subroutine stuff
469 */
470
471 int puffs_gendotdent(struct dirent **, ino_t, int, size_t *);
472 int puffs_nextdent(struct dirent **, const char *, ino_t,
473 uint8_t, size_t *);
474 int puffs_vtype2dt(enum vtype);
475 enum vtype puffs_mode2vt(mode_t);
476 void puffs_stat2vattr(struct vattr *va, const struct stat *);
477 mode_t puffs_addvtype2mode(mode_t, enum vtype);
478
479
480 /*
481 * credentials & permissions
482 */
483
484 /* Credential fetch */
485 int puffs_cred_getuid(const struct puffs_cred *pcr, uid_t *);
486 int puffs_cred_getgid(const struct puffs_cred *pcr, gid_t *);
487 int puffs_cred_getgroups(const struct puffs_cred *pcr, gid_t *, short *);
488
489 /* Credential check */
490 int puffs_cred_isuid(const struct puffs_cred *, uid_t);
491 int puffs_cred_hasgroup(const struct puffs_cred *, gid_t);
492 int puffs_cred_isregular(const struct puffs_cred *);
493 int puffs_cred_iskernel(const struct puffs_cred *);
494 int puffs_cred_isfs(const struct puffs_cred *);
495 int puffs_cred_isjuggernaut(const struct puffs_cred *);
496
497 /* misc */
498 int puffs_access(enum vtype, mode_t, uid_t, gid_t, mode_t,
499 const struct puffs_cred *);
500 int puffs_access_chown(uid_t, gid_t, uid_t, gid_t,
501 const struct puffs_cred *);
502 int puffs_access_chmod(uid_t, gid_t, enum vtype, mode_t,
503 const struct puffs_cred *);
504 int puffs_access_times(uid_t, gid_t, mode_t, int,
505 const struct puffs_cred *);
506
507
508 /*
509 * Requests
510 */
511
512 struct puffs_getreq *puffs_req_makeget(struct puffs_usermount *,
513 size_t, int);
514 int puffs_req_loadget(struct puffs_getreq *);
515 struct puffs_req *puffs_req_get(struct puffs_getreq *);
516 int puffs_req_remainingget(struct puffs_getreq *);
517 void puffs_req_setmaxget(struct puffs_getreq *, int);
518 void puffs_req_destroyget(struct puffs_getreq *);
519
520 struct puffs_putreq *puffs_req_makeput(struct puffs_usermount *);
521 void puffs_req_put(struct puffs_putreq *,struct puffs_req *);
522 void puffs_req_putcc(struct puffs_putreq *,struct puffs_cc*);
523 int puffs_req_putput(struct puffs_putreq *);
524 void puffs_req_resetput(struct puffs_putreq *);
525 void puffs_req_destroyput(struct puffs_putreq *);
526
527 int puffs_req_handle(struct puffs_getreq *,
528 struct puffs_putreq *, int);
529
530 /*
531 * Call Context interfaces relevant for user.
532 */
533
534 void puffs_cc_yield(struct puffs_cc *);
535 void puffs_cc_continue(struct puffs_cc *);
536 struct puffs_usermount *puffs_cc_getusermount(struct puffs_cc *);
537 void *puffs_cc_getspecific(struct puffs_cc *);
538 struct puffs_cc *puffs_cc_create(struct puffs_usermount *);
539 void puffs_cc_destroy(struct puffs_cc *);
540
541 /*
542 * Execute or continue a request
543 */
544
545 int puffs_dopreq(struct puffs_usermount *, struct puffs_req *,
546 struct puffs_putreq *);
547 void puffs_docc(struct puffs_cc *, struct puffs_putreq *);
548
549 /*
550 * Flushing / invalidation routines
551 */
552
553 int puffs_inval_namecache_dir(struct puffs_usermount *, void *);
554 int puffs_inval_namecache_all(struct puffs_usermount *);
555
556 int puffs_inval_pagecache_node(struct puffs_usermount *, void *);
557 int puffs_inval_pagecache_node_range(struct puffs_usermount *, void *,
558 off_t, off_t);
559 int puffs_flush_pagecache_node(struct puffs_usermount *, void *);
560 int puffs_flush_pagecache_node_range(struct puffs_usermount *, void *,
561 off_t, off_t);
562
563 /*
564 * Path constructicons
565 */
566
567 int puffs_stdpath_buildpath(struct puffs_usermount *,
568 const struct puffs_pathobj *,
569 const struct puffs_pathobj *, size_t,
570 struct puffs_pathobj *);
571 int puffs_stdpath_cmppath(struct puffs_usermount *, struct puffs_pathobj *,
572 struct puffs_pathobj *, size_t, int);
573 void puffs_stdpath_freepath(struct puffs_usermount *,struct puffs_pathobj *);
574
575 void *puffs_path_walkcmp(struct puffs_usermount *,
576 struct puffs_node *, void *);
577 void *puffs_path_prefixadj(struct puffs_usermount *,
578 struct puffs_node *, void *);
579 int puffs_path_pcnbuild(struct puffs_usermount *,
580 struct puffs_cn *, void *);
581 void puffs_path_buildhash(struct puffs_usermount *, struct puffs_pathobj *);
582
583 void puffs_set_pathbuild(struct puffs_usermount *, pu_pathbuild_fn);
584 void puffs_set_pathtransform(struct puffs_usermount *, pu_pathtransform_fn);
585 void puffs_set_pathcmp(struct puffs_usermount *, pu_pathcmp_fn);
586 void puffs_set_pathfree(struct puffs_usermount *, pu_pathfree_fn);
587 void puffs_set_namemod(struct puffs_usermount *, pu_namemod_fn);
588
589 /*
590 * Suspension
591 */
592
593 int puffs_fs_suspend(struct puffs_usermount *);
594
595 /*
596 * Frame buffering
597 */
598
599 void puffs_framev_init(struct puffs_usermount *,
600 puffs_framev_readframe_fn,
601 puffs_framev_writeframe_fn,
602 puffs_framev_cmpframe_fn,
603 puffs_framev_fdnotify_fn);
604
605 struct puffs_framebuf *puffs_framebuf_make(void);
606 void puffs_framebuf_destroy(struct puffs_framebuf *);
607 void puffs_framebuf_recycle(struct puffs_framebuf *);
608 int puffs_framebuf_reserve_space(struct puffs_framebuf *,
609 size_t);
610
611 int puffs_framebuf_putdata(struct puffs_framebuf *, const void *, size_t);
612 int puffs_framebuf_putdata_atoff(struct puffs_framebuf *, size_t,
613 const void *, size_t);
614 int puffs_framebuf_getdata(struct puffs_framebuf *, void *, size_t);
615 int puffs_framebuf_getdata_atoff(struct puffs_framebuf *, size_t,
616 void *, size_t);
617
618 size_t puffs_framebuf_telloff(struct puffs_framebuf *);
619 size_t puffs_framebuf_tellsize(struct puffs_framebuf *);
620 size_t puffs_framebuf_remaining(struct puffs_framebuf *);
621 int puffs_framebuf_seekset(struct puffs_framebuf *, size_t);
622 int puffs_framebuf_getwindow(struct puffs_framebuf *, size_t,
623 void **, size_t *);
624
625 int puffs_framev_enqueue_cc(struct puffs_cc *, int,
626 struct puffs_framebuf *);
627 int puffs_framev_enqueue_cb(struct puffs_usermount *, int,
628 struct puffs_framebuf *,
629 puffs_framev_cb, void *);
630 int puffs_framev_enqueue_justsend(struct puffs_usermount *, int,
631 struct puffs_framebuf *, int);
632 int puffs_framev_framebuf_ccpromote(struct puffs_framebuf *,
633 struct puffs_cc *);
634
635 int puffs_framev_addfd(struct puffs_usermount *pu, int);
636 int puffs_framev_removefd(struct puffs_usermount *pu, int, int);
637 void puffs_framev_unmountonclose(struct puffs_usermount *pu, int, int);
638
639 __END_DECLS
640
641 #endif /* _PUFFS_H_ */
642