Enum RequestErrorCode 

#[repr(u64)]
pub enum RequestErrorCode {
    InternalError = 0,
    Unauthorized = 1,
    Timeout = 2,
    NotSupported = 3,
    MalformedAuthToken = 4,
    ExpiredAuthToken = 5,
    DoesNotExist = 16,
    InvalidRange = 17,
    MalformedTrack = 18,
    Uninterested = 32,
    PrefixOverlap = 48,
    InvalidJoiningRequestId = 50,
    UnknownStatusInRange = 51,
}

REQUEST_ERROR Codes (draft-15 Section 13.3.2, defined in Section 9.8).

Carried in the REQUEST_ERROR message, which draft-15 sends in response to any request (SUBSCRIBE, FETCH, PUBLISH, SUBSCRIBE_NAMESPACE, PUBLISH_NAMESPACE, TRACK_STATUS). Most codepoints have identical meanings across request types, but Section 9.8 lists the registry in four bands, separated by which side of the session sends the code:

• 0x0 through 0x5 carry the same meaning whichever request they answer.
• 0x10 through 0x12 are for use by the publisher. They can appear in response to SUBSCRIBE, FETCH, TRACK_STATUS and SUBSCRIBE_NAMESPACE, unless otherwise noted.
• 0x20 is for use by the subscriber. It can appear in response to PUBLISH or PUBLISH_NAMESPACE, unless otherwise noted.
• 0x30 and above can only be used in response to one message type.

The draft assigns no greasing range in this registry, and leaves 0x31 unassigned between PREFIX_OVERLAP and INVALID_JOINING_REQUEST_ID.

Variants

InternalError = 0

INTERNAL_ERROR — an implementation specific or generic error occurred.

Unauthorized = 1

UNAUTHORIZED — the subscriber is not authorized to perform the requested action on the given track.

Timeout = 2

TIMEOUT — the subscription could not be completed before an implementation specific timeout. For example, a relay could not establish an upstream subscription within the timeout.

NotSupported = 3

NOT_SUPPORTED — the endpoint does not support the type of request.

MalformedAuthToken = 4

MALFORMED_AUTH_TOKEN — invalid Auth Token serialization during registration (see Section 9.2.1.1).

ExpiredAuthToken = 5

EXPIRED_AUTH_TOKEN — authorization token has expired (Section 9.2.1.1).

DoesNotExist = 16

DOES_NOT_EXIST — the track or namespace is not available at the publisher.

InvalidRange = 17

INVALID_RANGE — in response to SUBSCRIBE or FETCH, specified Filter or range of Locations cannot be satisfied.

MalformedTrack = 18

MALFORMED_TRACK — in response to a FETCH, a relay publisher detected the track was malformed (see Section 2.4.2).

Uninterested = 32

UNINTERESTED — the subscriber is not interested in the track or namespace.

PrefixOverlap = 48

PREFIX_OVERLAP — in response to SUBSCRIBE_NAMESPACE, the namespace prefix overlaps with another SUBSCRIBE_NAMESPACE in the same session.

InvalidJoiningRequestId = 50

INVALID_JOINING_REQUEST_ID — in response to a Joining FETCH, the referenced Request ID is not an Established Subscription. Established is the subscription state named in Section 5.1.

UnknownStatusInRange = 51

UNKNOWN_STATUS_IN_RANGE — in response to a FETCH, the requested range contains an object with unknown status.

Implementations

impl RequestErrorCode

pub const ALL: &[RequestErrorCode]

Every REQUEST_ERROR code draft-15 assigns, in ascending wire order.

This is the set Self::from_u64 accepts, written out so that it can be enumerated: nothing can iterate an enum’s variants, so a caller that wants the registry has to be handed it. Writing it down is also what lets a test state its claims about the registry itself rather than about the range some sweep happens to reach.

pub fn from_u64(v: u64) -> Option<Self>

Convert a raw u64 to a RequestErrorCode, if draft-15 defines it.

pub fn as_u64(self) -> u64

Return the raw u64 value of this error code.

Trait Implementations

impl Clone for RequestErrorCode

fn clone(&self) -> RequestErrorCode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for RequestErrorCode

impl Debug for RequestErrorCode

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

Formats the value using the given formatter.

impl Eq for RequestErrorCode

impl PartialEq for RequestErrorCode

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for RequestErrorCode