609e949ab0
Signed-off-by: chao.an <anchao@xiaomi.com>
716 lines
22 KiB
C
716 lines
22 KiB
C
/****************************************************************************
|
|
* include/nuttx/sched_note.h
|
|
*
|
|
* Licensed to the Apache Software Foundation (ASF) under one or more
|
|
* contributor license agreements. See the NOTICE file distributed with
|
|
* this work for additional information regarding copyright ownership. The
|
|
* ASF licenses this file to you 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.
|
|
*
|
|
****************************************************************************/
|
|
|
|
#ifndef __INCLUDE_NUTTX_SCHED_NOTE_H
|
|
#define __INCLUDE_NUTTX_SCHED_NOTE_H
|
|
|
|
/****************************************************************************
|
|
* Included Files
|
|
****************************************************************************/
|
|
|
|
#include <nuttx/config.h>
|
|
|
|
#include <sys/types.h>
|
|
#include <stdint.h>
|
|
#include <stdbool.h>
|
|
#include <stdarg.h>
|
|
|
|
#include <nuttx/sched.h>
|
|
|
|
/* For system call numbers definition */
|
|
|
|
#ifdef CONFIG_SCHED_INSTRUMENTATION_SYSCALL
|
|
#ifdef CONFIG_LIB_SYSCALL
|
|
#include <syscall.h>
|
|
#else
|
|
#define CONFIG_LIB_SYSCALL
|
|
#include <syscall.h>
|
|
#undef CONFIG_LIB_SYSCALL
|
|
#endif
|
|
#endif
|
|
|
|
#ifdef CONFIG_SCHED_INSTRUMENTATION
|
|
|
|
/****************************************************************************
|
|
* Pre-processor Definitions
|
|
****************************************************************************/
|
|
|
|
/* Provide defaults for some configuration settings (could be undefined with
|
|
* old configuration files)
|
|
*/
|
|
|
|
#ifndef CONFIG_SCHED_INSTRUMENTATION_CPUSET
|
|
# define CONFIG_SCHED_INSTRUMENTATION_CPUSET 0xffff
|
|
#endif
|
|
|
|
/* Note filter mode flag definitions */
|
|
|
|
#define NOTE_FILTER_MODE_FLAG_ENABLE (1 << 0) /* Enable instrumentation */
|
|
#ifdef CONFIG_SCHED_INSTRUMENTATION_SWITCH
|
|
#define NOTE_FILTER_MODE_FLAG_SWITCH (1 << 1) /* Enable syscall instrumentation */
|
|
#endif
|
|
#ifdef CONFIG_SCHED_INSTRUMENTATION_SYSCALL
|
|
#define NOTE_FILTER_MODE_FLAG_SYSCALL (1 << 2) /* Enable syscall instrumentation */
|
|
#endif
|
|
#ifdef CONFIG_SCHED_INSTRUMENTATION_IRQHANDLER
|
|
#define NOTE_FILTER_MODE_FLAG_IRQ (1 << 3) /* Enable IRQ instrumentaiton */
|
|
#endif
|
|
#ifdef CONFIG_SCHED_INSTRUMENTATION_DUMP
|
|
#define NOTE_FILTER_MODE_FLAG_DUMP (1 << 4) /* Enable dump instrumentaiton */
|
|
#endif
|
|
#ifdef CONFIG_SCHED_INSTRUMENTATION_SYSCALL
|
|
#define NOTE_FILTER_MODE_FLAG_SYSCALL_ARGS (1 << 5) /* Enable collecting syscall arguments */
|
|
#endif
|
|
|
|
/* Helper macros for syscall instrumentation filter */
|
|
|
|
#ifdef CONFIG_SCHED_INSTRUMENTATION_SYSCALL
|
|
#define NOTE_FILTER_SYSCALLMASK_SET(nr, s) \
|
|
((s)->syscall_mask[(nr) / 8] |= (1 << ((nr) % 8)))
|
|
#define NOTE_FILTER_SYSCALLMASK_CLR(nr, s) \
|
|
((s)->syscall_mask[(nr) / 8] &= ~(1 << ((nr) % 8)))
|
|
#define NOTE_FILTER_SYSCALLMASK_ISSET(nr, s) \
|
|
((s)->syscall_mask[(nr) / 8] & (1 << ((nr) % 8)))
|
|
#define NOTE_FILTER_SYSCALLMASK_ZERO(s) \
|
|
memset((s), 0, sizeof(struct note_filter_syscall_s))
|
|
#endif
|
|
|
|
/* Helper macros for IRQ instrumentation filter */
|
|
|
|
#ifdef CONFIG_SCHED_INSTRUMENTATION_IRQHANDLER
|
|
#define NOTE_FILTER_IRQMASK_SET(nr, s) \
|
|
((s)->irq_mask[(nr) / 8] |= (1 << ((nr) % 8)))
|
|
#define NOTE_FILTER_IRQMASK_CLR(nr, s) \
|
|
((s)->irq_mask[(nr) / 8] &= ~(1 << ((nr) % 8)))
|
|
#define NOTE_FILTER_IRQMASK_ISSET(nr, s) \
|
|
((s)->irq_mask[(nr) / 8] & (1 << ((nr) % 8)))
|
|
#define NOTE_FILTER_IRQMASK_ZERO(s) \
|
|
memset((s), 0, sizeof(struct note_filter_irq_s))
|
|
#endif
|
|
|
|
#ifdef CONFIG_SCHED_INSTRUMENTATION_DUMP
|
|
# define SCHED_NOTE_LABEL__(x, y) x ## y
|
|
# define SCHED_NOTE_LABEL_(x, y) SCHED_NOTE_LABEL__(x, y)
|
|
# define SCHED_NOTE_LABEL \
|
|
SCHED_NOTE_LABEL_(sched_note_here, __LINE__)
|
|
# define SCHED_NOTE_IP \
|
|
({SCHED_NOTE_LABEL: (uintptr_t)&&SCHED_NOTE_LABEL;})
|
|
# define SCHED_NOTE_STRING(buf) \
|
|
sched_note_string(SCHED_NOTE_IP, buf)
|
|
# define SCHED_NOTE_DUMP(event, buf, len) \
|
|
sched_note_dump(SCHED_NOTE_IP, event, buf, len)
|
|
# define SCHED_NOTE_VPRINTF(fmt, va) \
|
|
sched_note_vprintf(SCHED_NOTE_IP, fmt, va)
|
|
# define SCHED_NOTE_VBPRINTF(event, fmt, va) \
|
|
sched_note_vbprintf(SCHED_NOTE_IP, event, fmt, va)
|
|
# define SCHED_NOTE_PRINTF(fmt, args...) \
|
|
sched_note_printf(SCHED_NOTE_IP, fmt, ##args)
|
|
# define SCHED_NOTE_BPRINTF(event, fmt, args...) \
|
|
sched_note_bprintf(SCHED_NOTE_IP, event, fmt, ##args)
|
|
# define SCHED_NOTE_BEGIN() \
|
|
sched_note_begin(SCHED_NOTE_IP, __FUNCTION__)
|
|
# define SCHED_NOTE_END() \
|
|
sched_note_end(SCHED_NOTE_IP, __FUNCTION__)
|
|
#else
|
|
# define SCHED_NOTE_STRING(buf)
|
|
# define SCHED_NOTE_DUMP(event, buf, len)
|
|
# define SCHED_NOTE_VPRINTF(fmt, va)
|
|
# define SCHED_NOTE_VBPRINTF(event, fmt, va)
|
|
# define SCHED_NOTE_PRINTF(fmt, args...)
|
|
# define SCHED_NOTE_BPRINTF(event, fmt, args...)
|
|
# define SCHED_NOTE_BEGIN()
|
|
# define SCHED_NOTE_END()
|
|
#endif
|
|
|
|
/****************************************************************************
|
|
* Public Types
|
|
****************************************************************************/
|
|
|
|
/* This type identifies a note structure */
|
|
|
|
enum note_type_e
|
|
{
|
|
NOTE_START = 0,
|
|
NOTE_STOP = 1
|
|
#ifdef CONFIG_SCHED_INSTRUMENTATION_SWITCH
|
|
,
|
|
NOTE_SUSPEND = 2,
|
|
NOTE_RESUME = 3
|
|
#endif
|
|
#ifdef CONFIG_SMP
|
|
,
|
|
NOTE_CPU_START = 4,
|
|
NOTE_CPU_STARTED = 5
|
|
#ifdef CONFIG_SCHED_INSTRUMENTATION_SWITCH
|
|
,
|
|
NOTE_CPU_PAUSE = 6,
|
|
NOTE_CPU_PAUSED = 7,
|
|
NOTE_CPU_RESUME = 8,
|
|
NOTE_CPU_RESUMED = 9
|
|
#endif
|
|
#endif
|
|
#ifdef CONFIG_SCHED_INSTRUMENTATION_PREEMPTION
|
|
,
|
|
NOTE_PREEMPT_LOCK = 10,
|
|
NOTE_PREEMPT_UNLOCK = 11
|
|
#endif
|
|
#ifdef CONFIG_SCHED_INSTRUMENTATION_CSECTION
|
|
,
|
|
NOTE_CSECTION_ENTER = 12,
|
|
NOTE_CSECTION_LEAVE = 13
|
|
#endif
|
|
#ifdef CONFIG_SCHED_INSTRUMENTATION_SPINLOCKS
|
|
,
|
|
NOTE_SPINLOCK_LOCK = 14,
|
|
NOTE_SPINLOCK_LOCKED = 15,
|
|
NOTE_SPINLOCK_UNLOCK = 16,
|
|
NOTE_SPINLOCK_ABORT = 17
|
|
#endif
|
|
#ifdef CONFIG_SCHED_INSTRUMENTATION_SYSCALL
|
|
,
|
|
NOTE_SYSCALL_ENTER = 18,
|
|
NOTE_SYSCALL_LEAVE = 19
|
|
#endif
|
|
#ifdef CONFIG_SCHED_INSTRUMENTATION_IRQHANDLER
|
|
,
|
|
NOTE_IRQ_ENTER = 20,
|
|
NOTE_IRQ_LEAVE = 21
|
|
#endif
|
|
#ifdef CONFIG_SCHED_INSTRUMENTATION_DUMP
|
|
,
|
|
NOTE_DUMP_STRING = 22,
|
|
NOTE_DUMP_BINARY = 23
|
|
#endif
|
|
};
|
|
|
|
/* This structure provides the common header of each note */
|
|
|
|
struct note_common_s
|
|
{
|
|
uint8_t nc_length; /* Length of the note */
|
|
uint8_t nc_type; /* See enum note_type_e */
|
|
uint8_t nc_priority; /* Thread/task priority */
|
|
#ifdef CONFIG_SMP
|
|
uint8_t nc_cpu; /* CPU thread/task running on */
|
|
#endif
|
|
uint8_t nc_pid[sizeof(pid_t)]; /* ID of the thread/task */
|
|
|
|
#ifdef CONFIG_SCHED_INSTRUMENTATION_HIRES
|
|
uint8_t nc_systime_sec[sizeof(time_t)]; /* Time when note was buffered (sec) */
|
|
uint8_t nc_systime_nsec[sizeof(long)]; /* Time when note was buffered (nsec) */
|
|
#else
|
|
uint8_t nc_systime[sizeof(clock_t)]; /* Time when note was buffered */
|
|
#endif
|
|
};
|
|
|
|
/* This is the specific form of the NOTE_START note */
|
|
|
|
struct note_start_s
|
|
{
|
|
struct note_common_s nst_cmn; /* Common note parameters */
|
|
#if CONFIG_TASK_NAME_SIZE > 0
|
|
char nst_name[1]; /* Start of the name of the thread/task */
|
|
#endif
|
|
};
|
|
|
|
/* This is the specific form of the NOTE_STOP note */
|
|
|
|
struct note_stop_s
|
|
{
|
|
struct note_common_s nsp_cmn; /* Common note parameters */
|
|
};
|
|
|
|
#ifdef CONFIG_SCHED_INSTRUMENTATION_SWITCH
|
|
/* This is the specific form of the NOTE_SUSPEND note */
|
|
|
|
struct note_suspend_s
|
|
{
|
|
struct note_common_s nsu_cmn; /* Common note parameters */
|
|
uint8_t nsu_state; /* Task state */
|
|
};
|
|
|
|
/* This is the specific form of the NOTE_RESUME note */
|
|
|
|
struct note_resume_s
|
|
{
|
|
struct note_common_s nre_cmn; /* Common note parameters */
|
|
};
|
|
#endif
|
|
|
|
#ifdef CONFIG_SMP
|
|
|
|
/* This is the specific form of the NOTE_CPU_START note */
|
|
|
|
struct note_cpu_start_s
|
|
{
|
|
struct note_common_s ncs_cmn; /* Common note parameters */
|
|
uint8_t ncs_target; /* CPU being started */
|
|
};
|
|
|
|
/* This is the specific form of the NOTE_CPU_STARTED note */
|
|
|
|
struct note_cpu_started_s
|
|
{
|
|
struct note_common_s ncs_cmn; /* Common note parameters */
|
|
};
|
|
|
|
#ifdef CONFIG_SCHED_INSTRUMENTATION_SWITCH
|
|
/* This is the specific form of the NOTE_CPU_PAUSE note */
|
|
|
|
struct note_cpu_pause_s
|
|
{
|
|
struct note_common_s ncp_cmn; /* Common note parameters */
|
|
uint8_t ncp_target; /* CPU being paused */
|
|
};
|
|
|
|
/* This is the specific form of the NOTE_CPU_PAUSED note */
|
|
|
|
struct note_cpu_paused_s
|
|
{
|
|
struct note_common_s ncp_cmn; /* Common note parameters */
|
|
};
|
|
|
|
/* This is the specific form of the NOTE_CPU_RESUME note */
|
|
|
|
struct note_cpu_resume_s
|
|
{
|
|
struct note_common_s ncr_cmn; /* Common note parameters */
|
|
uint8_t ncr_target; /* CPU being resumed */
|
|
};
|
|
|
|
/* This is the specific form of the NOTE_CPU_RESUMED note */
|
|
|
|
struct note_cpu_resumed_s
|
|
{
|
|
struct note_common_s ncr_cmn; /* Common note parameters */
|
|
};
|
|
#endif
|
|
#endif
|
|
|
|
#ifdef CONFIG_SCHED_INSTRUMENTATION_PREEMPTION
|
|
/* This is the specific form of the NOTE_PREEMPT_LOCK/UNLOCK note */
|
|
|
|
struct note_preempt_s
|
|
{
|
|
struct note_common_s npr_cmn; /* Common note parameters */
|
|
uint8_t npr_count[2]; /* Count of nested locks */
|
|
};
|
|
#endif /* CONFIG_SCHED_INSTRUMENTATION_PREEMPTION */
|
|
|
|
#ifdef CONFIG_SCHED_INSTRUMENTATION_CSECTION
|
|
/* This is the specific form of the NOTE_CSECTION_ENTER/LEAVE note */
|
|
|
|
struct note_csection_s
|
|
{
|
|
struct note_common_s ncs_cmn; /* Common note parameters */
|
|
#ifdef CONFIG_SMP
|
|
uint8_t ncs_count[2]; /* Count of nested csections */
|
|
#endif
|
|
};
|
|
#endif /* CONFIG_SCHED_INSTRUMENTATION_CSECTION */
|
|
|
|
#ifdef CONFIG_SCHED_INSTRUMENTATION_SPINLOCKS
|
|
/* This is the specific form of the NOTE_SPINLOCK_LOCK/LOCKED/UNLOCK/ABORT
|
|
* note.
|
|
*/
|
|
|
|
struct note_spinlock_s
|
|
{
|
|
struct note_common_s nsp_cmn; /* Common note parameters */
|
|
uint8_t nsp_spinlock[sizeof(uintptr_t)]; /* Address of spinlock */
|
|
uint8_t nsp_value; /* Value of spinlock */
|
|
};
|
|
#endif /* CONFIG_SCHED_INSTRUMENTATION_SPINLOCKS */
|
|
|
|
#ifdef CONFIG_SCHED_INSTRUMENTATION_SYSCALL
|
|
/* This is the specific form of the NOTE_SYSCALL_ENTER/LEAVE notes */
|
|
|
|
#define MAX_SYSCALL_ARGS 6
|
|
#define SIZEOF_NOTE_SYSCALL_ENTER(n) (sizeof(struct note_common_s) + \
|
|
sizeof(uint8_t) + sizeof(uint8_t) + \
|
|
(sizeof(uintptr_t) * (n)))
|
|
|
|
struct note_syscall_enter_s
|
|
{
|
|
struct note_common_s nsc_cmn; /* Common note parameters */
|
|
uint8_t nsc_nr; /* System call number */
|
|
uint8_t nsc_argc; /* Number of system call arguments */
|
|
uint8_t nsc_args[sizeof(uintptr_t) * MAX_SYSCALL_ARGS]; /* System call arguments */
|
|
};
|
|
|
|
struct note_syscall_leave_s
|
|
{
|
|
struct note_common_s nsc_cmn; /* Common note parameters */
|
|
uint8_t nsc_nr; /* System call number */
|
|
uint8_t nsc_result[sizeof(uintptr_t)]; /* Result of the system call */
|
|
};
|
|
#endif /* CONFIG_SCHED_INSTRUMENTATION_SYSCALL */
|
|
|
|
#ifdef CONFIG_SCHED_INSTRUMENTATION_IRQHANDLER
|
|
/* This is the specific form of the NOTE_IRQ_ENTER/LEAVE notes */
|
|
|
|
struct note_irqhandler_s
|
|
{
|
|
struct note_common_s nih_cmn; /* Common note parameters */
|
|
uint8_t nih_irq; /* IRQ number */
|
|
};
|
|
#endif /* CONFIG_SCHED_INSTRUMENTATION_IRQHANDLER */
|
|
|
|
#ifdef CONFIG_SCHED_INSTRUMENTATION_DUMP
|
|
struct note_string_s
|
|
{
|
|
struct note_common_s nst_cmn; /* Common note parameters */
|
|
uint8_t nst_ip[sizeof(uintptr_t)]; /* Instruction pointer called from */
|
|
char nst_data[1]; /* String data terminated by '\0' */
|
|
};
|
|
|
|
#define SIZEOF_NOTE_STRING(n) (sizeof(struct note_string_s) + \
|
|
(n) * sizeof(char))
|
|
|
|
struct note_binary_s
|
|
{
|
|
struct note_common_s nbi_cmn; /* Common note parameters */
|
|
uint8_t nbi_ip[sizeof(uintptr_t)]; /* Instruction pointer called from */
|
|
uint8_t nbi_event; /* Event number */
|
|
uint8_t nbi_data[1]; /* Binary data */
|
|
};
|
|
|
|
#define SIZEOF_NOTE_BINARY(n) (sizeof(struct note_binary_s) + \
|
|
((n) - 1) * sizeof(uint8_t))
|
|
|
|
#endif /* CONFIG_SCHED_INSTRUMENTATION_DUMP */
|
|
|
|
#ifdef CONFIG_SCHED_INSTRUMENTATION_FILTER
|
|
|
|
/* This is the type of the argument passed to the NOTECTL_GETMODE and
|
|
* NOTECTL_SETMODE ioctls
|
|
*/
|
|
|
|
struct note_filter_mode_s
|
|
{
|
|
unsigned int flag; /* Filter mode flag */
|
|
#ifdef CONFIG_SMP
|
|
unsigned int cpuset; /* The set of monitored CPUs */
|
|
#endif
|
|
};
|
|
|
|
/* This is the type of the argument passed to the NOTECTL_GETSYSCALLFILTER
|
|
* and NOTECTL_SETSYSCALLFILTER ioctls
|
|
*/
|
|
|
|
#ifdef CONFIG_SCHED_INSTRUMENTATION_SYSCALL
|
|
struct note_filter_syscall_s
|
|
{
|
|
uint8_t syscall_mask[(SYS_nsyscalls + 7) / 8];
|
|
};
|
|
#endif
|
|
|
|
/* This is the type of the argument passed to the NOTECTL_GETIRQFILTER and
|
|
* NOTECTL_SETIRQFILTER ioctls
|
|
*/
|
|
|
|
#ifdef CONFIG_SCHED_INSTRUMENTATION_IRQHANDLER
|
|
struct note_filter_irq_s
|
|
{
|
|
uint8_t irq_mask[(NR_IRQS + 7) / 8];
|
|
};
|
|
#endif
|
|
|
|
#endif /* CONFIG_SCHED_INSTRUMENTATION_FILTER */
|
|
|
|
/****************************************************************************
|
|
* Public Function Prototypes
|
|
****************************************************************************/
|
|
|
|
#undef EXTERN
|
|
#if defined(__cplusplus)
|
|
#define EXTERN extern "C"
|
|
extern "C"
|
|
{
|
|
#else
|
|
#define EXTERN extern
|
|
#endif
|
|
|
|
/****************************************************************************
|
|
* Name: sched_note_*
|
|
*
|
|
* Description:
|
|
* If instrumentation of the scheduler is enabled, then some outboard
|
|
* logic must provide the following interfaces. These interfaces are not
|
|
* available to application code.
|
|
*
|
|
* Input Parameters:
|
|
* tcb - The TCB of the thread.
|
|
*
|
|
* Returned Value:
|
|
* None
|
|
*
|
|
****************************************************************************/
|
|
|
|
void sched_note_start(FAR struct tcb_s *tcb);
|
|
void sched_note_stop(FAR struct tcb_s *tcb);
|
|
|
|
#ifdef CONFIG_SCHED_INSTRUMENTATION_SWITCH
|
|
void sched_note_suspend(FAR struct tcb_s *tcb);
|
|
void sched_note_resume(FAR struct tcb_s *tcb);
|
|
#else
|
|
# define sched_note_suspend(t)
|
|
# define sched_note_resume(t)
|
|
#endif
|
|
|
|
#ifdef CONFIG_SMP
|
|
void sched_note_cpu_start(FAR struct tcb_s *tcb, int cpu);
|
|
void sched_note_cpu_started(FAR struct tcb_s *tcb);
|
|
#ifdef CONFIG_SCHED_INSTRUMENTATION_SWITCH
|
|
void sched_note_cpu_pause(FAR struct tcb_s *tcb, int cpu);
|
|
void sched_note_cpu_paused(FAR struct tcb_s *tcb);
|
|
void sched_note_cpu_resume(FAR struct tcb_s *tcb, int cpu);
|
|
void sched_note_cpu_resumed(FAR struct tcb_s *tcb);
|
|
#else
|
|
# define sched_note_cpu_pause(t,c)
|
|
# define sched_note_cpu_paused(t)
|
|
# define sched_note_cpu_resume(t,c)
|
|
# define sched_note_cpu_resumed(t)
|
|
#endif
|
|
#else
|
|
# define sched_note_cpu_pause(t,c)
|
|
# define sched_note_cpu_paused(t)
|
|
# define sched_note_cpu_resume(t,c)
|
|
# define sched_note_cpu_resumed(t)
|
|
# define sched_note_cpu_start(t,c)
|
|
# define sched_note_cpu_started(t)
|
|
#endif
|
|
|
|
#ifdef CONFIG_SCHED_INSTRUMENTATION_PREEMPTION
|
|
void sched_note_premption(FAR struct tcb_s *tcb, bool locked);
|
|
#else
|
|
# define sched_note_premption(t,l)
|
|
#endif
|
|
|
|
#ifdef CONFIG_SCHED_INSTRUMENTATION_CSECTION
|
|
void sched_note_csection(FAR struct tcb_s *tcb, bool enter);
|
|
#else
|
|
# define sched_note_csection(t,e)
|
|
#endif
|
|
|
|
#ifdef CONFIG_SCHED_INSTRUMENTATION_SPINLOCKS
|
|
void sched_note_spinlock(FAR struct tcb_s *tcb,
|
|
FAR volatile void *spinlock);
|
|
void sched_note_spinlocked(FAR struct tcb_s *tcb,
|
|
FAR volatile void *spinlock);
|
|
void sched_note_spinunlock(FAR struct tcb_s *tcb,
|
|
FAR volatile void *spinlock);
|
|
void sched_note_spinabort(FAR struct tcb_s *tcb,
|
|
FAR volatile void *spinlock);
|
|
#else
|
|
# define sched_note_spinlock(t,s)
|
|
# define sched_note_spinlocked(t,s)
|
|
# define sched_note_spinunlock(t,s)
|
|
# define sched_note_spinabort(t,s)
|
|
#endif
|
|
|
|
#ifdef CONFIG_SCHED_INSTRUMENTATION_SYSCALL
|
|
void sched_note_syscall_enter(int nr, int argc, ...);
|
|
void sched_note_syscall_leave(int nr, uintptr_t result);
|
|
#else
|
|
# define sched_note_syscall_enter(n,a...)
|
|
# define sched_note_syscall_leave(n,r)
|
|
#endif
|
|
|
|
#ifdef CONFIG_SCHED_INSTRUMENTATION_IRQHANDLER
|
|
void sched_note_irqhandler(int irq, FAR void *handler, bool enter);
|
|
#else
|
|
# define sched_note_irqhandler(i,h,e)
|
|
#endif
|
|
|
|
#ifdef CONFIG_SCHED_INSTRUMENTATION_DUMP
|
|
|
|
void sched_note_string(uintptr_t ip, FAR const char *buf);
|
|
void sched_note_dump(uintptr_t ip, uint8_t event,
|
|
FAR const void *buf, size_t len);
|
|
void sched_note_vprintf(uintptr_t ip, FAR const char *fmt,
|
|
va_list va) printflike(2, 0);
|
|
void sched_note_vbprintf(uintptr_t ip, uint8_t event,
|
|
FAR const char *fmt, va_list va) printflike(3, 0);
|
|
void sched_note_printf(uintptr_t ip,
|
|
FAR const char *fmt, ...) printflike(2, 3);
|
|
void sched_note_bprintf(uintptr_t ip, uint8_t event,
|
|
FAR const char *fmt, ...) printflike(3, 4);
|
|
void sched_note_begin(uintptr_t ip, FAR const char *buf);
|
|
void sched_note_end(uintptr_t ip, FAR const char *buf);
|
|
#else
|
|
# define sched_note_string(ip,b)
|
|
# define sched_note_dump(ip,e,b,l)
|
|
# define sched_note_vprintf(ip,f,v)
|
|
# define sched_note_vbprintf(ip,e,f,v)
|
|
# define sched_note_printf(ip,f...)
|
|
# define sched_note_bprintf(ip,e,f...)
|
|
# define sched_note_begin(ip,f...)
|
|
# define sched_note_end(ip,f...)
|
|
#endif /* CONFIG_SCHED_INSTRUMENTATION_DUMP */
|
|
|
|
#if defined(__KERNEL__) || defined(CONFIG_BUILD_FLAT)
|
|
|
|
/****************************************************************************
|
|
* Name: sched_note_add
|
|
*
|
|
* Description:
|
|
* Add the variable length note to the transport layer
|
|
*
|
|
* Input Parameters:
|
|
* note - The note buffer
|
|
* notelen - The buffer length
|
|
*
|
|
* Returned Value:
|
|
* None
|
|
*
|
|
* Assumptions:
|
|
* We are within a critical section.
|
|
*
|
|
****************************************************************************/
|
|
|
|
void sched_note_add(FAR const void *note, size_t notelen);
|
|
|
|
/****************************************************************************
|
|
* Name: sched_note_filter_mode
|
|
*
|
|
* Description:
|
|
* Set and get note filter mode.
|
|
* (Same as NOTECTL_GETMODE / NOTECTL_SETMODE ioctls)
|
|
*
|
|
* Input Parameters:
|
|
* oldm - A writable pointer to struct note_filter_mode_s to get current
|
|
* filter mode
|
|
* If 0, no data is written.
|
|
* newm - A read-only pointer to struct note_filter_mode_s which holds the
|
|
* new filter mode
|
|
* If 0, the filter mode is not updated.
|
|
*
|
|
* Returned Value:
|
|
* None
|
|
*
|
|
****************************************************************************/
|
|
|
|
#ifdef CONFIG_SCHED_INSTRUMENTATION_FILTER
|
|
void sched_note_filter_mode(struct note_filter_mode_s *oldm,
|
|
struct note_filter_mode_s *newm);
|
|
#endif
|
|
|
|
/****************************************************************************
|
|
* Name: sched_note_filter_syscall
|
|
*
|
|
* Description:
|
|
* Set and get syscall filter setting
|
|
* (Same as NOTECTL_GETSYSCALLFILTER / NOTECTL_SETSYSCALLFILTER ioctls)
|
|
*
|
|
* Input Parameters:
|
|
* oldf - A writable pointer to struct note_filter_syscall_s to get
|
|
* current syscall filter setting
|
|
* If 0, no data is written.
|
|
* newf - A read-only pointer to struct note_filter_syscall_s of the
|
|
* new syscall filter setting
|
|
* If 0, the setting is not updated.
|
|
*
|
|
* Returned Value:
|
|
* None
|
|
*
|
|
****************************************************************************/
|
|
|
|
#if defined(CONFIG_SCHED_INSTRUMENTATION_FILTER) && \
|
|
defined(CONFIG_SCHED_INSTRUMENTATION_SYSCALL)
|
|
void sched_note_filter_syscall(struct note_filter_syscall_s *oldf,
|
|
struct note_filter_syscall_s *newf);
|
|
#endif
|
|
|
|
/****************************************************************************
|
|
* Name: sched_note_filter_irq
|
|
*
|
|
* Description:
|
|
* Set and get IRQ filter setting
|
|
* (Same as NOTECTL_GETIRQFILTER / NOTECTL_SETIRQFILTER ioctls)
|
|
*
|
|
* Input Parameters:
|
|
* oldf - A writable pointer to struct note_filter_irq_s to get
|
|
* current IRQ filter setting
|
|
* If 0, no data is written.
|
|
* newf - A read-only pointer to struct note_filter_irq_s of the new
|
|
* IRQ filter setting
|
|
* If 0, the setting is not updated.
|
|
*
|
|
* Returned Value:
|
|
* None
|
|
*
|
|
****************************************************************************/
|
|
|
|
#if defined(CONFIG_SCHED_INSTRUMENTATION_FILTER) && \
|
|
defined(CONFIG_SCHED_INSTRUMENTATION_IRQHANDLER)
|
|
void sched_note_filter_irq(struct note_filter_irq_s *oldf,
|
|
struct note_filter_irq_s *newf);
|
|
#endif
|
|
|
|
#endif /* defined(__KERNEL__) || defined(CONFIG_BUILD_FLAT) */
|
|
|
|
#undef EXTERN
|
|
#if defined(__cplusplus)
|
|
}
|
|
#endif
|
|
|
|
#else /* CONFIG_SCHED_INSTRUMENTATION */
|
|
|
|
# define SCHED_NOTE_STRING(buf)
|
|
# define SCHED_NOTE_DUMP(event, buf, len)
|
|
# define SCHED_NOTE_VPRINTF(fmt, va)
|
|
# define SCHED_NOTE_VBPRINTF(event, fmt, va)
|
|
# define SCHED_NOTE_PRINTF(fmt, args...)
|
|
# define SCHED_NOTE_BPRINTF(event, fmt, args...)
|
|
# define SCHED_NOTE_BEGIN()
|
|
# define SCHED_NOTE_END()
|
|
|
|
# define sched_note_start(t)
|
|
# define sched_note_stop(t)
|
|
# define sched_note_suspend(t)
|
|
# define sched_note_resume(t)
|
|
# define sched_note_cpu_start(t,c)
|
|
# define sched_note_cpu_started(t)
|
|
# define sched_note_cpu_pause(t,c)
|
|
# define sched_note_cpu_paused(t)
|
|
# define sched_note_cpu_resume(t,c)
|
|
# define sched_note_cpu_resumed(t)
|
|
# define sched_note_premption(t,l)
|
|
# define sched_note_csection(t,e)
|
|
# define sched_note_spinlock(t,s)
|
|
# define sched_note_spinlocked(t,s)
|
|
# define sched_note_spinunlock(t,s)
|
|
# define sched_note_spinabort(t,s)
|
|
# define sched_note_syscall_enter(n,a...)
|
|
# define sched_note_syscall_leave(n,r)
|
|
# define sched_note_irqhandler(i,h,e)
|
|
# define sched_note_string(ip,b)
|
|
# define sched_note_dump(ip,e,b,l)
|
|
# define sched_note_vprintf(ip,f,v)
|
|
# define sched_note_vbprintf(ip,e,f,v)
|
|
# define sched_note_printf(ip,f...)
|
|
# define sched_note_bprintf(ip,e,f...)
|
|
# define sched_note_begin(ip,f...)
|
|
# define sched_note_end(ip,f...)
|
|
|
|
#endif /* CONFIG_SCHED_INSTRUMENTATION */
|
|
#endif /* __INCLUDE_NUTTX_SCHED_NOTE_H */
|