Emploi: bmxd

2023-03-05T19:51:34Z

bmxd

Neue Seite

==== BMX 0.7-freifunk-dresden [md5:7c12c568db112e354a99f8e8d6386fdc] (compatibility version 10)

== Hilfe ==
bmxd -h

Usage: bmxd [LONGOPT[=[-]VAL]] | [-SHORTOPT[SHORTOPT...] [[-]VAL]] ...
e.g. bmxd dev=eth0 dev=wlan0 # to start daemon on interface eth0 and wlan0
e.g. bmxd -cid8 # to connect and show configured options and connevtivity

=== General configuration options: ===
--help, -h
help

--version, -v
show version

--test
test remaining args and provide feedback about projected success (without applying them)

--no_fork, -d <VAL> def: -1 range: [ 0 ... 11 ]
print debug information instead of forking to background

--debug, -d <VAL> def: -1 range: [ 0 ... 11 ]
show debug information:
0 : system
1 : originators
2 : gateways
3 : changes
4 : verbose changes
5 : profiling (depends on -DDEBUG_MALLOC -DMEMORY_USAGE -DPROFILE_DATA)
8 : details
9 : announced networks and interfaces
10 : links
11 : testing

--runtime_dir <DIRECTORY>
set runtime DIR of pid, socket,... - default: /var/run/bmx (must be defined before --connect).

--loop_mode, -l
put client daemon in loop mode to periodically refresh debug information

--connect, -c
set client mode. Connect and forward remaining args to main routing daemon

=== System and policy-routing options: ===
--base_port <VAL> def: 4305 range: [ 1025 ... 60000 ]
set udp ports

--prio_rules_offset <VAL> def: 6400 range: [ 3 ... 32765 ]
set preferences for iproute2-style rules to rt_table (see: man ip)

--rt_table_offset <VAL> def: 64 range: [ 0 ... 252 ]
set bmx routing-table offset (iproute2 style, see: man ip)

--throw_rules <VAL> def: 1 range: [ 0 , 1 ]
disable/enable default throw rules

--prio_rules <VAL> def: 1 range: [ 0 , 1 ]
disable/enable default priority rules

--no_policy_routing, -n
disable policy routing (throw and priority rules)

--metric <VAL> def: 0 range: [ 0 ... 2147483647 ]
set non-zero metric for all bmx routes

--lo_rule <VAL> def: 1 range: [ 0 , 1 ]
disable/enable autoconfiguration of lo rule

--network <NETADDR>/<PREFIX-LENGTH>
only accept OGM from network

--gateway_tunnel_network <NETADDR>/<PREFIX-LENGTH>
set network used by gateway nodes

--options, -i
inform about configured options

--dbg_mute_timeout <VAL> def: 100000 range: [ 0 ... 10000000 ]
set timeout in ms for muting frequent messages

--throw <NETADDR>/<PREFIX-LENGTH>
do NOT route packets matching src or dst IP range(s) into gateway tunnel or announced networks
/network, /n <NETADDR>
specify network of throw rule
/netmask, /m <NETMASK>
specify network of throw rule

--pedantic_cleanup <VAL> def: 0 range: [ 0 , 1 ]
disable/enable pedantic cleanup of system configuration (like ip_forward,..)
at program termination. Its generally safer to keep this disabled to not mess up
with other routing protocols

=== Protocol options: ===
--status
show status

--routes
show routes

--links
show links

--originators
show originators

--dev <interface-name>
add or change device or its configuration, options for specified device are:
/ttl, /t <VAL> def: 50 range: [ 1 ... 63 ]
set TTL of generated OGMs
/clone, /c <VAL> def: 200 range: [ 0 ... 400 ]
broadcast OGMs per ogm-interval with given probability (e.g. 200% will broadcast the same OGM twice)
/hide, /h <VAL> def: 0 range: [ 0 , 1 ]
disable/enable hiding of OGMs generated to non link-neighboring nodes. Default for non-primary interfaces
/linklayer, /l <VAL> def: 0 range: [ 0 ... 2 ]
manually set device type for linklayer specific optimization (0=loopback, 1=lan, 2=wlan)

--interfaces
show configured interfaces

--link_window_size <VAL> def: 20 range: [ 1 ... 250 ]
set link window size (LWS) for link-quality calculation (link metric)

--link_lounge_size <VAL> def: 2 range: [ 0 ... 10 ]
set local LLS buffer size to artificially delay OGM processing for ordered link-quality calulation

--path_window_size <VAL> def: 100 range: [ 10 ... 250 ]
set path window size (PWS) for end2end path-quality calculation (path metric)

--path_lounge_size <VAL> def: 8 range: [ 0 ... 31 ]
set default PLS buffer size to artificially delay my OGM processing for ordered path-quality calulation

--path_hysteresis <VAL> def: 0 range: [ 0 ... 50 ]
use hysteresis to delay route switching to alternative next-hop neighbors with better path metric

--fast_path_window_size <VAL> def: 20 range: [ 2 ... 250 ]

--fast_path_hysteresis <VAL> def: 1 range: [ 0 ... 50 ]
use hysteresis to delay fast-route switching to alternative next-hop neighbors with a recently extremely better path metric

--fast_path_faktor <VAL> def: 150 range: [ 100 ... 1000 ]
configure threshold faktor for dead-path detection

--drop_two_hop_loops <VAL> def: 0 range: [ 0 , 1 ]
drop OGMs received via two-hop loops

--asymmetric_exp <VAL> def: 1 range: [ 0 ... 3 ]
ignore OGMs (rcvd via asymmetric links) with TQ^<val> to radically reflect asymmetric-links

--asocial_device <VAL> def: 0 range: [ 0 , 1 ]
disable/enable asocial mode for devices unwilling to forward other nodes' traffic

--ogm_broadcasts <VAL> def: 200 range: [ 0 ... 400 ]
broadcast OGMs per ogm-interval for wireless devices with
given probability [%] (eg 200% will broadcast the same OGM twice)

--asymmetric_weight <VAL> def: 100 range: [ 0 ... 100 ]
ignore OGMs (rcvd via asymmetric links) with given probability [%] to better reflect asymmetric-links

--hop_penalty <VAL> def: 1 range: [ 0 ... 100 ]
ignore OGMs with given probability [%] to better reflect path-hop distance

--lateness_penalty <VAL> def: 1 range: [ 0 ... 100 ]
penalize non-first rcvd OGMs

--purge_timeout <VAL> def: 100 range: [ 10 ... 864000 ]
timeout in seconds for purging stale originators

--dad_timeout <VAL> def: 100 range: [ 1 ... 3600 ]
duplicate address (DAD) detection timout in seconds

--ttl, -t <VAL> def: 50 range: [ 1 ... 63 ]
set time-to-live (TTL) for OGMs of primary interface

--flush_all
purge all neighbors and routes on the fly

--script <script-file>
called on gw selection

=== Scheduling options: ===
--ogm_interval, -o <VAL> def: 1000 range: [ 50 ... 100000 ]
set interval in ms with which new originator message (OGM) are send

--ogi_power_save <VAL> def: 50 range: [ 50 ... 100000 ]
enable power-saving feature by setting increased OGI when no other nodes are in range

--aggreg_interval <VAL> def: 500 range: [ 35 ... 4000 ]
set aggregation interval (SHOULD be smaller than the half of your and others OGM interval)

--udp_data_size <VAL> def: 256 range: [ 24 ... 1020 ]
set preferred udp-data size for send packets

--simulate_cleanup <VAL> def: 0 range: [ 0 , 1 ]
simulate paranoia and cleanup_all for testing

=== Gateway (GW) and tunnel options: ===
--routing_class, -r <VAL> def: 0 range: [ 0 ... 3 ]
control GW-client functionality:
0 -> no tunnel, no default route (default)
1 -> permanently select fastest GW according to GW announcment (deprecated)
2 -> permanently select most stable GW accoridng to measurement
3 -> dynamically switch to most stable GW

--gateway_hysteresis <VAL> def: 2 range: [ 1 ... 100 ]
set number of additional rcvd OGMs before changing to more stable GW (only relevant for -r3 GW-clients)

--preferred_gateway, -p <ADDRESS>
permanently select specified GW if available

--gateway_class, -g <VAL>[/VAL]
set GW up- & down-link class (e.g. 5mbit/1024kbit)

--tun_persist <VAL> def: 1 range: [ 0 , 1 ]
disable/enable ioctl TUNSETPERSIST for GW tunnels (disabling was required for openVZ emulation)

--gateways
show currently available gateways

Bmxd - Versionsgeschichte

Emploi: bmxd