Annotation of sys/dev/raidframe/rf_acctrace.h, Revision 1.1
1.1 ! nbrk 1: /* $OpenBSD: rf_acctrace.h,v 1.3 2002/12/16 07:01:03 tdeval Exp $ */
! 2: /* $NetBSD: rf_acctrace.h,v 1.3 1999/02/05 00:06:06 oster Exp $ */
! 3:
! 4: /*
! 5: * Copyright (c) 1995 Carnegie-Mellon University.
! 6: * All rights reserved.
! 7: *
! 8: * Author: Mark Holland
! 9: *
! 10: * Permission to use, copy, modify and distribute this software and
! 11: * its documentation is hereby granted, provided that both the copyright
! 12: * notice and this permission notice appear in all copies of the
! 13: * software, derivative works or modified versions, and any portions
! 14: * thereof, and that both notices appear in supporting documentation.
! 15: *
! 16: * CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS"
! 17: * CONDITION. CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND
! 18: * FOR ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.
! 19: *
! 20: * Carnegie Mellon requests users of this software to return to
! 21: *
! 22: * Software Distribution Coordinator or Software.Distribution@CS.CMU.EDU
! 23: * School of Computer Science
! 24: * Carnegie Mellon University
! 25: * Pittsburgh PA 15213-3890
! 26: *
! 27: * any improvements or extensions that they make and grant Carnegie the
! 28: * rights to redistribute these changes.
! 29: */
! 30:
! 31: /*****************************************************************************
! 32: *
! 33: * acctrace.h -- Header file for acctrace.c
! 34: *
! 35: *****************************************************************************/
! 36:
! 37:
! 38: #ifndef _RF__RF_ACCTRACE_H_
! 39: #define _RF__RF_ACCTRACE_H_
! 40:
! 41: #include "rf_types.h"
! 42: #include "rf_hist.h"
! 43: #include "rf_etimer.h"
! 44:
! 45: typedef struct RF_user_acc_stats_s {
! 46: RF_uint64 suspend_ovhd_us;/*
! 47: * usec spent mucking in the
! 48: * access-suspension code.
! 49: */
! 50: RF_uint64 map_us; /* usec spent mapping the access. */
! 51: RF_uint64 lock_us; /*
! 52: * usec spent locking & unlocking
! 53: * stripes, including time spent
! 54: * blocked.
! 55: */
! 56: RF_uint64 dag_create_us; /* usec spent creating the DAGs. */
! 57: RF_uint64 dag_retry_us; /*
! 58: * _total_ usec spent retrying the op
! 59: * -- not broken down into components.
! 60: */
! 61: RF_uint64 exec_us; /* usec spent in DispatchDAG. */
! 62: RF_uint64 exec_engine_us; /*
! 63: * usec spent in engine, not including
! 64: * blocking time.
! 65: */
! 66: RF_uint64 cleanup_us; /*
! 67: * usec spent tearing down the dag &
! 68: * maps, and generally cleaning up.
! 69: */
! 70: } RF_user_acc_stats_t;
! 71:
! 72: typedef struct RF_recon_acc_stats_s {
! 73: RF_uint32 recon_start_to_fetch_us;
! 74: RF_uint32 recon_fetch_to_return_us;
! 75: RF_uint32 recon_return_to_submit_us;
! 76: } RF_recon_acc_stats_t;
! 77:
! 78: typedef struct RF_acctrace_entry_s {
! 79: union {
! 80: RF_user_acc_stats_t user;
! 81: RF_recon_acc_stats_t recon;
! 82: } specific;
! 83: RF_uint8 reconacc; /*
! 84: * Whether this is a tracerec for a
! 85: * user acc or a recon acc.
! 86: */
! 87: RF_uint64 xor_us; /* usec spent doing XORs. */
! 88: RF_uint64 q_us; /* usec spent doing XORs. */
! 89: RF_uint64 plog_us; /*
! 90: * usec spent waiting to stuff parity
! 91: * into log.
! 92: */
! 93: RF_uint64 diskqueue_us; /*
! 94: * _total_ usec spent in disk queue(s),
! 95: * incl concurrent ops.
! 96: */
! 97: RF_uint64 diskwait_us; /*
! 98: * _total_ usec spent actually waiting
! 99: * on the disk, incl concurrent ops.
! 100: */
! 101: RF_uint64 total_us; /* Total usec spent on this access. */
! 102: RF_uint64 num_phys_ios; /* Number of physical I/Os invoked. */
! 103: RF_uint64 phys_io_us; /* Time of physical I/O. */
! 104: RF_Etimer_t tot_timer; /*
! 105: * A timer used to compute total
! 106: * access time.
! 107: */
! 108: RF_Etimer_t timer; /*
! 109: * A generic timer val for timing
! 110: * events that live across procedure
! 111: * boundaries.
! 112: */
! 113: RF_Etimer_t recon_timer; /* Generic timer for recon stuff. */
! 114: RF_uint64 index;
! 115: } RF_AccTraceEntry_t;
! 116:
! 117: typedef struct RF_AccTotals_s {
! 118: /* User acc stats. */
! 119: RF_uint64 suspend_ovhd_us;
! 120: RF_uint64 map_us;
! 121: RF_uint64 lock_us;
! 122: RF_uint64 dag_create_us;
! 123: RF_uint64 dag_retry_us;
! 124: RF_uint64 exec_us;
! 125: RF_uint64 exec_engine_us;
! 126: RF_uint64 cleanup_us;
! 127: RF_uint64 user_reccount;
! 128: /* Recon acc stats. */
! 129: RF_uint64 recon_start_to_fetch_us;
! 130: RF_uint64 recon_fetch_to_return_us;
! 131: RF_uint64 recon_return_to_submit_us;
! 132: RF_uint64 recon_io_overflow_count;
! 133: RF_uint64 recon_phys_io_us;
! 134: RF_uint64 recon_num_phys_ios;
! 135: RF_uint64 recon_diskwait_us;
! 136: RF_uint64 recon_reccount;
! 137: /* Trace entry stats. */
! 138: RF_uint64 xor_us;
! 139: RF_uint64 q_us;
! 140: RF_uint64 plog_us;
! 141: RF_uint64 diskqueue_us;
! 142: RF_uint64 diskwait_us;
! 143: RF_uint64 total_us;
! 144: RF_uint64 num_log_ents;
! 145: RF_uint64 phys_io_overflow_count;
! 146: RF_uint64 num_phys_ios;
! 147: RF_uint64 phys_io_us;
! 148: RF_uint64 bigvals;
! 149: /* Histograms. */
! 150: RF_Hist_t dw_hist[RF_HIST_NUM_BUCKETS];
! 151: RF_Hist_t tot_hist[RF_HIST_NUM_BUCKETS];
! 152: } RF_AccTotals_t;
! 153:
! 154: #if RF_UTILITY == 0
! 155: RF_DECLARE_EXTERN_MUTEX(rf_tracing_mutex);
! 156: #endif /* RF_UTILITY == 0 */
! 157:
! 158: int rf_ConfigureAccessTrace(RF_ShutdownList_t **);
! 159: void rf_LogTraceRec(RF_Raid_t * raid, RF_AccTraceEntry_t *);
! 160: void rf_FlushAccessTraceBuf(void);
! 161:
! 162: #endif /* !_RF__RF_ACCTRACE_H_ */
CVSweb