Struct BdxDownloadResponder 

pub struct BdxDownloadResponder<'a> { /* private fields */ }

The responding side of a download: a peer requested a download (sent a ReceiveInit), so this node becomes the Sender. Inspect the request via fd, then reply to obtain a BdxWriter, or reject it.

Implementations

impl<'a> BdxDownloadResponder<'a>

pub async fn accept( exchange: Exchange<'a>, ) -> Result<BdxDownloadResponder<'a>, Error>

Receive the incoming ReceiveInit on exchange, holding it until reply/reject.

pub fn fd(&self) -> &[u8]

The file designator the initiator requested (borrowed from the held init).

pub fn start_offset(&self) -> u64

The byte offset of the file from which the initiator asked the transfer to begin (0 for a transfer from the start): the sender should start sending from here, and advertise the remaining length in reply. Reject with StartOffsetNotSupported if the offset cannot be honored.

pub async fn reply<'b>( self, buf: &'b mut [u8], length: Option<u64>, ) -> Result<BdxWriter<'a, 'b>, Error>

Accept the transfer and start sending, staging blocks in the (non-empty) caller-provided buffer buf (its length bounds the block size). length advertises a definite transfer length (enabling the receiver’s progress reporting) when known.

pub async fn reject(self, status: BdxStatus) -> Result<(), Error>

Reject the transfer with the given status (e.g. FileDesignatorUnknown).