sys/dev/raid/vinum/vinumext.h

   1 /*-
   2  * Copyright (c) 1997, 1998
   3  *      Nan Yang Computer Services Limited.  All rights reserved.
   4  *
   5  *  This software is distributed under the so-called ``Berkeley
   6  *  License'':
   7  *
   8  * Redistribution and use in source and binary forms, with or without
   9  * modification, are permitted provided that the following conditions
  10  * are met:
  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 the
  15  *    documentation and/or other materials provided with the distribution.
  16  * 3. All advertising materials mentioning features or use of this software
  17  *    must display the following acknowledgement:
  18  *      This product includes software developed by Nan Yang Computer
  19  *      Services Limited.
  20  * 4. Neither the name of the Company nor the names of its contributors
  21  *    may be used to endorse or promote products derived from this software
  22  *    without specific prior written permission.
  23  *
  24  * This software is provided ``as is'', and any express or implied
  25  * warranties, including, but not limited to, the implied warranties of
  26  * merchantability and fitness for a particular purpose are disclaimed.
  27  * In no event shall the company or contributors be liable for any
  28  * direct, indirect, incidental, special, exemplary, or consequential
  29  * damages (including, but not limited to, procurement of substitute
  30  * goods or services; loss of use, data, or profits; or business
  31  * interruption) however caused and on any theory of liability, whether
  32  * in contract, strict liability, or tort (including negligence or
  33  * otherwise) arising in any way out of the use of this software, even if
  34  * advised of the possibility of such damage.
  35  */
  36
  37 /*
  38  * vinumext.h: external definitions
  39  */
  40
  41 extern struct _vinum_conf vinum_conf;   /* configuration information */
  42
  43 #ifdef VINUMDEBUG
  44 extern int debug;                       /* debug flags */
  45 #endif
  46
  47 /*
  48  * Physical read and write drive
  49  */
  50 #define read_drive(a, b, c, d) driveio (a, b, c, d, BUF_CMD_READ)
  51 #define write_drive(a, b, c, d) driveio (a, b, c, d, BUF_CMD_WRITE)
  52
  53 #define CHECKALLOC(ptr, msg)            \
  54     if (ptr == NULL) {                  \
  55             kprintf (msg);              \
  56             longjmp (command_fail, -1); \
  57     }
  58
  59 #ifndef _KERNEL
  60 struct vnode;
  61 struct proc;
  62 #endif
  63
  64 #ifdef _KERNEL
  65 int vinum_inactive(int);
  66 void free_vinum(int);
  67 int give_sd_to_plex(int plexno, int sdno);
  68 void give_sd_to_drive(int sdno);
  69 int give_plex_to_volume(int volno, int plexno);
  70 struct drive *check_drive(char *);
  71 enum drive_label_info read_drive_label(struct drive *, int);
  72 int parse_config(char *, struct keywordset *, int);
  73 int parse_user_config(char *cptr, struct keywordset *keyset);
  74 u_int64_t sizespec(char *spec);
  75 int volume_index(struct volume *volume);
  76 int plex_index(struct plex *plex);
  77 int sd_index(struct sd *sd);
  78 int drive_index(struct drive *drive);
  79 int my_plex(int volno, int plexno);
  80 int my_sd(int plexno, int sdno);
  81 int get_empty_drive(void);
  82 int find_drive(const char *name, int create);
  83 int find_drive_by_dev(const char *devname, int create);
  84 int get_empty_sd(void);
  85 int find_subdisk(const char *name, int create);
  86 void return_drive_space(int driveno, int64_t offset, int length);
  87 void free_sd(int sdno);
  88 void free_volume(int volno);
  89 int get_empty_plex(void);
  90 int find_plex(const char *name, int create);
  91 void free_plex(int plexno);
  92 int get_empty_volume(void);
  93 int find_volume(const char *name, int create);
  94 void config_subdisk(int);
  95 void config_plex(int);
  96 void config_volume(int);
  97 void config_drive(int);
  98 void updateconfig(int);
  99 void update_sd_config(int sdno, int kernelstate);
 100 void update_plex_config(int plexno, int kernelstate);
 101 void update_volume_config(int volno, int kernelstate);
 102 void update_config(void);
 103 void drive_io_done(struct buf *);
 104 void save_config(void);
 105 void daemon_save_config(void);
 106 void write_config(char *, int);
 107 int start_config(int);
 108 void finish_config(int);
 109 void remove(struct vinum_ioctl_msg *msg);
 110 void remove_drive_entry(int driveno, int force);
 111 void remove_sd_entry(int sdno, int force, int recurse);
 112 void remove_plex_entry(int plexno, int force, int recurse);
 113 void remove_volume_entry(int volno, int force, int recurse);
 114
 115 void checkdiskconfig(char *);
 116 int open_drive(struct drive *, struct proc *, int);
 117 void close_drive(struct drive *drive);
 118 void close_locked_drive(struct drive *drive);
 119 int driveio(struct drive *, char *, size_t, off_t, buf_cmd_t);
 120 int set_drive_parms(struct drive *drive);
 121 int init_drive(struct drive *, int);
 122 /* void throw_rude_remark (int, struct _ioctl_reply *, char *, ...); XXX */
 123 void throw_rude_remark(int, char *,...);
 124
 125 /* XXX die die */
 126 void format_config(char *config, int len);
 127 void checkkernel(char *op);
 128 void free_drive(struct drive *drive);
 129 void down_drive(struct drive *drive);
 130 void remove_drive(int driveno);
 131
 132 int vinum_scandisk(char *drivename[], int drives);
 133
 134 /* I/O */
 135 d_open_t vinumopen;
 136 d_close_t vinumclose;
 137 d_strategy_t vinumstrategy;
 138 d_ioctl_t vinumioctl;
 139 d_dump_t vinumdump;
 140 d_psize_t vinumsize;
 141 d_poll_t vinumpoll;
 142
 143 int vinumstart(cdev_t dev, struct bio *bio, int reviveok);
 144 int launch_requests(struct request *rq, int reviveok);
 145 void sdio(struct bio *bio);
 146
 147 /* XXX Do we need this? */
 148 int vinumpart(cdev_t);
 149
 150 extern jmp_buf command_fail;            /* return here if config fails */
 151 extern struct dev_ops vinum_ops;
 152
 153 #ifdef VINUMDEBUG
 154 /* Memory allocation and request tracing */
 155 void vinum_meminfo(caddr_t data);
 156 int vinum_mallocinfo(caddr_t data);
 157 int vinum_rqinfo(caddr_t data);
 158 void LongJmp(jmp_buf, int);
 159 #else
 160 void longjmp(jmp_buf, int);             /* the kernel doesn't define this */
 161 #endif
 162 int setjmp(jmp_buf);
 163
 164 char *basename(char *);
 165 void expand_table(void **, int, int);
 166
 167 struct request;
 168 struct rqgroup *allocrqg(struct request *rq, int elements);
 169 void deallocrqg(struct rqgroup *rqg);
 170
 171 /* Device number decoding */
 172 int Volno(cdev_t x);
 173 int Plexno(cdev_t x);
 174 int Sdno(cdev_t x);
 175
 176 /* State transitions */
 177 int set_drive_state(int driveno, enum drivestate state, enum setstateflags flags);
 178 int set_sd_state(int sdno, enum sdstate state, enum setstateflags flags);
 179 enum requeststatus checksdstate(struct sd *sd, struct request *rq, vinum_off_t diskaddr, vinum_off_t diskend);
 180 int set_plex_state(int plexno, enum plexstate state, enum setstateflags flags);
 181 int set_volume_state(int volumeno, enum volumestate state, enum setstateflags flags);
 182 void update_sd_state(int sdno);
 183 void forceup(int plexno);
 184 void update_plex_state(int plexno);
 185 void update_volume_state(int volno);
 186 void invalidate_subdisks(struct plex *, enum sdstate);
 187 void start_object(struct vinum_ioctl_msg *);
 188 void stop_object(struct vinum_ioctl_msg *);
 189 void setstate(struct vinum_ioctl_msg *msg);
 190 void setstate_by_force(struct vinum_ioctl_msg *msg);
 191 void vinum_label(int);
 192 int initsd(int, int);
 193 struct buf *parityrebuild(struct plex *, vinum_off_t, int, enum parityop, struct rangelock **, off_t *);
 194 enum requeststatus sddownstate(struct request *rq);
 195
 196 int restart_plex(int plexno);
 197 int revive_read(struct sd *sd);
 198 int revive_block(int sdno);
 199 void parityops(struct vinum_ioctl_msg *);
 200
 201 /* Auxiliary functions */
 202 enum sdstates sdstatemap(struct plex *plex);
 203 enum volplexstate vpstate(struct plex *plex);
 204 #endif
 205
 206 enum keyword get_keyword(char *, struct keywordset *);
 207 void listconfig(void);
 208 char *drive_state(enum drivestate);
 209 char *volume_state(enum volumestate);
 210 char *plex_state(enum plexstate);
 211 char *plex_org(enum plexorg);
 212 char *sd_state(enum sdstate);
 213 enum drivestate DriveState(char *text);
 214 enum sdstate SdState(char *text);
 215 enum plexstate PlexState(char *text);
 216 enum volumestate VolState(char *text);
 217 struct drive *validdrive(int driveno, struct _ioctl_reply *);
 218 struct sd *validsd(int sdno, struct _ioctl_reply *);
 219 struct plex *validplex(int plexno, struct _ioctl_reply *);
 220 struct volume *validvol(int volno, struct _ioctl_reply *);
 221 int tokenize(char *, char *[]);
 222 void resetstats(struct vinum_ioctl_msg *msg);
 223
 224 /* Locking */
 225 #ifdef VINUMDEBUG
 226 int lockdrive(struct drive *drive, char *, int);
 227 #else
 228 int lockdrive(struct drive *drive);
 229 #endif
 230 void unlockdrive(struct drive *drive);
 231 int lockvol(struct volume *vol);
 232 void unlockvol(struct volume *vol);
 233 int lockplex(struct plex *plex);
 234 void unlockplex(struct plex *plex);
 235 struct rangelock *lockrange(vinum_off_t stripe, struct buf *bp, struct plex *plex);
 236 int lock_config(void);
 237 void unlock_config(void);
 238
 239 /* Dæmon */
 240
 241 void vinum_daemon(void);
 242 int vinum_finddaemon(void);
 243 int vinum_setdaemonopts(int);
 244
 245 extern struct daemonq *daemonq;         /* daemon's work queue */
 246 extern struct daemonq *dqend;           /* and the end of the queue */
 247
 248 #undef Free                             /* defined in some funny net stuff */
 249 #ifdef _KERNEL
 250 #ifdef VINUMDEBUG
 251 #define Malloc(x)  MMalloc ((x), __FILE__, __LINE__)
 252 #define Free(x)    FFree ((x), __FILE__, __LINE__)
 253 caddr_t MMalloc(int size, char *, int);
 254 void FFree(void *mem, char *, int);
 255 #define LOCKDRIVE(d) lockdrive (d, __FILE__, __LINE__)
 256 #else
 257 #define Malloc(x)  kmalloc((x), M_DEVBUF, \
 258         mycpu->gd_intr_nesting_level == 0? M_WAITOK: M_INTWAIT)
 259 #define Free(x)    kfree((x), M_DEVBUF)
 260 #define LOCKDRIVE(d) lockdrive (d)
 261 #endif
 262 #else
 263 #define Malloc(x)  malloc ((x))         /* just the size */
 264 #define Free(x)    free ((x))           /* just the address */
 265 #endif
 266