Debian Codegraph @

external/boringssl/crypto/obj/README

raw
1 OID information is generated via a series of perl scripts. In order, the full
2 list of commands to run are:
3
4 perl objects.pl objects.txt obj_mac.num ../../include/openssl/nid.h
5 perl obj_dat.pl ../../include/openssl/nid.h obj_dat.h
6 perl obj_xref.pl obj_mac.num obj_xref.txt > obj_xref.h
7
8 objects.txt contains the list of all built-in OIDs. It is processed by
9 objects.pl to output obj_mac.num and nid.h. obj_mac.num is the list of NID
10 values for each OID. This is an input/output parameter so NID values are stable
11 across regenerations. nid.h is the header which defines macros for all the
12 built-in OIDs in C.
13
14 nid.h is read by obj_dat.pl to generate obj_dat.h. obj_dat.h contains the
15 ASN1_OBJECTs corresponding to built-in OIDs themselves along with lookup tables
16 for search by short name, OID, etc.
17
18 obj_mac.num and obj_xref.txt are read by obj_xref.pl to generate
19 obj_xref.h. obj_xref.txt links signature OIDs to corresponding public key
20 algorithms and digests. obj_xref.h contains lookup tables for querying this
21 information in both directions.
22
23 Dependency graph:
24
25 objects.txt
26 |
27 V
28 [objects.pl] <--+
29 / \ |
30 V V |
31 nid.h obj_mac.num obj_xref.txt
32 | \ /
33 V V V
34 [obj_dat.pl] [obj_xref.pl]
35 | |
36 V V
37 obj_dat.h obj_xref.h