c/libxlsxwriter
1
0
Fork 0
mirror of https://github.com/jmcnamara/libxlsxwriter synced 2025-03-28 21:13:14 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add support for using MD5 functions from OpenSSL.

Browse Source 
Feature request #335
This commit is contained in:
John McNamara 2021-05-28 15:40:05 +01:00
parent 925a147fc1
commit 7eacdb47f9
2 changed files with 29 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
License.txt
View File

@ -165,8 +165,12 @@ has the following licence:
(This is a heavily cut-down "BSD license".)
Note, the MD5 library is used to avoid including duplicate image files in the
xlsx file. If this functionality isn't required it is possible to compile
libxlsxwriter without this library by passing `USE_NO_MD5=1` to make.
xlsx file. If you don't want to use this code, and the additional licence, you
can use OpenSSL's MD5 functions instead by passing `USE_OPENSSL_MD5=1` to
make. If this functionality isn't required it is possible to compile
libxlsxwriter without image deduplication by passing `USE_NO_MD5=1` to make.
See also @ref gsg_md5.
Next: @ref changes
*/

23
docs/src/getting_started.dox
View File

@ -618,6 +618,29 @@ The following external guide shows how to [Build libxlsxwriter inside
Qt-Creator for Windows](https://github.com/jmcnamara/libxlsxwriter/issues/270)
with step by step instructions.
@section gsg_md5 MD5 functionality for handling duplicate images
Libxlsxwriter uses a an MD5 digest to avoid including duplicate image files in
the xlsx file. By default it uses a third party library, [Openwall
MD5](https://openwall.info/wiki/people/solar/software/public-domain-source-code/md5),
which is a fast portable implementation of the MD5 Algorithm and which uses
the same function prototypes as OpenSSL MD5 digest. See @ref license.
The Openwall MD5 code is included in the libxlsxwriter repo and compiled in by
default. If you don't want to use this code, and the additional license, you
can use OpenSSL's MD5 functions dynamically by passing `USE_OPENSSL_MD5=1` to
make.
make USE_OPENSSL_MD5=1
This requires that you have the OpenSSL development libraries installed and on
paths known to your compiler.
If this MD5 functionality isn't required it is possible to compile
libxlsxwriter without image de-duplication by passing `USE_NO_MD5=1` to make.
make USE_NO_MD5=1
@section gsg_minizip Linking against system minizip
Libxlsxwriter uses the `minizip` component of [Zlib](http://www.zlib.net) to