mirror of
https://github.com/seaweedfs/seaweedfs.git
synced 2026-10-16 19:18:30 +02:00
Ping QiuandClaude Opus 4.6
9d0ec8efa3
Replace UseIOUring bool with IOBackend IOBackendMode (tri-state): - "standard" (default): sequential pread/pwrite/fdatasync - "auto": try io_uring, fall back to standard with warning log - "io_uring": require io_uring, fail startup if unavailable NewIOUring now returns ErrIOUringUnavailable instead of silently falling back — callers decide whether to fail or fall back based on the requested mode. All mode transitions are logged: io backend: requested=auto selected=standard reason=... io backend: requested=io_uring selected=io_uring CLI: --io-backend=standard|auto|io_uring added to iscsi-target. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
58 lines
2.1 KiB
Go
58 lines
2.1 KiB
Go
// Package batchio provides a swappable I/O backend for batch pread/pwrite/fsync.
|
|
//
|
|
// The standard implementation uses sequential os.File calls (identical to current
|
|
// code). An optional io_uring implementation (Linux 5.6+, build-tagged) can batch
|
|
// these into fewer syscalls for higher throughput.
|
|
//
|
|
// Usage:
|
|
//
|
|
// bio := batchio.NewStandard() // or batchio.NewIOUring(256) on Linux
|
|
// defer bio.Close()
|
|
// bio.PreadBatch(fd, ops)
|
|
// bio.PwriteBatch(fd, ops)
|
|
// bio.Fsync(fd)
|
|
package batchio
|
|
|
|
import (
|
|
"errors"
|
|
"os"
|
|
)
|
|
|
|
// ErrIOUringUnavailable is returned by NewIOUring when io_uring cannot be
|
|
// initialized (unsupported kernel, seccomp, non-Linux platform, etc.).
|
|
// Callers decide whether to fall back to standard or fail.
|
|
var ErrIOUringUnavailable = errors.New("batchio: io_uring unavailable")
|
|
|
|
// Op represents a single I/O operation: read or write buf at offset.
|
|
type Op struct {
|
|
Buf []byte
|
|
Offset int64
|
|
}
|
|
|
|
// BatchIO batches pread/pwrite/fsync operations.
|
|
// All methods are safe for concurrent use from a single goroutine.
|
|
// Callers must not share a BatchIO across goroutines without external locking.
|
|
type BatchIO interface {
|
|
// PreadBatch reads multiple regions from fd. Each Op.Buf is filled with
|
|
// data from Op.Offset. Returns the first error encountered.
|
|
PreadBatch(fd *os.File, ops []Op) error
|
|
|
|
// PwriteBatch writes multiple regions to fd. Each Op.Buf is written at
|
|
// Op.Offset. Returns the first error encountered.
|
|
PwriteBatch(fd *os.File, ops []Op) error
|
|
|
|
// Fsync issues fdatasync on the file, flushing data to disk without
|
|
// updating file metadata (mtime, size). On non-Linux platforms where
|
|
// fdatasync is unavailable, falls back to fsync. Both backends use
|
|
// identical sync semantics.
|
|
Fsync(fd *os.File) error
|
|
|
|
// LinkedWriteFsync writes buf at offset then issues fdatasync as a pair.
|
|
// On io_uring this is a linked SQE chain (one io_uring_enter syscall).
|
|
// On standard, this is sequential pwrite + fdatasync.
|
|
LinkedWriteFsync(fd *os.File, buf []byte, offset int64) error
|
|
|
|
// Close releases resources (io_uring ring, etc). No-op for standard.
|
|
Close() error
|
|
}
|