Struct SendFile

pub struct SendFile<F, S> { /* private fields */ }

Wrapper around the sendfile system call.

From the sendfile manual ($ man sendfile 2):

sendfile copies data between one file descriptor and another. Because this copying is done within the kernel, sendfile is more efficient than the combination of read and write, which would require transferring data to and from user space.

Platform support

• Android.
• FreeBSD.
• Linux.
• macOS.

Notes

The Future implementation doesn’t implement waking, it is up to the caller to ensure future is polled again once the socket is ready to receive more data.

Implementations

impl<F, S> SendFile<F, S>

pub fn into_inner(self) -> (F, S)

Retrieve the file and socket.

pub fn written(&self) -> usize

Returns the number of bytes written.

Trait Implementations

impl<F: Debug, S: Debug> Debug for SendFile<F, S>

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

Formats the value using the given formatter.

impl<F, S> Future for SendFile<F, S>

where F: AsRawFd + Unpin, S: AsRawFd + Unpin,

type Output = Result<(), Error>

The number of bytes written, or an I/O error.

fn poll(self: Pin<&mut Self>, _: &mut Context<'_>) -> Poll<Self::Output>

Attempts to resolve the future to a final value, registering the current task for wakeup if the value is not yet available.