fs/iomap/direct-io.c
Source file repositories/reference/linux-study-clean/fs/iomap/direct-io.c
File Facts
- System
- Linux kernel
- Corpus path
fs/iomap/direct-io.c- Extension
.c- Size
- 25355 bytes
- Lines
- 905
- Domain
- Core OS
- Bucket
- VFS And Filesystem Core
- Inferred role
- Core OS: exported/initcall integration point
- Status
- integration 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.
- Exports symbols or registers init work; inspect boot/module ordering and who consumes the exported contract.
- Touches user memory; correctness depends on fault-safe copying and privilege boundary handling.
- Uses kernel synchronization; read lock ordering, sleepability, and interrupt context assumptions before translating.
- 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/bio-integrity.hlinux/blk-crypto.hlinux/fscrypt.hlinux/pagemap.hlinux/iomap.hlinux/task_io_accounting_ops.hlinux/fserror.hinternal.htrace.h../internal.h
Detected Declarations
struct iomap_diofunction iomap_dio_submit_biofunction iomap_dio_err_typefunction should_report_dio_fserrorfunction iomap_dio_completefunction iomap_dio_complete_workfunction contextfunction iomap_dio_donefunction __iomap_dio_bio_end_iofunction iomap_dio_bio_end_iofunction iomap_finish_ioend_directfunction iomap_dio_zerofunction iomap_dio_bio_iter_onefunction iomap_dio_bio_iterfunction iomap_dio_hole_iterfunction iomap_dio_inline_iterfunction iomap_dio_iterfunction __iomap_dio_rwfunction iomap_dio_rwexport iomap_dio_completeexport iomap_dio_bio_end_ioexport __iomap_dio_rwexport iomap_dio_rw
Annotated Snippet
struct iomap_dio {
struct kiocb *iocb;
const struct iomap_dio_ops *dops;
loff_t i_size;
loff_t size;
atomic_t ref;
unsigned flags;
int error;
size_t done_before;
bool wait_for_completion;
union {
/* used during submission and for synchronous completion: */
struct {
struct iov_iter *iter;
struct task_struct *waiter;
} submit;
/* used for aio completion: */
struct {
struct work_struct work;
} aio;
};
};
static struct bio *iomap_dio_alloc_bio(const struct iomap_iter *iter,
struct iomap_dio *dio, unsigned short nr_vecs, blk_opf_t opf)
{
if (dio->dops && dio->dops->bio_set)
return bio_alloc_bioset(iter->iomap.bdev, nr_vecs, opf,
GFP_KERNEL, dio->dops->bio_set);
return bio_alloc(iter->iomap.bdev, nr_vecs, opf, GFP_KERNEL);
}
static void iomap_dio_submit_bio(const struct iomap_iter *iter,
struct iomap_dio *dio, struct bio *bio, loff_t pos)
{
struct kiocb *iocb = dio->iocb;
atomic_inc(&dio->ref);
/* Sync dio can't be polled reliably */
if ((iocb->ki_flags & IOCB_HIPRI) && !is_sync_kiocb(iocb)) {
bio->bi_opf |= REQ_POLLED;
WRITE_ONCE(iocb->private, bio);
}
if (dio->dops && dio->dops->submit_io) {
dio->dops->submit_io(iter, bio, pos);
} else {
WARN_ON_ONCE(iter->iomap.flags & IOMAP_F_ANON_WRITE);
blk_crypto_submit_bio(bio);
}
}
static inline enum fserror_type iomap_dio_err_type(const struct iomap_dio *dio)
{
if (dio->flags & IOMAP_DIO_WRITE)
return FSERR_DIRECTIO_WRITE;
return FSERR_DIRECTIO_READ;
}
static inline bool should_report_dio_fserror(const struct iomap_dio *dio)
{
switch (dio->error) {
case 0:
case -EAGAIN:
case -ENOTBLK:
/* don't send fsnotify for success or magic retry codes */
return false;
default:
return true;
}
}
ssize_t iomap_dio_complete(struct iomap_dio *dio)
{
const struct iomap_dio_ops *dops = dio->dops;
struct kiocb *iocb = dio->iocb;
loff_t offset = iocb->ki_pos;
ssize_t ret = dio->error;
if (dops && dops->end_io)
ret = dops->end_io(iocb, dio->size, ret, dio->flags);
if (should_report_dio_fserror(dio))
fserror_report_io(file_inode(iocb->ki_filp),
iomap_dio_err_type(dio), offset, dio->size,
dio->error, GFP_NOFS);
if (likely(!ret)) {
Annotation
- Immediate include surface: `linux/bio-integrity.h`, `linux/blk-crypto.h`, `linux/fscrypt.h`, `linux/pagemap.h`, `linux/iomap.h`, `linux/task_io_accounting_ops.h`, `linux/fserror.h`, `internal.h`.
- Detected declarations: `struct iomap_dio`, `function iomap_dio_submit_bio`, `function iomap_dio_err_type`, `function should_report_dio_fserror`, `function iomap_dio_complete`, `function iomap_dio_complete_work`, `function context`, `function iomap_dio_done`, `function __iomap_dio_bio_end_io`, `function iomap_dio_bio_end_io`.
- Atlas domain: Core OS / VFS And Filesystem Core.
- Implementation status: integration implementation candidate.
- This snippet crosses the user/kernel memory boundary; validate fault handling and access checks before translating the pattern.
- 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.