1
1

docs/HACKING.CRYPTO: Improve documentation for autoconf build system

Этот коммит содержится в:
Peter Stuge 2016-11-16 22:20:02 +01:00
родитель 8dc9f4c156
Коммит ddb0c65856

Просмотреть файл

@ -15,29 +15,34 @@ indicates the libssh2 core modules never use the function result.
0) Build system.
Add a new crypto backend to the autotools build system (./configure) as such:
Adding a crypto backend to the autotools build system (./configure) is easy:
* Add one new line to configure.ac:
0.1) Add one new line in configure.ac
m4_set_add([crypto_backends], [newname])
This automatically creates a new --with-crypto=newname option which users can
specify when invoking configure at compile-time to select the new backend.
This automatically creates a --with-crypto=newname option.
* Add a new m4_case stanza to acinclude.m4 within LIBSSH2_CRYPTO_CHECK,
with checks for library availability. A successful check should set
library linking variables. The LIBSSH2_LIB_HAVE_LINKFLAGS macro creates
such a variable automatically if the checked library can be found.
0.2) Add an m4_case stanza to LIBSSH2_CRYPTO_CHECK in acinclude.m4
* Add a Makefile.newname.inc in the top-level directory which sets
CRYPTO_CSOURCES and CRYPTO_HHEADERS to the new backend source files,
and CRYPTO_LTLIBS to the libtool linking parameters for the library, set
e.g. by a LIBSSH2_LIB_HAVE_LINKFLAGS call in LIBSSH2_CRYPTO_CHECK.
This must check for all required libraries, and if found set and AC_SUBST a
variable with the library linking flags. The recommended method is to use
LIBSSH2_LIB_HAVE_LINKFLAGS from LIBSSH2_CRYPTO_CHECK, which automatically
creates and handles a --with-$newname-prefix option and sets an
LTLIBNEWNAME variable on success.
* Add a new block to src/Makefile.am:
if NEWNAME
include ../Makefile.newname.inc
endif
0.3) Create Makefile.newname.inc in the top-level directory
This must set CRYPTO_CSOURCES, CRYPTO_HHEADERS and CRYPTO_LTLIBS.
Set CRYPTO_CSOURCES and CRYPTO_HHEADERS to the new backend source files
and set CRYPTO_LTLIBS to the required library linking parameters, e.g.
$(LTLIBNEWNAME) as generated by by LIBSSH2_LIB_HAVE_LINKFLAGS.
0.4) Add a new block in src/Makefile.am
if NEWNAME
include ../Makefile.newname.inc
endif
1) Crypto library initialization/termination.