osfmk/kperf/kperf_timer.h

   1 #ifndef KPERF_TIMER_H
   2 #define KPERF_TIMER_H
   3 /*
   4  * Copyright (c) 2011 Apple Computer, Inc. All rights reserved.
   5  *
   6  * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
   7  *
   8  * This file contains Original Code and/or Modifications of Original Code
   9  * as defined in and that are subject to the Apple Public Source License
  10  * Version 2.0 (the 'License'). You may not use this file except in
  11  * compliance with the License. The rights granted to you under the License
  12  * may not be used to create, or enable the creation or redistribution of,
  13  * unlawful or unlicensed copies of an Apple operating system, or to
  14  * circumvent, violate, or enable the circumvention or violation of, any
  15  * terms of an Apple operating system software license agreement.
  16  *
  17  * Please obtain a copy of the License at
  18  * http://www.opensource.apple.com/apsl/ and read it before using this file.
  19  *
  20  * The Original Code and all software distributed under the License are
  21  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
  22  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
  23  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
  24  * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
  25  * Please see the License for the specific language governing rights and
  26  * limitations under the License.
  27  *
  28  * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
  29  */
  30
  31 #include <kern/timer_call.h>
  32 #include <kern/bits.h>
  33
  34 struct kperf_timer {
  35         struct timer_call tcall;
  36         uint64_t period;
  37         unsigned actionid;
  38         volatile unsigned active;
  39
  40         /*
  41          * A bitmap of CPUs that have a pending timer to service.  On Intel, it
  42          * allows the core responding to the timer interrupt to not queue up
  43          * cross-calls on cores that haven't yet responded.  On ARM, it allows
  44          * the signal handler to multiplex simultaneous fires of different
  45          * timers.
  46          */
  47         bitmap_t pending_cpus;
  48 };
  49
  50 extern struct kperf_timer *kperf_timerv;
  51 extern unsigned int kperf_timerc;
  52
  53 void kperf_timer_reprogram(void);
  54 void kperf_timer_reprogram_all(void);
  55
  56 void kperf_ipi_handler(void *param);
  57
  58 // return values from the action
  59 #define TIMER_REPROGRAM (0)
  60 #define TIMER_STOP      (1)
  61
  62 /* getters and setters on timers */
  63 unsigned kperf_timer_get_count(void);
  64 int kperf_timer_set_count(unsigned int count);
  65
  66 int kperf_timer_get_period(unsigned int timer, uint64_t *period);
  67 int kperf_timer_set_period(unsigned int timer, uint64_t period);
  68
  69 int kperf_timer_get_action(unsigned int timer, uint32_t *action);
  70 int kperf_timer_set_action(unsigned int timer, uint32_t action);
  71
  72 void kperf_timer_go(void);
  73 void kperf_timer_stop(void);
  74 void kperf_timer_reset(void);
  75
  76 unsigned int kperf_timer_get_petid(void);
  77 int kperf_timer_set_petid(unsigned int count);
  78
  79 /* so PET thread can re-arm the timer */
  80 void kperf_timer_pet_rearm(uint64_t elapsed_ticks);
  81
  82 #endif /* !defined(KPERF_TIMER_H) */