sys/sys/disk.h

   1 /*
   2  * Copyright (c) 2003,2004 The DragonFly Project.  All rights reserved.
   3  *
   4  * This code is derived from software contributed to The DragonFly Project
   5  * by Matthew Dillon <dillon@backplane.com>
   6  *
   7  * Redistribution and use in source and binary forms, with or without
   8  * modification, are permitted provided that the following conditions
   9  * are met:
  10  *
  11  * 1. Redistributions of source code must retain the above copyright
  12  *    notice, this list of conditions and the following disclaimer.
  13  * 2. Redistributions in binary form must reproduce the above copyright
  14  *    notice, this list of conditions and the following disclaimer in
  15  *    the documentation and/or other materials provided with the
  16  *    distribution.
  17  * 3. Neither the name of The DragonFly Project nor the names of its
  18  *    contributors may be used to endorse or promote products derived
  19  *    from this software without specific, prior written permission.
  20  *
  21  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  22  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  23  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  24  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE
  25  * COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
  26  * INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING,
  27  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  28  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
  29  * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  30  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
  31  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  32  * SUCH DAMAGE.
  33  *
  34  * ----------------------------------------------------------------------------
  35  * "THE BEER-WARE LICENSE" (Revision 42):
  36  * <phk@FreeBSD.ORG> wrote this file.  As long as you retain this notice you
  37  * can do whatever you want with this stuff. If we meet some day, and you think
  38  * this stuff is worth it, you can buy me a beer in return.   Poul-Henning Kamp
  39  * ----------------------------------------------------------------------------
  40  *
  41  * $FreeBSD: src/sys/sys/disk.h,v 1.16.2.3 2001/06/20 16:11:01 scottl Exp $
  42  */
  43
  44 #ifndef _SYS_DISK_H_
  45 #define _SYS_DISK_H_
  46
  47 #if !defined(_KERNEL) && !defined(_KERNEL_STRUCTURES)
  48 #error "This file should not be included by userland programs."
  49 #endif
  50
  51 #ifndef _SYS_DISKSLICE_H_
  52 #include <sys/diskslice.h>
  53 #endif
  54 #ifndef _SYS_QUEUE_H_
  55 #include <sys/queue.h>
  56 #endif
  57 #ifndef _SYS_MSGPORT_H_
  58 #include <sys/msgport.h>
  59 #endif
  60 #ifndef _SYS_DMSG_H_
  61 #include <sys/dmsg.h>
  62 #endif
  63
  64 /*
  65  * Media information structure - filled in by the media driver.
  66  *
  67  * NOTE: d_serialno is copied on the call to setdiskinfo and need
  68  *       not be valid after that.
  69  */
  70 struct disk_info {
  71         /*
  72          * These fields are required.  Most drivers will load a disk_info
  73          * structure in the device open function with the media parameters
  74          * and call disk_setdiskinfo().
  75          *
  76          * Note that only one of d_media_size or d_media_blocks should be
  77          * filled in.
  78          *
  79          * d_media_size         media size in bytes
  80          * d_media_blocks       media size in blocks (e.g. total sectors)
  81          * d_media_blksize      media block size / sector size
  82          * d_dsflags            disklabel management flags
  83          */
  84         u_int64_t               d_media_size;
  85         u_int64_t               d_media_blocks;
  86         int                     d_media_blksize;
  87         u_int                   d_dsflags;
  88
  89         /*
  90          * Optional fields, leave 0 if not known
  91          */
  92         u_int                   d_type;         /* DTYPE_xxx */
  93         u_int                   d_nheads;
  94         u_int                   d_ncylinders;
  95         u_int                   d_secpertrack;
  96         u_int                   d_secpercyl;
  97         u_int                   d_trimflag;
  98         char                    *d_serialno;
  99 };
 100
 101 /*
 102  * d_dsflags, also used for dsopen() - control disklabel processing
 103  *
 104  * COMPATPARTA  - used by scsi devices to allow CDs to boot from cd0a.
 105  *                cd's don't have disklabels and the default compat label
 106  *                does not implement an 'a' partition.
 107  *
 108  * COMPATMBR    - used by the vn device to request that one sector be
 109  *                reserved as if an MBR were present even when one isn't.
 110  *
 111  * MBRQUIET     - silently ignore MBR probe if unable to read sector 0.
 112  *                used by VN.
 113  *
 114  * DEVICEMAPPER - used by the device mapper (dm). Adds a '.' between the
 115  *                device name and the slice/part stuff (i.e. foo.s0).
 116  *
 117  * RAWPSIZE     - use the dev_psize of the underlying raw device if the top
 118  *                psize fails.
 119  */
 120 #define DSO_NOLABELS            0x0001
 121 #define DSO_ONESLICE            0x0002
 122 #define DSO_COMPATLABEL         0x0004
 123 #define DSO_COMPATPARTA         0x0008
 124 #define DSO_COMPATMBR           0x0010
 125 #define DSO_RAWEXTENSIONS       0x0020
 126 #define DSO_MBRQUIET            0x0040
 127 #define DSO_DEVICEMAPPER        0x0080
 128 #define DSO_RAWPSIZE            0x0100
 129
 130 #if defined(_KERNEL) || defined(_KERNEL_STRUCTURES)
 131
 132 /*
 133  * Disk management structure - automated disklabel support.
 134  */
 135 struct disk {
 136         struct dev_ops          *d_dev_ops;     /* our device switch */
 137         struct dev_ops          *d_raw_ops;     /* the raw device switch */
 138         u_int                   d_flags;
 139         int                     d_opencount;    /* The current open count */
 140         cdev_t                  d_rawdev;       /* backing raw device */
 141         cdev_t                  d_cdev;         /* special whole-disk part */
 142         struct diskslices       *d_slice;
 143         struct disk_info        d_info;         /* info structure for media */
 144         void                    *d_unused01;
 145         void                    *d_unused02;
 146         void                    *d_unused03;
 147         const char              *d_disktype;    /* Disk type information */
 148         LIST_ENTRY(disk)        d_list;
 149         kdmsg_iocom_t           d_iocom;        /* cluster import/export */
 150         int                     d_refs;         /* interlock destruction */
 151 };
 152
 153 #endif
 154
 155 /*
 156  * d_flags
 157  */
 158 #define DISKFLAG_LOCK           0x0001
 159 #define DISKFLAG_WANTED         0x0002
 160 #define DISKFLAG_MARKER         0x0004
 161
 162 #ifdef _KERNEL
 163 cdev_t disk_create (int unit, struct disk *disk, struct dev_ops *raw_ops);
 164 cdev_t disk_create_clone (int unit, struct disk *disk, struct dev_ops *raw_ops);
 165 cdev_t disk_create_named(const char *name, int unit, struct disk *dp, struct dev_ops *raw_ops);
 166 cdev_t disk_create_named_clone(const char *name, int unit, struct disk *dp, struct dev_ops *raw_ops);
 167 cdev_t disk_locate (const char *devname);
 168 void disk_destroy (struct disk *disk);
 169 void disk_setdiskinfo (struct disk *disk, struct disk_info *info);
 170 int disk_setdisktype(struct disk *disk, const char *type);
 171 int disk_getopencount(struct disk *disk);
 172 void disk_setdiskinfo_sync(struct disk *disk, struct disk_info *info);
 173 int disk_dumpcheck (cdev_t dev, u_int64_t *count, u_int64_t *blkno, u_int *secsize);
 174 int disk_dumpconf(cdev_t dev, u_int onoff);
 175 struct disk *disk_enumerate (struct disk *marker, struct disk *dp);
 176 void disk_enumerate_stop (struct disk *marker, struct disk *dp);
 177 void disk_invalidate (struct disk *disk);
 178 void disk_unprobe(struct disk *disk);
 179
 180 void disk_msg_send(uint32_t cmd, void *load, void *load2);
 181 void disk_msg_send_sync(uint32_t cmd, void *load, void *load2);
 182 void disk_config(void *);
 183
 184 int bounds_check_with_mediasize(struct bio *bio, int secsize, uint64_t mediasize);
 185
 186 void disk_iocom_init(struct disk *dp);
 187 void disk_iocom_update(struct disk *dp);
 188 void disk_iocom_uninit(struct disk *dp);
 189 int disk_iocom_ioctl(struct disk *dp, u_long cmd, void *data);
 190 void disk_clusterctl_wakeup(kdmsg_iocom_t *iocom);
 191
 192 typedef struct disk_msg {
 193         struct lwkt_msg hdr;
 194         void    *load;
 195         void    *load2;
 196 } *disk_msg_t;
 197
 198 #define DISK_DISK_PROBE         0x01
 199 #define DISK_DISK_DESTROY       0x02
 200 #define DISK_SLICE_REPROBE      0x03
 201 #define DISK_DISK_REPROBE       0x04
 202 #define DISK_UNPROBE            0x05
 203 #define DISK_SYNC               0x99
 204
 205
 206 #endif /* _KERNEL */
 207
 208 #endif /* _SYS_DISK_H_ */