drivers/block/null_blk/trace.h
Source file repositories/reference/linux-study-clean/drivers/block/null_blk/trace.h
File Facts
- System
- Linux kernel
- Corpus path
drivers/block/null_blk/trace.h- Extension
.h- Size
- 2310 bytes
- Lines
- 86
- Domain
- Driver Families
- Bucket
- drivers/block
- 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/trace_seq.hnull_blk.htrace/define_trace.h
Detected Declarations
function __assign_disk_name
Annotated Snippet
#undef TRACE_SYSTEM
#define TRACE_SYSTEM nullb
#if !defined(_TRACE_NULLB_H) || defined(TRACE_HEADER_MULTI_READ)
#define _TRACE_NULLB_H
#include <linux/tracepoint.h>
#include <linux/trace_seq.h>
#include "null_blk.h"
const char *nullb_trace_disk_name(struct trace_seq *p, char *name);
#define __print_disk_name(name) nullb_trace_disk_name(p, name)
#ifndef TRACE_HEADER_MULTI_READ
static inline void __assign_disk_name(char *name, struct gendisk *disk)
{
if (disk)
memcpy(name, disk->disk_name, DISK_NAME_LEN);
else
memset(name, 0, DISK_NAME_LEN);
}
#endif
TRACE_EVENT(nullb_zone_op,
TP_PROTO(struct nullb_cmd *cmd, unsigned int zone_no,
unsigned int zone_cond),
TP_ARGS(cmd, zone_no, zone_cond),
TP_STRUCT__entry(
__array(char, disk, DISK_NAME_LEN)
/*
* __field() uses is_signed_type(). is_signed_type() does not
* support bitwise types. Use __field_struct() instead because
* it does not use is_signed_type().
*/
__field_struct(enum req_op, op)
__field(unsigned int, zone_no)
__field(unsigned int, zone_cond)
),
TP_fast_assign(
__entry->op = req_op(blk_mq_rq_from_pdu(cmd));
__entry->zone_no = zone_no;
__entry->zone_cond = zone_cond;
__assign_disk_name(__entry->disk,
blk_mq_rq_from_pdu(cmd)->q->disk);
),
TP_printk("%s req=%-15s zone_no=%u zone_cond=%-10s",
__print_disk_name(__entry->disk),
blk_op_str(__entry->op),
__entry->zone_no,
blk_zone_cond_str(__entry->zone_cond))
);
TRACE_EVENT(nullb_report_zones,
TP_PROTO(struct nullb *nullb, unsigned int nr_zones),
TP_ARGS(nullb, nr_zones),
TP_STRUCT__entry(
__array(char, disk, DISK_NAME_LEN)
__field(unsigned int, nr_zones)
),
TP_fast_assign(
__entry->nr_zones = nr_zones;
__assign_disk_name(__entry->disk, nullb->disk);
),
TP_printk("%s nr_zones=%u",
__print_disk_name(__entry->disk), __entry->nr_zones)
);
#endif /* _TRACE_NULLB_H */
#undef TRACE_INCLUDE_PATH
#define TRACE_INCLUDE_PATH .
#undef TRACE_INCLUDE_FILE
#define TRACE_INCLUDE_FILE trace
/* This part must be outside protection */
#include <trace/define_trace.h>
Annotation
- Immediate include surface: `linux/tracepoint.h`, `linux/trace_seq.h`, `null_blk.h`, `trace/define_trace.h`.
- Detected declarations: `function __assign_disk_name`.
- Atlas domain: Driver Families / drivers/block.
- 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.