1ampr-ripd(1)                General Manual Commands               ampr-ripd(1)
2
3
4

NAME

6       ampr-ripd - routing daemon for AMPRNet gateways v2.3
7

SYNOPSIS

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

DESCRIPTION

15       AMPRnet is a RIPv4 Listener and route injector daemon used with AMPRnet
16       gateways.
17

OPTIONS

19       -?, -h Usage info
20
21       -d     Debug mode: no daemonization, verbose output
22
23       -v     More verbose debug output Using this option without debug leaves
24              the console attached
25
26       -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
30       -r     Use a raw listening socket for  systems  with  broken  multicast
31              support
32
33       -i <interface>
34              Tunnel interface to use, defaults to tunl0
35
36       -t <table>
37              Routing table to use, defaults to 'main'
38
39       -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
46       -m <metric>
47              Metric to be used when setting  routes.   This  is  a  numerical
48              value from 0 to 255. Defaults to 0.
49
50       -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
56       -p <password>
57              RIPv2 password, defaults to the current valid password. Use only
58              if the password should ever change
59
60       -f <interface>
61              Interface for RIP forwarding, defaults to none/disabled
62
63       -e <ip>
64              RIP forward destination IP, defaults to 224.0.0.9 if enabled
65
66       -F <interface>
67              Interface for AMPR RIP forwarding, defaults to none/disabled
68
69       -E <ip>
70              AMPR  RIP  forward  destination  IP,  defaults  to  224.0.0.9 if
71              enabled
72
73       -x <system command>
74              Execute this system command after route set/change. If the  com‐
75              mand includes white spaces, use quotes.
76
77       -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
81       -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
91       Observation
92              All routes are created with netlink protocol 44 for easy manage‐
93              ment.
94

SIGNALS

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
100              - On signal SIG_TERM  (exit),  ampr-ripd  will  delete  all  set
101              routes and exit.
102

DEBUG

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

AUTHOR

111       Author: Marius Petrescu, YO2LOJ, <marius@yo2loj.ro>
112

KNOWN ISSUES

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
120       For BGP announced 44net endpoints, only a single subnet may be assigned
121       to a given endpoint.
122
123
124
125ampr-ripd                         April 2017                      ampr-ripd(1)
Impressum