include/linux/eventfd.h
Source file repositories/reference/linux-study-clean/include/linux/eventfd.h
File Facts
- System
- Linux kernel
- Corpus path
include/linux/eventfd.h- Extension
.h- Size
- 2153 bytes
- Lines
- 94
- 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
linux/wait.hlinux/err.hlinux/percpu-defs.hlinux/percpu.hlinux/sched.huapi/linux/eventfd.h
Detected Declarations
struct eventfd_ctxstruct filefunction eventfd_signal_allowedfunction eventfd_signal_maskfunction eventfd_signal_allowedfunction eventfd_ctx_do_read
Annotated Snippet
#ifndef _LINUX_EVENTFD_H
#define _LINUX_EVENTFD_H
#include <linux/wait.h>
#include <linux/err.h>
#include <linux/percpu-defs.h>
#include <linux/percpu.h>
#include <linux/sched.h>
#include <uapi/linux/eventfd.h>
/*
* CAREFUL: Check include/uapi/asm-generic/fcntl.h when defining
* new flags, since they might collide with O_* ones. We want
* to re-use O_* flags that couldn't possibly have a meaning
* from eventfd, in order to leave a free define-space for
* shared O_* flags.
*/
#define EFD_SHARED_FCNTL_FLAGS (O_CLOEXEC | O_NONBLOCK)
#define EFD_FLAGS_SET (EFD_SHARED_FCNTL_FLAGS | EFD_SEMAPHORE)
struct eventfd_ctx;
struct file;
#ifdef CONFIG_EVENTFD
void eventfd_ctx_put(struct eventfd_ctx *ctx);
struct file *eventfd_fget(int fd);
struct eventfd_ctx *eventfd_ctx_fdget(int fd);
struct eventfd_ctx *eventfd_ctx_fileget(struct file *file);
void eventfd_signal_mask(struct eventfd_ctx *ctx, __poll_t mask);
int eventfd_ctx_remove_wait_queue(struct eventfd_ctx *ctx, wait_queue_entry_t *wait,
__u64 *cnt);
void eventfd_ctx_do_read(struct eventfd_ctx *ctx, __u64 *cnt);
static inline bool eventfd_signal_allowed(void)
{
return !current->in_eventfd;
}
#else /* CONFIG_EVENTFD */
/*
* Ugly ugly ugly error layer to support modules that uses eventfd but
* pretend to work in !CONFIG_EVENTFD configurations. Namely, AIO.
*/
static inline struct eventfd_ctx *eventfd_ctx_fdget(int fd)
{
return ERR_PTR(-ENOSYS);
}
static inline void eventfd_signal_mask(struct eventfd_ctx *ctx, __poll_t mask)
{
}
static inline void eventfd_ctx_put(struct eventfd_ctx *ctx)
{
}
static inline int eventfd_ctx_remove_wait_queue(struct eventfd_ctx *ctx,
wait_queue_entry_t *wait, __u64 *cnt)
{
return -ENOSYS;
}
static inline bool eventfd_signal_allowed(void)
{
return true;
}
static inline void eventfd_ctx_do_read(struct eventfd_ctx *ctx, __u64 *cnt)
{
}
#endif
static inline void eventfd_signal(struct eventfd_ctx *ctx)
{
eventfd_signal_mask(ctx, 0);
}
#endif /* _LINUX_EVENTFD_H */
Annotation
- Immediate include surface: `linux/wait.h`, `linux/err.h`, `linux/percpu-defs.h`, `linux/percpu.h`, `linux/sched.h`, `uapi/linux/eventfd.h`.
- Detected declarations: `struct eventfd_ctx`, `struct file`, `function eventfd_signal_allowed`, `function eventfd_signal_mask`, `function eventfd_signal_allowed`, `function eventfd_ctx_do_read`.
- 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.