freebsd-skq/sys/geom/raid/g_raid_tr_if.m
Alexander Motin 89b172238a MFgraid/head:
Add new RAID GEOM class, that is going to replace ataraid(4) in supporting
various BIOS-based software RAIDs. Unlike ataraid(4) this implementation
does not depend on legacy ata(4) subsystem and can be used with any disk
drivers, including new CAM-based ones (ahci(4), siis(4), mvs(4), ata(4)
with `options ATA_CAM`). To make code more readable and extensible, this
implementation follows modular design, including core part and two sets
of modules, implementing support for different metadata formats and RAID
levels.

Support for such popular metadata formats is now implemented:
Intel, JMicron, NVIDIA, Promise (also used by AMD/ATI) and SiliconImage.

Such RAID levels are now supported:
RAID0, RAID1, RAID1E, RAID10, SINGLE, CONCAT.

For any all of these RAID levels and metadata formats this class supports
full cycle of volume operations: reading, writing, creation, deletion,
disk removal and insertion, rebuilding, dirty shutdown detection
and resynchronization, bad sector recovery, faulty disks tracking,
hot-spare disks. For Intel and Promise formats there is support multiple
volumes per disk set.

Look graid(8) manual page for additional details.

Co-authored by:	imp
Sponsored by:	Cisco Systems, Inc. and iXsystems, Inc.
2011-03-24 21:31:32 +00:00

119 lines
3.1 KiB
Objective-C

#-
# Copyright (c) 2010 Alexander Motin
# All rights reserved.
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions
# are met:
#
# 1. Redistributions of source code must retain the above copyright
# notice, this list of conditions and the following disclaimer.
# 2. Redistributions in binary form must reproduce the above copyright
# notice, this list of conditions and the following disclaimer in the
# documentation and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
# IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
# OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
# IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
# INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
# NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
# THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
#
# $FreeBSD$
#include <sys/param.h>
#include <sys/lock.h>
#include <sys/malloc.h>
#include <sys/mutex.h>
#include <sys/sbuf.h>
#include <sys/bus.h>
#include <machine/bus.h>
#include <sys/systm.h>
#include <geom/geom.h>
#include <geom/raid/g_raid.h>
# The G_RAID transformation class interface.
INTERFACE g_raid_tr;
# Default implementations of methods.
CODE {
static int
g_raid_tr_locked_default(struct g_raid_tr_object *tr, void *argp)
{
return (0);
}
};
HEADER {
#define G_RAID_TR_TASTE_FAIL -1
#define G_RAID_TR_TASTE_SUCCEED 0
};
# taste() - volume taste method.
METHOD int taste {
struct g_raid_tr_object *tr;
struct g_raid_volume *volume;
};
# event() - events handling method.
METHOD int event {
struct g_raid_tr_object *tr;
struct g_raid_subdisk *sd;
u_int event;
};
# start() - begin operation.
METHOD int start {
struct g_raid_tr_object *tr;
};
# stop() - stop operation.
METHOD int stop {
struct g_raid_tr_object *tr;
};
# iorequest() - manage forward transformation and generates requests to disks.
METHOD void iostart {
struct g_raid_tr_object *tr;
struct bio *bp;
};
# iodone() - manages backward transformation and reports completion status.
METHOD void iodone {
struct g_raid_tr_object *tr;
struct g_raid_subdisk *sd;
struct bio *bp;
};
# kerneldump() - optimized for rebustness (simplified) kernel dumping routine.
METHOD int kerneldump {
struct g_raid_tr_object *tr;
void *virtual;
vm_offset_t physical;
off_t offset;
size_t length;
} DEFAULT g_raid_tr_kerneldump_common;
# locked() - callback method for lock().
METHOD int locked {
struct g_raid_tr_object *tr;
void *argp;
} DEFAULT g_raid_tr_locked_default;
# free() - destructor.
METHOD int free {
struct g_raid_tr_object *tr;
};
# idle() - callback when the volume is idle for a while and the TR wants
# to schedule some work for that idle period.
METHOD int idle {
struct g_raid_tr_object *tr;
};