sound/hda/core/trace.h
Source file repositories/reference/linux-study-clean/sound/hda/core/trace.h
File Facts
- System
- Linux kernel
- Corpus path
sound/hda/core/trace.h- Extension
.h- Size
- 2319 bytes
- Lines
- 102
- Domain
- Driver Families
- Bucket
- sound/hda
- Inferred role
- Driver Families: implementation source
- Status
- source implementation candidate
Why This File Exists
Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.
- Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
linux/tracepoint.hlinux/device.hsound/hdaudio.htrace/define_trace.h
Detected Declarations
struct hdac_busstruct hdac_codec
Annotated Snippet
#undef TRACE_SYSTEM
#define TRACE_SYSTEM hda
#if !defined(__HDAC_TRACE_H) || defined(TRACE_HEADER_MULTI_READ)
#define __HDAC_TRACE_H
#include <linux/tracepoint.h>
#include <linux/device.h>
#include <sound/hdaudio.h>
#ifndef HDAC_MSG_MAX
#define HDAC_MSG_MAX 500
#endif
struct hdac_bus;
struct hdac_codec;
TRACE_EVENT(hda_send_cmd,
TP_PROTO(struct hdac_bus *bus, unsigned int cmd),
TP_ARGS(bus, cmd),
TP_STRUCT__entry(
__string(name, dev_name((bus)->dev))
__field(u32, cmd)
),
TP_fast_assign(
__assign_str(name);
__entry->cmd = cmd;
),
TP_printk("[%s:%d] val=0x%08x", __get_str(name), __entry->cmd >> 28, __entry->cmd)
);
TRACE_EVENT(hda_get_response,
TP_PROTO(struct hdac_bus *bus, unsigned int addr, unsigned int res),
TP_ARGS(bus, addr, res),
TP_STRUCT__entry(
__string(name, dev_name((bus)->dev))
__field(u32, addr)
__field(u32, res)
),
TP_fast_assign(
__assign_str(name);
__entry->addr = addr;
__entry->res = res;
),
TP_printk("[%s:%d] val=0x%08x", __get_str(name), __entry->addr, __entry->res)
);
TRACE_EVENT(hda_unsol_event,
TP_PROTO(struct hdac_bus *bus, u32 res, u32 res_ex),
TP_ARGS(bus, res, res_ex),
TP_STRUCT__entry(
__string(name, dev_name((bus)->dev))
__field(u32, res)
__field(u32, res_ex)
),
TP_fast_assign(
__assign_str(name);
__entry->res = res;
__entry->res_ex = res_ex;
),
TP_printk("[%s:%d] res=0x%08x, res_ex=0x%08x", __get_str(name),
__entry->res_ex & 0x0f, __entry->res, __entry->res_ex)
);
DECLARE_EVENT_CLASS(hdac_stream,
TP_PROTO(struct hdac_bus *bus, struct hdac_stream *azx_dev),
TP_ARGS(bus, azx_dev),
TP_STRUCT__entry(
__field(unsigned char, stream_tag)
),
TP_fast_assign(
__entry->stream_tag = (azx_dev)->stream_tag;
),
TP_printk("stream_tag: %d", __entry->stream_tag)
);
DEFINE_EVENT(hdac_stream, snd_hdac_stream_start,
TP_PROTO(struct hdac_bus *bus, struct hdac_stream *azx_dev),
TP_ARGS(bus, azx_dev)
);
DEFINE_EVENT(hdac_stream, snd_hdac_stream_stop,
TP_PROTO(struct hdac_bus *bus, struct hdac_stream *azx_dev),
TP_ARGS(bus, azx_dev)
);
Annotation
- Immediate include surface: `linux/tracepoint.h`, `linux/device.h`, `sound/hdaudio.h`, `trace/define_trace.h`.
- Detected declarations: `struct hdac_bus`, `struct hdac_codec`.
- Atlas domain: Driver Families / sound/hda.
- Implementation status: source implementation candidate.
Implementation Notes
- This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
- Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
- Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.