Struct h2::Reason

source ·
pub struct Reason(/* private fields */);
Expand description

HTTP/2 error codes.

Error codes are used in RST_STREAM and GOAWAY frames to convey the reasons for the stream or connection error. For example, SendStream::send_reset takes a Reason argument. Also, the Error type may contain a Reason.

Error codes share a common code space. Some error codes apply only to streams, others apply only to connections, and others may apply to either. See [RFC 7540] for more information.

See Error Codes in the spec.

Implementations§

source§

impl Reason

source

pub const NO_ERROR: Reason = _

The associated condition is not a result of an error.

For example, a GOAWAY might include this code to indicate graceful shutdown of a connection.

source

pub const PROTOCOL_ERROR: Reason = _

The endpoint detected an unspecific protocol error.

This error is for use when a more specific error code is not available.

source

pub const INTERNAL_ERROR: Reason = _

The endpoint encountered an unexpected internal error.

source

pub const FLOW_CONTROL_ERROR: Reason = _

The endpoint detected that its peer violated the flow-control protocol.

source

pub const SETTINGS_TIMEOUT: Reason = _

The endpoint sent a SETTINGS frame but did not receive a response in a timely manner.

source

pub const STREAM_CLOSED: Reason = _

The endpoint received a frame after a stream was half-closed.

source

pub const FRAME_SIZE_ERROR: Reason = _

The endpoint received a frame with an invalid size.

source

pub const REFUSED_STREAM: Reason = _

The endpoint refused the stream prior to performing any application processing.

source

pub const CANCEL: Reason = _

Used by the endpoint to indicate that the stream is no longer needed.

source

pub const COMPRESSION_ERROR: Reason = _

The endpoint is unable to maintain the header compression context for the connection.

source

pub const CONNECT_ERROR: Reason = _

The connection established in response to a CONNECT request was reset or abnormally closed.

source

pub const ENHANCE_YOUR_CALM: Reason = _

The endpoint detected that its peer is exhibiting a behavior that might be generating excessive load.

source

pub const INADEQUATE_SECURITY: Reason = _

The underlying transport has properties that do not meet minimum security requirements.

source

pub const HTTP_1_1_REQUIRED: Reason = _

The endpoint requires that HTTP/1.1 be used instead of HTTP/2.

source

pub fn description(&self) -> &str

Get a string description of the error code.

Trait Implementations§

source§

impl Clone for Reason

source§

fn clone(&self) -> Reason

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl Debug for Reason

source§

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

Formats the value using the given formatter. Read more
source§

impl Display for Reason

source§

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

Formats the value using the given formatter. Read more
source§

impl From<Reason> for Error

source§

fn from(src: Reason) -> Error

Converts to this type from the input type.
source§

impl From<Reason> for u32

source§

fn from(src: Reason) -> u32

Converts to this type from the input type.
source§

impl From<u32> for Reason

source§

fn from(src: u32) -> Reason

Converts to this type from the input type.
source§

impl PartialEq for Reason

source§

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

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

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.
source§

impl Copy for Reason

source§

impl Eq for Reason

source§

impl StructuralPartialEq for Reason

Auto Trait Implementations§

§

impl Freeze for Reason

§

impl RefUnwindSafe for Reason

§

impl Send for Reason

§

impl Sync for Reason

§

impl Unpin for Reason

§

impl UnwindSafe for Reason

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> CloneToUninit for T
where T: Copy,

source§

unsafe fn clone_to_uninit(&self, dst: *mut T)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dst. Read more
source§

impl<T> CloneToUninit for T
where T: Clone,

source§

default unsafe fn clone_to_uninit(&self, dst: *mut T)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dst. Read more
source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

source§

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more
source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

source§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T> Instrument for T

source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T> ToString for T
where T: Display + ?Sized,

source§

default fn to_string(&self) -> String

Converts the given value to a String. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
source§

impl<T> WithSubscriber for T

source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more