g_raid_tr_if.m revision 256281
1#- 2# Copyright (c) 2010 Alexander Motin 3# All rights reserved. 4# 5# Redistribution and use in source and binary forms, with or without 6# modification, are permitted provided that the following conditions 7# are met: 8# 9# 1. Redistributions of source code must retain the above copyright 10# notice, this list of conditions and the following disclaimer. 11# 2. Redistributions in binary form must reproduce the above copyright 12# notice, this list of conditions and the following disclaimer in the 13# documentation and/or other materials provided with the distribution. 14# 15# THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 16# IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 17# OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 18# IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 19# INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 20# NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 21# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 22# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 23# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 24# THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 25# 26# $FreeBSD: stable/10/sys/geom/raid/g_raid_tr_if.m 219974 2011-03-24 21:31:32Z mav $ 27 28#include <sys/param.h> 29#include <sys/lock.h> 30#include <sys/malloc.h> 31#include <sys/mutex.h> 32#include <sys/sbuf.h> 33#include <sys/bus.h> 34#include <machine/bus.h> 35#include <sys/systm.h> 36#include <geom/geom.h> 37#include <geom/raid/g_raid.h> 38 39# The G_RAID transformation class interface. 40 41INTERFACE g_raid_tr; 42 43# Default implementations of methods. 44CODE { 45 static int 46 g_raid_tr_locked_default(struct g_raid_tr_object *tr, void *argp) 47 { 48 49 return (0); 50 } 51}; 52 53HEADER { 54#define G_RAID_TR_TASTE_FAIL -1 55#define G_RAID_TR_TASTE_SUCCEED 0 56}; 57 58# taste() - volume taste method. 59METHOD int taste { 60 struct g_raid_tr_object *tr; 61 struct g_raid_volume *volume; 62}; 63 64# event() - events handling method. 65METHOD int event { 66 struct g_raid_tr_object *tr; 67 struct g_raid_subdisk *sd; 68 u_int event; 69}; 70 71# start() - begin operation. 72METHOD int start { 73 struct g_raid_tr_object *tr; 74}; 75 76# stop() - stop operation. 77METHOD int stop { 78 struct g_raid_tr_object *tr; 79}; 80 81# iorequest() - manage forward transformation and generates requests to disks. 82METHOD void iostart { 83 struct g_raid_tr_object *tr; 84 struct bio *bp; 85}; 86 87# iodone() - manages backward transformation and reports completion status. 88METHOD void iodone { 89 struct g_raid_tr_object *tr; 90 struct g_raid_subdisk *sd; 91 struct bio *bp; 92}; 93 94# kerneldump() - optimized for rebustness (simplified) kernel dumping routine. 95METHOD int kerneldump { 96 struct g_raid_tr_object *tr; 97 void *virtual; 98 vm_offset_t physical; 99 off_t offset; 100 size_t length; 101} DEFAULT g_raid_tr_kerneldump_common; 102 103# locked() - callback method for lock(). 104METHOD int locked { 105 struct g_raid_tr_object *tr; 106 void *argp; 107} DEFAULT g_raid_tr_locked_default; 108 109# free() - destructor. 110METHOD int free { 111 struct g_raid_tr_object *tr; 112}; 113 114# idle() - callback when the volume is idle for a while and the TR wants 115# to schedule some work for that idle period. 116METHOD int idle { 117 struct g_raid_tr_object *tr; 118}; 119