1ampr-ripd(1) General Manual Commands ampr-ripd(1)
2
6 ampr-ripd - routing daemon for AMPRNet gateways v2.3
7
9 ampr-ripd [-?|-h] [-d] [-v] [-s] [-r] [-i <interface>] [-a <ip|host‐
10 name|subnet>[,<ip|hostname|subnet>...]] [-p <password>] [-m <metric>]
11 [-w <window>] [-f <interface>] [-e <ip>] [-F <interface>] [-E <ip>] [-x
12 <system command>] [-g <gateway>]
13
15 AMPRnet is a RIPv4 Listener and route injector daemon used with AMPRnet
16 gateways.
17
19 -?, -h Usage info
20 -d Debug mode: no daemonization, verbose output
22 -v More verbose debug output Using this option without debug leaves
24 the console attached
25 -s Save routes to /var/lib/ampr-ripd/encap.txt (encap format), if
27 this file exists, it will be loaded on startup regardless of
28 this option
29 -r Use a raw listening socket for systems with broken multicast
31 support
32 -i <interface>
34 Tunnel interface to use, defaults to tunl0
35 -t <table>
37 Routing table to use, defaults to 'main'
38 -a <ip>[,<ip>...] Comma separated list of IPs, hostnames or ampr
40 subnets to be ignored. Subnets can be in full network/mask
41 (e.g. 44.182.20.0/24) or encap (e.g. 44.182.20/24) format, but
42 MUST match an entry in the RIP broadcast If a hostname is used,
43 its IP will be re-resolved 30 sec after every RIP broadcast.
44 The List contains local interface IPs by default
45 -m <metric>
47 Metric to be used when setting routes. This is a numerical
48 value from 0 to 255. Defaults to 0.
49 -w <window>
51 Sets the TCP window size to a given value (defaults to 840).
52 This is needed since IP over AX.25 connections have small TCP
53 window size. A value of 0 diables setting the window size (not
54 recommended, default value should be ok)
55 -p <password>
57 RIPv2 password, defaults to the current valid password. Use only
58 if the password should ever change
59 -f <interface>
61 Interface for RIP forwarding, defaults to none/disabled
62 -e <ip>
64 RIP forward destination IP, defaults to 224.0.0.9 if enabled
65 -F <interface>
67 Interface for AMPR RIP forwarding, defaults to none/disabled
68 -E <ip>
70 AMPR RIP forward destination IP, defaults to 224.0.0.9 if
71 enabled
72 -x <system command>
74 Execute this system command after route set/change. If the com‐
75 mand includes white spaces, use quotes.
76 -g <gateway>
78 Gateway for direct 44net connections. Accepts an gateway IP or
79 an interface name. If not set, it will be auto-detected.
80 -L <callsign@locator>
82 This parameter will enable the sending of a callsign@locator
83 string (actually any string) to my home gateway
84 (udp:44.182.21.1:59001). The string will be sent at starup, and
85 then every 5 minutes. On termination, a "shutdown" string will
86 be sent. On HUP, the string will be sent immediately and the
87 cycle restarted. The purpose of this option is to allow the
88 construction of a dynamic map of all ampr-ripd gateways for vis‐
89 ual display. If the parameter is not set, no data will be sent.
90 Observation
92 All routes are created with netlink protocol 44 for easy manage‐
93 ment.
94
96 - On signal SIG_HUP, ampr-ripd will delete all set routes, but
97 will remain active, so routes will be set again on next received
98 RIPv2 set, and the saved encap file updated.
99 - On signal SIG_TERM (exit), ampr-ripd will delete all set
101 routes and exit.
102
104 With the default debug level, using the -d option, the daemon will stay
105 in the foreground and allow you to find the RIPv2 password if needed
106 (see the find_pass.sh shell script). To have full debug output, it has
107 to be compiled with -D HAVE_DEBUG or by uncommenting the right DOPT
108 line.
109
111 Author: Marius Petrescu, YO2LOJ, <marius@yo2loj.ro>
112
114 When using other table than 'main', interogating the routes via netlink
115 does not work properly. This means that on any update, the route is
116 deleted and then recreated, even if it is already set correctly. This
117 should be no problem since this happen only at startup on encap loading
118 and on route change.
119 For BGP announced 44net endpoints, only a single subnet may be assigned
121 to a given endpoint.
122ampr-ripd April 2017 ampr-ripd(1)