commit | 56987e0eefa7be46a7ed000af48ae68e644d0a31 | [log] [tgz] |
---|---|---|
author | James Farrell <jamesfarrell@google.com> | Mon Aug 26 20:42:32 2024 +0000 |
committer | James Farrell <jamesfarrell@google.com> | Mon Aug 26 20:42:32 2024 +0000 |
tree | db963f9e850367297b01c28c21238b045f4b7caf | |
parent | 4491ef675fa074716e48a20505625aef5b0ea08e [diff] |
Migrate 25 crates to monorepo. combine command-fds const-oid coset crc32fast criterion criterion-plot crossbeam-channel crossbeam-deque crossbeam-epoch crossbeam-queue crossbeam-utils darling_core darling_macro dashmap data-encoding der der_derive derive_arbitrary displaydoc document-features downcast-rs drm either enumn Bug: 339424309 Test: treehugger Change-Id: Ice5354745a8f3cae4695622a2393ac2d5f5030b1
Const-friendly implementation of the ISO/IEC Object Identifier (OID) standard as defined in ITU X.660, with support for BER/DER encoding/decoding as well as heapless no_std
(i.e. embedded) environments.
Object Identifiers, a.k.a. OIDs, are an International Telecommunications Union (ITU) and ISO/IEC standard for naming any object, concept, or “thing” with a globally unambiguous persistent name.
The ITU‘s X.660 standard provides the OID specification. Every OID is part of a hierarchical namespace which begins with a root OID, which is either the ITU’s root OID (0), the ISO's root OID (1), or the joint ISO/ITU root OID (2).
The following is an example of an OID, in this case identifying the rsaEncryption
algorithm:
1.2.840.113549.1.1.1
For more information, see: https://en.wikipedia.org/wiki/Object_identifier
This library supports parsing OIDs in const contexts, e.g.:
use const_oid::ObjectIdentifier; pub const MY_OID: ObjectIdentifier = ObjectIdentifier::new_unwrap("1.2.840.113549.1.1.1");
The OID parser is implemented entirely in terms of const fn
and without the use of proc macros.
Additionally, it also includes a const fn
OID serializer, and stores the OIDs parsed from const contexts encoded using the BER/DER serialization (sans header).
This allows ObjectIdentifier
to impl AsRef<[u8]>
which can be used to obtain the BER/DER serialization of an OID, even one declared const
.
Additionally, it impls FromStr
and TryFrom<&[u8]>
and functions just as well as a runtime OID library.
This crate requires Rust 1.57 at a minimum.
We may change the MSRV in the future, but it will be accompanied by a minor version bump.
Licensed under either of:
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.