include/trace/events/pagemap.h
Source file repositories/reference/linux-study-clean/include/trace/events/pagemap.h
File Facts
- System
- Linux kernel
- Corpus path
include/trace/events/pagemap.h- Extension
.h- Size
- 2190 bytes
- Lines
- 84
- Domain
- Repository Root And Misc
- Bucket
- include
- Inferred role
- Repository Root And Misc: implementation source
- Status
- source implementation candidate
Why This File Exists
Top-level or miscellaneous repository surface. Use this as map coverage unless a later manual pass promotes the file into a deeper subsystem dossier.
- Top-level or miscellaneous repository surface. Use this as map coverage unless a later manual pass promotes the file into a deeper subsystem dossier.
- Allocates kernel memory; connect allocation flags and lifetime to context constraints.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
linux/tracepoint.hlinux/mm.htrace/define_trace.h
Detected Declarations
- No top-level syscall, struct, function, initcall, or export declaration detected by the generator.
Annotated Snippet
#undef TRACE_SYSTEM
#define TRACE_SYSTEM pagemap
#if !defined(_TRACE_PAGEMAP_H) || defined(TRACE_HEADER_MULTI_READ)
#define _TRACE_PAGEMAP_H
#include <linux/tracepoint.h>
#include <linux/mm.h>
#define PAGEMAP_MAPPED 0x0001u
#define PAGEMAP_ANONYMOUS 0x0002u
#define PAGEMAP_FILE 0x0004u
#define PAGEMAP_SWAPCACHE 0x0008u
#define PAGEMAP_SWAPBACKED 0x0010u
#define PAGEMAP_MAPPEDDISK 0x0020u
#define PAGEMAP_BUFFERS 0x0040u
#define trace_pagemap_flags(folio) ( \
(folio_test_anon(folio) ? PAGEMAP_ANONYMOUS : PAGEMAP_FILE) | \
(folio_mapped(folio) ? PAGEMAP_MAPPED : 0) | \
(folio_test_swapcache(folio) ? PAGEMAP_SWAPCACHE : 0) | \
(folio_test_swapbacked(folio) ? PAGEMAP_SWAPBACKED : 0) | \
(folio_test_mappedtodisk(folio) ? PAGEMAP_MAPPEDDISK : 0) | \
(folio_test_private(folio) ? PAGEMAP_BUFFERS : 0) \
)
TRACE_EVENT(mm_lru_insertion,
TP_PROTO(struct folio *folio),
TP_ARGS(folio),
TP_STRUCT__entry(
__field(struct folio *, folio )
__field(unsigned long, pfn )
__field(enum lru_list, lru )
__field(unsigned long, flags )
),
TP_fast_assign(
__entry->folio = folio;
__entry->pfn = folio_pfn(folio);
__entry->lru = folio_lru_list(folio);
__entry->flags = trace_pagemap_flags(folio);
),
/* Flag format is based on page-types.c formatting for pagemap */
TP_printk("folio=%p pfn=0x%lx lru=%d flags=%s%s%s%s%s%s",
__entry->folio,
__entry->pfn,
__entry->lru,
__entry->flags & PAGEMAP_MAPPED ? "M" : " ",
__entry->flags & PAGEMAP_ANONYMOUS ? "a" : "f",
__entry->flags & PAGEMAP_SWAPCACHE ? "s" : " ",
__entry->flags & PAGEMAP_SWAPBACKED ? "b" : " ",
__entry->flags & PAGEMAP_MAPPEDDISK ? "d" : " ",
__entry->flags & PAGEMAP_BUFFERS ? "B" : " ")
);
TRACE_EVENT(mm_lru_activate,
TP_PROTO(struct folio *folio),
TP_ARGS(folio),
TP_STRUCT__entry(
__field(struct folio *, folio )
__field(unsigned long, pfn )
),
TP_fast_assign(
__entry->folio = folio;
__entry->pfn = folio_pfn(folio);
),
TP_printk("folio=%p pfn=0x%lx", __entry->folio, __entry->pfn)
);
#endif /* _TRACE_PAGEMAP_H */
/* This part must be outside protection */
#include <trace/define_trace.h>
Annotation
- Immediate include surface: `linux/tracepoint.h`, `linux/mm.h`, `trace/define_trace.h`.
- Atlas domain: Repository Root And Misc / include.
- 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.