| | |
|---|
| | | ####################################### |
|---|
| | | C++ software protection with Licensecc |
|---|
| | | ####################################### |
|---|
| | | Copy protect, restrict the usage of your C++ software with a license file using this library. |
|---|
| | | ############## |
|---|
| | | Licensecc |
|---|
| | | ############## |
|---|
| | | *Copy protection, licensing library and license generator for Windows and Linux.* |
|---|
| | | |
|---|
| | | |c11|_ |License|_ |unstable|_ |BuildStatus|_ |CodacyBadge|_ |codecov|_ |forum|_ |
|---|
| | | |c11|_ |License|_ |unstable|_ |TravisBuild|_ |GithubCI|_ |CodacyBadge|_ |codecov|_ |forum|_ |
|---|
| | | |
|---|
| | | .. |c11| image:: https://img.shields.io/badge/c%2B%2B-11-blue.svg |
|---|
| | | .. _c11: https://en.wikipedia.org/wiki/C%2B%2B#Standardization |
|---|
| | |
|---|
| | | .. _unstable: http://github.com/badges/stability-badges |
|---|
| | | .. |License| image:: https://img.shields.io/badge/License-BSD%203--Clause-blue.svg |
|---|
| | | .. _License: ttps://opensource.org/licenses/BSD-3-Clause |
|---|
| | | .. |BuildStatus| image:: https://travis-ci.org/open-license-manager/open-license-manager.svg?branch=develop |
|---|
| | | .. _BuildStatus: https://travis-ci.org/open-license-manager/open-license-manager |
|---|
| | | .. |CodacyBadge| image:: https://api.codacy.com/project/badge/Grade/62d6e1bb22d648bd85b6f3bc344a545a |
|---|
| | | .. _CodacyBadge: https://www.codacy.com/manual/gcontini/open-license-manager?utm_source=github.com&utm_medium=referral&utm_content=open-license-manager/open-license-manager&utm_campaign=Badge_Grade |
|---|
| | | .. |codecov| image:: https://codecov.io/gh/open-license-manager/open-license-manager/branch/develop/graph/badge.svg |
|---|
| | | .. _codecov: https://codecov.io/gh/open-license-manager/open-license-manager |
|---|
| | | .. |issues| image:: https://img.shields.io/github/issues/open-license-manager/open-license-manager |
|---|
| | | .. _issues: http://github.com/open-license-manager/open-license-manager/issues |
|---|
| | | .. |TravisBuild| image:: https://travis-ci.org/open-license-manager/licensecc.svg?branch=develop |
|---|
| | | .. _TravisBuild: https://travis-ci.org/open-license-manager/licensecc |
|---|
| | | .. |GithubCI| image:: https://github.com/open-license-manager/licensecc/workflows/Github_CI/badge.svg |
|---|
| | | .. _GithubCI: https://github.com/open-license-manager/licensecc/actions |
|---|
| | | .. |CodacyBadge| image:: https://app.codacy.com/project/badge/Grade/81a1f6bc15014618934fc5fab4d3c206 |
|---|
| | | .. _CodacyBadge: https://www.codacy.com/gh/open-license-manager/licensecc/dashboard?utm_source=github.com&utm_medium=referral&utm_content=open-license-manager/licensecc&utm_campaign=Badge_Grade |
|---|
| | | .. |codecov| image:: https://codecov.io/gh/open-license-manager/licensecc/branch/develop/graph/badge.svg?token=vdrBBzX6Rl |
|---|
| | | .. _codecov: https://codecov.io/gh/open-license-manager/licensecc |
|---|
| | | .. |issues| image:: https://img.shields.io/github/issues/open-license-manager/licensecc |
|---|
| | | .. _issues: http://github.com/open-license-manager/licensecc/issues |
|---|
| | | .. |forum| image:: https://img.shields.io/badge/forum-licensecc-blue.svg?style=flat |
|---|
| | | .. _forum: https://groups.google.com/d/forum/licensecc |
|---|
| | | .. _forum: https://github.com/open-license-manager/licensecc/discussions |
|---|
| | | |
|---|
| | | Protect the software you develop from unauthorized copies, limit the usage in time, to a specific set of |
|---|
| | | machines, or prevent the usage in virtualized environments. It is an open source license management system that helps to keep your |
|---|
| | | software closed :smirk: . Among the other features the most notable one is: if it runs on a "real hardware" |
|---|
| | | machines, or prevent the usage in virtualized environments. `Licensecc` is an open source license management system |
|---|
| | | that helps to keep your software closed |:smirk:| . |
|---|
| | | |
|---|
| | | Among the other features the most notable one is: if it runs on a "real hardware" (not a container/vm) |
|---|
| | | it can generate a signature of that hardware and report if the signature doesn't match, because for instance |
|---|
| | | the software has been copied to another pc. |
|---|
| | | the software has been copied to another place. |
|---|
| | | |
|---|
| | | A comprehensive :ref:`list of features <analysis/features:Features>`, and their status is available in the project wiki. |
|---|
| | | |
|---|
| | | If you're experiencing problems, or you just need informations you can't find here in the documentation, |
|---|
| | | please contact us on the `user forum <https://groups.google.com/forum/#!forum/licensecc>`_ (hosted on Google), we'll be happy to help. |
|---|
| | | |
|---|
| | | License (BSD) |
|---|
| | | ************** |
|---|
| | |
|---|
| | | |
|---|
| | | Project Structure |
|---|
| | | ******************* |
|---|
| | | The software is made by 3 main sub-components: |
|---|
| | | The software is made by 4 main sub-components: |
|---|
| | | |
|---|
| | | * ``licensecc`` : the C++ library with a C api (the part you have to integrate in your software) with minimal (or no) external dependencies. This is the project you're currently looking at. |
|---|
| | | * ``lccinspector`` : a license debugger to be sent to the final customer to diagnose licensing problems or for calculating the pc hash before issuing the license. |
|---|
| | | * ``licensecc`` : the C++ library with a C api (the part you have to integrate in your software) with minimal external dependencies. (github project `licensecc <https://github.com/open-license-manager/licensecc>`_ ) |
|---|
| | | * ``lccinspector`` : a license debugger to be sent to the final customer to diagnose licensing problems or for calculating the hardware id before issuing the license. |
|---|
| | | * ``lccgen`` : a license generator (github project `lcc-license-generator`_ ) to initialize the library and generate the licenses. |
|---|
| | | * ``examples`` : usage samples (github project `examples <https://github.com/open-license-manager/examples>`_ ). |
|---|
| | | |
|---|
| | | .. _lcc-license-generator: https://github.com/open-license-manager/lcc-license-generator |
|---|
| | | |
|---|
| | |
|---|
| | | * tools : Cmake(>3.6), git, make/ninja(linux) |
|---|
| | | * libraries : If target is Linux Openssl is required. Windows depends only on system libraries. Boost is necessary to build license generator and to run the tests but it's NOT a dependency of the final `licensecc` library. |
|---|
| | | |
|---|
| | | For a complete list of dependencies and supported environments see the :ref:`development/Dependencies:Dependencies` section. |
|---|
| | | Clone the project. It has submodules, don't forget the `--recursive` option. |
|---|
| | | For a complete list of dependencies and supported environments see the :ref:`dependencies <development/Dependencies:Dependencies>` section. |
|---|
| | | Clone the project. |
|---|
| | | |
|---|
| | | .. NOTE:: |
|---|
| | | It has submodules, don't forget the `--recursive` option. |
|---|
| | | |
|---|
| | | .. code-block:: console |
|---|
| | | |
|---|
| | | git clone --recursive https://github.com/open-license-manager/open-license-manager.git |
|---|
| | | cd open-license-manager/ |
|---|
| | | git clone --recursive https://github.com/open-license-manager/licensecc.git |
|---|
| | | cd licensecc/ |
|---|
| | | cd build |
|---|
| | | |
|---|
| | | Build on Linux |
|---|
| | |
|---|
| | | make |
|---|
| | | make install |
|---|
| | | |
|---|
| | | Build on Windows (with MSVC 2015) |
|---|
| | | Build on Windows (with MSVC 2017) |
|---|
| | | ================================== |
|---|
| | | |
|---|
| | | .. code-block:: console |
|---|
| | | |
|---|
| | | cmake .. -G "Visual Studio 14 2015 Win64" -DBOOST_ROOT="{Folder where boost is}" -DCMAKE_INSTALL_PREFIX=../install |
|---|
| | | cmake .. -G "Visual Studio 16 2017 Win64" -DBOOST_ROOT="{Folder where boost is}" -DCMAKE_INSTALL_PREFIX=../install |
|---|
| | | cmake --build . --target install --config Release |
|---|
| | | |
|---|
| | | Cross compile with MINGW on Linux |
|---|
| | |
|---|
| | | |
|---|
| | | .. _examples: https://github.com/open-license-manager/examples |
|---|
| | | |
|---|
| | | Branches and status |
|---|
| | | ********************* |
|---|
| | | |
|---|
| | | * On branch ``master`` there is the 'stable' 2.0.0 version. |
|---|
| | | * On branch ``develop`` there is the upcoming 2.1.0 version that corresponds to this documentation. This version is under development and has not been extensively used/tested. However we encourage users to download and use this one. |
|---|
| | | |
|---|
| | | How to contribute |
|---|
| | | ******************** |
|---|
| | | |
|---|
| | |
|---|
| | | |
|---|
| | | We use `GitFlow`_ (or at least a subset of it). Remember to install the gitflow git plugin and use ``develop`` as default branch for your pull requests. |
|---|
| | | |
|---|
| | | .. _forums: https://groups.google.com/forum/#!forum/licensecc |
|---|
| | | .. _issue system: https://github.com/open-license-manager/open-license-manager/issues |
|---|
| | | .. _contribution guidelines: https://github.com/open-license-manager/open-license-manager/blob/develop/CONTRIBUTING.md |
|---|
| | | .. _forums: https://github.com/open-license-manager/licensecc/discussions |
|---|
| | | .. _issue system: https://github.com/open-license-manager/licensecc/issues |
|---|
| | | .. _contribution guidelines: https://github.com/open-license-manager/licensecc/blob/develop/CONTRIBUTING.md |
|---|
| | | .. _GitFlow: https://datasift.github.io/gitflow/IntroducingGitFlow.html |
|---|
| | | |
|---|
| | | * :ref:`genindex` |
|---|
| | |
|---|
| | | :caption: Miscellaneous: |
|---|
| | | |
|---|
| | | other/* |
|---|
| | | |
|---|
| | | .. meta:: |
|---|
| | | :description: open source license manager, copy protection library in C++. |
|---|
| | | :keywords: c++, open source, licensing software, copy protection, license manager, hardware identifcation |
|---|
| | | |
|---|
| | | .. title:: |
|---|
| | | C++ copy protection library |
|---|
