services/tracing/index.html · services/tracing/index.rst 공식 원문 ↗

Zephyr 3.7.0 · Services · Observability

Tracing

Kernel과 application의 시간축 event를 target에서 수집해 host 분석 도구로 복원합니다.

Official pathservices/tracing/index.html
Source fileservices/tracing/index.rst
Source versionZephyr 3.7.0
TranslationFull · reviewed

본문 기준: Zephyr 3.7.0 LTS3 · 이후 유지보수 패치는 별도입니다.

Part 1

요약·해설

Format top layer와 transport bottom layer, CTF workflow, SystemView post-mortem, RAM dump, atomicity·buffering 설계와 kernel object hook을 설명합니다.

Formats

CTF · SystemView · custom

Backends

UART · USB · file · RTT · RAM

Hooks

229 kernel symbols

Part 2

접을 수 있는 영어 원문 전체

영어 원문 전체 펼치기
원문 SHA-256 5BE848271A001C1F27D61E2A45DBB95A09B58B8470DBF702F363307138F5301F
.. _tracing:

Tracing
#######

Overview
********

The tracing feature provides hooks that permits you to collect data from
your application and allows tools running on a host to visualize the inner-working of
the kernel and various subsystems.

Every system has application-specific events to trace out.  Historically,
that has implied:

1. Determining the application-specific payload,
2. Choosing suitable serialization-format,
3. Writing the on-target serialization code,
4. Deciding on and writing the I/O transport mechanics,
5. Writing the PC-side deserializer/parser,
6. Writing custom ad-hoc tools for filtering and presentation.

An application can use one of the existing formats or define a custom format by
overriding the macros declared in :zephyr_file:`include/zephyr/tracing/tracing.h`.

Different formats, transports and host tools are available and supported in
Zephyr.

In fact, I/O varies greatly from system to system.  Therefore, it is
instructive to create a taxonomy for I/O types when we must ensure the
interface between payload/format (Top Layer) and the transport mechanics
(bottom Layer) is generic and efficient enough to model these. See the
*I/O taxonomy* section below.


Serialization Formats
**********************

.. _ctf:

Common Trace Format (CTF) Support
=================================

Common Trace Format, CTF, is an open format and language to describe trace
formats. This enables tool reuse, of which line-textual (babeltrace) and
graphical (TraceCompass) variants already exist.

CTF should look familiar to C programmers but adds stronger typing.
See `CTF - A Flexible, High-performance Binary Trace Format
<http://diamon.org/ctf/>`_.


CTF allows us to formally describe application specific payload and the
serialization format, which enables common infrastructure for host tools
and parsers and tools for filtering and presentation.


A Generic Interface
--------------------

In CTF, an event is serialized to a packet containing one or more fields.
As seen from *I/O taxonomy* section below, a bottom layer may:

- perform actions at transaction-start (e.g. mutex-lock),
- process each field in some way (e.g. sync-push emit, concat, enqueue to
  thread-bound FIFO),
- perform actions at transaction-stop (e.g. mutex-release, emit of concat
  buffer).

CTF Top-Layer Example
----------------------

The CTF_EVENT macro will serialize each argument to a field::

  /* Example for illustration */
  static inline void ctf_top_foo(uint32_t thread_id, ctf_bounded_string_t name)
  {
    CTF_EVENT(
      CTF_LITERAL(uint8_t, 42),
      thread_id,
      name,
      "hello, I was emitted from function: ",
      __func__  /* __func__ is standard since C99 */
    );
  }

How to serialize and emit fields as well as handling alignment, can be done
internally and statically at compile-time in the bottom-layer.


The CTF top layer is enabled using the configuration option
:kconfig:option:`CONFIG_TRACING_CTF` and can be used with the different transport
backends both in synchronous and asynchronous modes.


SEGGER SystemView Support
=========================

Zephyr provides built-in support for `SEGGER SystemView`_ that can be enabled in
any application for platforms that have the required hardware support.

The payload and format used with SystemView is custom to the application and
relies on RTT as a transport. Newer versions of SystemView support other
transports, for example UART or using snapshot mode (both still not
supported in Zephyr).

To enable tracing support with `SEGGER SystemView`_ add the configuration option
:kconfig:option:`CONFIG_SEGGER_SYSTEMVIEW` to your project configuration file and set
it to *y*. For example, this can be added to the
:zephyr:code-sample:`synchronization` sample to visualize fast switching between threads.
SystemView can also be used for post-mortem tracing, which can be enabled with
`CONFIG_SEGGER_SYSVIEW_POST_MORTEM_MODE`. In this mode, a debugger can
be attached after the system has crashed using ``west attach`` after which the
latest data from the internal RAM buffer can be loaded into SystemView::

    CONFIG_STDOUT_CONSOLE=y
    # enable to use thread names
    CONFIG_THREAD_NAME=y
    CONFIG_SEGGER_SYSTEMVIEW=y
    CONFIG_USE_SEGGER_RTT=y
    CONFIG_TRACING=y
    # enable for post-mortem tracing
    CONFIG_SEGGER_SYSVIEW_POST_MORTEM_MODE=n


.. figure:: ../../../../services/tracing/segger_systemview.png
    :align: center
    :alt: SEGGER SystemView
    :figclass: align-center
    :width: 80%

.. _SEGGER SystemView: https://www.segger.com/products/development-tools/systemview/


Recent versions of `SEGGER SystemView`_ come with an API translation table for
Zephyr which is incomplete and does not match the current level of support
available in Zephyr. To use the latest Zephyr API description table, copy the
file available in the tree to your local configuration directory to override the
builtin table::

        # On Linux and MacOS
        cp $ZEPHYR_BASE/subsys/tracing/sysview/SYSVIEW_Zephyr.txt ~/.config/SEGGER/

User-Defined Tracing
====================

This tracing format allows the user to define functions to perform any work desired
when a task is switched in or out, when an interrupt is entered or exited, and when the cpu
is idle.

Examples include:
- simple toggling of GPIO for external scope tracing while minimizing extra cpu load
- generating/outputting trace data in a non-standard or proprietary format that can
not be supported by the other tracing systems

The following functions can be defined by the user:

.. code-block:: c

   void sys_trace_thread_create_user(struct k_thread *thread);
   void sys_trace_thread_abort_user(struct k_thread *thread);
   void sys_trace_thread_suspend_user(struct k_thread *thread);
   void sys_trace_thread_resume_user(struct k_thread *thread);
   void sys_trace_thread_name_set_user(struct k_thread *thread);
   void sys_trace_thread_switched_in_user(struct k_thread *thread);
   void sys_trace_thread_switched_out_user(struct k_thread *thread);
   void sys_trace_thread_info_user(struct k_thread *thread);
   void sys_trace_thread_sched_ready_user(struct k_thread *thread);
   void sys_trace_thread_pend_user(struct k_thread *thread);
   void sys_trace_thread_priority_set_user(struct k_thread *thread, int prio);
   void sys_trace_isr_enter_user(int nested_interrupts);
   void sys_trace_isr_exit_user(int nested_interrupts);
   void sys_trace_idle_user();

Enable this format with the :kconfig:option:`CONFIG_TRACING_USER` option.

Transport Backends
******************

The following backends are currently supported:

* UART
* USB
* File (Using the native port with POSIX architecture based targets)
* RTT (With SystemView)
* RAM (buffer to be retrieved by a debugger)

Using Tracing
*************

The sample :zephyr_file:`samples/subsys/tracing` demonstrates tracing with
different formats and backends.

To get started, the simplest way is to use the CTF format with the :ref:`native_sim <native_sim>`
port, build the sample as follows:

.. zephyr-app-commands::
   :tool: all
   :app: samples/subsys/tracing
   :board: native_sim
   :gen-args: -DCONF_FILE=prj_native_ctf.conf
   :goals: build

You can then run the resulting binary with the option ``-trace-file`` to generate
the tracing data::

    mkdir data
    cp $ZEPHYR_BASE/subsys/tracing/ctf/tsdl/metadata data/
    ./build/zephyr/zephyr.exe -trace-file=data/channel0_0

The resulting CTF output can be visualized using babeltrace or TraceCompass
by pointing the tool to the ``data`` directory with the metadata and trace files.

Using RAM backend
=================

For devices that do not have available I/O for tracing such as USB or UART but have
enough RAM to collect trace data, the ram backend can be enabled with configuration
:kconfig:option:`CONFIG_TRACING_BACKEND_RAM`.
Adjust :kconfig:option:`CONFIG_RAM_TRACING_BUFFER_SIZE` to be able to record enough traces for your needs.
Then thanks to a runtime debugger such as gdb this buffer can be fetched from the target
to an host computer::

    (gdb) dump binary memory data/channel0_0 <ram_tracing_start> <ram_tracing_end>

The resulting channel0_0 file have to be placed in a directory with the ``metadata``
file like the other backend.

Visualisation Tools
*******************

TraceCompass
=============

TraceCompass is an open source tool that visualizes CTF events such as thread
scheduling and interrupts, and is helpful to find unintended interactions and
resource conflicts on complex systems.

See also the presentation by Ericsson,
`Advanced Trouble-shooting Of Real-time Systems
<https://wiki.eclipse.org/images/0/0e/TechTalkOnlineDemoFeb2017_v1.pdf>`_.



Future LTTng Inspiration
************************

Currently, the top-layer provided here is quite simple and bare-bones,
and needlessly copied from Zephyr's Segger SystemView debug module.

For an OS like Zephyr, it would make sense to draw inspiration from
Linux's LTTng and change the top-layer to serialize to the same format.
Doing this would enable direct reuse of TraceCompass' canned analyses
for Linux.  Alternatively, LTTng-analyses in TraceCompass could be
customized to Zephyr.  It is ongoing work to enable TraceCompass
visibility of Zephyr in a target-agnostic and open source way.


I/O Taxonomy
=============

- Atomic Push/Produce/Write/Enqueue:

  - synchronous:
                  means data-transmission has completed with the return of the
                  call.

  - asynchronous:
                  means data-transmission is pending or ongoing with the return
                  of the call. Usually, interrupts/callbacks/signals or polling
                  is used to determine completion.

  - buffered:
                  means data-transmissions are copied and grouped together to
                  form a larger ones. Usually for amortizing overhead (burst
                  dequeue) or jitter-mitigation (steady dequeue).

  Examples:
    - sync  unbuffered
        E.g. PIO via GPIOs having steady stream, no extra FIFO memory needed.
        Low jitter but may be less efficient (can't amortize the overhead of
        writing).

    - sync  buffered
        E.g. ``fwrite()`` or enqueuing into FIFO.
        Blockingly burst the FIFO when its buffer-waterlevel exceeds threshold.
        Jitter due to bursts may lead to missed deadlines.

    - async unbuffered
        E.g. DMA, or zero-copying in shared memory.
        Be careful of data hazards, race conditions, etc!

    - async buffered
        E.g. enqueuing into FIFO.



- Atomic Pull/Consume/Read/Dequeue:

  - synchronous:
                  means data-reception has completed with the return of the call.

  - asynchronous:
                  means data-reception is pending or ongoing with the return of
                  the call. Usually, interrupts/callbacks/signals or polling is
                  used to determine completion.

  - buffered:
                  means data is copied-in in larger chunks than request-size.
                  Usually for amortizing wait-time.

  Examples:
    - sync  unbuffered
        E.g. Blocking read-call, ``fread()`` or SPI-read, zero-copying in shared
        memory.

    - sync  buffered
        E.g. Blocking read-call with caching applied.
        Makes sense if read pattern exhibits spatial locality.

    - async unbuffered
        E.g. zero-copying in shared memory.
        Be careful of data hazards, race conditions, etc!

    - async buffered
        E.g. ``aio_read()`` or DMA.



Unfortunately, I/O may not be atomic and may, therefore, require locking.
Locking may not be needed if multiple independent channels are available.

  - The system has non-atomic write and one shared channel
        E.g. UART. Locking required.

        ``lock(); emit(a); emit(b); emit(c); release();``

  - The system has non-atomic write but many channels
        E.g. Multi-UART. Lock-free if the bottom-layer maps each Zephyr
        thread+ISR to its own channel, thus alleviating races as each
        thread is sequentially consistent with itself.

        ``emit(a,thread_id); emit(b,thread_id); emit(c,thread_id);``

  - The system has atomic write     but one shared channel
        E.g. ``native_sim`` or board with DMA. May or may not need locking.

        ``emit(a ## b ## c); /* Concat to buffer */``

        ``lock(); emit(a); emit(b); emit(c); release(); /* No extra mem */``

  - The system has atomic write     and many channels
        E.g. native_sim or board with multi-channel DMA. Lock-free.

        ``emit(a ## b ## c, thread_id);``


Object tracking
***************

The kernel can also maintain lists of objects that can be used to track
their usage. Currently, the following lists can be enabled::

  struct k_timer *_track_list_k_timer;
  struct k_mem_slab *_track_list_k_mem_slab;
  struct k_sem *_track_list_k_sem;
  struct k_mutex *_track_list_k_mutex;
  struct k_stack *_track_list_k_stack;
  struct k_msgq *_track_list_k_msgq;
  struct k_mbox *_track_list_k_mbox;
  struct k_pipe *_track_list_k_pipe;
  struct k_queue *_track_list_k_queue;
  struct k_event *_track_list_k_event;

Those global variables are the head of each list - they can be traversed
with the help of macro ``SYS_PORT_TRACK_NEXT``. For instance, to traverse
all initialized mutexes, one can write::

  struct k_mutex *cur = _track_list_k_mutex;
  while (cur != NULL) {
    /* Do something */

    cur = SYS_PORT_TRACK_NEXT(cur);
  }

To enable object tracking, enable :kconfig:option:`CONFIG_TRACING_OBJECT_TRACKING`.
Note that each list can be enabled or disabled via their tracing
configuration. For example, to disable tracking of semaphores, one can
disable :kconfig:option:`CONFIG_TRACING_SEMAPHORE`.

Object tracking is behind tracing configuration as it currently leverages
tracing infrastructure to perform the tracking.

API
***


Common
======

.. doxygengroup:: subsys_tracing_apis

Threads
=======

.. doxygengroup:: subsys_tracing_apis_thread

Work Queues
===========

.. doxygengroup:: subsys_tracing_apis_work

Poll
====

.. doxygengroup:: subsys_tracing_apis_poll

Semaphore
=========

.. doxygengroup:: subsys_tracing_apis_sem

Mutex
=====

.. doxygengroup:: subsys_tracing_apis_mutex

Condition Variables
===================

.. doxygengroup:: subsys_tracing_apis_condvar

Queues
======

.. doxygengroup:: subsys_tracing_apis_queue

FIFO
====

.. doxygengroup:: subsys_tracing_apis_fifo

LIFO
====
.. doxygengroup:: subsys_tracing_apis_lifo

Stacks
======

.. doxygengroup:: subsys_tracing_apis_stack

Message Queues
==============

.. doxygengroup:: subsys_tracing_apis_msgq

Mailbox
=======

.. doxygengroup:: subsys_tracing_apis_mbox

Pipes
======

.. doxygengroup:: subsys_tracing_apis_pipe

Heaps
=====

.. doxygengroup:: subsys_tracing_apis_heap

Memory Slabs
============

.. doxygengroup:: subsys_tracing_apis_mslab

Timers
======

.. doxygengroup:: subsys_tracing_apis_timer

Object tracking
===============

.. doxygengroup:: subsys_tracing_object_tracking

Syscalls
========

.. doxygengroup:: subsys_tracing_apis_syscall

Part 3

한국어 전문 번역

Overview

Tracing 기능은 application과 kernel subsystem의 내부 동작에서 data를 수집할 hook을 제공합니다. Host에서 실행되는 tool은 이 event를 시간순으로 복원해 thread scheduling, interrupt, synchronization과 resource conflict를 시각화합니다.

Application-specific event를 처음부터 구현하려면 payload 선정, serialization format 선택, target-side serializer, I/O transport, PC-side parser, filtering·presentation tool을 모두 만들어야 했습니다. Zephyr tracing은 이 역할을 format top layer와 transport bottom layer로 나눠 재사용하게 합니다.

Application은 기존 format을 쓰거나 include/zephyr/tracing/tracing.h의 macro를 override해 custom format을 정의할 수 있습니다. Zephyr는 여러 format, transport와 host tool 조합을 지원합니다.

System마다 사용할 수 있는 I/O의 latency, atomicity, buffering과 channel 수가 크게 다릅니다. 그래서 payload/format top layer와 transport bottom layer 사이 interface가 다양한 I/O taxonomy를 효율적으로 표현해야 합니다.

Trace event의 target-to-host pipeline
Kernel · Application hooksthread · ISR · object · user event payload
top layer
Serialization formatCTF · SystemView · custom user format
bottom layer
Transport backendUART · USB · file · RTT · RAM
decode · visualize
Host toolsbabeltrace · TraceCompass · SystemView

Serialization Formats

Common Trace Format (CTF) Support

CTF(Common Trace Format)는 trace schema와 binary layout을 기술하는 공개 format·language입니다. C programmer에게 익숙한 syntax에 더 강한 type을 제공하며, line-oriented babeltrace와 graphical TraceCompass 같은 기존 tool을 재사용할 수 있습니다.

Application-specific payload와 serialization을 formal schema로 정의하므로 host parser, filter와 presentation infrastructure를 event마다 새로 만들 필요가 없습니다.

A Generic Interface

CTF event는 하나 이상의 field가 든 packet으로 serialize됩니다. Bottom layer는 transaction 시작 때 mutex를 lock하고, 각 field를 즉시 push·concat·FIFO enqueue한 뒤, transaction 종료 때 mutex를 release하거나 concat buffer를 emit할 수 있습니다.

CTF Top-Layer Example

CTF_EVENT macro는 각 argument를 field로 serialize합니다. Literal type, thread ID, bounded string, literal string과 C99 __func__를 한 event에 넣는 공식 예제입니다.

/* Example for illustration */
static inline void ctf_top_foo(uint32_t thread_id, ctf_bounded_string_t name)
{
  CTF_EVENT(
    CTF_LITERAL(uint8_t, 42),
    thread_id,
    name,
    "hello, I was emitted from function: ",
    __func__  /* __func__ is standard since C99 */
  );
}

Field emit 방법과 alignment 처리는 bottom layer가 compile time에 정적으로 결정할 수 있습니다. CTF top layer는 CONFIG_TRACING_CTF로 활성화하며 synchronous·asynchronous transport backend와 조합할 수 있습니다.

SEGGER SystemView Support

필요 hardware가 있는 platform에서는 SEGGER SystemView 지원을 application에 켤 수 있습니다. Zephyr 통합은 application-specific payload·format과 RTT transport를 사용합니다. SystemView 자체는 UART와 snapshot도 지원하지만 이 문서 시점의 Zephyr backend는 아직 지원하지 않습니다.

CONFIG_SEGGER_SYSTEMVIEW=y로 켜고, thread name과 RTT를 함께 설정합니다. Post-mortem mode는 crash 뒤 west attach로 debugger를 연결해 RAM buffer의 최신 trace를 SystemView로 가져오게 합니다.

CONFIG_STDOUT_CONSOLE=y
# enable to use thread names
CONFIG_THREAD_NAME=y
CONFIG_SEGGER_SYSTEMVIEW=y
CONFIG_USE_SEGGER_RTT=y
CONFIG_TRACING=y
# enable for post-mortem tracing
CONFIG_SEGGER_SYSVIEW_POST_MORTEM_MODE=n
SEGGER SystemView에서 Zephyr thread switching trace를 표시한 화면
SEGGER SystemView · Zephyr 3.7.0 official documentation asset · SHA-256 64AC29DB2E478EA455FCA83B384BABD1B9D3295B727A541A6DAFC25F52F66783

최근 SystemView 내장 Zephyr API translation table은 불완전하고 현재 Zephyr support와 맞지 않을 수 있습니다. Zephyr tree의 최신 table을 local configuration directory로 복사해 override합니다.

# On Linux and MacOS
cp $ZEPHYR_BASE/subsys/tracing/sysview/SYSVIEW_Zephyr.txt ~/.config/SEGGER/

User-Defined Tracing

User-defined format은 task switch in/out, interrupt enter/exit, CPU idle 같은 지점에서 application이 원하는 작업을 직접 수행하게 합니다. CPU overhead가 작은 GPIO toggle로 oscilloscope trace를 만들거나, standard backend가 지원하지 않는 proprietary binary format을 출력할 수 있습니다.

다음 user function을 정의할 수 있습니다. Thread create·abort·suspend·resume·name·switch·scheduler state와 ISR nesting, idle event를 각각 받습니다.

void sys_trace_thread_create_user(struct k_thread *thread);
void sys_trace_thread_abort_user(struct k_thread *thread);
void sys_trace_thread_suspend_user(struct k_thread *thread);
void sys_trace_thread_resume_user(struct k_thread *thread);
void sys_trace_thread_name_set_user(struct k_thread *thread);
void sys_trace_thread_switched_in_user(struct k_thread *thread);
void sys_trace_thread_switched_out_user(struct k_thread *thread);
void sys_trace_thread_info_user(struct k_thread *thread);
void sys_trace_thread_sched_ready_user(struct k_thread *thread);
void sys_trace_thread_pend_user(struct k_thread *thread);
void sys_trace_thread_priority_set_user(struct k_thread *thread, int prio);
void sys_trace_isr_enter_user(int nested_interrupts);
void sys_trace_isr_exit_user(int nested_interrupts);
void sys_trace_idle_user();

CONFIG_TRACING_USER로 이 format을 활성화합니다.

Transport Backends

지원 backend는 UART, USB, native POSIX target의 file, SystemView용 RTT, debugger로 회수하는 RAM buffer입니다. Format과 transport는 독립 layer이므로 CTF를 file·UART·RAM과 조합하거나 SystemView를 RTT로 사용할 수 있습니다.

Using Tracing

samples/subsys/tracing sample이 여러 format과 backend 조합을 보여 줍니다. 가장 단순한 시작은 native_sim에서 CTF configuration을 build하는 것입니다.

west build -b native_sim samples/subsys/tracing -- -DCONF_FILE=prj_native_ctf.conf
# Use cmake to configure a Ninja-based buildsystem:
cmake -Bbuild -GNinja -DBOARD=native_sim -DCONF_FILE=prj_native_ctf.conf samples/subsys/tracing

# Now run the build tool on the generated build system:
ninja -Cbuild

생성 binary를 -trace-file option으로 실행합니다. CTF metadata와 channel data를 같은 directory에 둡니다.

mkdir data
cp $ZEPHYR_BASE/subsys/tracing/ctf/tsdl/metadata data/
./build/zephyr/zephyr.exe -trace-file=data/channel0_0

data directory를 babeltrace 또는 TraceCompass에 열면 metadata schema에 따라 CTF event를 decode하고 시각화할 수 있습니다.

Using RAM backend

USB·UART처럼 실시간 trace I/O는 없지만 RAM 여유가 있는 device는 CONFIG_TRACING_BACKEND_RAM을 사용합니다. CONFIG_RAM_TRACING_BUFFER_SIZE를 필요한 record window에 맞춰 조정합니다.

Run-time debugger인 GDB로 target의 ram_tracing_start부터 ram_tracing_end까지 binary를 host file로 dump합니다.

(gdb) dump binary memory data/channel0_0 <ram_tracing_start> <ram_tracing_end>

생성한 channel0_0를 CTF metadata와 같은 directory에 두면 다른 backend output과 같은 tool로 분석할 수 있습니다.

Visualisation Tools

TraceCompass

TraceCompass는 thread scheduling과 interrupt 같은 CTF event를 timeline과 analysis view로 보여 주는 open-source tool입니다. 복잡한 real-time system에서 의도하지 않은 interaction, priority inversion 후보와 shared resource conflict를 찾는 데 유용합니다.

Ericsson의 ‘Advanced Trouble-shooting Of Real-time Systems’ 자료는 TraceCompass를 실제 문제 분석에 사용하는 예를 제공합니다.

Future LTTng Inspiration

현재 Zephyr top layer는 단순하며 SEGGER SystemView debug module에서 일부 구조를 복제했습니다. Linux LTTng와 같은 format으로 serialize하면 TraceCompass가 가진 Linux용 canned analysis를 직접 재사용할 수 있습니다.

다른 방법은 TraceCompass의 LTTng analysis를 Zephyr semantics에 맞게 조정하는 것입니다. Target과 vendor에 종속되지 않는 open-source Zephyr visibility를 만드는 작업이 계속 진행 중입니다.

I/O Taxonomy

Atomic push/produce/write/enqueue에서 synchronous는 call이 돌아올 때 transmission이 완료된 상태입니다. Asynchronous는 return 뒤에도 전송이 진행되며 interrupt, callback, signal 또는 polling으로 완료를 확인합니다. Buffered는 작은 전송을 복사·묶어 큰 burst로 만들어 overhead를 나누거나 dequeue jitter를 평탄화합니다.

  • sync unbuffered: GPIO PIO 같은 steady stream. 추가 FIFO가 없고 jitter가 낮지만 write overhead를 묶지 못합니다.
  • sync buffered: fwrite() 또는 FIFO enqueue. Watermark에서 blocking burst가 발생해 deadline jitter가 생길 수 있습니다.
  • async unbuffered: DMA 또는 shared-memory zero-copy. Data hazard와 race를 직접 방어해야 합니다.
  • async buffered: FIFO에 enqueue하고 별도 consumer가 전송합니다.

Atomic pull/consume/read/dequeue도 같은 축을 가집니다. Synchronous는 return 전에 reception 완료, asynchronous는 이후 완료, buffered read는 요청보다 큰 chunk를 미리 읽어 wait overhead를 나눕니다.

  • sync unbuffered: blocking fread(), SPI read, shared-memory zero-copy.
  • sync buffered: cache가 적용된 blocking read로 spatial locality가 있을 때 유리합니다.
  • async unbuffered: shared-memory zero-copy이며 race와 data hazard에 주의합니다.
  • async buffered: aio_read() 또는 DMA입니다.

I/O operation이 atomic하지 않으면 locking이 필요합니다. 독립 channel이 충분하면 lock 없이 thread·ISR별 ordering을 유지할 수도 있습니다.

  • Non-atomic write + one shared channel: UART처럼 lock(); emit(a); emit(b); emit(c); release();가 필요합니다.
  • Non-atomic write + many channels: Multi-UART처럼 thread·ISR별 channel을 배정하면 각 producer 자체 ordering으로 race를 피할 수 있습니다.
  • Atomic write + one channel: native_sim 또는 DMA board에서 field를 buffer에 concat해 한 번에 emit하거나, extra memory 없이 lock 안에서 여러 emit을 수행합니다.
  • Atomic write + many channels: Multi-channel DMA처럼 concat packet에 thread ID channel을 지정해 lock-free로 전송할 수 있습니다.

Object tracking

Kernel은 tracing 분석에서 object 사용량을 추적할 수 있도록 initialized object의 global linked list를 유지할 수 있습니다. Timer, memory slab, semaphore, mutex, stack, message queue, mailbox, pipe, queue와 event list head는 다음과 같습니다.

struct k_timer *_track_list_k_timer;
struct k_mem_slab *_track_list_k_mem_slab;
struct k_sem *_track_list_k_sem;
struct k_mutex *_track_list_k_mutex;
struct k_stack *_track_list_k_stack;
struct k_msgq *_track_list_k_msgq;
struct k_mbox *_track_list_k_mbox;
struct k_pipe *_track_list_k_pipe;
struct k_queue *_track_list_k_queue;
struct k_event *_track_list_k_event;

각 global variable은 list head입니다. SYS_PORT_TRACK_NEXT macro로 다음 object를 얻습니다. 모든 initialized mutex를 순회하는 예는 다음과 같습니다.

struct k_mutex *cur = _track_list_k_mutex;
while (cur != NULL) {
  /* Do something */

  cur = SYS_PORT_TRACK_NEXT(cur);
}

CONFIG_TRACING_OBJECT_TRACKING으로 켭니다. Object type별 tracing Kconfig로 list를 선택적으로 비활성화할 수 있습니다. 예를 들어 semaphore tracking은 CONFIG_TRACING_SEMAPHORE를 끕니다. 현재 tracking 구현이 tracing infrastructure를 재사용하므로 tracing configuration 아래에 있습니다.

API

아래 229개 symbol은 kernel lifecycle 지점에서 backend로 event를 전달하는 tracing hook입니다. enter, blocking, exit을 함께 구현하면 call latency, wait time과 result를 분리해 분석할 수 있습니다.

Common

System · ISR · idle lifecycle에서 노출되는 6개 trace hook입니다.

sys_trace_sys_init_enter
System initialization routine에 들어갈 때 발생하는 공통 tracing hook입니다.
sys_trace_sys_init_exit
System initialization routine이 끝날 때 발생하는 공통 tracing hook입니다.
sys_trace_isr_enter
Interrupt service routine 진입과 nested interrupt depth를 기록하는 hook입니다.
sys_trace_isr_exit
Interrupt service routine이 끝나 interrupted context로 돌아가는 지점을 기록합니다.
sys_trace_isr_exit_to_scheduler
ISR 종료 뒤 원래 context가 아니라 scheduler로 넘기는 경로를 기록합니다.
sys_trace_idle
CPU가 runnable work 없이 idle state로 들어가는 시점을 기록합니다.

Threads

Thread와 scheduler lifecycle에서 노출되는 43개 trace hook입니다.

sys_port_trace_k_thread_foreach_enter
Thread와 scheduler의 k thread foreach 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_foreach_exit
Thread와 scheduler의 k thread foreach 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_foreach_unlocked_enter
Thread와 scheduler의 k thread foreach unlocked 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_foreach_unlocked_exit
Thread와 scheduler의 k thread foreach unlocked 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_create
Thread와 scheduler의 k thread create 상태가 바뀌는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_user_mode_enter
Thread와 scheduler의 k thread user mode 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_join_enter
Thread와 scheduler의 k thread join 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_join_blocking
Thread와 scheduler의 k thread join 호출자가 대기 상태로 전환되는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_join_exit
Thread와 scheduler의 k thread join 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_sleep_enter
Thread와 scheduler의 k thread sleep 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_sleep_exit
Thread와 scheduler의 k thread sleep 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_msleep_enter
Thread와 scheduler의 k thread msleep 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_msleep_exit
Thread와 scheduler의 k thread msleep 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_usleep_enter
Thread와 scheduler의 k thread usleep 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_usleep_exit
Thread와 scheduler의 k thread usleep 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_busy_wait_enter
Thread와 scheduler의 k thread busy wait 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_busy_wait_exit
Thread와 scheduler의 k thread busy wait 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_yield
Thread와 scheduler의 k thread yield 상태가 바뀌는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_wakeup
Thread와 scheduler의 k thread wakeup 상태가 바뀌는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_start
Thread와 scheduler의 k thread 동작 시작 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_abort
Thread와 scheduler의 k thread abort 상태가 바뀌는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_abort_enter
Thread와 scheduler의 k thread abort 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_abort_exit
Thread와 scheduler의 k thread abort 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_priority_set
Thread와 scheduler의 k thread priority set 상태가 바뀌는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_suspend_enter
Thread와 scheduler의 k thread suspend 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_suspend_exit
Thread와 scheduler의 k thread suspend 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_resume_enter
Thread와 scheduler의 k thread resume 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_resume_exit
Thread와 scheduler의 k thread resume 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_sched_lock
Thread와 scheduler의 k thread sched lock 상태가 바뀌는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_sched_unlock
Thread와 scheduler의 k thread sched unlock 상태가 바뀌는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_name_set
Thread와 scheduler의 k thread name set 상태가 바뀌는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_switched_out
Thread와 scheduler의 k thread switched out 상태가 바뀌는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_switched_in
Thread와 scheduler의 k thread switched in 상태가 바뀌는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_ready
Thread와 scheduler의 k thread ready 상태가 바뀌는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_pend
Thread와 scheduler의 k thread pend 상태가 바뀌는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_info
Thread와 scheduler의 k thread info 상태가 바뀌는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_sched_wakeup
Thread와 scheduler의 k thread sched wakeup 상태가 바뀌는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_sched_abort
Thread와 scheduler의 k thread sched abort 상태가 바뀌는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_sched_priority_set
Thread와 scheduler의 k thread sched priority set 상태가 바뀌는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_sched_ready
Thread와 scheduler의 k thread sched ready 상태가 바뀌는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_sched_pend
Thread와 scheduler의 k thread sched pend 상태가 바뀌는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_sched_resume
Thread와 scheduler의 k thread sched resume 상태가 바뀌는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_thread_sched_suspend
Thread와 scheduler의 k thread sched suspend 상태가 바뀌는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.

Work Queues

Work item과 work queue lifecycle에서 노출되는 13개 trace hook입니다.

sys_port_trace_k_work_init
Work item과 work queue의 k work object 초기화 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_work_submit_to_queue_enter
Work item과 work queue의 k work submit to queue 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_work_submit_to_queue_exit
Work item과 work queue의 k work submit to queue 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_work_submit_enter
Work item과 work queue의 k work submit 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_work_submit_exit
Work item과 work queue의 k work submit 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_work_flush_enter
Work item과 work queue의 k work flush 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_work_flush_blocking
Work item과 work queue의 k work flush 호출자가 대기 상태로 전환되는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_work_flush_exit
Work item과 work queue의 k work flush 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_work_cancel_enter
Work item과 work queue의 k work cancel 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_work_cancel_exit
Work item과 work queue의 k work cancel 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_work_cancel_sync_enter
Work item과 work queue의 k work cancel sync 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_work_cancel_sync_blocking
Work item과 work queue의 k work cancel sync 호출자가 대기 상태로 전환되는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_work_cancel_sync_exit
Work item과 work queue의 k work cancel sync 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.

Poll

Poll event와 signal lifecycle에서 노출되는 7개 trace hook입니다.

sys_port_trace_k_poll_api_event_init
Poll event와 signal의 k poll api event object 초기화 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_poll_api_poll_enter
Poll event와 signal의 k poll api poll 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_poll_api_poll_exit
Poll event와 signal의 k poll api poll 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_poll_api_signal_init
Poll event와 signal의 k poll api signal object 초기화 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_poll_api_signal_reset
Poll event와 signal의 k poll api signal 상태 reset 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_poll_api_signal_check
Poll event와 signal의 k poll api signal 상태 확인 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_poll_api_signal_raise
Poll event와 signal의 k poll api signal signal raise 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.

Semaphore

Semaphore lifecycle에서 노출되는 7개 trace hook입니다.

sys_port_trace_k_sem_init
Semaphore의 k sem object 초기화 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_sem_give_enter
Semaphore의 k sem give 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_sem_give_exit
Semaphore의 k sem give 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_sem_take_enter
Semaphore의 k sem take 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_sem_take_blocking
Semaphore의 k sem take 호출자가 대기 상태로 전환되는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_sem_take_exit
Semaphore의 k sem take 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_sem_reset
Semaphore의 k sem 상태 reset 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.

Mutex

Mutex lifecycle에서 노출되는 6개 trace hook입니다.

sys_port_trace_k_mutex_init
Mutex의 k mutex object 초기화 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_mutex_lock_enter
Mutex의 k mutex lock 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_mutex_lock_blocking
Mutex의 k mutex lock 호출자가 대기 상태로 전환되는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_mutex_lock_exit
Mutex의 k mutex lock 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_mutex_unlock_enter
Mutex의 k mutex unlock 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_mutex_unlock_exit
Mutex의 k mutex unlock 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.

Condition Variables

Condition variable lifecycle에서 노출되는 8개 trace hook입니다.

sys_port_trace_k_condvar_init
Condition variable의 k condvar object 초기화 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_condvar_signal_enter
Condition variable의 k condvar signal 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_condvar_signal_blocking
Condition variable의 k condvar signal 호출자가 대기 상태로 전환되는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_condvar_signal_exit
Condition variable의 k condvar signal 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_condvar_broadcast_enter
Condition variable의 k condvar broadcast 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_condvar_broadcast_exit
Condition variable의 k condvar broadcast 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_condvar_wait_enter
Condition variable의 k condvar wait 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_condvar_wait_exit
Condition variable의 k condvar wait 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.

Queues

Generic queue lifecycle에서 노출되는 29개 trace hook입니다.

sys_port_trace_k_queue_init
Generic queue의 k queue object 초기화 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_queue_cancel_wait
Generic queue의 k queue cancel wait 상태가 바뀌는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_queue_queue_insert_enter
Generic queue의 k queue queue insert 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_queue_queue_insert_blocking
Generic queue의 k queue queue insert 호출자가 대기 상태로 전환되는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_queue_queue_insert_exit
Generic queue의 k queue queue insert 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_queue_append_enter
Generic queue의 k queue append 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_queue_append_exit
Generic queue의 k queue append 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_queue_alloc_append_enter
Generic queue의 k queue alloc append 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_queue_alloc_append_exit
Generic queue의 k queue alloc append 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_queue_prepend_enter
Generic queue의 k queue prepend 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_queue_prepend_exit
Generic queue의 k queue prepend 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_queue_alloc_prepend_enter
Generic queue의 k queue alloc prepend 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_queue_alloc_prepend_exit
Generic queue의 k queue alloc prepend 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_queue_insert_enter
Generic queue의 k queue insert 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_queue_insert_blocking
Generic queue의 k queue insert 호출자가 대기 상태로 전환되는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_queue_insert_exit
Generic queue의 k queue insert 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_queue_append_list_enter
Generic queue의 k queue append list 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_queue_append_list_exit
Generic queue의 k queue append list 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_queue_merge_slist_enter
Generic queue의 k queue merge slist 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_queue_merge_slist_exit
Generic queue의 k queue merge slist 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_queue_get_enter
Generic queue의 k queue get 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_queue_get_blocking
Generic queue의 k queue get 호출자가 대기 상태로 전환되는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_queue_get_exit
Generic queue의 k queue get 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_queue_remove_enter
Generic queue의 k queue remove 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_queue_remove_exit
Generic queue의 k queue remove 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_queue_unique_append_enter
Generic queue의 k queue unique append 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_queue_unique_append_exit
Generic queue의 k queue unique append 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_queue_peek_head
Generic queue의 k queue peek head 상태가 바뀌는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_queue_peek_tail
Generic queue의 k queue peek tail 상태가 바뀌는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.

FIFO

FIFO lifecycle에서 노출되는 18개 trace hook입니다.

sys_port_trace_k_fifo_init_enter
FIFO의 k fifo init 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_fifo_init_exit
FIFO의 k fifo init 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_fifo_cancel_wait_enter
FIFO의 k fifo cancel wait 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_fifo_cancel_wait_exit
FIFO의 k fifo cancel wait 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_fifo_put_enter
FIFO의 k fifo put 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_fifo_put_exit
FIFO의 k fifo put 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_fifo_alloc_put_enter
FIFO의 k fifo alloc put 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_fifo_alloc_put_exit
FIFO의 k fifo alloc put 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_fifo_put_list_enter
FIFO의 k fifo put list 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_fifo_put_list_exit
FIFO의 k fifo put list 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_fifo_alloc_put_slist_enter
FIFO의 k fifo alloc put slist 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_fifo_alloc_put_slist_exit
FIFO의 k fifo alloc put slist 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_fifo_get_enter
FIFO의 k fifo get 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_fifo_get_exit
FIFO의 k fifo get 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_fifo_peek_head_enter
FIFO의 k fifo peek head 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_fifo_peek_head_exit
FIFO의 k fifo peek head 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_fifo_peek_tail_enter
FIFO의 k fifo peek tail 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_fifo_peek_tail_exit
FIFO의 k fifo peek tail 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.

LIFO

LIFO lifecycle에서 노출되는 8개 trace hook입니다.

sys_port_trace_k_lifo_init_enter
LIFO의 k lifo init 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_lifo_init_exit
LIFO의 k lifo init 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_lifo_put_enter
LIFO의 k lifo put 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_lifo_put_exit
LIFO의 k lifo put 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_lifo_alloc_put_enter
LIFO의 k lifo alloc put 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_lifo_alloc_put_exit
LIFO의 k lifo alloc put 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_lifo_get_enter
LIFO의 k lifo get 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_lifo_get_exit
LIFO의 k lifo get 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.

Stacks

Kernel stack lifecycle에서 노출되는 10개 trace hook입니다.

sys_port_trace_k_stack_init
Kernel stack의 k stack object 초기화 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_stack_alloc_init_enter
Kernel stack의 k stack alloc init 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_stack_alloc_init_exit
Kernel stack의 k stack alloc init 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_stack_cleanup_enter
Kernel stack의 k stack cleanup 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_stack_cleanup_exit
Kernel stack의 k stack cleanup 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_stack_push_enter
Kernel stack의 k stack push 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_stack_push_exit
Kernel stack의 k stack push 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_stack_pop_enter
Kernel stack의 k stack pop 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_stack_pop_blocking
Kernel stack의 k stack pop 호출자가 대기 상태로 전환되는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_stack_pop_exit
Kernel stack의 k stack pop 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.

Message Queues

Message queue lifecycle에서 노출되는 13개 trace hook입니다.

sys_port_trace_k_msgq_init
Message queue의 k msgq object 초기화 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_msgq_alloc_init_enter
Message queue의 k msgq alloc init 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_msgq_alloc_init_exit
Message queue의 k msgq alloc init 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_msgq_cleanup_enter
Message queue의 k msgq cleanup 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_msgq_cleanup_exit
Message queue의 k msgq cleanup 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_msgq_put_enter
Message queue의 k msgq put 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_msgq_put_blocking
Message queue의 k msgq put 호출자가 대기 상태로 전환되는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_msgq_put_exit
Message queue의 k msgq put 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_msgq_get_enter
Message queue의 k msgq get 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_msgq_get_blocking
Message queue의 k msgq get 호출자가 대기 상태로 전환되는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_msgq_get_exit
Message queue의 k msgq get 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_msgq_peek
Message queue의 k msgq peek 상태가 바뀌는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_msgq_purge
Message queue의 k msgq 대기 data purge 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.

Mailbox

Mailbox lifecycle에서 노출되는 12개 trace hook입니다.

sys_port_trace_k_mbox_init
Mailbox의 k mbox object 초기화 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_mbox_message_put_enter
Mailbox의 k mbox message put 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_mbox_message_put_blocking
Mailbox의 k mbox message put 호출자가 대기 상태로 전환되는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_mbox_message_put_exit
Mailbox의 k mbox message put 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_mbox_put_enter
Mailbox의 k mbox put 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_mbox_put_exit
Mailbox의 k mbox put 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_mbox_async_put_enter
Mailbox의 k mbox async put 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_mbox_async_put_exit
Mailbox의 k mbox async put 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_mbox_get_enter
Mailbox의 k mbox get 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_mbox_get_blocking
Mailbox의 k mbox get 호출자가 대기 상태로 전환되는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_mbox_get_exit
Mailbox의 k mbox get 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_mbox_data_get
Mailbox의 k mbox data get 상태가 바뀌는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.

Pipes

Pipe lifecycle에서 노출되는 15개 trace hook입니다.

sys_port_trace_k_pipe_init
Pipe의 k pipe object 초기화 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_pipe_cleanup_enter
Pipe의 k pipe cleanup 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_pipe_cleanup_exit
Pipe의 k pipe cleanup 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_pipe_alloc_init_enter
Pipe의 k pipe alloc init 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_pipe_alloc_init_exit
Pipe의 k pipe alloc init 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_pipe_flush_enter
Pipe의 k pipe flush 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_pipe_flush_exit
Pipe의 k pipe flush 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_pipe_buffer_flush_enter
Pipe의 k pipe buffer flush 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_pipe_buffer_flush_exit
Pipe의 k pipe buffer flush 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_pipe_put_enter
Pipe의 k pipe put 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_pipe_put_blocking
Pipe의 k pipe put 호출자가 대기 상태로 전환되는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_pipe_put_exit
Pipe의 k pipe put 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_pipe_get_enter
Pipe의 k pipe get 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_pipe_get_blocking
Pipe의 k pipe get 호출자가 대기 상태로 전환되는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_pipe_get_exit
Pipe의 k pipe get 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.

Heaps

Heap과 system allocation lifecycle에서 노출되는 19개 trace hook입니다.

sys_port_trace_k_heap_init
Heap과 system allocation의 k heap object 초기화 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_heap_aligned_alloc_enter
Heap과 system allocation의 k heap aligned alloc 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_heap_aligned_alloc_blocking
Heap과 system allocation의 k heap aligned alloc 호출자가 대기 상태로 전환되는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_heap_aligned_alloc_exit
Heap과 system allocation의 k heap aligned alloc 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_heap_alloc_enter
Heap과 system allocation의 k heap alloc 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_heap_alloc_exit
Heap과 system allocation의 k heap alloc 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_heap_free
Heap과 system allocation의 k heap memory 해제 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_heap_realloc_enter
Heap과 system allocation의 k heap realloc 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_heap_realloc_exit
Heap과 system allocation의 k heap realloc 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_heap_sys_k_aligned_alloc_enter
Heap과 system allocation의 k heap sys k aligned alloc 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_heap_sys_k_aligned_alloc_exit
Heap과 system allocation의 k heap sys k aligned alloc 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_heap_sys_k_malloc_enter
Heap과 system allocation의 k heap sys k malloc 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_heap_sys_k_malloc_exit
Heap과 system allocation의 k heap sys k malloc 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_heap_sys_k_free_enter
Heap과 system allocation의 k heap sys k free 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_heap_sys_k_free_exit
Heap과 system allocation의 k heap sys k free 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_heap_sys_k_calloc_enter
Heap과 system allocation의 k heap sys k calloc 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_heap_sys_k_calloc_exit
Heap과 system allocation의 k heap sys k calloc 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_heap_sys_k_realloc_enter
Heap과 system allocation의 k heap sys k realloc 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_heap_sys_k_realloc_exit
Heap과 system allocation의 k heap sys k realloc 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.

Memory Slabs

Memory slab lifecycle에서 노출되는 6개 trace hook입니다.

sys_port_trace_k_mem_slab_init
Memory slab의 k mem slab object 초기화 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_mem_slab_alloc_enter
Memory slab의 k mem slab alloc 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_mem_slab_alloc_blocking
Memory slab의 k mem slab alloc 호출자가 대기 상태로 전환되는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_mem_slab_alloc_exit
Memory slab의 k mem slab alloc 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_mem_slab_free_enter
Memory slab의 k mem slab free 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_mem_slab_free_exit
Memory slab의 k mem slab free 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.

Timers

Kernel timer lifecycle에서 노출되는 6개 trace hook입니다.

sys_port_trace_k_timer_init
Kernel timer의 k timer object 초기화 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_timer_start
Kernel timer의 k timer 동작 시작 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_timer_stop
Kernel timer의 k timer 동작 중지 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_timer_status_sync_enter
Kernel timer의 k timer status sync 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_timer_status_sync_blocking
Kernel timer의 k timer status sync 호출자가 대기 상태로 전환되는 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_k_timer_status_sync_exit
Kernel timer의 k timer status sync 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.

Object tracking

Kernel object linked list lifecycle에서 노출되는 1개 trace hook입니다.

SYS_PORT_TRACK_NEXT
Tracing object list에서 현재 kernel object 다음 항목을 얻는 macro입니다. Object tracking traversal이 object 내부 link 표현에 의존하지 않도록 합니다.

Syscalls

System call lifecycle에서 노출되는 2개 trace hook입니다.

sys_port_trace_syscall_enter
System call의 syscall 호출 진입 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.
sys_port_trace_syscall_exit
System call의 syscall 호출 종료와 return 결과 시점에 호출되는 tracing port hook입니다. 선택 backend가 object pointer, argument와 result를 필요한 trace format으로 직렬화하도록 연결합니다.

Source

출처

영어 원문에는 문단, 문서 지시문, 표, 코드, 코드 심벌, 경로를 그대로 보존했습니다.