include/linux/tty_buffer.h
Source file repositories/reference/linux-study-clean/include/linux/tty_buffer.h
File Facts
- System
- Linux kernel
- Corpus path
include/linux/tty_buffer.h- Extension
.h- Size
- 1361 bytes
- Lines
- 59
- 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.
- 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/atomic.hlinux/llist.hlinux/mutex.hlinux/workqueue.h
Detected Declarations
struct tty_bufferstruct tty_bufhead
Annotated Snippet
struct tty_buffer {
union {
struct tty_buffer *next;
struct llist_node free;
};
unsigned int used;
unsigned int size;
unsigned int commit;
unsigned int lookahead; /* Lazy update on recv, can become less than "read" */
unsigned int read;
bool flags;
/* Data points here */
u8 data[] __aligned(sizeof(unsigned long));
};
static inline u8 *char_buf_ptr(struct tty_buffer *b, unsigned int ofs)
{
return b->data + ofs;
}
static inline u8 *flag_buf_ptr(struct tty_buffer *b, unsigned int ofs)
{
return char_buf_ptr(b, ofs) + b->size;
}
struct tty_bufhead {
struct tty_buffer *head; /* Queue head */
struct workqueue_struct *flip_wq;
struct work_struct work;
struct mutex lock;
atomic_t priority;
struct tty_buffer sentinel;
struct llist_head free; /* Free queue head */
atomic_t mem_used; /* In-use buffers excluding free list */
int mem_limit;
struct tty_buffer *tail; /* Active buffer */
};
/*
* When a break, frame error, or parity error happens, these codes are
* stuffed into the flags buffer.
*/
#define TTY_NORMAL 0
#define TTY_BREAK 1
#define TTY_FRAME 2
#define TTY_PARITY 3
#define TTY_OVERRUN 4
#endif
Annotation
- Immediate include surface: `linux/atomic.h`, `linux/llist.h`, `linux/mutex.h`, `linux/workqueue.h`.
- Detected declarations: `struct tty_buffer`, `struct tty_bufhead`.
- Atlas domain: Core OS / Core Kernel Interface.
- 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.