kris/boringssl
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
dc9194f78b
boringssl/crypto/obj
History
David Benjamin dc9194f78b Fix a bug in obj_dat.pl and add basic crypto/obj tests. 
It's not possible to encode an OID with only one component, so some of
the NIDs do not have encodings. The logic to actually encode OIDs checks
for this (before calling der_it), but not the logic to compute the
sorted OID list.

Without this, OBJ_obj2nid, when given an empty OID, returns something
arbitrary based on the binary search implementation instead of
NID_undef.

Change-Id: Ib68bae349f66eff3d193616eb26491b6668d4b0a
Reviewed-on: https://boringssl-review.googlesource.com/7752
Reviewed-by: Steven Valdez <svaldez@google.com>
Reviewed-by: David Benjamin <davidben@google.com>
2016-04-26 15:19:26 +00:00
..
CMakeLists.txt Fix a bug in obj_dat.pl and add basic crypto/obj tests. 2016-04-26 15:19:26 +00:00
obj_dat.h Fix a bug in obj_dat.pl and add basic crypto/obj tests. 2016-04-26 15:19:26 +00:00
obj_dat.pl Fix a bug in obj_dat.pl and add basic crypto/obj tests. 2016-04-26 15:19:26 +00:00
obj_mac.num Rename NID_x25519 to NID_X25519. 2016-03-07 15:48:51 +00:00
obj_test.cc Fix a bug in obj_dat.pl and add basic crypto/obj tests. 2016-04-26 15:19:26 +00:00
obj_xref.c Inital import. 2014-06-20 13:17:32 -07:00
obj_xref.h Renegerate OID outputs. 2014-12-04 22:13:50 +00:00
obj_xref.pl Add documentation for the OID scripts. 2014-12-04 22:12:26 +00:00
obj_xref.txt Inital import. 2014-06-20 13:17:32 -07:00
obj.c Remove the func parameter to OPENSSL_PUT_ERROR. 2015-07-16 02:02:37 +00:00
objects.pl Rename obj_mac.h to nid.h and make it a multiply-includable header. 2016-03-31 20:45:35 +00:00
objects.txt Rename NID_x25519 to NID_X25519. 2016-03-07 15:48:51 +00:00
README Rename obj_mac.h to nid.h and make it a multiply-includable header. 2016-03-31 20:45:35 +00:00

README 

OID information is generated via a series of perl scripts. In order, the full
list of commands to run are:

        perl objects.pl objects.txt obj_mac.num ../../include/openssl/nid.h
        perl obj_dat.pl ../../include/openssl/nid.h obj_dat.h
        perl obj_xref.pl obj_mac.num obj_xref.txt > obj_xref.h

objects.txt contains the list of all built-in OIDs. It is processed by
objects.pl to output obj_mac.num and nid.h. obj_mac.num is the list of NID
values for each OID. This is an input/output parameter so NID values are stable
across regenerations. nid.h is the header which defines macros for all the
built-in OIDs in C.

nid.h is read by obj_dat.pl to generate obj_dat.h. obj_dat.h contains the
ASN1_OBJECTs corresponding to built-in OIDs themselves along with lookup tables
for search by short name, OID, etc.

obj_mac.num and obj_xref.txt are read by obj_xref.pl to generate
obj_xref.h. obj_xref.txt links signature OIDs to corresponding public key
algorithms and digests. obj_xref.h contains lookup tables for querying this
information in both directions.

Dependency graph:

                        objects.txt
                            |
                            V
                       [objects.pl] <--+
                         /      \      |
                        V        V     |
                     nid.h     obj_mac.num  obj_xref.txt
                      |              \      /
                      V               V    V
                 [obj_dat.pl]      [obj_xref.pl]
                      |                  |
                      V                  V
                  obj_dat.h         obj_xref.h