1 /* $OpenBSD: ccdvar.h,v 1.11 2007/06/06 17:15:13 deraadt Exp $ */
2 /* $NetBSD: ccdvar.h,v 1.11 1996/02/28 01:08:32 thorpej Exp $ */
3
4 /*-
5 * Copyright (c) 1996 The NetBSD Foundation, Inc.
6 * All rights reserved.
7 *
8 * This code is derived from software contributed to The NetBSD Foundation
9 * by Jason R. Thorpe.
10 *
11 * Redistribution and use in source and binary forms, with or without
12 * modification, are permitted provided that the following conditions
13 * are met:
14 * 1. Redistributions of source code must retain the above copyright
15 * notice, this list of conditions and the following disclaimer.
16 * 2. Redistributions in binary form must reproduce the above copyright
17 * notice, this list of conditions and the following disclaimer in the
18 * documentation and/or other materials provided with the distribution.
19 * 3. All advertising materials mentioning features or use of this software
20 * must display the following acknowledgement:
21 * This product includes software developed by the NetBSD
22 * Foundation, Inc. and its contributors.
23 * 4. Neither the name of The NetBSD Foundation nor the names of its
24 * contributors may be used to endorse or promote products derived
25 * from this software without specific prior written permission.
26 *
27 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
28 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
29 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
30 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE
31 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
32 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
33 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
34 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
35 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
36 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
37 * POSSIBILITY OF SUCH DAMAGE.
38 */
39
40 /*
41 * Copyright (c) 1988 University of Utah.
42 * Copyright (c) 1990, 1993
43 * The Regents of the University of California. All rights reserved.
44 *
45 * This code is derived from software contributed to Berkeley by
46 * the Systems Programming Group of the University of Utah Computer
47 * Science Department.
48 *
49 * Redistribution and use in source and binary forms, with or without
50 * modification, are permitted provided that the following conditions
51 * are met:
52 * 1. Redistributions of source code must retain the above copyright
53 * notice, this list of conditions and the following disclaimer.
54 * 2. Redistributions in binary form must reproduce the above copyright
55 * notice, this list of conditions and the following disclaimer in the
56 * documentation and/or other materials provided with the distribution.
57 * 3. Neither the name of the University nor the names of its contributors
58 * may be used to endorse or promote products derived from this software
59 * without specific prior written permission.
60 *
61 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
62 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
63 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
64 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
65 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
66 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
67 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
68 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
69 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
70 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
71 * SUCH DAMAGE.
72 *
73 * from: Utah $Hdr: cdvar.h 1.1 90/07/09$
74 *
75 * @(#)cdvar.h 8.1 (Berkeley) 6/10/93
76 */
77
78 /*
79 * Dynamic configuration and disklabel support by:
80 * Jason R. Thorpe <thorpej@nas.nasa.gov>
81 * Numerical Aerodynamic Simulation Facility
82 * Mail Stop 258-6
83 * NASA Ames Research Center
84 * Moffett Field, CA 94035
85 */
86
87 /*
88 * A concatenated disk is described at initialization time by this structure.
89 */
90 struct ccddevice {
91 struct vnode **ccd_vpp; /* array of component vnodes */
92 char **ccd_cpp; /* array of component pathnames */
93 int ccd_unit; /* logical unit of this ccd */
94 int ccd_interleave; /* interleave (DEV_BSIZE blocks) */
95 int ccd_flags; /* misc. information */
96 int ccd_ndev; /* number of component devices */
97 };
98
99 /*
100 * This structure is used to configure a ccd via ioctl(2).
101 */
102 struct ccd_ioctl {
103 char **ccio_disks; /* pointer to component paths */
104 u_int ccio_ndisks; /* number of disks to concatenate */
105 int ccio_ileave; /* interleave (DEV_BSIZE blocks) */
106 int ccio_flags; /* misc. information */
107 int ccio_unit; /* unit number: use varies */
108 size_t ccio_size; /* (returned) size of ccd */
109 };
110
111 /* ccd_flags */
112 #define CCDF_SWAP 0x01 /* interleave should be dmmax */
113 #define CCDF_UNIFORM 0x02 /* use LCCD of sizes for uniform interleave */
114 #define CCDF_MIRROR 0x04 /* enable data mirroring */
115 #define CCDF_OLD 0x08 /* legacy */
116 #define CCDF_BITS \
117 "\020\01swap\02uniform\03mirror\04old"
118
119 /* Mask of user-settable ccd flags. */
120 #define CCDF_USERMASK \
121 (CCDF_SWAP|CCDF_UNIFORM|CCDF_MIRROR|CCDF_OLD)
122
123 /*
124 * Component info table.
125 * Describes a single component of a concatenated disk.
126 */
127 struct ccdcinfo {
128 struct vnode *ci_vp; /* device's vnode */
129 char *ci_path; /* path to component */
130 size_t ci_size; /* size */
131 size_t ci_pathlen; /* length of component path */
132 dev_t ci_dev; /* XXX: device's dev_t */
133 int ci_flags; /* see below */
134 };
135
136 #define CCIF_FAILED 0x01 /* had a B_ERROR on this one */
137
138 /*
139 * Interleave description table.
140 * Computed at boot time to speed irregular-interleave lookups.
141 * The idea is that we interleave in "groups". First we interleave
142 * evenly over all component disks up to the size of the smallest
143 * component (the first group), then we interleave evenly over all
144 * remaining disks up to the size of the next-smallest (second group),
145 * and so on.
146 *
147 * Each table entry describes the interleave characteristics of one
148 * of these groups. For example if a concatenated disk consisted of
149 * three components of 5, 3, and 7 DEV_BSIZE blocks interleaved at
150 * DEV_BSIZE (1), the table would have three entries:
151 *
152 * ndisk startblk startoff dev
153 * 3 0 0 0, 1, 2
154 * 2 9 3 0, 2
155 * 1 13 5 2
156 * 0 - - -
157 *
158 * which says that the first nine blocks (0-8) are interleaved over
159 * 3 disks (0, 1, 2) starting at block offset 0 on any component disk,
160 * the next 4 blocks (9-12) are interleaved over 2 disks (0, 2) starting
161 * at component block 3, and the remaining blocks (13-14) are on disk
162 * 2 starting at offset 5.
163 */
164 struct ccdiinfo {
165 daddr64_t ii_startblk; /* starting scaled block # for range */
166 daddr64_t ii_startoff; /* starting component offset (block #) */
167 int *ii_index; /* ordered list of components in range */
168 int *ii_parity; /* list of parity shifts */
169 int ii_ndisk; /* # of disks range is interleaved over */
170 };
171
172 /*
173 * Concatenated disk pseudo-geometry information.
174 */
175 struct ccdgeom {
176 u_int32_t ccg_secsize; /* # bytes per sector */
177 u_int32_t ccg_nsectors; /* # data sectors per track */
178 u_int32_t ccg_ntracks; /* # tracks per cylinder */
179 u_int32_t ccg_ncylinders; /* # cylinders per unit */
180 u_int16_t ccg_rpm;
181 };
182
183 /*
184 * Before you can use a unit, it must be configured with CCDIOCSET.
185 * The configuration persists across opens and closes of the device;
186 * a CCDIOCCLR must be used to reset a configuration. An attempt to
187 * CCDIOCSET an already active unit will return EBUSY. Attempts to
188 * CCDIOCCLR an inactive unit will return ENXIO.
189 */
190 #define CCDIOCSET _IOWR('F', 16, struct ccd_ioctl) /* enable ccd */
191 #define CCDIOCCLR _IOW('F', 17, struct ccd_ioctl) /* disable ccd */