chiark / gitweb /
test-example: Provide a new-style public key set for site outside
[secnet.git] / test-example / README
1 This directory contains some files useful for ad-hoc tests.
2 With these it is possible to run a test of secnet on a Linux host
3 even if that Linux host does not have another working network connection.
4
5 The keys here are (obviously) public.  They were generated like this:
6  ssh-keygen -C inside@example.com -f test-example/inside.key -t rsa1 -b 1024
7  ssh-keygen -C outside@example.com -f test-example/outside.key -t rsa1 -b 1024
8  # edit sites to paste {inside,outside}.key.pub into pubkey lines
9  base64 <inside.key >inside.key.b64
10  base64 <outside.key >outside.key.b64
11
12 To run the test:
13  Run the makefile:
14   make -C test-example/
15  In one window, as root
16   ./secnet -dvnc test-example/inside.conf
17  And in another
18   ./secnet -dvnc test-example/outside.conf
19  Then in a third
20   ping -I secnet-test-i 172.18.232.2 
21  
22 For running under valgrind memcheck, do something like this:
23   valgrind --num-callers=40 --gen-suppressions=yes --db-attach=yes \
24     --leak-check=full --suppressions=test-example/memcheck.suppressions \
25     ./secnet -dvnc test-example/outside.conf
26 NB that --num-callers is needed as secnet's stack can be deep.
27
28 The config file outside-unshare.conf can be used on Linux in
29 conjunction with test-example/fake-userv and a built checkout of
30 userv-utils.git to run the "outside" copy of secnet in a new "network
31 namespace".
32
33
34
35 Everything in this directory is part of secnet.  See README (in the
36 directory above) for full list of copyright holders.
37
38 secnet is free software; you can redistribute it and/or modify it
39 under the terms of the GNU General Public License as published by
40 the Free Software Foundation; either version 3 of the License, or
41 (at your option) any later version.
42
43 secnet is distributed in the hope that it will be useful, but
44 WITHOUT ANY WARRANTY; without even the implied warranty of
45 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
46 General Public License for more details.
47
48 You should have received a copy of the GNU General Public License
49 version 3 along with secnet; if not, see
50 https://www.gnu.org/licenses/gpl.html.