Struct SerialNumber

pub struct SerialNumber<P: Profile = Rfc5280> { /* private fields */ }

[RFC 5280 Section 4.1.2.2.] Serial Number

The serial number MUST be a positive integer assigned by the CA to each certificate. It MUST be unique for each certificate issued by a given CA (i.e., the issuer name and serial number identify a unique certificate). CAs MUST force the serialNumber to be a non-negative integer.

Given the uniqueness requirements above, serial numbers can be expected to contain long integers. Certificate users MUST be able to handle serialNumber values up to 20 octets. Conforming CAs MUST NOT use serialNumber values longer than 20 octets.

Note: Non-conforming CAs may issue certificates with serial numbers that are negative or zero. Certificate users SHOULD be prepared to gracefully handle such certificates.

Implementations

impl<P: Profile> SerialNumber<P>

pub const MAX_LEN: Length = _

Maximum length in bytes for a SerialNumber

pub fn new(bytes: &[u8]) -> Result<Self>

Create a new SerialNumber from a byte slice.

The byte slice must represent a positive integer.

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

Borrow the inner byte slice which contains the least significant bytes of a big endian integer value with all leading zeros stripped.

Trait Implementations

impl<P: Clone + Profile> Clone for SerialNumber<P>

fn clone(&self) -> SerialNumber<P>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<P: Debug + Profile> Debug for SerialNumber<P>

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

Formats the value using the given formatter.

impl<'a, P: Profile> DecodeValue<'a> for SerialNumber<P>

fn decode_value<R: Reader<'a>>(reader: &mut R, header: Header) -> Result<Self>

Attempt to decode this message using the provided Reader.

impl Display for SerialNumber

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

Formats the value using the given formatter.

impl<P: Profile> EncodeValue for SerialNumber<P>

fn value_len(&self) -> Result<Length>

Compute the length of this value (sans [Tag]+Length header) when encoded as ASN.1 DER.

fn encode_value(&self, writer: &mut impl Writer) -> Result<()>

Encode value (sans [Tag]+Length header) as ASN.1 DER using the provided Writer.

fn header(&self) -> Result<Header, Error>

where Self: Tagged,

Get the Header used to encode this value.

impl<P: Profile> FixedTag for SerialNumber<P>

const TAG: Tag = <Int as FixedTag>::TAG

ASN.1 tag

impl From<u16> for SerialNumber

fn from(inner: u16) -> SerialNumber

Converts to this type from the input type.

impl From<u32> for SerialNumber

fn from(inner: u32) -> SerialNumber

Converts to this type from the input type.

impl From<u64> for SerialNumber

fn from(inner: u64) -> SerialNumber

Converts to this type from the input type.

impl From<u8> for SerialNumber

fn from(inner: u8) -> SerialNumber

Converts to this type from the input type.

impl From<usize> for SerialNumber

fn from(inner: usize) -> SerialNumber

Converts to this type from the input type.

impl<P: Ord + Profile> Ord for SerialNumber<P>

fn cmp(&self, other: &SerialNumber<P>) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl<P: PartialEq + Profile> PartialEq for SerialNumber<P>

fn eq(&self, other: &SerialNumber<P>) -> bool

Tests for self and other values to be equal, and is used by ==.

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

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

impl<P: PartialOrd + Profile> PartialOrd for SerialNumber<P>

fn partial_cmp(&self, other: &SerialNumber<P>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl ValueOrd for SerialNumber

fn value_cmp(&self, other: &Self) -> Result<Ordering>

Return an Ordering between value portion of TLV-encoded self and other when serialized as ASN.1 DER.

impl<P: Eq + Profile> Eq for SerialNumber<P>

impl<P: Profile> StructuralPartialEq for SerialNumber<P>