/*
* Copyright (c) 2010-2013 Apple Inc. All rights reserved.
*
* @APPLE_APACHE_LICENSE_HEADER_START@
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* @APPLE_APACHE_LICENSE_HEADER_END@
*/
/*
* DTrace Probes for libdispatch
*
* Only available in the introspection version of the library,
* loaded by running a process with the environment variable
* DYLD_LIBRARY_PATH=/usr/lib/system/introspection
*/
typedef struct dispatch_object_s *dispatch_object_t;
typedef struct dispatch_queue_s *dispatch_queue_t;
typedef struct dispatch_source_s *dispatch_source_t;
typedef void (*dispatch_function_t)(void *);
typedef struct dispatch_trace_timer_params_s {
int64_t deadline, interval, leeway;
} *dispatch_trace_timer_params_t;
provider dispatch {
/*
* Probes for dispatch queue push and pop operations
*
* dispatch$target:libdispatch*.dylib::queue-push
* dispatch$target:libdispatch*.dylib::queue-pop
*/
probe queue__push(dispatch_queue_t queue, const char *label,
dispatch_object_t item, const char *kind,
dispatch_function_t function, void *context);
probe queue__pop(dispatch_queue_t queue, const char *label,
dispatch_object_t item, const char *kind,
dispatch_function_t function, void *context);
/*
* Probes for dispatch callouts to client functions
*
* dispatch$target:libdispatch*.dylib::callout-entry
* dispatch$target:libdispatch*.dylib::callout-return
*/
probe callout__entry(dispatch_queue_t queue, const char *label,
dispatch_function_t function, void *context);
probe callout__return(dispatch_queue_t queue, const char *label,
dispatch_function_t function, void *context);
/*
* Probes for dispatch timer configuration and programming
*
* Timer configuration indicates that dispatch_source_set_timer() was called.
* Timer programming indicates that the dispatch manager is about to sleep
* for 'deadline' ns (but may wake up earlier if non-timer events occur).
* Time parameters are in nanoseconds, a value of -1 means "forever".
*
* dispatch$target:libdispatch*.dylib::timer-configure
* dispatch$target:libdispatch*.dylib::timer-program
*/
probe timer__configure(dispatch_source_t source,
dispatch_function_t handler, dispatch_trace_timer_params_t params);
probe timer__program(dispatch_source_t source, dispatch_function_t handler,
dispatch_trace_timer_params_t params);
/*
* Probes for dispatch timer wakes and fires
*
* Timer wakes indicate that the dispatch manager woke up due to expiry of the
* deadline for the specified timer.
* Timer fires indicate that that the dispatch manager scheduled the event
* handler of the specified timer for asynchronous execution (may occur without
* a corresponding timer wake if the manager was awake processing other events
* when the timer deadline expired).
*
* dispatch$target:libdispatch*.dylib::timer-wake
* dispatch$target:libdispatch*.dylib::timer-fire
*/
probe timer__wake(dispatch_source_t source, dispatch_function_t handler);
probe timer__fire(dispatch_source_t source, dispatch_function_t handler);
};
#pragma D attributes Evolving/Evolving/Common provider dispatch provider
#pragma D attributes Private/Private/Common provider dispatch module
#pragma D attributes Private/Private/Common provider dispatch function
#pragma D attributes Evolving/Evolving/Common provider dispatch name
#pragma D attributes Evolving/Evolving/Common provider dispatch args
typedef struct voucher_s *voucher_t;
/*
* Probes for vouchers
*/
provider voucher {
/*
* Voucher lifetime:
*
* voucher$target:::create A new voucher is being created
* voucher$target:::dispose A voucher is being freed
* voucher$target:::retain A voucher is being retained
* voucher$target:::release A voucher is being released
*/
probe create(voucher_t voucher, mach_port_t kv, uint64_t activity_id);
probe dispose(voucher_t voucher);
probe retain(voucher_t voucher, int resulting_refcnt);
probe release(voucher_t voucher, int resulting_refcnt);
/*
* Thread adoption
*
* voucher$target:::adopt A voucher is being adopted by the current thread
* voucher$target:::orphan A voucher is being orphanned by the current thread
*/
probe adopt(voucher_t voucher);
probe orphan(voucher_t voucher);
};
#pragma D attributes Evolving/Evolving/Common provider voucher provider
#pragma D attributes Private/Private/Common provider voucher module
#pragma D attributes Private/Private/Common provider voucher function
#pragma D attributes Evolving/Evolving/Common provider voucher name
#pragma D attributes Evolving/Evolving/Common provider voucher args