bsd/sys/lockstat.h

   1 /*
   2  * CDDL HEADER START
   3  *
   4  * The contents of this file are subject to the terms of the
   5  * Common Development and Distribution License, Version 1.0 only
   6  * (the "License").  You may not use this file except in compliance
   7  * with the License.
   8  *
   9  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
  10  * or http://www.opensolaris.org/os/licensing.
  11  * See the License for the specific language governing permissions
  12  * and limitations under the License.
  13  *
  14  * When distributing Covered Code, include this CDDL HEADER in each
  15  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  16  * If applicable, add the following below this CDDL HEADER, with the
  17  * fields enclosed by brackets "[]" replaced with your own identifying
  18  * information: Portions Copyright [yyyy] [name of copyright owner]
  19  *
  20  * CDDL HEADER END
  21  */
  22 /*
  23  * Copyright 1997-2003 Sun Microsystems, Inc.  All rights reserved.
  24  * Use is subject to license terms.
  25  */
  26
  27 #ifndef _SYS_LOCKSTAT_H
  28 #define _SYS_LOCKSTAT_H
  29 #endif
  30
  31 /* #pragma ident        "@(#)lockstat.h 1.6     05/06/08 SMI" */
  32
  33 #ifdef  __cplusplus
  34 extern "C" {
  35 #endif
  36
  37 /*
  38  * Spin locks - we have less variants
  39  */
  40 #define LS_LCK_SPIN_LOCK_ACQUIRE        0
  41 #define LS_LCK_SPIN_LOCK_SPIN           1
  42 #define LS_LCK_SPIN_UNLOCK_RELEASE      2
  43 /*
  44  * Mutexes can also have interlock-spin events, which are
  45  * unique to our lock implementation.
  46  */
  47 #define LS_LCK_MTX_LOCK_ACQUIRE                 3
  48 #define LS_LCK_MTX_LOCK_BLOCK                   5
  49 #define LS_LCK_MTX_LOCK_SPIN                    6
  50 #define LS_LCK_MTX_LOCK_ILK_SPIN                7
  51 #define LS_LCK_MTX_TRY_LOCK_ACQUIRE             8
  52 #define LS_LCK_MTX_TRY_SPIN_LOCK_ACQUIRE        9
  53 #define LS_LCK_MTX_UNLOCK_RELEASE               10
  54
  55 #define LS_LCK_MTX_LOCK_SPIN_ACQUIRE            39
  56 /*
  57  * Provide a parallel set for indirect mutexes
  58  */
  59 #define LS_LCK_MTX_EXT_LOCK_ACQUIRE                     17
  60 #define LS_LCK_MTX_EXT_LOCK_BLOCK                       18
  61 #define LS_LCK_MTX_EXT_LOCK_SPIN                        19
  62 #define LS_LCK_MTX_EXT_LOCK_ILK_SPIN            20
  63 #define LS_LCK_MTX_TRY_EXT_LOCK_ACQUIRE         21
  64 #define LS_LCK_MTX_EXT_UNLOCK_RELEASE           22
  65 /*
  66  * Our reader-writer locks support a blocking upgrade primitive, as
  67  * well as the possibility of spinning on the interlock.
  68  */
  69 #define LS_LCK_RW_LOCK_SHARED_ACQUIRE           23
  70 #define LS_LCK_RW_LOCK_SHARED_BLOCK             24
  71 #define LS_LCK_RW_LOCK_SHARED_SPIN              25
  72
  73 #define LS_LCK_RW_LOCK_EXCL_ACQUIRE             26
  74 #define LS_LCK_RW_LOCK_EXCL_BLOCK               27
  75 #define LS_LCK_RW_LOCK_EXCL_SPIN                28
  76
  77 #define LS_LCK_RW_DONE_RELEASE                  29
  78
  79 #define LS_LCK_RW_TRY_LOCK_SHARED_ACQUIRE       30
  80 #define LS_LCK_RW_TRY_LOCK_SHARED_SPIN          31
  81
  82 #define LS_LCK_RW_TRY_LOCK_EXCL_ACQUIRE         32
  83 #define LS_LCK_RW_TRY_LOCK_EXCL_ILK_SPIN        33
  84
  85 #define LS_LCK_RW_LOCK_SHARED_TO_EXCL_UPGRADE   34
  86 #define LS_LCK_RW_LOCK_SHARED_TO_EXCL_SPIN      35
  87 #define LS_LCK_RW_LOCK_SHARED_TO_EXCL_BLOCK     36
  88
  89 #define LS_LCK_RW_LOCK_EXCL_TO_SHARED_DOWNGRADE 37
  90 #define LS_LCK_RW_LOCK_EXCL_TO_SHARED_ILK_SPIN  38
  91
  92 #define LS_NPROBES                      40
  93
  94 /*
  95  * Name the various locking functions...
  96  */
  97 #define LS_LCK_MTX_LOCK                 "lck_mtx_lock"
  98 #define LS_LCK_MTX_SPIN_LOCK            "lck_mtx_spin_lock"
  99 #define LS_LCK_MTX_UNLOCK               "lck_mtx_unlock"
 100 #define LS_LCK_MTX_TRY_LOCK             "lck_mtx_try_lock"
 101 #define LS_LCK_MTX_TRY_SPIN_LOCK        "lck_mtx_try_spin_lock"
 102 #define LS_LCK_MTX_EXT_LOCK             "lck_mtx_ext_lock"
 103 #define LS_LCK_MTX_EXT_UNLOCK           "lck_mtx_ext_unlock"
 104 #define LS_LCK_MTX_EXT_TRY_LOCK         "lck_mtx_ext_try_lock"
 105 #define LS_LCK_MTX_LOCK_SPIN_LOCK       "lck_mtx_lock_spin"
 106
 107 #define LS_LCK_SPIN_LOCK                "lck_spin_lock"
 108 #define LS_LCK_SPIN_TRY_LOCK            "lck_spin_try_lock"
 109 #define LS_LCK_SPIN_UNLOCK              "lck_spin_unlock"
 110 #define LS_LCK_RW_LOCK_SHARED           "lck_rw_lock_shared"
 111 #define LS_LCK_RW_LOCK_EXCL             "lck_rw_lock_exclusive"
 112 #define LS_LCK_RW_DONE                  "lck_rw_done"
 113 #define LS_LCK_RW_TRY_LOCK_EXCL         "lck_rw_try_lock_exclusive"
 114 #define LS_LCK_RW_TRY_LOCK_SHARED       "lck_rw_try_lock_shared"
 115 #define LS_LCK_RW_LOCK_SHARED_TO_EXCL   "lck_rw_shared_to_exclusive"
 116 #define LS_LCK_RW_LOCK_EXCL_TO_SHARED   "lck_rw_exclusive_to_shared"
 117
 118 #define LS_ACQUIRE                      "acquire"
 119 #define LS_RELEASE                      "release"
 120 #define LS_SPIN                         "spin"
 121 #define LS_BLOCK                        "block"
 122 #define LS_UPGRADE                      "upgrade"
 123 #define LS_DOWNGRADE                    "downgrade"
 124
 125 #define LS_TYPE_ADAPTIVE                "adaptive"
 126 #define LS_TYPE_SPIN                    "spin"
 127 #define LS_TYPE_ILK                     "interlock"     /* OS X only */
 128 #define LS_TYPE_THREAD                  "thread"        /* Solaris only */
 129 #define LS_TYPE_RW                      "rw"
 130 #define LS_TYPE_RWUPGRADE               "rwupgrade"     /* OS X only */
 131
 132 #define LSA_ACQUIRE                     (LS_TYPE_ADAPTIVE "-" LS_ACQUIRE)
 133 #define LSA_RELEASE                     (LS_TYPE_ADAPTIVE "-" LS_RELEASE)
 134 #define LSA_SPIN                        (LS_TYPE_ADAPTIVE "-" LS_SPIN)
 135 #define LSA_BLOCK                       (LS_TYPE_ADAPTIVE "-" LS_BLOCK)
 136 #define LSA_ILK_SPIN                    (LS_TYPE_ILK "-" LS_SPIN)
 137 #define LSS_ACQUIRE                     (LS_TYPE_SPIN "-" LS_ACQUIRE)
 138 #define LSS_RELEASE                     (LS_TYPE_SPIN "-" LS_RELEASE)
 139 #define LSS_SPIN                        (LS_TYPE_SPIN "-" LS_SPIN)
 140 #define LSR_ACQUIRE                     (LS_TYPE_RW "-" LS_ACQUIRE)
 141 #define LSR_RELEASE                     (LS_TYPE_RW "-" LS_RELEASE)
 142 #define LSR_BLOCK                       (LS_TYPE_RW "-" LS_BLOCK)
 143 #define LSR_SPIN                        (LS_TYPE_RW "-" LS_SPIN)
 144 #define LSR_UPGRADE                     (LS_TYPE_RW "-" LS_UPGRADE)
 145 #define LSR_UPGRADE_BLOCK               (LS_TYPE_RWUPGRADE "-" LS_BLOCK)
 146 #define LSR_DOWNGRADE                   (LS_TYPE_RW "-" LS_DOWNGRADE)
 147 #define LST_SPIN                        (LS_TYPE_THREAD "-" LS_SPIN)
 148
 149 #ifndef _ASM
 150
 151 #include <stdint.h>
 152 #ifdef KERNEL
 153
 154 #ifndef _KERNEL
 155 #define _KERNEL /* Solaris vs. Darwin */
 156 #endif
 157
 158 /*
 159  * Platform-independent kernel support for the lockstat driver.
 160  */
 161 #if defined(NEED_DTRACE_DEFS)
 162 typedef uint32_t dtrace_id_t;           /* probe identifier - also in dtrace.h! */
 163 typedef uint64_t        u_longlong_t;   /* also in dtrace.h! */
 164 #endif
 165
 166 extern dtrace_id_t lockstat_probemap[LS_NPROBES];
 167 extern void (*lockstat_probe)(dtrace_id_t, uint64_t, uint64_t,
 168     uint64_t, uint64_t, uint64_t);
 169
 170
 171 #ifdef _KERNEL
 172
 173 #if     CONFIG_DTRACE
 174 /*
 175  * Macros to record lockstat probes.
 176  */
 177 #define LOCKSTAT_RECORD4(probe, lp, arg0, arg1, arg2, arg3)             \
 178         {                                                               \
 179                 dtrace_id_t id;                                         \
 180                 if ((id = lockstat_probemap[(probe)])) {                \
 181                         (*lockstat_probe)(id, (uintptr_t)(lp), (arg0),  \
 182                             (arg1), (arg2), (arg3));                    \
 183                 }                                                       \
 184         }
 185
 186 #define LOCKSTAT_RECORD2(probe, lp, arg1, arg2) \
 187         LOCKSTAT_RECORD4(probe, lp, arg1, arg2, 0, 0)
 188
 189 #define LOCKSTAT_RECORD(probe, lp, arg) \
 190         LOCKSTAT_RECORD4(probe, lp, arg, 0, 0, 0)
 191
 192 #define LOCKSTAT_RECORD0(probe, lp)     \
 193         LOCKSTAT_RECORD4(probe, lp, 0, 0, 0, 0)
 194 #else
 195         /* No Lockstat provider */
 196
 197 #define LOCKSTAT_RECORD()
 198 #define LOCKSTAT_RECORD0()
 199 #define LOCKSTAT_RECORD2()
 200 #define LOCKSTAT_RECORD4()
 201
 202 #endif /* !CONFIG_DTRACE */
 203
 204 #endif /* _KERNEL */
 205
 206 #endif /* _ASM */
 207
 208 #ifdef  __cplusplus
 209 }
 210 #endif
 211
 212 #endif  /* _SYS_LOCKSTAT_H */
 213