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