Enum nbdkit::ThreadModel

#[repr(i32)]
pub enum ThreadModel {
    SerializeConnections,
    SerializeAllRequests,
    SerializeRequests,
    Parallel,
}

A plugin’s maximum thread safety model

Variants

SerializeConnections

Only a single handle can be open at any time, and all requests happen from one thread.

SerializeAllRequests

Multiple handles can be open at the same time, but requests are serialized so that for the plugin as a whole only one open/read/write/close (etc) request will be in progress at any time.

This is a useful setting if the library you are using is not thread-safe. However performance may not be good.

SerializeRequests

Multiple handles can be open and multiple data requests can happen in parallel. However only one request will happen per handle at a time (but requests on different handles might happen concurrently).

Parallel

Multiple handles can be open and multiple data requests can happen in parallel (even on the same handle). The server may reorder replies, answering a later request before an earlier one.

All the libraries you use must be thread-safe and reentrant, and any code that creates a file descriptor should atomically set FD_CLOEXEC if you do not want it accidentally leaked to another thread’s child process. You may also need to provide mutexes for fields in your connection handle.

Trait Implementations

impl Clone for ThreadModel

fn clone(&self) -> ThreadModel

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ThreadModel

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

Formats the value using the given formatter.

impl PartialEq<ThreadModel> for ThreadModel

fn eq(&self, other: &ThreadModel) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for ThreadModel

impl Eq for ThreadModel

impl StructuralEq for ThreadModel

impl StructuralPartialEq for ThreadModel