Struct FileHandle 

pub struct FileHandle { /* private fields */ }

A registered file descriptor.

Implementations

impl FileHandle

pub unsafe fn register(fd: i32) -> Result<Self>

Register an open file descriptor with cuFile. fd is typically obtained from std::fs::File::as_raw_fd() on Linux.

Safety

fd must stay open for the lifetime of the returned handle.

pub fn as_raw(&self) -> CUfileHandle_t

pub unsafe fn read( &self, dev_buf: *mut c_void, size: usize, file_offset: i64, buf_offset: i64, ) -> Result<usize>

Read size bytes from file_offset into dev_buf + buf_offset. Returns the number of bytes actually read (negative on failure; we map negatives to Err).

Safety

dev_buf must be a device pointer with at least size bytes live starting at buf_offset.

pub unsafe fn write( &self, dev_buf: *const c_void, size: usize, file_offset: i64, buf_offset: i64, ) -> Result<usize>

Write size bytes from dev_buf + buf_offset into file_offset.

Safety

Same as Self::read.

impl FileHandle

pub unsafe fn read_async( &self, dev_buf: *mut c_void, size_p: *mut usize, file_offset_p: *mut i64, buf_offset_p: *mut i64, bytes_read: *mut isize, stream: *mut c_void, ) -> Result<()>

Queue a stream-ordered read. All parameters point at device / pinned-host memory that cuFile reads when the stream reaches this op (not at call time). bytes_read is written when the op completes.

Safety

All pointers must stay live until the stream reports completion. stream must be previously registered via StreamRegistration::register.

pub unsafe fn write_async( &self, dev_buf: *const c_void, size_p: *mut usize, file_offset_p: *mut i64, buf_offset_p: *mut i64, bytes_written: *mut isize, stream: *mut c_void, ) -> Result<()>

Queue a stream-ordered write.

Safety

Same as Self::read_async.

pub fn use_count(&self) -> Result<i32>

cuFile’s per-handle ref-count (non-zero = handle in use by outstanding I/O).

Trait Implementations

impl Debug for FileHandle

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Drop for FileHandle

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.