git ssb

1
Installation
2
************
3
4
NNCP should run on any POSIX-compatible operating system with file
5
systems supporting directory and filename’s length up to 57 characters.
6
7
   NNCP is written on Go (https://golang.org/) programming language and
8
you have to install Go compiler (1.7+ version is highly recommended).
9
_Make_ (BSD and GNU ones are fine) is recommended for convenient
10
building.  Texinfo (https://www.gnu.org/software/texinfo/) is used for
11
building documentation.
12
13
   In general you must get *note the tarball: Tarballs, check its *note
14
integrity and authenticity: Integrity. and run ‘make’.  Look for general
15
and *note platform-specific: Platform-specific. installation
16
instructions.
17
18
Prepared tarballs
19
=================
20
21
You can obtain releases source code prepared tarballs on
22
<http://www.nncpgo.org/>.
23
Tarballs integrity check
24
========================
25
26
You *have to* check downloaded archives integrity and verify their
27
signature to be sure that you have got trusted, untampered software.
28
For integrity and authentication of downloaded binaries The GNU Privacy
29
Guard (https://www.gnupg.org/) is used.  You must download signature
30
(‘.sig’) provided with the tarball.
31
32
   For the very first time you need to import signing public key.  It is
33
provided below, but it is better to check alternative resources with it.
34
35
pub   rsa2048/0x2B25868E75A1A953 2017-01-10
36
      92C2 F0AE FE73 208E 46BF  F3DE 2B25 868E 75A1 A953
37
uid   NNCP releases <releases at nncpgo dot org>
38
39
   • % gpg --keyserver hkp://keys.gnupg.net/ --recv-keys 0x2B25868E75A1A953
40
     % gpg --auto-key-locate dane --locate-keys releases at nncpgo dot org
41
     % gpg --auto-key-locate wkd --locate-keys releases at nncpgo dot org
42
     % gpg --auto-key-locate pka --locate-keys releases at nncpgo dot org
43
44
   • -----BEGIN PGP PUBLIC KEY BLOCK-----
45
46
     mQENBFh0lv0BCADmquHdyjr1Mr8VHRNxzipHxmgbdK3CGJL1yzb1ntj7zbJl5UnQ
47
     71cxQ968pYPOBYqsA3oqtURAXzVL6qPGajHM+OXKB5OOjmt7vbd3xP5sBCWOjlrq
48
     S7yWx5ffuXf++tCGiXGkG7q+4zmXJUBuaot0fQ5ebBVLzVVIMv2C4hArZFZtK+YZ
49
     GkrIU+S49joe4qeUdCIQ1KpEB2m774QFxG05fMMys9L60wkL6ZgAy0GadkvCI5jD
50
     Xj5nRxa0fn+T/pcOWCpy7ka4rCR0rKCCNB8ARvpDnknTu2S9cxnWy1uOMv8JQpTb
51
     nY27vprdkH9aykdPl/7uHL/X1hutFxE8FOAjABEBAAG0I05OQ1AgcmVsZWFzZXMg
52
     PHJlbGVhc2VzQG5uY3Bnby5vcmc+iQFXBBMBCABBFiEEksLwrv5zII5Gv/PeKyWG
53
     jnWhqVMFAlh0lv0CGwMMCwoJDQgMBwsDBAECBxUKCQgLAwIFFgIBAwACHgECF4AA
54
     CgkQKyWGjnWhqVOaBggAqWywYtUddljHpiR/SK8uiYjSl8/F4QemM+tsu66GW56Y
55
     ZB7VFOxNFcpEfSnWwH61cJ5lCuRRgyjJcIOptzbKbO+nvYQEtXznjQYoJMLnPqAa
56
     2UPI5Seaijx8sXQWzYRq2Vzl9KUDBlhB2y4jZD4CFC1V29NRbWuPUajZn8UiZzFT
57
     IUR/gjvtYQozF0jN8Sevs+oGAN1tqK5kYo8YXEeL+3NCVUJkqFmBtFVxrxzty4cE
58
     ozgKpXzt9bi10a1hthKluWcZD6Zc4InqQhAGXb2JB2a5wRTs8CkJtHadwBOD3JEt
59
     HjfhBAoZMYmhOBeHt87AG5OjFNRIOJ2rRacnRDA3E4h1BBARCAAdFiEEz2Domlkj
60
     HnbiY2QirhqBCeSYV+8FAlh0lxYACgkQrhqBCeSYV+9i1QD/bdLAY67nf5giI/wQ
61
     i6K7v6PTPFwG6TtG6jj68Cy13RgA/iMuKw7niLwyPWRKzWcMIG1YhVyCNCgKQvFL
62
     vdr6yKbN
63
     =R8E0
64
     -----END PGP PUBLIC KEY BLOCK-----
65
66
   Then you could verify tarballs signature:
67
% gpg --verify nncp-0.1.tar.xz.sig nncp-0.1.tar.xz
68
Platform-specific instructions
69
==============================
70
71
General installation instructions
72
---------------------------------
73
74
% wget http://www.nncpgo.org/download/nncp-0.1.tar.xz
75
% wget http://www.nncpgo.org/download/nncp-0.1.tar.xz.sig
76
% gpg --verify nncp-0.1.tar.xz.sig nncp-0.1.tar.xz
77
% tar xf nncp-0.1.tar.xz
78
% make -C nncp-0.1 all
79
80
   There is ‘install’ target respecting ‘DESTDIR’.  It will install
81
binaries and info-documentation.
82
83
FreeBSD installation instructions
84
---------------------------------
85
86
Look *note here: Integrity. for finding public keys for tarball
87
authentication.
88
89
# pkg install go
90
91
   follow *note general: General. installation instructions
92
93
# make -C nncp-0.1 install
94
95
Ubuntu installation instructions
96
--------------------------------
97
98
Look *note here: Integrity. for finding public keys for tarball
99
authentication.
100
101
Ubuntu 16.04
102
103
     # apt install golang
104
105
     follow *note general: General. installation instructions
106
107
     # make -C nncp-0.1 install PREFIX=/usr
108
109
Ubuntu 14.04
110
111
     # apt-get install golang-1.6
112
     % wget http://www.nncpgo.org/download/nncp-0.1.tar.xz
113
     % wget http://www.nncpgo.org/download/nncp-0.1.tar.xz.sig
114
     % gpg --verify nncp-0.1.tar.xz.sig nncp-0.1.tar.xz
115
     % tar xf nncp-0.1.tar.xz
116
     % PATH=/usr/lib/go-1.6/bin:$PATH make -C nncp-0.1 all
117
     # make -C nncp-0.1 install PREFIX=/usr
118
119
Development source code
120
=======================
121
122
Development source code contains the latest version of the code.  It may
123
be buggy.  It does not contain compiled documentation and dependent
124
libraries source code.  Because of that, it is recommended for porters
125
to use *note tarballs: Tarballs. instead.
126
127
   You can obtain it by cloning Git (http://git-scm.com/) repository
128
(http://git.cypherpunks.ru/cgit.cgi/nncp.git/log/) and fetching
129
dependent libraries source code as git submodules:
130
131
% git clone git://git.cypherpunks.ru/nncp.git nncp
132
% cd nncp
133
% git checkout develop
134
% git submodule update --init
135
136
   Github.com mirror exists: <https://github.com/stargrave/nncp>.
137
138