openssl/crypto/objects
Viktor Dukhovni 1bfd76b3af Update generator copyright year.
Some Travis builds appear to fail because generated objects get
2019 copyrights now, and the diff complains.

Reviewed-by: Bernd Edlinger <bernd.edlinger@hotmail.de>
Reviewed-by: Matt Caswell <matt@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/7969)
2019-01-07 13:53:24 -05:00
..
build.info unified build scheme: add build.info files 2016-02-01 12:46:58 +01:00
o_names.c Make OBJ_NAME case insensitive. 2018-09-04 07:35:45 +10:00
obj_dat.c Add missing error code when alloc-return-null 2018-04-26 12:27:46 -04:00
obj_dat.h make update 2019-01-03 09:26:34 +00:00
obj_dat.pl Update generator copyright year. 2019-01-07 13:53:24 -05:00
obj_err.c Add missing error code when alloc-return-null 2018-04-26 12:27:46 -04:00
obj_lcl.h Copyright consolidation 04/10 2016-05-17 14:24:46 -04:00
obj_lib.c Remove parentheses of return. 2017-10-18 16:05:06 +01:00
obj_mac.num Add OIDs for HMAC SHA512/224 and HMAC SHA512/256. 2018-08-01 11:58:39 +10:00
obj_xref.c Harmonize use of sk_TYPE_find's return value. 2018-08-07 08:56:54 +02:00
obj_xref.h make update 2019-01-03 09:26:34 +00:00
obj_xref.txt Integrate X448 and Ed448 into libcrypto 2018-03-02 10:14:31 +00:00
objects.pl Update generator copyright year. 2019-01-07 13:53:24 -05:00
objects.txt Change the OID references for X25519, X448, ED25519 and ED448 from the draft RFC 2018-08-10 08:41:00 +10:00
objxref.pl Update generator copyright year. 2019-01-07 13:53:24 -05:00
README Many spelling fixes/typo's corrected. 2017-11-11 19:03:10 -05:00

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 converted 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.