include/linux/pr.h
Source file repositories/reference/linux-study-clean/include/linux/pr.h
File Facts
- System
- Linux kernel
- Corpus path
include/linux/pr.h- Extension
.h- Size
- 1358 bytes
- Lines
- 45
- Domain
- Core OS
- Bucket
- Core Kernel Interface
- Inferred role
- Core OS: implementation source
- Status
- source implementation candidate
Why This File Exists
Core operating-system implementation surface: boot, tasks, memory, VFS, syscall-facing interfaces, synchronization, credentials, and isolation.
- Core operating-system implementation surface: boot, tasks, memory, VFS, syscall-facing interfaces, synchronization, credentials, and isolation.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
uapi/linux/pr.h
Detected Declarations
struct pr_keysstruct pr_held_reservationstruct pr_ops
Annotated Snippet
struct pr_keys {
u32 generation;
u32 num_keys;
u64 keys[];
};
struct pr_held_reservation {
u64 key;
u32 generation;
enum pr_type type;
};
struct pr_ops {
int (*pr_register)(struct block_device *bdev, u64 old_key, u64 new_key,
u32 flags);
int (*pr_reserve)(struct block_device *bdev, u64 key,
enum pr_type type, u32 flags);
int (*pr_release)(struct block_device *bdev, u64 key,
enum pr_type type);
int (*pr_preempt)(struct block_device *bdev, u64 old_key, u64 new_key,
enum pr_type type, bool abort);
int (*pr_clear)(struct block_device *bdev, u64 key);
/*
* pr_read_keys - Read the registered keys and return them in the
* pr_keys->keys array. The keys array will have been allocated at the
* end of the pr_keys struct, and pr_keys->num_keys must be set to the
* number of keys the array can hold. If there are more than can fit
* in the array, success will still be returned and pr_keys->num_keys
* will reflect the total number of keys the device contains, so the
* caller can retry with a larger array.
*/
int (*pr_read_keys)(struct block_device *bdev,
struct pr_keys *keys_info);
int (*pr_read_reservation)(struct block_device *bdev,
struct pr_held_reservation *rsv);
};
#endif /* LINUX_PR_H */
Annotation
- Immediate include surface: `uapi/linux/pr.h`.
- Detected declarations: `struct pr_keys`, `struct pr_held_reservation`, `struct pr_ops`.
- Atlas domain: Core OS / Core Kernel Interface.
- 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.