kris/boringssl
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
afbc63fc2f
boringssl/crypto/obj
History
Adam Langley 2b2d66d409 Remove string.h from base.h. 
Including string.h in base.h causes any file that includes a BoringSSL
header to include string.h. Generally this wouldn't be a problem,
although string.h might slow down the compile if it wasn't otherwise
needed. However, it also causes problems for ipsec-tools in Android
because OpenSSL didn't have this behaviour.

This change removes string.h from base.h and, instead, adds it to each
.c file that requires it.

Change-Id: I5968e50b0e230fd3adf9b72dd2836e6f52d6fb37
Reviewed-on: https://boringssl-review.googlesource.com/3200
Reviewed-by: David Benjamin <davidben@chromium.org>
Reviewed-by: Adam Langley <agl@google.com>
2015-02-02 19:14:15 +00:00
..
CMakeLists.txt Change CMakeLists.txt to two-space indent. 2015-01-28 16:37:10 -08:00
obj_dat.h Renegerate OID outputs. 2014-12-04 22:13:50 +00:00
obj_dat.pl Add documentation for the OID scripts. 2014-12-04 22:12:26 +00:00
obj_error.c Move public headers to include/openssl/ 2014-07-14 22:42:18 +00:00
obj_mac.num Restore obj_mac.num from upstream. 2014-12-04 22:12:55 +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 string.h from base.h. 2015-02-02 19:14:15 +00:00
objects.pl Keep the obj_mac.h license header round-tripping. 2014-12-04 22:13:17 +00:00
objects.txt Inital import. 2014-06-20 13:17:32 -07:00
README Add documentation for the OID scripts. 2014-12-04 22:12:26 +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/obj_mac.h
        perl obj_dat.pl ../../include/openssl/obj_mac.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 obj_mac.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. obj_mac.h is the header which defines macros for all the
built-in OIDs in C.

obj_mac.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     |
                  obj_mac.h    obj_mac.num  obj_xref.txt
                      |              \      /
                      V               V    V
                 [obj_dat.pl]      [obj_xref.pl]
                      |                  |
                      V                  V
                  obj_dat.h         obj_xref.h