forked from CESNET/libnetconf
-
Notifications
You must be signed in to change notification settings - Fork 0
/
INSTALL
117 lines (75 loc) · 2.79 KB
/
INSTALL
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
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
Please note, that master branch of our git repository is supposed to be
an unstable branch. For stable code, please switch to the one of the version
branches such as 0.10.x.
Prerequisites
=============
You will need to have installed the following software. Header
files (-dev or -devel packages) of the following libraries are
also needed to compile libnetconf.
- libxml2
http://xmlsoft.org
- libssh
Version 0.6.4 or greater is recomended.
http://www.libssh.org
To disable usage of the libssh, use:
$ ./configure --disable-libssh
In such a case, libnetconf will use standalone ssh(1) client
application to connect NETCONF client to the NETCONF server.
ssh(1) is available as a part of the OpenSSH.
- DBus
libdbus version 1.0.0 or greater
http://dbus.freedesktop.org
DBus is required by the NETCONF Notifications subsystem. If the
Notifications support is switched off, DBus is no more needed:
$ ./configure --disable-notifications
These items are conditional.
- OpenSSL
Always the newest version is recommended, to ensure maximum
security.
https://www.openssl.org
OpenSSL is required only if compiling with either
$ ./configure --enable-tls
or
$ ./configure --enable-dnssec
or both.
- dnsval (libval)
Version 2.0 or greater
http://dnssec-tools.org
Required when compiling with
$ ./configure --enable-dnssec
to enable DNSSEC data retrieval and validation - automatic server SSH
key acceptance. In that case, the following is performed once a client
tries to connect to a server:
- DNSSEC query is sent with the server hostname asking for SSHFP entries
- then any answers are carefully checked and then compared to
the key fingerprint presented by the server
- only if an exact match is found and DNSSEC was used for the fingerprint
retrieval is user input skipped and key is accepted (but it is NOT added
into the known_hosts file!)
The remaining items are optional.
- doxygen
Used to generate documentation from the source code.
Version 1.8.0 or greater is recommended.
http://www.doxygen.org
- rpmbuild
Used to build RPM package.
http://www.rpm.org
Building / Installation
=======================
To install libnetconf with default options:
$ ./configure
$ make
# make install
This way the library will be installed in /usr/local/lib and
/usr/local/include respectively. Configure can have many
options specified, to show them all use:
$ ./configure --help
Contact
=======
The homepage is at
https://github.com/CESNET/libnetconf
To get the very latest source code from the GIT repository, use:
$ git clone https://github.com/CESNET/libnetconf.git
Problem reports, questions, suggestions as well as success stories
are welcome. Feel free to contact us via the project issue tracker:
https://github.com/CESNET/libnetconf/issues