Annotation of sys/dev/ccdvar.h, Revision 1.1
1.1 ! nbrk 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 */
CVSweb