drivers/scsi/scsi_trace.c
Source file repositories/reference/linux-study-clean/drivers/scsi/scsi_trace.c
File Facts
- System
- Linux kernel
- Corpus path
drivers/scsi/scsi_trace.c- Extension
.c- Size
- 9011 bytes
- Lines
- 414
- Domain
- Driver Families
- Bucket
- drivers/scsi
- 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.
- Uses kernel synchronization; read lock ordering, sleepability, and interrupt context assumptions before translating.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
linux/kernel.hlinux/trace_seq.hlinux/unaligned.htrace/events/scsi.h
Detected Declarations
function scsi_trace_rw6function scsi_trace_rw10function scsi_trace_rw12function scsi_trace_rw16function scsi_trace_rw32function scsi_trace_unmapfunction scsi_trace_service_action_infunction scsi_trace_maintenance_infunction scsi_trace_maintenance_outfunction scsi_trace_zbc_infunction scsi_trace_zbc_outfunction scsi_trace_atomic_write16_outfunction scsi_trace_varlenfunction scsi_trace_miscfunction scsi_trace_parse_cdb
Annotated Snippet
// SPDX-License-Identifier: GPL-2.0-only
/*
* Copyright (C) 2010 FUJITSU LIMITED
* Copyright (C) 2010 Tomohiro Kusumi <kusumi.tomohiro@jp.fujitsu.com>
*/
#include <linux/kernel.h>
#include <linux/trace_seq.h>
#include <linux/unaligned.h>
#include <trace/events/scsi.h>
#define SERVICE_ACTION16(cdb) (cdb[1] & 0x1f)
#define SERVICE_ACTION32(cdb) (get_unaligned_be16(&cdb[8]))
static const char *
scsi_trace_misc(struct trace_seq *, unsigned char *, int);
static const char *
scsi_trace_rw6(struct trace_seq *p, unsigned char *cdb, int len)
{
const char *ret = trace_seq_buffer_ptr(p);
u32 lba, txlen;
lba = get_unaligned_be24(&cdb[1]) & 0x1fffff;
/*
* From SBC-2: a TRANSFER LENGTH field set to zero specifies that 256
* logical blocks shall be read (READ(6)) or written (WRITE(6)).
*/
txlen = cdb[4] ? cdb[4] : 256;
trace_seq_printf(p, "lba=%u txlen=%u", lba, txlen);
trace_seq_putc(p, 0);
return ret;
}
static const char *
scsi_trace_rw10(struct trace_seq *p, unsigned char *cdb, int len)
{
const char *ret = trace_seq_buffer_ptr(p);
u32 lba, txlen;
lba = get_unaligned_be32(&cdb[2]);
txlen = get_unaligned_be16(&cdb[7]);
trace_seq_printf(p, "lba=%u txlen=%u protect=%u", lba, txlen,
cdb[1] >> 5);
if (cdb[0] == WRITE_SAME)
trace_seq_printf(p, " unmap=%u", cdb[1] >> 3 & 1);
trace_seq_putc(p, 0);
return ret;
}
static const char *
scsi_trace_rw12(struct trace_seq *p, unsigned char *cdb, int len)
{
const char *ret = trace_seq_buffer_ptr(p);
u32 lba, txlen;
lba = get_unaligned_be32(&cdb[2]);
txlen = get_unaligned_be32(&cdb[6]);
trace_seq_printf(p, "lba=%u txlen=%u protect=%u", lba, txlen,
cdb[1] >> 5);
trace_seq_putc(p, 0);
return ret;
}
static const char *
scsi_trace_rw16(struct trace_seq *p, unsigned char *cdb, int len)
{
const char *ret = trace_seq_buffer_ptr(p);
u64 lba;
u32 txlen;
lba = get_unaligned_be64(&cdb[2]);
txlen = get_unaligned_be32(&cdb[10]);
trace_seq_printf(p, "lba=%llu txlen=%u protect=%u", lba, txlen,
cdb[1] >> 5);
if (cdb[0] == WRITE_SAME_16)
trace_seq_printf(p, " unmap=%u", cdb[1] >> 3 & 1);
trace_seq_putc(p, 0);
return ret;
Annotation
- Immediate include surface: `linux/kernel.h`, `linux/trace_seq.h`, `linux/unaligned.h`, `trace/events/scsi.h`.
- Detected declarations: `function scsi_trace_rw6`, `function scsi_trace_rw10`, `function scsi_trace_rw12`, `function scsi_trace_rw16`, `function scsi_trace_rw32`, `function scsi_trace_unmap`, `function scsi_trace_service_action_in`, `function scsi_trace_maintenance_in`, `function scsi_trace_maintenance_out`, `function scsi_trace_zbc_in`.
- Atlas domain: Driver Families / drivers/scsi.
- Implementation status: source implementation candidate.
- Synchronization appears in or near this file; preserve lock ordering, sleepability, and interrupt-context constraints.
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.