X-Git-Url: https://git.teslayout.com/public/public/public/?a=blobdiff_plain;f=README.md;h=32f17c68a0a86f31ffab8638885f33b49fb04559;hb=refs%2Fheads%2Fwithout_sql;hp=841195846d5d6989adabff2f59608ddef14ef1ad;hpb=c68d53c4623b63ee20014a7eae0b9759a490c90e;p=anna.git diff --git a/README.md b/README.md index 8411958..32f17c6 100644 --- a/README.md +++ b/README.md @@ -11,79 +11,96 @@ ANNA is a complete suite of tools and resources to build proffesional applicatio Based on GIT, hosted on http://redmine.teslayout.com You could use my pre-commit specific template if you want to do some basic checkings (i.e. - astyle code processing): Execute './scr/git/use-pre-commit.sh' + astyle code processing): Execute './scripts/git/use-pre-commit.sh' -## Documentation -Execute 'scons doc' +## Build project -## Unit tests +This is a CMake based building suite. +Install cmake: -Execute 'scons test' + > sudo apt-get install cmake -## Examples +And then generate the makefiles from project root directory: -Execute 'scons example' to generate example binaries + > cmake . -## Install +You could specify type of build, 'Debug' or 'Release', for example: -Execute 'scons install' -(install-include-and-lib and install-example, are another aliases for selective installation) + > cmake -DCMAKE_BUILD_TYPE=Debug . + > cmake -DCMAKE_BUILD_TYPE=Release . -## Uninstall +## Clean project -Execute 'scons uninstall' + > make clean +## Change the compilers + > cmake -DCMAKE_CXX_COMPILER=/usr/bin/g++ -DCMAKE_C_COMPILER=/usr/bin/gcc + or + > cmake -DCMAKE_CXX_COMPILER=/usr/bin/clang++ -DCMAKE_C_COMPILER=/usr/bin/clang ## Some basic ubuntu requirements -### Scons python-based building suite: - sudo apt-get install scons - ### OpenSSL: - sudo apt-get install libssl-dev + > sudo apt-get install libssl-dev ### Gnome XML: - sudo apt-get install libxml2-dev + > sudo apt-get install libxml2-dev ### OpenLDAP: - sudo apt-get install libldap2-dev + > sudo apt-get install libldap2-dev -### MySql: - sudo apt-get install libmysqlclient-dev +### Pcap: + > sudo apt-get install libpcap-dev -### Oracle: - https://help.ubuntu.com/community/Oracle%20Instant%20Client - Set 'ORACLE_HOME' environment variable in your profile, i.e.: - export ORACLE_HOME=/usr/lib/oracle/12.1/client64/ +### Google Test Framework: - Be sure to create in that directory, a link to oracle includes, - for example: + > sudo apt-get install libgtest-dev - @:/usr/lib/oracle/12.1/client64$ ls -lrt - total 8 - drwxr-xr-x 2 root root 4096 Feb 28 15:59 bin - drwxr-xr-x 2 root root 4096 Feb 28 15:59 lib - lrwxrwxrwx 1 root root 33 Feb 28 16:07 include -> /usr/include/oracle/12.1/client64 + Note that this package only install source files. You have to compile the + code yourself to create the necessary library files. These source files + should be located at /usr/src/gtest. Browse to this folder and use cmake + to compile the library: - The alternative is to edit SConstruct file directly to set - oracle includes directory. + > cd /usr/src/gtest + > sudo cmake CMakeLists.txt + > sudo make + + Copy or symlink libgtest.a and libgtest_main.a to your /usr/lib folder: + > sudo cp *.a /usr/lib -### Oracle-OpenLDAP conflict: - as usual, Oracle is doing things very bad. Move the ldap.h from oracle includes, i.e.: +## Documentation - cd /usr/include/oracle/12.1/client64 - sudo mv ldap.h ldap.h.orig +Execute 'make doc' -### Boost: - Although the more i use, the more i dislike, this suite is included (ambition to learn - new things...): + > cd docs/doxygen + > tree -L 1 - sudo apt-get install libboost-dev - sudo apt-get install libboost-test-dev + . + ├── Doxyfile + ├── html + ├── latex + └── man - Development module is no longer needed, but still unit testing is done through boost. - + +## Unit tests + +Execute 'make test' + +## Install + +To install headers, libraries, and examples, execute: + + > sudo make install + +Optionally you could specify another prefix for installation: + + > cmake -DMY_OWN_INSTALL_PREFIX=$HOME/anna-deploy + > make install + +## Uninstall + + > cat install_manifest.txt | sudo xargs rm