xref: /dragonfly/sys/sys/vnioctl.h (revision cc93b0eb)
1 /*
2  * Copyright (c) 1988 University of Utah.
3  * Copyright (c) 1990, 1993
4  *	The Regents of the University of California.  All rights reserved.
5  *
6  * This code is derived from software contributed to Berkeley by
7  * the Systems Programming Group of the University of Utah Computer
8  * Science Department.
9  *
10  * Redistribution and use in source and binary forms, with or without
11  * modification, are permitted provided that the following conditions
12  * are met:
13  * 1. Redistributions of source code must retain the above copyright
14  *    notice, this list of conditions and the following disclaimer.
15  * 2. Redistributions in binary form must reproduce the above copyright
16  *    notice, this list of conditions and the following disclaimer in the
17  *    documentation and/or other materials provided with the distribution.
18  * 3. All advertising materials mentioning features or use of this software
19  *    must display the following acknowledgement:
20  *	This product includes software developed by the University of
21  *	California, Berkeley and its contributors.
22  * 4. Neither the name of the University nor the names of its contributors
23  *    may be used to endorse or promote products derived from this software
24  *    without specific prior written permission.
25  *
26  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
27  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
28  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
29  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
30  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
31  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
32  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
33  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
34  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
35  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
36  * SUCH DAMAGE.
37  *
38  * from: Utah $Hdr: fdioctl.h 1.1 90/07/09$
39  *
40  *	@(#)vnioctl.h	8.1 (Berkeley) 6/10/93
41  *
42  * $FreeBSD: src/sys/sys/vnioctl.h,v 1.4 1999/09/17 05:33:58 dillon Exp $
43  * $DragonFly: src/sys/sys/vnioctl.h,v 1.4 2008/01/30 11:46:33 cat Exp $
44  */
45 
46 #ifndef _SYS_VNIOCTL_H_
47 #define _SYS_VNIOCTL_H_
48 
49 #ifndef _SYS_PARAMH_H_
50 #include <sys/param.h>		/* PATH_MAX */
51 #endif
52 
53 /*
54  * Ioctl definitions for file (vnode) disk pseudo-device.
55  */
56 
57 #define _PATH_VNTAB	"/etc/vntab"	/* default config file */
58 
59 struct vn_ioctl {
60 	char	*vn_file;	/* pathname of file to mount */
61 	int64_t	vn_size;	/* (returned) size of disk */
62 };
63 
64 /*
65  * Structure used by userland to query vn devices.
66  *
67  * In file-backed configurations, vnu_file will contain the full path to
68  * the backing file, with vnu_dev and vnu_ino pointing to the appropriate
69  * filesystem entries for that file.
70  *
71  * In swap-backed configurations, vnu_file will contain the token "swap",
72  * with vnu_size and vnu_secsize indicating the portion of virtual memory
73  * in use by the vnode disk.
74  *
75  * Todo: verify vnu_file within a jail - path disclosure problem ?
76  */
77 
78 
79 struct vn_user {
80         int     	vnu_unit;		/* vn unit */
81         char    	vnu_file[PATH_MAX];	/* vn description */
82 #define _VN_USER_SWAP	"swap"			/* indicates swap-backed vn */
83 	union {
84 	        dev_t   	dev;		/* vn device */
85 		u_int64_t	size;		/* size per vnu_secsize */
86 	} data1;
87 	union {
88         	ino_t   	ino;		/* vn inode */
89 		int		secsize;	/* sector size */
90 	} data2;
91 };
92 #define vnu_dev		data1.dev
93 #define vnu_size	data1.size
94 #define vnu_ino		data2.ino
95 #define vnu_secsize	data2.secsize
96 
97 /*
98  * Before you can use a unit, it must be configured with VNIOCSET.
99  * The configuration persists across opens and closes of the device;
100  * an VNIOCCLR must be used to reset a configuration.  An attempt to
101  * VNIOCSET an already active unit will return EBUSY.
102  */
103 #define VNIOCATTACH	_IOWR('F', 0, struct vn_ioctl)	/* attach file */
104 #define VNIOCDETACH	_IOWR('F', 1, struct vn_ioctl)	/* detach disk */
105 #define VNIOCGSET	_IOWR('F', 2, u_long )		/* set global option */
106 #define VNIOCGCLEAR	_IOWR('F', 3, u_long )		/* reset --//-- */
107 #define VNIOCUSET	_IOWR('F', 4, u_long )		/* set unit option */
108 #define VNIOCUCLEAR	_IOWR('F', 5, u_long )		/* reset --//-- */
109 #define VNIOCGET	_IOWR('F', 6, struct vn_user)	/* get disk info */
110 
111 #define VN_LABELS	0x1	/* Use disk(/slice) labels */
112 #define VN_FOLLOW	0x2	/* Debug flow in vn driver */
113 #define VN_DEBUG	0x4	/* Debug data in vn driver */
114 #define VN_IO		0x8	/* Debug I/O in vn driver */
115 #define VN_DONTCLUSTER	0x10	/* Don't cluster */
116 #define VN_RESERVE	0x20	/* Pre-reserve swap */
117 
118 #endif	/* _SYS_VNIOCTL_H_*/
119