Annotation of kernel/bsd/sys/disklabel.h, revision 1.1

1.1     ! root        1: /*
        !             2:  * Copyright (c) 1999 Apple Computer, Inc. All rights reserved.
        !             3:  *
        !             4:  * @APPLE_LICENSE_HEADER_START@
        !             5:  * 
        !             6:  * Portions Copyright (c) 1999 Apple Computer, Inc.  All Rights
        !             7:  * Reserved.  This file contains Original Code and/or Modifications of
        !             8:  * Original Code as defined in and that are subject to the Apple Public
        !             9:  * Source License Version 1.1 (the "License").  You may not use this file
        !            10:  * except in compliance with the License.  Please obtain a copy of the
        !            11:  * License at http://www.apple.com/publicsource and read it before using
        !            12:  * this file.
        !            13:  * 
        !            14:  * The Original Code and all software distributed under the License are
        !            15:  * distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, EITHER
        !            16:  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
        !            17:  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
        !            18:  * FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT.  Please see the
        !            19:  * License for the specific language governing rights and limitations
        !            20:  * under the License.
        !            21:  * 
        !            22:  * @APPLE_LICENSE_HEADER_END@
        !            23:  */
        !            24: 
        !            25: /* Copyright (c) 1995 NeXT Computer, Inc. All Rights Reserved */
        !            26: /*
        !            27:  * Copyright (c) 1987, 1988, 1993
        !            28:  *     The Regents of the University of California.  All rights reserved.
        !            29:  *
        !            30:  * Redistribution and use in source and binary forms, with or without
        !            31:  * modification, are permitted provided that the following conditions
        !            32:  * are met:
        !            33:  * 1. Redistributions of source code must retain the above copyright
        !            34:  *    notice, this list of conditions and the following disclaimer.
        !            35:  * 2. Redistributions in binary form must reproduce the above copyright
        !            36:  *    notice, this list of conditions and the following disclaimer in the
        !            37:  *    documentation and/or other materials provided with the distribution.
        !            38:  * 3. All advertising materials mentioning features or use of this software
        !            39:  *    must display the following acknowledgement:
        !            40:  *     This product includes software developed by the University of
        !            41:  *     California, Berkeley and its contributors.
        !            42:  * 4. Neither the name of the University nor the names of its contributors
        !            43:  *    may be used to endorse or promote products derived from this software
        !            44:  *    without specific prior written permission.
        !            45:  *
        !            46:  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
        !            47:  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
        !            48:  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
        !            49:  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
        !            50:  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
        !            51:  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
        !            52:  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
        !            53:  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
        !            54:  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
        !            55:  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
        !            56:  * SUCH DAMAGE.
        !            57:  *
        !            58:  *     @(#)disklabel.h 8.2 (Berkeley) 7/10/94
        !            59:  */
        !            60: 
        !            61: /*
        !            62:  * Disk description table, see disktab(5)
        !            63:  */
        !            64: #define        _PATH_DISKTAB   "/etc/disktab"
        !            65: #define        DISKTAB         "/etc/disktab"          /* deprecated */
        !            66: 
        !            67: /*
        !            68:  * Each disk has a label which includes information about the hardware
        !            69:  * disk geometry, filesystem partitions, and drive specific information.
        !            70:  * The location of the label, as well as the number of partitions the
        !            71:  * label can describe and the number of the "whole disk" (raw)
        !            72:  * paritition are machine dependent.
        !            73:  */
        !            74: #include <machine/disklabel.h>
        !            75: 
        !            76: /*
        !            77:  * The absolute maximum number of disk partitions allowed.
        !            78:  * This is the maximum value of MAXPARTITIONS for which 'struct disklabel'
        !            79:  * is <= DEV_BSIZE bytes long.  If MAXPARTITIONS is greater than this, beware.
        !            80:  */
        !            81: #define        MAXMAXPARTITIONS        22
        !            82: #if MAXPARTITIONS > MAXMAXPARTITIONS
        !            83: #warning beware: MAXPARTITIONS bigger than MAXMAXPARTITIONS
        !            84: #endif
        !            85: 
        !            86: /*
        !            87:  * Translate between device numbers and major/disk unit/disk partition.
        !            88:  */
        !            89: #define        DISKUNIT(dev)   (minor(dev) / MAXPARTITIONS)
        !            90: #define        DISKPART(dev)   (minor(dev) % MAXPARTITIONS)
        !            91: #define        MAKEDISKDEV(maj, unit, part) \
        !            92:     (makedev((maj), ((unit) * MAXPARTITIONS) + (part)))
        !            93: 
        !            94: #define DISKMAGIC      ((u_int32_t)0x82564557) /* The disk magic number */
        !            95: 
        !            96: #ifndef LOCORE
        !            97: struct disklabel {
        !            98:        u_int32_t d_magic;              /* the magic number */
        !            99:        u_int16_t d_type;               /* drive type */
        !           100:        u_int16_t d_subtype;            /* controller/d_type specific */
        !           101:        char      d_typename[16];       /* type name, e.g. "eagle" */
        !           102: 
        !           103:        /* 
        !           104:         * d_packname contains the pack identifier and is returned when
        !           105:         * the disklabel is read off the disk or in-core copy.
        !           106:         * d_boot0 and d_boot1 are the (optional) names of the
        !           107:         * primary (block 0) and secondary (block 1-15) bootstraps
        !           108:         * as found in /usr/mdec.  These are returned when using
        !           109:         * getdiskbyname(3) to retrieve the values from /etc/disktab.
        !           110:         */
        !           111:        union {
        !           112:                char    un_d_packname[16];      /* pack identifier */ 
        !           113:                struct {
        !           114:                        char *un_d_boot0;       /* primary bootstrap name */
        !           115:                        char *un_d_boot1;       /* secondary bootstrap name */
        !           116:                } un_b; 
        !           117:        } d_un; 
        !           118: #define d_packname     d_un.un_d_packname
        !           119: #define d_boot0                d_un.un_b.un_d_boot0
        !           120: #define d_boot1                d_un.un_b.un_d_boot1
        !           121: 
        !           122:                        /* disk geometry: */
        !           123:        u_int32_t d_secsize;            /* # of bytes per sector */
        !           124:        u_int32_t d_nsectors;           /* # of data sectors per track */
        !           125:        u_int32_t d_ntracks;            /* # of tracks per cylinder */
        !           126:        u_int32_t d_ncylinders;         /* # of data cylinders per unit */
        !           127:        u_int32_t d_secpercyl;          /* # of data sectors per cylinder */
        !           128:        u_int32_t d_secperunit;         /* # of data sectors per unit */
        !           129: 
        !           130:        /*
        !           131:         * Spares (bad sector replacements) below are not counted in
        !           132:         * d_nsectors or d_secpercyl.  Spare sectors are assumed to
        !           133:         * be physical sectors which occupy space at the end of each
        !           134:         * track and/or cylinder.
        !           135:         */
        !           136:        u_int16_t d_sparespertrack;     /* # of spare sectors per track */
        !           137:        u_int16_t d_sparespercyl;       /* # of spare sectors per cylinder */
        !           138:        /*
        !           139:         * Alternate cylinders include maintenance, replacement, configuration
        !           140:         * description areas, etc.
        !           141:         */
        !           142:        u_int32_t d_acylinders;         /* # of alt. cylinders per unit */
        !           143: 
        !           144:                        /* hardware characteristics: */
        !           145:        /*
        !           146:         * d_interleave, d_trackskew and d_cylskew describe perturbations
        !           147:         * in the media format used to compensate for a slow controller.
        !           148:         * Interleave is physical sector interleave, set up by the
        !           149:         * formatter or controller when formatting.  When interleaving is
        !           150:         * in use, logically adjacent sectors are not physically
        !           151:         * contiguous, but instead are separated by some number of
        !           152:         * sectors.  It is specified as the ratio of physical sectors
        !           153:         * traversed per logical sector.  Thus an interleave of 1:1
        !           154:         * implies contiguous layout, while 2:1 implies that logical
        !           155:         * sector 0 is separated by one sector from logical sector 1.
        !           156:         * d_trackskew is the offset of sector 0 on track N relative to
        !           157:         * sector 0 on track N-1 on the same cylinder.  Finally, d_cylskew
        !           158:         * is the offset of sector 0 on cylinder N relative to sector 0
        !           159:         * on cylinder N-1.
        !           160:         */
        !           161:        u_int16_t d_rpm;                /* rotational speed */
        !           162:        u_int16_t d_interleave;         /* hardware sector interleave */
        !           163:        u_int16_t d_trackskew;          /* sector 0 skew, per track */
        !           164:        u_int16_t d_cylskew;            /* sector 0 skew, per cylinder */
        !           165:        u_int32_t d_headswitch;         /* head switch time, usec */
        !           166:        u_int32_t d_trkseek;            /* track-to-track seek, usec */
        !           167:        u_int32_t d_flags;              /* generic flags */
        !           168: #define NDDATA 5
        !           169:        u_int32_t d_drivedata[NDDATA];  /* drive-type specific information */
        !           170: #define NSPARE 5
        !           171:        u_int32_t d_spare[NSPARE];      /* reserved for future use */
        !           172:        u_int32_t d_magic2;             /* the magic number (again) */
        !           173:        u_int16_t d_checksum;           /* xor of data incl. partitions */
        !           174: 
        !           175:                        /* filesystem and partition information: */
        !           176:        u_int16_t d_npartitions;        /* number of partitions in following */
        !           177:        u_int32_t d_bbsize;             /* size of boot area at sn0, bytes */
        !           178:        u_int32_t d_sbsize;             /* max size of fs superblock, bytes */
        !           179:        struct  partition {             /* the partition table */
        !           180:                u_int32_t p_size;       /* number of sectors in partition */
        !           181:                u_int32_t p_offset;     /* starting sector */
        !           182:                u_int32_t p_fsize;      /* filesystem basic fragment size */
        !           183:                u_int8_t p_fstype;      /* filesystem type, see below */
        !           184:                u_int8_t p_frag;        /* filesystem fragments per block */
        !           185:                union {
        !           186:                        u_int16_t cpg;  /* UFS: FS cylinders per group */
        !           187:                        u_int16_t sgs;  /* LFS: FS segment shift */
        !           188:                } __partition_u1;
        !           189: #define        p_cpg   __partition_u1.cpg
        !           190: #define        p_sgs   __partition_u1.sgs
        !           191:        } d_partitions[MAXPARTITIONS];  /* actually may be more */
        !           192: };
        !           193: #else /* LOCORE */
        !           194:        /*
        !           195:         * offsets for asm boot files.
        !           196:         */
        !           197:        .set    d_secsize,40
        !           198:        .set    d_nsectors,44
        !           199:        .set    d_ntracks,48
        !           200:        .set    d_ncylinders,52
        !           201:        .set    d_secpercyl,56
        !           202:        .set    d_secperunit,60
        !           203:        .set    d_end_,276              /* size of disk label */
        !           204: #endif /* LOCORE */
        !           205: 
        !           206: /* d_type values: */
        !           207: #define        DTYPE_SMD               1               /* SMD, XSMD; VAX hp/up */
        !           208: #define        DTYPE_MSCP              2               /* MSCP */
        !           209: #define        DTYPE_DEC               3               /* other DEC (rk, rl) */
        !           210: #define        DTYPE_SCSI              4               /* SCSI */
        !           211: #define        DTYPE_ESDI              5               /* ESDI interface */
        !           212: #define        DTYPE_ST506             6               /* ST506 etc. */
        !           213: #define        DTYPE_HPIB              7               /* CS/80 on HP-IB */
        !           214: #define        DTYPE_HPFL              8               /* HP Fiber-link */
        !           215: #define        DTYPE_FLOPPY            10              /* floppy */
        !           216: 
        !           217: #ifdef DKTYPENAMES
        !           218: static char *dktypenames[] = {
        !           219:        "unknown",
        !           220:        "SMD",
        !           221:        "MSCP",
        !           222:        "old DEC",
        !           223:        "SCSI",
        !           224:        "ESDI",
        !           225:        "ST506",
        !           226:        "HP-IB",
        !           227:        "HP-FL",
        !           228:        "type 9",
        !           229:        "floppy",
        !           230:        NULL
        !           231: };
        !           232: #define DKMAXTYPES     (sizeof(dktypenames) / sizeof(dktypenames[0]) - 1)
        !           233: #endif
        !           234: 
        !           235: /*
        !           236:  * Filesystem type and version.
        !           237:  * Used to interpret other filesystem-specific
        !           238:  * per-partition information.
        !           239:  */
        !           240: #define        FS_UNUSED       0               /* unused */
        !           241: #define        FS_SWAP         1               /* swap */
        !           242: #define        FS_V6           2               /* Sixth Edition */
        !           243: #define        FS_V7           3               /* Seventh Edition */
        !           244: #define        FS_SYSV         4               /* System V */
        !           245: #define        FS_V71K         5               /* V7 with 1K blocks (4.1, 2.9) */
        !           246: #define        FS_V8           6               /* Eighth Edition, 4K blocks */
        !           247: #define        FS_BSDFFS       7               /* 4.2BSD fast file system */
        !           248: #define        FS_MSDOS        8               /* MSDOS file system */
        !           249: #define        FS_BSDLFS       9               /* 4.4BSD log-structured file system */
        !           250: #define        FS_OTHER        10              /* in use, but unknown/unsupported */
        !           251: #define        FS_HPFS         11              /* OS/2 high-performance file system */
        !           252: #define        FS_ISO9660      12              /* ISO 9660, normally CD-ROM */
        !           253: #define        FS_BOOT         13              /* partition contains bootstrap */
        !           254: #define        FS_ADOS         14              /* AmigaDOS fast file system */
        !           255: #define        FS_HFS          15              /* Macintosh HFS */
        !           256: 
        !           257: #ifdef DKTYPENAMES
        !           258: static char *fstypenames[] = {
        !           259:        "unused",
        !           260:        "swap",
        !           261:        "Version 6",
        !           262:        "Version 7",
        !           263:        "System V",
        !           264:        "4.1BSD",
        !           265:        "Eighth Edition",
        !           266:        "4.2BSD",
        !           267:        "MSDOS",
        !           268:        "4.4LFS",
        !           269:        "unknown",
        !           270:        "HPFS",
        !           271:        "ISO9660",
        !           272:        "boot",
        !           273:        "ADOS",
        !           274:        "HFS",
        !           275:        NULL
        !           276: };
        !           277: #define FSMAXTYPES     (sizeof(fstypenames) / sizeof(fstypenames[0]) - 1)
        !           278: #endif
        !           279: 
        !           280: /*
        !           281:  * flags shared by various drives:
        !           282:  */
        !           283: #define                D_REMOVABLE     0x01            /* removable media */
        !           284: #define                D_ECC           0x02            /* supports ECC */
        !           285: #define                D_BADSECT       0x04            /* supports bad sector forw. */
        !           286: #define                D_RAMDISK       0x08            /* disk emulator */
        !           287: #define                D_CHAIN         0x10            /* can do back-back transfers */
        !           288: 
        !           289: /*
        !           290:  * Drive data for SMD.
        !           291:  */
        !           292: #define        d_smdflags      d_drivedata[0]
        !           293: #define                D_SSE           0x1             /* supports skip sectoring */
        !           294: #define        d_mindist       d_drivedata[1]
        !           295: #define        d_maxdist       d_drivedata[2]
        !           296: #define        d_sdist         d_drivedata[3]
        !           297: 
        !           298: /*
        !           299:  * Drive data for ST506.
        !           300:  */
        !           301: #define d_precompcyl   d_drivedata[0]
        !           302: #define d_gap3         d_drivedata[1]          /* used only when formatting */
        !           303: 
        !           304: /*
        !           305:  * Drive data for SCSI.
        !           306:  */
        !           307: #define        d_blind         d_drivedata[0]
        !           308: 
        !           309: #ifndef LOCORE
        !           310: /*
        !           311:  * Structure used to perform a format or other raw operation, returning
        !           312:  * data and/or register values.  Register identification and format
        !           313:  * are device- and driver-dependent.
        !           314:  */
        !           315: struct format_op {
        !           316:        char    *df_buf;
        !           317:        int      df_count;              /* value-result */
        !           318:        daddr_t  df_startblk;
        !           319:        int      df_reg[8];             /* result */
        !           320: };
        !           321: 
        !           322: /*
        !           323:  * Structure used internally to retrieve information about a partition
        !           324:  * on a disk.
        !           325:  */
        !           326: struct partinfo {
        !           327:        struct disklabel *disklab;
        !           328:        struct partition *part;
        !           329: };
        !           330: 
        !           331: /*
        !           332:  * Disk-specific ioctls.
        !           333:  */
        !           334:                /* get and set disklabel; DIOCGPART used internally */
        !           335: #define DIOCGDINFO     _IOR('d', 101, struct disklabel)/* get */
        !           336: #define DIOCSDINFO     _IOW('d', 102, struct disklabel)/* set */
        !           337: #define DIOCWDINFO     _IOW('d', 103, struct disklabel)/* set, update disk */
        !           338: #define DIOCGPART      _IOW('d', 104, struct partinfo) /* get partition */
        !           339: 
        !           340: /* do format operation, read or write */
        !           341: #define DIOCRFORMAT    _IOWR('d', 105, struct format_op)
        !           342: #define DIOCWFORMAT    _IOWR('d', 106, struct format_op)
        !           343: 
        !           344: #define DIOCSSTEP      _IOW('d', 107, int)     /* set step rate */
        !           345: #define DIOCSRETRIES   _IOW('d', 108, int)     /* set # of retries */
        !           346: #define DIOCWLABEL     _IOW('d', 109, int)     /* write en/disable label */
        !           347: 
        !           348: #define DIOCSBAD       _IOW('d', 110, struct dkbad)    /* set kernel dkbad */
        !           349: 
        !           350: #endif /* LOCORE */
        !           351: 
        !           352: #if !defined(_KERNEL) && !defined(LOCORE)
        !           353: 
        !           354: #include <sys/cdefs.h>
        !           355: 
        !           356: __BEGIN_DECLS
        !           357: struct disklabel *getdiskbyname __P((const char *));
        !           358: __END_DECLS
        !           359: 
        !           360: #endif

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.