pub enum WhenOptionUnsupportedByProxy {
Error,
Forward,
}
Expand description
Proxy Unsafe or Safe-to-Forward and NoCacheKey
generated from RFC7252 section 5.4.2
In addition to an option being marked as critical or elective, options are also classified based on how a proxy is to deal with the option if it does not recognize it. For this purpose, an option can either be considered Unsafe to forward (UnSafe is set) or Safe-to- Forward (UnSafe is clear).
In addition, for an option that is marked Safe-to-Forward, the option number indicates whether or not it is intended to be part of the Cache-Key (Section 5.6) in a request. If some of the NoCacheKey bits are 0, it is; if all NoCacheKey bits are 1, it is not (see Section 5.4.6).
Note: The Cache-Key indication is relevant only for proxies that do not implement the given option as a request option and instead rely on the Unsafe/Safe-to-Forward indication only. For example, for ETag, actually using the request option as a part of the Cache-Key is grossly inefficient, but it is the best thing one can do if ETag is not implemented by a proxy, as the response is going to differ based on the presence of the request option. A more useful proxy that does implement the ETag request option is not using ETag as a part of the Cache-Key.
NoCacheKey is indicated in three bits so that only one out of eight codepoints is qualified as NoCacheKey, leaving seven out of eight codepoints for what appears to be the more likely case.
Proxy behavior with regard to these classes is defined in Section 5.7.
Variants§
Error
This option /must be/ processed & understood by proxies and may not be forwarded blindly to their destination.
Corresponds to the option being “UnSafe” to forward in strict CoAP terms
Forward
This option may not be processed & understood by proxies and may be forwarded blindly to their destination.
Corresponds to the option being “SafeToForward” in strict CoAP terms
Trait Implementations§
source§impl Clone for WhenOptionUnsupportedByProxy
impl Clone for WhenOptionUnsupportedByProxy
source§fn clone(&self) -> WhenOptionUnsupportedByProxy
fn clone(&self) -> WhenOptionUnsupportedByProxy
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moresource§impl Debug for WhenOptionUnsupportedByProxy
impl Debug for WhenOptionUnsupportedByProxy
source§impl Ord for WhenOptionUnsupportedByProxy
impl Ord for WhenOptionUnsupportedByProxy
source§fn cmp(&self, other: &WhenOptionUnsupportedByProxy) -> Ordering
fn cmp(&self, other: &WhenOptionUnsupportedByProxy) -> Ordering
1.21.0 · source§fn max(self, other: Self) -> Selfwhere
Self: Sized,
fn max(self, other: Self) -> Selfwhere
Self: Sized,
source§impl PartialEq<WhenOptionUnsupportedByProxy> for WhenOptionUnsupportedByProxy
impl PartialEq<WhenOptionUnsupportedByProxy> for WhenOptionUnsupportedByProxy
source§fn eq(&self, other: &WhenOptionUnsupportedByProxy) -> bool
fn eq(&self, other: &WhenOptionUnsupportedByProxy) -> bool
self
and other
values to be equal, and is used
by ==
.source§impl PartialOrd<WhenOptionUnsupportedByProxy> for WhenOptionUnsupportedByProxy
impl PartialOrd<WhenOptionUnsupportedByProxy> for WhenOptionUnsupportedByProxy
source§fn partial_cmp(&self, other: &WhenOptionUnsupportedByProxy) -> Option<Ordering>
fn partial_cmp(&self, other: &WhenOptionUnsupportedByProxy) -> Option<Ordering>
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read more