aboutsummaryrefslogtreecommitdiff
path: root/README.adoc
blob: 5e09599011e659b81bb587e800289dd72b0c5d88 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
pdf-simple-sign
===============
:compact-option:

'pdf-simple-sign' is a simple open source PDF signer intended for documents
generated by Cairo.  As such, it currently comes with some restrictions:

 * the document may not have any forms or signatures already, as they will be
   overwitten
 * the document may not employ cross-reference streams, or must constitute
   a hybrid-reference file at least
 * the document may not be newer than PDF 1.6 already, or it will get downgraded
   to that version
 * the signature may take at most 4 kilobytes as a compile-time limit,
   which should be enough space even for one intermediate certificate

The signature is attached to the first page and has no appearance.

I don't aim to extend the functionality any further.  The project is fairly
self-contained and it should be easy to grasp and change to suit to your needs.

Building
--------
Build dependencies: Meson, a C++11 compiler, pkg-config +
Runtime dependencies: libcrypto

 $ git clone https://github.com/pjanouch/pdf-simple-sign.git
 $ cd pdf-simple-sign
 $ meson builddir
 $ cd builddir
 $ ninja

Usage
-----

 $ ./pdf-simple-sign document.pdf document.signed.pdf KeyAndCerts.p12 password

Contributing and Support
------------------------
Use this project's GitHub to report any bugs, request features, or submit pull
requests.  If you want to discuss this project, or maybe just hang out with
the developer, feel free to join me at irc://irc.janouch.name, channel #dev.

Bitcoin donations: 12r5uEWEgcHC46xd64tt3hHt9EUvYYDHe9

License
-------
'pdf-simple-sign' is written by Přemysl Janouch <p.janouch@gmail.com>.

You may use the software under the terms of the ISC license, the text of which
is included within the package, or, at your option, you may relicense the work
under the MIT or the Modified BSD License, as listed at the following site:

http://www.gnu.org/licenses/license-list.html