1
0
mirror of https://github.com/kakwa/uts-server synced 2024-11-11 12:08:54 +01:00

explicitly mention BUNDLE_CIVETWEB has a developpment/testing option

This commit is contained in:
kakwa 2017-01-30 19:21:58 +01:00
parent 4b40fd97a7
commit 55dea707b9
2 changed files with 27 additions and 7 deletions

View File

@ -48,12 +48,17 @@ Some use cases:
* time-stamp log files at rotation time. * time-stamp log files at rotation time.
* time-stamp file at upload to prove it was delivered in due time or not. * time-stamp file at upload to prove it was delivered in due time or not.
Quick Start Quick (and dirty) Testing
----------- -------------------------
Here a few steps to quickly trying out uts-server, for production setup, please compile civetweb externally and create proper CA and certificates:
.. sourcecode:: bash .. sourcecode:: bash
# Building with civetweb embedded (will recover civetweb from github). # Building with civetweb embedded (will recover civetweb from github).
# Note: the BUNDLE_CIVETWEB option is only here for fast testing purpose
# The recommended way to deploy uts-server in production is to build civetweb
# separatly and to link against it.
$ cmake . -DBUNDLE_CIVETWEB=ON $ cmake . -DBUNDLE_CIVETWEB=ON
$ make $ make

View File

@ -12,10 +12,10 @@ List of dependencies uts-server relies on to run:
Build dependencies Build dependencies
------------------ ------------------
List of dependencies needed to build civetweb: List of dependencies needed to build uts-server:
* cmake * `CMake <https://cmake.org/>`_
* either gcc or clang * either `gcc <https://gcc.gnu.org/>`_ or `clang <https://clang.llvm.org/>`_
Compilation Compilation
=========== ===========
@ -28,12 +28,14 @@ uts-server is compiled using cmake:
$ cmake . $ cmake .
$ make $ make
# If civetweb is not present # If civetweb is not present.
# this will get the proper tag of civetweb from upstream and compile it # this will get the master branch of civetweb from upstream and compile it.
# Only for developpment/testing purposes
$ cmake . -DBUNDLE_CIVETWEB=ON $ cmake . -DBUNDLE_CIVETWEB=ON
$ make $ make
# Compile with debug flags # Compile with debug flags
# Only for developpment/testing purposes
$ cmake . -DDEBUG=ON $ cmake . -DDEBUG=ON
$ make $ make
@ -43,3 +45,16 @@ uts-server is compiled using cmake:
# add -DDL_LINK=ON and/or -DGCC_S_LINK=ON) # add -DDL_LINK=ON and/or -DGCC_S_LINK=ON)
$ cmake . -DSTATIC=ON # -DDL_LINK=ON -DGCC_S_LINK=ON $ cmake . -DSTATIC=ON # -DDL_LINK=ON -DGCC_S_LINK=ON
$ make $ make
.. warning::
The BUNDLE_CIVETWEB exists only for developpment/testing purposes.
Please compile civetweb externally for building a production binary.
Using this option outside of developpment/testing is a bad idea for the
following reasons:
* having an external download in a build process is a bad idea
* recovering the master branch ensures that the build may break randomly
* a build proccess should be reproductible which is not the case with this option