Home | History | Annotate | Line # | Download | only in puffs
puffs_msgif.h revision 1.41
      1  1.41  pooka /*	$NetBSD: puffs_msgif.h,v 1.41 2007/07/16 16:11:23 pooka Exp $	*/
      2   1.1  pooka 
      3   1.1  pooka /*
      4   1.1  pooka  * Copyright (c) 2005, 2006  Antti Kantee.  All Rights Reserved.
      5   1.1  pooka  *
      6   1.1  pooka  * Development of this software was supported by the
      7   1.1  pooka  * Google Summer of Code program and the Ulla Tuominen Foundation.
      8   1.1  pooka  * The Google SoC project was mentored by Bill Studenmund.
      9   1.1  pooka  *
     10   1.1  pooka  * Redistribution and use in source and binary forms, with or without
     11   1.1  pooka  * modification, are permitted provided that the following conditions
     12   1.1  pooka  * are met:
     13   1.1  pooka  * 1. Redistributions of source code must retain the above copyright
     14   1.1  pooka  *    notice, this list of conditions and the following disclaimer.
     15   1.1  pooka  * 2. Redistributions in binary form must reproduce the above copyright
     16   1.1  pooka  *    notice, this list of conditions and the following disclaimer in the
     17   1.1  pooka  *    documentation and/or other materials provided with the distribution.
     18   1.1  pooka  *
     19   1.1  pooka  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS
     20   1.1  pooka  * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
     21   1.1  pooka  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
     22   1.1  pooka  * DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
     23   1.1  pooka  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
     24   1.1  pooka  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
     25   1.1  pooka  * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     26   1.1  pooka  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
     27   1.1  pooka  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
     28   1.1  pooka  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
     29   1.1  pooka  * SUCH DAMAGE.
     30   1.1  pooka  */
     31   1.1  pooka 
     32   1.1  pooka #ifndef _PUFFS_MSGIF_H_
     33   1.1  pooka #define _PUFFS_MSGIF_H_
     34   1.1  pooka 
     35   1.1  pooka #include <sys/param.h>
     36   1.1  pooka #include <sys/time.h>
     37   1.1  pooka #include <sys/ioccom.h>
     38   1.1  pooka #include <sys/uio.h>
     39   1.1  pooka #include <sys/vnode.h>
     40   1.1  pooka #include <sys/ucred.h>
     41   1.1  pooka #include <sys/statvfs.h>
     42   1.1  pooka #include <sys/dirent.h>
     43   1.1  pooka #include <sys/fcntl.h>
     44   1.1  pooka 
     45   1.1  pooka #define PUFFSOP_VFS	1
     46   1.1  pooka #define PUFFSOP_VN	2
     47  1.20  pooka #define PUFFSOP_CACHE	3
     48   1.5  pooka #define PUFFSOPFLAG_FAF	0x10	/* fire-and-forget */
     49   1.5  pooka 
     50   1.5  pooka #define PUFFSOP_OPCMASK		0x03
     51   1.5  pooka #define PUFFSOP_OPCLASS(a)	((a) & PUFFSOP_OPCMASK)
     52   1.6  pooka #define PUFFSOP_WANTREPLY(a)	(((a) & PUFFSOPFLAG_FAF) == 0)
     53   1.1  pooka 
     54   1.9  pooka /* XXX: we don't need everything */
     55   1.1  pooka enum {
     56   1.1  pooka 	PUFFS_VFS_MOUNT,	PUFFS_VFS_START,	PUFFS_VFS_UNMOUNT,
     57   1.1  pooka 	PUFFS_VFS_ROOT,		PUFFS_VFS_STATVFS,	PUFFS_VFS_SYNC,
     58   1.1  pooka 	PUFFS_VFS_VGET,		PUFFS_VFS_FHTOVP,	PUFFS_VFS_VPTOFH,
     59   1.1  pooka 	PUFFS_VFS_INIT,		PUFFS_VFS_DONE,		PUFFS_VFS_SNAPSHOT,
     60  1.19  pooka 	PUFFS_VFS_EXTATTCTL,	PUFFS_VFS_SUSPEND
     61   1.1  pooka };
     62   1.1  pooka #define PUFFS_VFS_MAX PUFFS_VFS_EXTATTCTL
     63   1.1  pooka 
     64   1.9  pooka /* moreXXX: we don't need everything here either */
     65   1.1  pooka enum {
     66   1.1  pooka 	PUFFS_VN_LOOKUP,	PUFFS_VN_CREATE,	PUFFS_VN_MKNOD,
     67   1.1  pooka 	PUFFS_VN_OPEN,		PUFFS_VN_CLOSE,		PUFFS_VN_ACCESS,
     68   1.1  pooka 	PUFFS_VN_GETATTR,	PUFFS_VN_SETATTR,	PUFFS_VN_READ,
     69   1.1  pooka 	PUFFS_VN_WRITE,		PUFFS_VN_IOCTL,		PUFFS_VN_FCNTL,
     70   1.1  pooka 	PUFFS_VN_POLL,		PUFFS_VN_KQFILTER,	PUFFS_VN_REVOKE,
     71   1.1  pooka 	PUFFS_VN_MMAP,		PUFFS_VN_FSYNC,		PUFFS_VN_SEEK,
     72   1.1  pooka 	PUFFS_VN_REMOVE,	PUFFS_VN_LINK,		PUFFS_VN_RENAME,
     73   1.1  pooka 	PUFFS_VN_MKDIR,		PUFFS_VN_RMDIR,		PUFFS_VN_SYMLINK,
     74   1.1  pooka 	PUFFS_VN_READDIR,	PUFFS_VN_READLINK,	PUFFS_VN_ABORTOP,
     75   1.1  pooka 	PUFFS_VN_INACTIVE,	PUFFS_VN_RECLAIM,	PUFFS_VN_LOCK,
     76   1.1  pooka 	PUFFS_VN_UNLOCK,	PUFFS_VN_BMAP,		PUFFS_VN_STRATEGY,
     77   1.1  pooka 	PUFFS_VN_PRINT,		PUFFS_VN_ISLOCKED,	PUFFS_VN_PATHCONF,
     78   1.1  pooka 	PUFFS_VN_ADVLOCK,	PUFFS_VN_LEASE,		PUFFS_VN_WHITEOUT,
     79   1.1  pooka 	PUFFS_VN_GETPAGES,	PUFFS_VN_PUTPAGES,	PUFFS_VN_GETEXTATTR,
     80   1.1  pooka 	PUFFS_VN_LISTEXTATTR,	PUFFS_VN_OPENEXTATTR,	PUFFS_VN_DELETEEXTATTR,
     81   1.1  pooka 	PUFFS_VN_SETEXTATTR
     82   1.1  pooka };
     83   1.1  pooka #define PUFFS_VN_MAX PUFFS_VN_SETEXTATTR
     84   1.1  pooka 
     85  1.14  pooka #define PUFFSDEVELVERS	0x80000000
     86  1.39  pooka #define PUFFSVERSION	14
     87   1.1  pooka #define PUFFSNAMESIZE	32
     88  1.25  pooka struct puffs_kargs {
     89  1.14  pooka 	unsigned int	pa_vers;
     90   1.1  pooka 	int		pa_fd;
     91   1.9  pooka 	uint32_t	pa_flags;
     92  1.26  pooka 
     93   1.1  pooka 	size_t		pa_maxreqlen;
     94  1.27  pooka 	int		pa_nhashbuckets;
     95  1.27  pooka 
     96  1.26  pooka 	size_t		pa_fhsize;
     97  1.27  pooka 	int		pa_fhflags;
     98  1.26  pooka 
     99  1.30  pooka 	void		*pa_root_cookie;
    100  1.30  pooka 	enum vtype	pa_root_vtype;
    101  1.30  pooka 	voff_t		pa_root_vsize;
    102  1.30  pooka 	dev_t		pa_root_rdev;
    103  1.30  pooka 
    104  1.30  pooka 	struct statvfs	pa_svfsb;
    105  1.30  pooka 
    106  1.14  pooka 	char		pa_name[PUFFSNAMESIZE+1];   /* name for puffs type */
    107   1.9  pooka 	uint8_t		pa_vnopmask[PUFFS_VN_MAX];
    108   1.1  pooka };
    109  1.34  pooka #define PUFFS_KFLAG_NOCACHE_NAME	0x01	/* don't use name cache     */
    110  1.34  pooka #define PUFFS_KFLAG_NOCACHE_PAGE	0x02	/* don't use page cache	    */
    111  1.35  pooka #define PUFFS_KFLAG_NOCACHE		0x03	/* no cache whatsoever      */
    112  1.34  pooka #define PUFFS_KFLAG_ALLOPS		0x04	/* ignore pa_vnopmask       */
    113  1.34  pooka #define PUFFS_KFLAG_WTCACHE		0x08	/* write-through page cache */
    114  1.34  pooka #define PUFFS_KFLAG_IAONDEMAND		0x10	/* inactive only on demand  */
    115  1.38  pooka #define PUFFS_KFLAG_LOOKUP_FULLPNBUF	0x20	/* full pnbuf in lookup     */
    116  1.41  pooka #define PUFFS_KFLAG_MASK		0x3f
    117  1.27  pooka 
    118  1.27  pooka #define PUFFS_FHFLAG_DYNAMIC	0x01
    119  1.27  pooka #define PUFFS_FHFLAG_NFSV2	0x02
    120  1.27  pooka #define PUFFS_FHFLAG_NFSV3	0x04
    121  1.27  pooka #define PUFFS_FHFLAG_PROTOMASK	0x06
    122  1.27  pooka 
    123  1.27  pooka #define PUFFS_FHSIZE_MAX	1020	/* XXX: FHANDLE_SIZE_MAX - 4 */
    124   1.1  pooka 
    125   1.1  pooka /*
    126   1.1  pooka  * This is the device minor number for the cloning device.  Make it
    127   1.1  pooka  * a high number "just in case", even though we don't want to open
    128   1.1  pooka  * any specific devices currently.
    129   1.1  pooka  */
    130   1.1  pooka #define PUFFS_CLONER 0x7ffff
    131   1.1  pooka 
    132  1.11  pooka struct puffs_reqh_get {
    133  1.11  pooka 	void	*phg_buf;	/* user buffer		*/
    134  1.11  pooka 	size_t	phg_buflen;	/* user buffer length	*/
    135  1.11  pooka 
    136  1.11  pooka 	int	phg_nops;	/* max ops user wants / number delivered */
    137  1.11  pooka 	int	phg_more;	/* advisory: more ops available? */
    138  1.11  pooka };
    139  1.11  pooka 
    140  1.11  pooka struct puffs_reqh_put {
    141  1.11  pooka 	int		php_nops;	/* ops available / ops handled */
    142  1.11  pooka 
    143  1.11  pooka 	/* these describe the first request */
    144  1.11  pooka 	uint64_t	php_id;		/* request id */
    145  1.11  pooka 	void		*php_buf;	/* user buffer address */
    146  1.11  pooka 	size_t		php_buflen;	/* user buffer length, hdr NOT incl. */
    147  1.11  pooka };
    148  1.11  pooka 
    149   1.1  pooka /*
    150  1.11  pooka  * The requests work as follows:
    151  1.11  pooka  *
    152  1.11  pooka  *  + GETOP: When fetching operations from the kernel, the user server
    153  1.11  pooka  *           supplies a flat buffer into which operations are written.
    154  1.11  pooka  *           The number of operations written to the buffer is
    155  1.11  pooka  *           MIN(prhg_nops, requests waiting, space in buffer).
    156  1.11  pooka  *
    157  1.11  pooka  *           Operations follow each other and each one is described
    158  1.11  pooka  *           by the puffs_req structure, which is immediately followed
    159  1.11  pooka  *           by the aligned request data buffer in preq_buf.  The next
    160  1.11  pooka  *           puffs_req can be found at preq + preq_buflen.
    161  1.11  pooka  *
    162  1.11  pooka  *           Visually, the server should expect:
    163  1.11  pooka  *
    164  1.11  pooka  *           |<-- preq_buflen -->|
    165  1.11  pooka  *           ---------------------------------------------------------------
    166  1.11  pooka  *           |hdr|  buffer |align|hdr| buffer |hdr| ....   |buffer|        |
    167  1.11  pooka  *           ---------------------------------------------------------------
    168  1.11  pooka  *           ^ start       ^ unaligned        ^ aligned    ^ always aligned
    169  1.11  pooka  *
    170  1.11  pooka  *           The server is allowed to modify the contents of the buffers.
    171  1.11  pooka  *           Since the headers are the same size for both get and put, it
    172  1.11  pooka  *           is possible to handle all operations simply by doing in-place
    173  1.11  pooka  *           modification.  Where more input is expected that what was put
    174  1.11  pooka  *           out, the kernel leaves a hole in the buffer.  This hole size
    175  1.11  pooka  *           is derived from the operational semantics known by the vnode
    176  1.11  pooka  *           layer.  The hole size is included in preq_buflen.  The
    177  1.11  pooka  *           amount of relevant information in the buffer is call-specific
    178  1.11  pooka  *           and can be deduced by the server from the call type.
    179  1.11  pooka  *
    180  1.11  pooka  *  + PUTOP: When returning the results of an operation to the kernel, the
    181  1.11  pooka  *           user server is allowed to input results in a scatter-gather
    182  1.11  pooka  *           fashion.  Each request is made up of a header and the buffer.
    183  1.11  pooka  *           The header describes the *NEXT* request for copyin, *NOT* the
    184  1.11  pooka  *           current one.  The first request is described in puffs_reqh_put
    185  1.11  pooka  *           and the last one is left uninterpreted.  This is to halve the
    186  1.11  pooka  *           amount of copyin's required.
    187  1.11  pooka  *
    188  1.11  pooka  *           Fans of my ascii art, rejoice:
    189  1.11  pooka  *               /-------------------->| preq_buflen     |
    190  1.11  pooka  *           ---^----------------------------------------------------------
    191  1.11  pooka  *           |hdr|buffer| empty spaces |hdr|    buffer   |                |
    192  1.11  pooka  *           --v-----------------------^-v---------------------------------
    193  1.11  pooka  *             \------- preq_buf -----/  \------- preq_buf ....
    194  1.11  pooka  *
    195  1.11  pooka  *           This scheme also allows for better in-place modification of the
    196  1.11  pooka  *           request buffer when handling requests.  The vision is that
    197  1.11  pooka  *           operations which can be immediately satisfied will be edited
    198  1.11  pooka  *           in-place while ones which can't will be left blank.  Also,
    199  1.11  pooka  *           requests from async operations which have been satisfied
    200  1.11  pooka  *           meanwhile can be included.
    201  1.11  pooka  *
    202  1.11  pooka  *           The total number of operations is given by the ioctl control
    203  1.11  pooka  *           structure puffs_reqh.  The values in the header in the final
    204  1.11  pooka  *           are not used.
    205   1.1  pooka  */
    206   1.1  pooka struct puffs_req {
    207  1.11  pooka 	uint64_t	preq_id;		/* get: cur, put: next */
    208   1.1  pooka 
    209  1.11  pooka 	union u {
    210  1.11  pooka 		struct {
    211  1.11  pooka 			uint8_t	opclass;	/* cur */
    212  1.11  pooka 			uint8_t	optype;		/* cur */
    213  1.11  pooka 
    214  1.11  pooka 			/*
    215  1.11  pooka 			 * preq_cookie is the node cookie associated with
    216  1.11  pooka 			 * the request.  It always maps 1:1 to a vnode
    217  1.11  pooka 			 * and could map to a userspace struct puffs_node.
    218  1.11  pooka 			 * The cookie usually describes the first
    219  1.11  pooka 			 * vnode argument of the VOP_POP() in question.
    220  1.11  pooka 			 */
    221  1.11  pooka 
    222  1.11  pooka 			void	*cookie;	/* cur */
    223  1.11  pooka 		} out;
    224  1.11  pooka 		struct {
    225  1.11  pooka 			int	rv;		/* cur */
    226  1.29  pooka 			int	setbacks;	/* cur */
    227  1.11  pooka 			void	*buf;		/* next */
    228  1.11  pooka 		} in;
    229  1.11  pooka 	} u;
    230   1.1  pooka 
    231  1.11  pooka 	size_t  preq_buflen;			/* get: cur, put: next */
    232   1.1  pooka 	/*
    233  1.11  pooka 	 * the following helper pads the struct size to md alignment
    234  1.11  pooka 	 * multiple (should size_t not cut it).  it makes sure that
    235  1.11  pooka 	 * whatever comes after this struct is aligned
    236   1.1  pooka 	 */
    237  1.11  pooka 	uint8_t	preq_buf[0] __aligned(ALIGNBYTES+1);
    238   1.1  pooka };
    239  1.11  pooka #define preq_opclass	u.out.opclass
    240  1.11  pooka #define preq_optype	u.out.optype
    241  1.11  pooka #define preq_cookie	u.out.cookie
    242  1.11  pooka #define preq_rv		u.in.rv
    243  1.29  pooka #define preq_setbacks	u.in.setbacks
    244  1.11  pooka #define preq_nextbuf	u.in.buf
    245   1.1  pooka 
    246  1.29  pooka #define PUFFS_SETBACK_INACT_N1	0x01	/* set VOP_INACTIVE for node 1 */
    247  1.29  pooka #define PUFFS_SETBACK_INACT_N2	0x02	/* set VOP_INACTIVE for node 2 */
    248  1.32  pooka #define PUFFS_SETBACK_NOREF_N1	0x04	/* set pn PN_NOREFS for node 1 */
    249  1.32  pooka #define PUFFS_SETBACK_NOREF_N2	0x08	/* set pn PN_NOREFS for node 2 */
    250  1.32  pooka #define PUFFS_SETBACK_MASK	0x0f
    251  1.29  pooka 
    252   1.1  pooka /*
    253   1.1  pooka  * Some operations have unknown size requirements.  So as the first
    254   1.1  pooka  * stab at handling it, do an extra bounce between the kernel and
    255   1.1  pooka  * userspace.
    256   1.1  pooka  */
    257   1.1  pooka struct puffs_sizeop {
    258   1.1  pooka 	uint64_t	pso_reqid;
    259   1.1  pooka 
    260   1.1  pooka 	uint8_t		*pso_userbuf;
    261   1.1  pooka 	size_t		pso_bufsize;
    262   1.1  pooka };
    263   1.1  pooka 
    264   1.1  pooka /*
    265  1.16  pooka  * Flush operation.  This can be used to invalidate:
    266  1.16  pooka  * 1) name cache for one node
    267  1.16  pooka  * 2) name cache for all children
    268  1.16  pooka  * 3) name cache for the entire mount
    269  1.16  pooka  * 4) page cache for a set of ranges in one node
    270  1.16  pooka  * 5) page cache for one entire node
    271  1.16  pooka  *
    272  1.16  pooka  * It can be used to flush:
    273  1.16  pooka  * 1) page cache for a set of ranges in one node
    274  1.16  pooka  * 2) page cache for one entire node
    275  1.16  pooka  */
    276  1.16  pooka 
    277  1.20  pooka /* XXX: needs restructuring */
    278  1.16  pooka struct puffs_flush {
    279  1.16  pooka 	void		*pf_cookie;
    280  1.16  pooka 
    281  1.16  pooka 	int		pf_op;
    282  1.20  pooka 	off_t		pf_start;
    283  1.20  pooka 	off_t		pf_end;
    284  1.16  pooka };
    285  1.16  pooka #define PUFFS_INVAL_NAMECACHE_NODE		0
    286  1.16  pooka #define PUFFS_INVAL_NAMECACHE_DIR		1
    287  1.16  pooka #define PUFFS_INVAL_NAMECACHE_ALL		2
    288  1.16  pooka #define PUFFS_INVAL_PAGECACHE_NODE_RANGE	3
    289  1.23  pooka #define PUFFS_FLUSH_PAGECACHE_NODE_RANGE	4
    290  1.16  pooka 
    291  1.16  pooka 
    292  1.16  pooka /*
    293  1.16  pooka  * Available ioctl operations
    294  1.16  pooka  */
    295  1.30  pooka #define PUFFSGETOP		_IOWR('p', 1, struct puffs_reqh_get)
    296  1.30  pooka #define PUFFSPUTOP		_IOWR('p', 2, struct puffs_reqh_put)
    297  1.30  pooka #define PUFFSSIZEOP		_IOWR('p', 3, struct puffs_sizeop)
    298  1.30  pooka #define PUFFSFLUSHOP		_IOW ('p', 4, struct puffs_flush)
    299  1.17  pooka #if 0
    300  1.30  pooka #define PUFFSFLUSHMULTIOP	_IOW ('p', 5, struct puffs_flushmulti)
    301  1.17  pooka #endif
    302  1.30  pooka #define PUFFSSUSPENDOP		_IO  ('p', 6)
    303  1.16  pooka 
    304  1.16  pooka 
    305  1.16  pooka /*
    306   1.1  pooka  * Credentials for an operation.  Can be either struct uucred for
    307   1.1  pooka  * ops called from a credential context or NOCRED/FSCRED for ops
    308   1.1  pooka  * called from within the kernel.  It is up to the implementation
    309   1.1  pooka  * if it makes a difference between these two and the super-user.
    310   1.1  pooka  */
    311  1.36  pooka struct puffs_kcred {
    312  1.36  pooka 	struct uucred	pkcr_uuc;
    313  1.36  pooka 	uint8_t		pkcr_type;
    314  1.36  pooka 	uint8_t		pkcr_internal;
    315   1.1  pooka };
    316   1.1  pooka #define PUFFCRED_TYPE_UUC	1
    317   1.1  pooka #define PUFFCRED_TYPE_INTERNAL	2
    318   1.1  pooka #define PUFFCRED_CRED_NOCRED	1
    319   1.1  pooka #define PUFFCRED_CRED_FSCRED	2
    320   1.1  pooka 
    321   1.1  pooka /*
    322  1.22  pooka  * 2*MAXPHYS is the max size the system will attempt to copy,
    323   1.1  pooka  * else treated as garbage
    324   1.1  pooka  */
    325  1.22  pooka #define PUFFS_REQ_MAXSIZE	2*MAXPHYS
    326   1.2  pooka #define PUFFS_REQSTRUCT_MAX	4096 /* XXX: approxkludge */
    327   1.1  pooka 
    328   1.1  pooka #define PUFFS_TOMOVE(a,b) (MIN((a), b->pmp_req_maxsize - PUFFS_REQSTRUCT_MAX))
    329   1.1  pooka 
    330  1.37  pooka /* caller id */
    331  1.37  pooka struct puffs_kcid {
    332  1.37  pooka 	int	pkcid_type;
    333  1.37  pooka 	pid_t	pkcid_pid;
    334  1.37  pooka 	lwpid_t	pkcid_lwpid;
    335  1.37  pooka };
    336  1.37  pooka #define PUFFCID_TYPE_REAL	1
    337  1.37  pooka #define PUFFCID_TYPE_FAKE	2
    338  1.37  pooka 
    339  1.13  pooka /* puffs struct componentname built by kernel */
    340  1.13  pooka struct puffs_kcn {
    341   1.1  pooka 	/* args */
    342  1.13  pooka 	u_long			pkcn_nameiop;	/* namei operation	*/
    343  1.13  pooka 	u_long			pkcn_flags;	/* flags		*/
    344  1.13  pooka 
    345  1.38  pooka 	char pkcn_name[MAXPATHLEN];	/* nulterminated path component */
    346  1.38  pooka 	long pkcn_namelen;		/* current component length	*/
    347  1.38  pooka 	long pkcn_consume;		/* IN: extra chars server ate   */
    348   1.1  pooka };
    349   1.1  pooka 
    350   1.1  pooka /*
    351   1.1  pooka  * XXX: figure out what to do with these, copied from namei.h for now
    352   1.1  pooka  */
    353   1.1  pooka #define	PUFFSLOOKUP_LOOKUP	0	/* perform name lookup only */
    354   1.1  pooka #define PUFFSLOOKUP_CREATE	1	/* setup for file creation */
    355   1.1  pooka #define PUFFSLOOKUP_DELETE	2	/* setup for file deletion */
    356   1.1  pooka #define PUFFSLOOKUP_RENAME	3	/* setup for file renaming */
    357   1.1  pooka #define PUFFSLOOKUP_OPMASK	3	/* mask for operation */
    358   1.1  pooka 
    359  1.21  pooka #define PUFFSLOOKUP_FOLLOW	0x00004	/* follow final symlink */
    360  1.21  pooka #define PUFFSLOOKUP_NOFOLLOW	0x00008	/* don't follow final symlink */
    361  1.21  pooka #define PUFFSLOOKUP_ISLASTCN	0x08000 /* is last component of lookup */
    362  1.40  pooka #define PUFFSLOOKUP_REQUIREDIR	0x80000 /* must be directory */
    363   1.1  pooka 
    364  1.24  pooka 
    365  1.11  pooka /*
    366  1.11  pooka  * Next come the individual requests.  They are all subclassed from
    367  1.11  pooka  * puffs_req and contain request-specific fields in addition.  Note
    368  1.11  pooka  * that there are some requests which have to handle arbitrary-length
    369  1.11  pooka  * buffers.
    370  1.11  pooka  *
    371  1.11  pooka  * The division is the following: puffs_req is to be touched only
    372  1.11  pooka  * by generic routines while the other stuff is supposed to be
    373  1.11  pooka  * modified only by specific routines.
    374  1.11  pooka  */
    375   1.6  pooka 
    376   1.1  pooka /*
    377   1.1  pooka  * aux structures for vfs operations.
    378   1.1  pooka  */
    379   1.1  pooka struct puffs_vfsreq_unmount {
    380  1.11  pooka 	struct puffs_req	pvfsr_pr;
    381  1.11  pooka 
    382   1.1  pooka 	int			pvfsr_flags;
    383  1.37  pooka 	struct puffs_kcid	pvfsr_cid;
    384   1.1  pooka };
    385   1.1  pooka 
    386   1.1  pooka struct puffs_vfsreq_statvfs {
    387  1.11  pooka 	struct puffs_req	pvfsr_pr;
    388  1.11  pooka 
    389   1.1  pooka 	struct statvfs		pvfsr_sb;
    390  1.37  pooka 	struct puffs_kcid	pvfsr_cid;
    391   1.1  pooka };
    392   1.1  pooka 
    393   1.1  pooka struct puffs_vfsreq_sync {
    394  1.11  pooka 	struct puffs_req	pvfsr_pr;
    395  1.11  pooka 
    396  1.36  pooka 	struct puffs_kcred	pvfsr_cred;
    397  1.37  pooka 	struct puffs_kcid	pvfsr_cid;
    398   1.1  pooka 	int			pvfsr_waitfor;
    399   1.1  pooka };
    400   1.1  pooka 
    401  1.24  pooka struct puffs_vfsreq_fhtonode {
    402  1.24  pooka 	struct puffs_req	pvfsr_pr;
    403  1.24  pooka 
    404  1.24  pooka 	void			*pvfsr_fhcookie;	/* IN	*/
    405  1.24  pooka 	enum vtype		pvfsr_vtype;		/* IN	*/
    406  1.24  pooka 	voff_t			pvfsr_size;		/* IN	*/
    407  1.24  pooka 	dev_t			pvfsr_rdev;		/* IN	*/
    408  1.24  pooka 
    409  1.24  pooka 	size_t			pvfsr_dsize;		/* OUT */
    410  1.27  pooka 	uint8_t			pvfsr_data[0]		/* OUT, XXX */
    411  1.24  pooka 				    __aligned(ALIGNBYTES+1);
    412  1.24  pooka };
    413  1.24  pooka 
    414  1.24  pooka struct puffs_vfsreq_nodetofh {
    415  1.24  pooka 	struct puffs_req	pvfsr_pr;
    416  1.24  pooka 
    417  1.24  pooka 	void			*pvfsr_fhcookie;	/* OUT	*/
    418  1.24  pooka 
    419  1.24  pooka 	size_t			pvfsr_dsize;		/* OUT/IN  */
    420  1.27  pooka 	uint8_t			pvfsr_data[0]		/* IN, XXX */
    421  1.24  pooka 				    __aligned(ALIGNBYTES+1);
    422  1.24  pooka };
    423  1.24  pooka 
    424  1.19  pooka struct puffs_vfsreq_suspend {
    425  1.19  pooka 	struct puffs_req	pvfsr_pr;
    426  1.19  pooka 
    427  1.19  pooka 	int			pvfsr_status;
    428  1.19  pooka };
    429  1.19  pooka #define PUFFS_SUSPEND_START	0
    430  1.19  pooka #define PUFFS_SUSPEND_SUSPENDED	1
    431  1.19  pooka #define PUFFS_SUSPEND_RESUME	2
    432  1.19  pooka #define PUFFS_SUSPEND_ERROR	3
    433  1.19  pooka 
    434   1.1  pooka /*
    435   1.1  pooka  * aux structures for vnode operations.
    436   1.1  pooka  */
    437   1.1  pooka 
    438   1.1  pooka struct puffs_vnreq_lookup {
    439  1.11  pooka 	struct puffs_req	pvn_pr;
    440  1.11  pooka 
    441  1.13  pooka 	struct puffs_kcn	pvnr_cn;		/* OUT	*/
    442  1.36  pooka 	struct puffs_kcred	pvnr_cn_cred;		/* OUT	*/
    443  1.37  pooka 	struct puffs_kcid	pvnr_cn_cid;		/* OUT	*/
    444  1.36  pooka 
    445   1.1  pooka 	void			*pvnr_newnode;		/* IN	*/
    446   1.1  pooka 	enum vtype		pvnr_vtype;		/* IN	*/
    447   1.5  pooka 	voff_t			pvnr_size;		/* IN	*/
    448   1.4  pooka 	dev_t			pvnr_rdev;		/* IN	*/
    449   1.1  pooka };
    450   1.1  pooka 
    451   1.1  pooka struct puffs_vnreq_create {
    452  1.11  pooka 	struct puffs_req	pvn_pr;
    453  1.11  pooka 
    454  1.13  pooka 	struct puffs_kcn	pvnr_cn;		/* OUT	*/
    455  1.36  pooka 	struct puffs_kcred	pvnr_cn_cred;		/* OUT	*/
    456  1.37  pooka 	struct puffs_kcid	pvnr_cn_cid;		/* OUT	*/
    457  1.36  pooka 
    458   1.1  pooka 	struct vattr		pvnr_va;		/* OUT	*/
    459   1.1  pooka 	void			*pvnr_newnode;		/* IN	*/
    460   1.1  pooka };
    461   1.1  pooka 
    462   1.1  pooka struct puffs_vnreq_mknod {
    463  1.11  pooka 	struct puffs_req	pvn_pr;
    464  1.11  pooka 
    465  1.13  pooka 	struct puffs_kcn	pvnr_cn;		/* OUT	*/
    466  1.36  pooka 	struct puffs_kcred	pvnr_cn_cred;		/* OUT	*/
    467  1.37  pooka 	struct puffs_kcid	pvnr_cn_cid;		/* OUT	*/
    468  1.36  pooka 
    469   1.1  pooka 	struct vattr		pvnr_va;		/* OUT	*/
    470   1.1  pooka 	void			*pvnr_newnode;		/* IN	*/
    471   1.1  pooka };
    472   1.1  pooka 
    473   1.1  pooka struct puffs_vnreq_open {
    474  1.11  pooka 	struct puffs_req	pvn_pr;
    475  1.11  pooka 
    476  1.36  pooka 	struct puffs_kcred	pvnr_cred;		/* OUT	*/
    477  1.37  pooka 	struct puffs_kcid	pvnr_cid;		/* OUT	*/
    478   1.1  pooka 	int			pvnr_mode;		/* OUT	*/
    479   1.1  pooka };
    480   1.1  pooka 
    481   1.1  pooka struct puffs_vnreq_close {
    482  1.11  pooka 	struct puffs_req	pvn_pr;
    483  1.11  pooka 
    484  1.36  pooka 	struct puffs_kcred	pvnr_cred;		/* OUT	*/
    485  1.37  pooka 	struct puffs_kcid	pvnr_cid;		/* OUT	*/
    486   1.1  pooka 	int			pvnr_fflag;		/* OUT	*/
    487   1.1  pooka };
    488   1.1  pooka 
    489   1.1  pooka struct puffs_vnreq_access {
    490  1.11  pooka 	struct puffs_req	pvn_pr;
    491  1.11  pooka 
    492  1.36  pooka 	struct puffs_kcred	pvnr_cred;		/* OUT	*/
    493  1.37  pooka 	struct puffs_kcid	pvnr_cid;		/* OUT	*/
    494   1.1  pooka 	int			pvnr_mode;		/* OUT	*/
    495   1.1  pooka };
    496   1.1  pooka 
    497   1.1  pooka #define puffs_vnreq_setattr puffs_vnreq_setgetattr
    498   1.1  pooka #define puffs_vnreq_getattr puffs_vnreq_setgetattr
    499   1.1  pooka struct puffs_vnreq_setgetattr {
    500  1.11  pooka 	struct puffs_req	pvn_pr;
    501  1.11  pooka 
    502  1.36  pooka 	struct puffs_kcred	pvnr_cred;		/* OUT	*/
    503  1.37  pooka 	struct puffs_kcid	pvnr_cid;		/* OUT	*/
    504   1.1  pooka 	struct vattr		pvnr_va;		/* IN/OUT (op depend) */
    505   1.1  pooka };
    506   1.1  pooka 
    507   1.1  pooka #define puffs_vnreq_read puffs_vnreq_readwrite
    508   1.1  pooka #define puffs_vnreq_write puffs_vnreq_readwrite
    509   1.1  pooka struct puffs_vnreq_readwrite {
    510  1.11  pooka 	struct puffs_req	pvn_pr;
    511  1.11  pooka 
    512  1.36  pooka 	struct puffs_kcred	pvnr_cred;		/* OUT	  */
    513   1.1  pooka 	off_t			pvnr_offset;		/* OUT	  */
    514   1.1  pooka 	size_t			pvnr_resid;		/* IN/OUT */
    515   1.1  pooka 	int			pvnr_ioflag;		/* OUT	  */
    516   1.1  pooka 
    517   1.1  pooka 	uint8_t			pvnr_data[0];		/* IN/OUT (wr/rd) */
    518   1.1  pooka };
    519   1.1  pooka 
    520   1.1  pooka #define puffs_vnreq_ioctl puffs_vnreq_fcnioctl
    521   1.1  pooka #define puffs_vnreq_fcntl puffs_vnreq_fcnioctl
    522   1.1  pooka struct puffs_vnreq_fcnioctl {
    523  1.11  pooka 	struct puffs_req	pvn_pr;
    524  1.11  pooka 
    525  1.36  pooka 	struct puffs_kcred	pvnr_cred;
    526   1.1  pooka 	u_long			pvnr_command;
    527   1.1  pooka 	pid_t			pvnr_pid;
    528   1.1  pooka 	int			pvnr_fflag;
    529   1.1  pooka 
    530   1.1  pooka 	void			*pvnr_data;
    531   1.1  pooka 	size_t			pvnr_datalen;
    532   1.1  pooka 	int			pvnr_copyback;
    533   1.1  pooka };
    534   1.1  pooka 
    535   1.1  pooka struct puffs_vnreq_poll {
    536  1.11  pooka 	struct puffs_req	pvn_pr;
    537  1.11  pooka 
    538  1.31  pooka 	int			pvnr_events;		/* IN/OUT */
    539  1.37  pooka 	struct puffs_kcid	pvnr_cid;		/* OUT    */
    540   1.1  pooka };
    541   1.1  pooka 
    542   1.1  pooka struct puffs_vnreq_fsync {
    543  1.11  pooka 	struct puffs_req	pvn_pr;
    544  1.11  pooka 
    545  1.36  pooka 	struct puffs_kcred	pvnr_cred;		/* OUT	*/
    546  1.37  pooka 	struct puffs_kcid	pvnr_cid;		/* OUT	*/
    547   1.1  pooka 	off_t			pvnr_offlo;		/* OUT	*/
    548   1.1  pooka 	off_t			pvnr_offhi;		/* OUT	*/
    549   1.1  pooka 	int			pvnr_flags;		/* OUT	*/
    550   1.1  pooka };
    551   1.1  pooka 
    552   1.1  pooka struct puffs_vnreq_seek {
    553  1.11  pooka 	struct puffs_req	pvn_pr;
    554  1.11  pooka 
    555  1.36  pooka 	struct puffs_kcred	pvnr_cred;		/* OUT	*/
    556   1.1  pooka 	off_t			pvnr_oldoff;		/* OUT	*/
    557   1.1  pooka 	off_t			pvnr_newoff;		/* OUT	*/
    558   1.1  pooka };
    559   1.1  pooka 
    560   1.1  pooka struct puffs_vnreq_remove {
    561  1.11  pooka 	struct puffs_req	pvn_pr;
    562  1.11  pooka 
    563  1.13  pooka 	struct puffs_kcn	pvnr_cn;		/* OUT	*/
    564  1.36  pooka 	struct puffs_kcred	pvnr_cn_cred;		/* OUT	*/
    565  1.37  pooka 	struct puffs_kcid	pvnr_cn_cid;		/* OUT	*/
    566  1.36  pooka 
    567   1.1  pooka 	void			*pvnr_cookie_targ;	/* OUT	*/
    568   1.1  pooka };
    569   1.1  pooka 
    570   1.1  pooka struct puffs_vnreq_mkdir {
    571  1.11  pooka 	struct puffs_req	pvn_pr;
    572  1.11  pooka 
    573  1.13  pooka 	struct puffs_kcn	pvnr_cn;		/* OUT	*/
    574  1.36  pooka 	struct puffs_kcred	pvnr_cn_cred;		/* OUT	*/
    575  1.37  pooka 	struct puffs_kcid	pvnr_cn_cid;		/* OUT	*/
    576  1.36  pooka 
    577   1.1  pooka 	struct vattr		pvnr_va;		/* OUT	*/
    578   1.1  pooka 	void			*pvnr_newnode;		/* IN	*/
    579   1.1  pooka };
    580   1.1  pooka 
    581   1.1  pooka struct puffs_vnreq_rmdir {
    582  1.11  pooka 	struct puffs_req	pvn_pr;
    583  1.11  pooka 
    584  1.13  pooka 	struct puffs_kcn	pvnr_cn;		/* OUT	*/
    585  1.36  pooka 	struct puffs_kcred	pvnr_cn_cred;		/* OUT	*/
    586  1.37  pooka 	struct puffs_kcid	pvnr_cn_cid;		/* OUT	*/
    587  1.37  pooka 
    588   1.1  pooka 	void			*pvnr_cookie_targ;	/* OUT	*/
    589   1.1  pooka };
    590   1.1  pooka 
    591   1.1  pooka struct puffs_vnreq_link {
    592  1.11  pooka 	struct puffs_req	pvn_pr;
    593  1.11  pooka 
    594  1.36  pooka 	struct puffs_kcn	pvnr_cn;		/* OUT	*/
    595  1.36  pooka 	struct puffs_kcred	pvnr_cn_cred;		/* OUT	*/
    596  1.37  pooka 	struct puffs_kcid	pvnr_cn_cid;		/* OUT	*/
    597  1.37  pooka 
    598  1.36  pooka 	void			*pvnr_cookie_targ;	/* OUT	*/
    599   1.1  pooka };
    600   1.1  pooka 
    601   1.1  pooka struct puffs_vnreq_rename {
    602  1.11  pooka 	struct puffs_req	pvn_pr;
    603  1.11  pooka 
    604  1.13  pooka 	struct puffs_kcn	pvnr_cn_src;		/* OUT	*/
    605  1.36  pooka 	struct puffs_kcred	pvnr_cn_src_cred;	/* OUT	*/
    606  1.37  pooka 	struct puffs_kcid	pvnr_cn_src_cid;	/* OUT	*/
    607  1.13  pooka 	struct puffs_kcn	pvnr_cn_targ;		/* OUT	*/
    608  1.36  pooka 	struct puffs_kcred	pvnr_cn_targ_cred;	/* OUT	*/
    609  1.37  pooka 	struct puffs_kcid	pvnr_cn_targ_cid;	/* OUT	*/
    610  1.36  pooka 
    611   1.1  pooka 	void			*pvnr_cookie_src;	/* OUT	*/
    612   1.1  pooka 	void			*pvnr_cookie_targ;	/* OUT	*/
    613   1.1  pooka 	void			*pvnr_cookie_targdir;	/* OUT	*/
    614   1.1  pooka };
    615   1.1  pooka 
    616   1.1  pooka struct puffs_vnreq_symlink {
    617  1.11  pooka 	struct puffs_req	pvn_pr;
    618  1.11  pooka 
    619  1.13  pooka 	struct puffs_kcn	pvnr_cn;		/* OUT	*/
    620  1.36  pooka 	struct puffs_kcred	pvnr_cn_cred;		/* OUT	*/
    621  1.37  pooka 	struct puffs_kcid	pvnr_cn_cid;		/* OUT	*/
    622  1.36  pooka 
    623   1.1  pooka 	struct vattr		pvnr_va;		/* OUT	*/
    624   1.1  pooka 	void			*pvnr_newnode;		/* IN	*/
    625   1.1  pooka 	char			pvnr_link[MAXPATHLEN];	/* OUT	*/
    626   1.1  pooka };
    627   1.1  pooka 
    628   1.1  pooka struct puffs_vnreq_readdir {
    629  1.11  pooka 	struct puffs_req	pvn_pr;
    630  1.11  pooka 
    631  1.36  pooka 	struct puffs_kcred	pvnr_cred;		/* OUT	  */
    632   1.1  pooka 	off_t			pvnr_offset;		/* IN/OUT */
    633   1.1  pooka 	size_t			pvnr_resid;		/* IN/OUT */
    634  1.24  pooka 	size_t			pvnr_ncookies;		/* IN/OUT */
    635  1.24  pooka 	int			pvnr_eofflag;		/* IN     */
    636   1.1  pooka 
    637  1.24  pooka 	size_t			pvnr_dentoff;		/* OUT    */
    638  1.24  pooka 	uint8_t			pvnr_data[0]		/* IN  	  */
    639  1.24  pooka 				    __aligned(ALIGNBYTES+1);
    640   1.1  pooka };
    641   1.1  pooka 
    642   1.1  pooka struct puffs_vnreq_readlink {
    643  1.11  pooka 	struct puffs_req	pvn_pr;
    644  1.11  pooka 
    645  1.36  pooka 	struct puffs_kcred	pvnr_cred;		/* OUT */
    646   1.1  pooka 	size_t			pvnr_linklen;		/* IN  */
    647   1.1  pooka 	char			pvnr_link[MAXPATHLEN];	/* IN, XXX  */
    648   1.1  pooka };
    649   1.1  pooka 
    650   1.1  pooka struct puffs_vnreq_reclaim {
    651  1.11  pooka 	struct puffs_req	pvn_pr;
    652  1.11  pooka 
    653  1.37  pooka 	struct puffs_kcid	pvnr_cid;		/* OUT	*/
    654   1.1  pooka };
    655   1.1  pooka 
    656   1.3  pooka struct puffs_vnreq_inactive {
    657  1.11  pooka 	struct puffs_req	pvn_pr;
    658  1.11  pooka 
    659  1.37  pooka 	struct puffs_kcid	pvnr_cid;		/* OUT	*/
    660   1.3  pooka };
    661   1.3  pooka 
    662   1.1  pooka struct puffs_vnreq_print {
    663  1.11  pooka 	struct puffs_req	pvn_pr;
    664  1.11  pooka 
    665   1.1  pooka 	/* empty */
    666   1.1  pooka };
    667   1.1  pooka 
    668   1.1  pooka struct puffs_vnreq_pathconf {
    669  1.11  pooka 	struct puffs_req	pvn_pr;
    670  1.11  pooka 
    671   1.1  pooka 	int			pvnr_name;		/* OUT	*/
    672   1.1  pooka 	int			pvnr_retval;		/* IN	*/
    673   1.1  pooka };
    674   1.1  pooka 
    675   1.1  pooka struct puffs_vnreq_advlock {
    676  1.11  pooka 	struct puffs_req	pvn_pr;
    677  1.11  pooka 
    678   1.1  pooka 	struct flock		pvnr_fl;		/* OUT	*/
    679   1.1  pooka 	void			*pvnr_id;		/* OUT	*/
    680   1.1  pooka 	int			pvnr_op;		/* OUT	*/
    681   1.1  pooka 	int			pvnr_flags;		/* OUT	*/
    682   1.1  pooka };
    683   1.1  pooka 
    684  1.12  pooka struct puffs_vnreq_mmap {
    685  1.12  pooka 	struct puffs_req	pvn_pr;
    686  1.12  pooka 
    687  1.12  pooka 	int			pvnr_fflags;		/* OUT	*/
    688  1.36  pooka 	struct puffs_kcred	pvnr_cred;		/* OUT	*/
    689  1.37  pooka 	struct puffs_kcid	pvnr_cid;		/* OUT	*/
    690  1.12  pooka };
    691  1.12  pooka 
    692  1.20  pooka 
    693  1.20  pooka /*
    694  1.20  pooka  * For cache reports.  Everything is always out-out-out, no replies
    695  1.20  pooka  */
    696  1.20  pooka 
    697  1.20  pooka struct puffs_cacherun {
    698  1.20  pooka 	off_t			pcache_runstart;
    699  1.20  pooka 	off_t			pcache_runend;
    700  1.20  pooka };
    701  1.20  pooka 
    702  1.20  pooka /* cache info.  old used for write now */
    703  1.20  pooka struct puffs_cacheinfo {
    704  1.20  pooka 	struct puffs_req	pcache_pr;
    705  1.20  pooka 
    706  1.20  pooka 	int			pcache_type;
    707  1.20  pooka 	size_t			pcache_nruns;
    708  1.20  pooka 	struct puffs_cacherun	pcache_runs[0];
    709  1.20  pooka };
    710  1.20  pooka #define PCACHE_TYPE_READ	0
    711  1.20  pooka #define PCACHE_TYPE_WRITE	1
    712  1.20  pooka 
    713   1.1  pooka /* notyet */
    714   1.1  pooka #if 0
    715   1.1  pooka struct puffs_vnreq_kqfilter { };
    716   1.1  pooka struct puffs_vnreq_islocked { };
    717   1.1  pooka #endif
    718   1.1  pooka struct puffs_vnreq_getextattr { };
    719   1.1  pooka struct puffs_vnreq_setextattr { };
    720   1.1  pooka struct puffs_vnreq_listextattr { };
    721   1.1  pooka 
    722   1.1  pooka #ifdef _KERNEL
    723   1.1  pooka #define PUFFS_VFSREQ(a)							\
    724   1.1  pooka 	struct puffs_vfsreq_##a a##_arg;				\
    725   1.1  pooka 	memset(&a##_arg, 0, sizeof(struct puffs_vfsreq_##a))
    726   1.1  pooka 
    727   1.1  pooka #define PUFFS_VNREQ(a)							\
    728   1.1  pooka 	struct puffs_vnreq_##a a##_arg;					\
    729   1.1  pooka 	memset(&a##_arg, 0, sizeof(struct puffs_vnreq_##a))
    730   1.1  pooka #endif
    731   1.1  pooka 
    732   1.1  pooka #endif /* _PUFFS_MSGIF_H_ */
    733