File: README

package info (click to toggle)
uacme 1.8.0-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 1,708 kB
  • sloc: ansic: 20,622; sh: 1,798; makefile: 85
file content (81 lines) | stat: -rw-r--r-- 2,400 bytes parent folder | download
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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
uacme README 
Copyright (C) 2019-2026 Nicola Di Lieto <nicola.dilieto@gmail.com>

uacme is a client for the RFC8555 ACMEv2 protocol. Additional
information can be found at <https://github.com/ndilieto/uacme>
and the manual pages at <https://ndilieto.github.io/uacme/uacme.html>
and <https://ndilieto.github.io/uacme/ualpn.html>


README
------
This README is targeted for users of the software who build from
sources but do not necessarily develop.


COMPILATION
-----------
A typical command sequence for building uacme is shown below.
A complete list of options available for configure can be found
by running './configure --help'.

    cd uacme-<version>
    ./configure
    make
    sudo make install

The software depends on libcurl and one of GnuTLS, OpenSSL or
mbedTLS

 * libcurl: the multiprotocol file transfer library 
    https://curl.haxx.se/libcurl
 * GnuTLS: for cryptographic algorithms
    https://gnutls.org
 * OpenSSL: alternative to GnuTLS
    https://www.openssl.org
 * mbedTLS: lightweight alternative to GnuTLS
    https://tls.mbed.org


DOCUMENTATION
-------------
See README.md and the manual pages included in the distribution
(uacme.1 or uacme.1.html and ualpn.1 or ualpn.1.html)


LICENSING
---------
See the COPYING file for licensing information


BUGS
----
If you believe you have found a bug, please create a new issue
at https://github.com/ndilieto/uacme/issues with any applicable
information. 

Applicable information would include why the issue is a uacme bug (if
not readily apparent), output from 'uname -a', the version of uacme
being used, a stack trace if available ('bt full' if under gdb or
valgrind output), and perhaps a network trace.  Vague queries or
piecemeal messages are difficult to act upon and don't help the
development effort.


PATCHES
-------
Patches are welcome and encouraged. Patches can be submitted by 
creating a pull request at https://github.com/ndilieto/uacme/pulls

When submitting patches, please be sure to use sources from the git
repository, and preferrably from the master branch.  To create a patch
for the project from a local git repository, please use the following
commands. 'uacme' should be the local directory of a previous git clone.

    cd uacme
    git add the-file-you-modified.c another-file.c
    git commit the-file-you-modified.c another-file.c

For more information on use of Git, visit http://git-scm.com/