mirror of
https://github.com/openssl/openssl.git
synced 2024-11-27 05:21:51 +08:00
591b7aef05
objects.pl only looked for a space to see if the name could be used as a C identifier. Improve the test to match the real C rules. Signed-off-by: Rich Salz <rsalz@akamai.com> Reviewed-by: Matt Caswell <matt@openssl.org>
45 lines
1.2 KiB
Plaintext
45 lines
1.2 KiB
Plaintext
objects.txt syntax
|
|
------------------
|
|
|
|
To cover all the naming hacks that were previously in objects.h needed some
|
|
kind of hacks in objects.txt.
|
|
|
|
The basic syntax for adding an object is as follows:
|
|
|
|
1 2 3 4 : shortName : Long Name
|
|
|
|
If Long Name contains only word characters and hyphen-minus
|
|
(0x2D) or full stop (0x2E) then Long Name is used as basis
|
|
for the base name in C. Otherwise, the shortName is used.
|
|
|
|
The base name (let's call it 'base') will then be used to
|
|
create the C macros SN_base, LN_base, NID_base and OBJ_base.
|
|
|
|
Note that if the base name contains spaces, dashes or periods,
|
|
those will be converte to underscore.
|
|
|
|
Then there are some extra commands:
|
|
|
|
!Alias foo 1 2 3 4
|
|
|
|
This just makes a name foo for an OID. The C macro
|
|
OBJ_foo will be created as a result.
|
|
|
|
!Cname foo
|
|
|
|
This makes sure that the name foo will be used as base name
|
|
in C.
|
|
|
|
!module foo
|
|
1 2 3 4 : shortName : Long Name
|
|
!global
|
|
|
|
The !module command was meant to define a kind of modularity.
|
|
What it does is to make sure the module name is prepended
|
|
to the base name. !global turns this off. This construction
|
|
is not recursive.
|
|
|
|
Lines starting with # are treated as comments, as well as any line starting
|
|
with ! and not matching the commands above.
|
|
|