Enum x509_cert::ext::pkix::name::DirectoryString

pub enum DirectoryString {
    PrintableString(PrintableString),
    TeletexString(TeletexString),
    Utf8String(String),
}

DirectoryString as defined in RFC 5280 Section 4.2.1.4.

ASN.1 structure for DirectoryString is below.

DirectoryString ::= CHOICE {
    teletexString           TeletexString (SIZE (1..MAX)),
    printableString         PrintableString (SIZE (1..MAX)),
    universalString         UniversalString (SIZE (1..MAX)),
    utf8String              UTF8String (SIZE (1..MAX)),
    bmpString               BMPString (SIZE (1..MAX))
}

Further, RFC 5280 Section 4.2.1.4 states:

The DirectoryString type is defined as a choice of PrintableString,
TeletexString, BMPString, UTF8String, and UniversalString.  CAs
conforming to this profile MUST use either the PrintableString or
UTF8String encoding of DirectoryString, with two exceptions.  When
CAs have previously issued certificates with issuer fields with
attributes encoded using TeletexString, BMPString, or
UniversalString, then the CA MAY continue to use these encodings of
the DirectoryString to preserve backward compatibility.  Also, new
CAs that are added to a domain where existing CAs issue certificates
with issuer fields with attributes encoded using TeletexString,
BMPString, or UniversalString MAY encode attributes that they share
with the existing CAs using the same encodings as the existing CAs
use.

The implication of the above paragraph is that PrintableString and UTF8String are the new types and the other types are legacy. Until the need arises, we only support PrintableString and UTF8String.

Variants

PrintableString(PrintableString)

TeletexString(TeletexString)

Utf8String(String)

Trait Implementations

impl<'__der_lifetime> Choice<'__der_lifetime> for DirectoryString

fn can_decode(tag: Tag) -> bool

Is the provided Tag decodable as a variant of this CHOICE?

impl Clone for DirectoryString

fn clone(&self) -> DirectoryString

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for DirectoryString

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

Formats the value using the given formatter.

impl<'__der_lifetime> Decode<'__der_lifetime> for DirectoryString

fn decode<R: Reader<'__der_lifetime>>(reader: &mut R) -> Result<Self>

Attempt to decode this message using the provided decoder.

fn from_der(bytes: &'a [u8]) -> Result<Self, Error>

Parse Self from the provided DER-encoded byte slice.

impl EncodeValue for DirectoryString

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

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

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

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

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

where Self: Tagged,

Get the Header used to encode this value.

impl PartialEq for DirectoryString

fn eq(&self, other: &DirectoryString) -> 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 Tagged for DirectoryString

fn tag(&self) -> Tag

Get the ASN.1 tag that this type is encoded with.

impl ValueOrd for DirectoryString

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 Eq for DirectoryString

impl StructuralEq for DirectoryString

impl StructuralPartialEq for DirectoryString