/* * 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