lck_debug.h

Go to the documentation of this file.

//      Module  LCK_DEBUG.H     "X-1"
//
//   Copyright © Compaq Computer Corporation, 2000 All Rights Reserved.
//   Unpublished rights reserved under the copyright laws of the United States.
//
//   The software contained on this media is proprietary to and embodies the
//   confidential technology of Compaq Computer Corporation.  Possession, use,
//   duplication or dissemination of the software and media is authorized only
//   pursuant to a valid written license from Compaq Computer Corporation.
//
//   RESTRICTED RIGHTS LEGEND   Use, duplication, or disclosure by the U.S.
//   Government is subject to restrictions as set forth in Subparagraph
//   (c)(1)(ii) of DFARS 252.227-7013, or in FAR 52.227-19, as applicable.
//
//++
//
//  FACILITY:
//
//      OpenVMS Executive (SYS)
//
//  ABSTRACT:
//
//      This module contains constants and structure definitions for the 
//      lock manager tracing utility.
//
//  AUTHOR:
//
//      Christian Moser, August 2000
//
//  MODIFIED BY:
//
//      X-1     CMOS            Christian Moser         21-AUG-2000
//              Initial version.
//

//
// Define some constants needed for both the debug and the SDA extension
// image
//
#define TRACE_BUFFER_PAGES 128

#define LCK_NEWLOCK     1
#define LCK_CONVERSION  2
#define LCK_DEQUEUE     3
#define LCK_EXIT        4
#define LCK_ERROR       5
#define LCK_STALL       6
#define LCK_INFO        8
#define LCK_GRANTED     9

#define TRACE_NEWLOCK    (1 << LCK_NEWLOCK)
#define TRACE_CONVERSION (1 << LCK_CONVERSION)
#define TRACE_DEQUEUE    (1 << LCK_DEQUEUE)
#define TRACE_EXIT       (1 << LCK_EXIT)
#define TRACE_ERROR      (1 << LCK_ERROR)
#define TRACE_STALL      (1 << LCK_STALL)
#define TRACE_INFO       (1 << LCK_INFO)
#define TRACE_GRANTED    (1 << LCK_GRANTED)

#define DISP_LOCKS      1
#define DISP_RESOURCES  2
#define DISP_TREES      4

#define OP_LOAD         1
#define OP_REBUILD      2
#define OP_REMASTER     4


typedef struct _trace_entry {
        int64           timestamp;
        int32           flag;
        int             pid;
        uint64          lkb;
        uint64          rsb;
        char            resource[32];
        uint64          par_lkb;
        uint64          par_rsb;
        uint32          cpudb;
        uint32          status;
        uint32          enq_flags;
        uint8           rsnlen;
        uint8           fill1;
        int8            rqmode;
        int8            grmode;
        } TRACE_ENTRY;

//
// Define trace header structure
//
typedef struct _trace_hdr {
        uint32                  idx;
        uint32                  max_idx;
        unsigned short int      mbo;    
        unsigned char           type;   
        unsigned char           subtype;
        uint32                  scc;
        unsigned __int64        size;     
        #pragma __required_pointer_size __save  
        #pragma __required_pointer_size __long  
        TRACE_ENTRY             *entry_ptr;
        #pragma __required_pointer_size __restore 
        TRACE_ENTRY             entry[1];
        } TRACE_HDR;


//
// Define shared structure used as communications area between debug image
// and SDA extension image
//
typedef struct _lckdbg {
        int                     (*trace_newlock)();
        int                     (*trace_conversion)();
        unsigned short int      mbo;    
        unsigned char           type;        
        unsigned char           subtype;     
        int                     (*trace_dequeue)();
        unsigned __int64        size;     
        int                     (*trace_exit)();
        int                     (*trace_error)();
        int                     (*trace_stall)();
        int                     (*debug_print)();
        int                     (*start_trace)();
        int                     (*stop_trace)();
        #pragma __required_pointer_size __save  
        #pragma __required_pointer_size __long
        TRACE_HDR               *trace_buffer;          
        #pragma __required_pointer_size __restore 
        int                     (*trace_granted)();
        int                     fill1;
        int                     (*rebuild)();
        int                     (*remaster)();
        int                     (*start_rebuild)();
        int                     (*stop_rebuild)();
        int                     (*start_remaster)();
        int                     (*stop_remaster)();
        #pragma __required_pointer_size __save  
        #pragma __required_pointer_size __long
        TQE64                   *tqe_rebuild;
        TQE64                   *tqe_remaster;
        #pragma __required_pointer_size __restore 
        int                     trace_flags;
        int                     fill2;
        int                     (*start_regression)();
        int                     (*stop_regression)();
        int                     regr_flags;
        int                     regr_threads;
        int                     regr_trees;
        int                     regr_locks;
        uint64                  regr_ticks;
        int64                   scc_b[CPU$C_MAX_CPUS];
        int64                   systime_b[CPU$C_MAX_CPUS];
        } LCKDBG;

Project space on SourceForge.net