From 9d0a1ea9b70508c97ea54ae2735bec9712b4863b Mon Sep 17 00:00:00 2001 From: Ferry Huberts Date: Wed, 29 Apr 2015 18:59:36 +0200 Subject: [PATCH 1/1] pud: move the config sample into the readme Signed-off-by: Ferry Huberts --- lib/pud/README | 360 +++++++++++++++++++++++++++++++++++++- lib/pud/olsrd.conf.sample | 355 ------------------------------------- 2 files changed, 359 insertions(+), 356 deletions(-) delete mode 100644 lib/pud/olsrd.conf.sample diff --git a/lib/pud/README b/lib/pud/README index 5d8f1e7b..15751d08 100644 --- a/lib/pud/README +++ b/lib/pud/README @@ -1,3 +1,361 @@ -This plugin depends on the NMEA parsing library that can be found at: +This plugin depends on the (included) NMEA parsing library that can be found at: https://github.com/AHR-Project/nmealib + +See the document doc/pud.odt for a detailed specification of the module. + +LoadPlugin "/olsrd_pud.so.2.2.0" +{ + # nodeId contains the node identification. It first describes the semantics + # (meaning/code) of the identification and then specifies the node + # identification itself. + # For some codes the identification itself is not relevant and + # therefore ignored (specified if so). + # + # The format is "number,identification" + # + # "Number" is a number in the range 0-255, with the following + # meaning: + # 0 : MAC address of sending interface + # (identification is not relevant) + # 1 : an MSISDN number with 15 digits + # 2 : a Tetra number with 17 digits + # 3 : a DNS name + # (identification can be empty, in which case the hostname is + # used) + # 4 : IPv4 address (OLSR main address) of the sending node + # (identification is not relevant) + # 5 : an UUID number with 32 hexadecimal digits + # 6 : IPv6 address (OLSR main address) of the sending node + # (identification is not relevant) + # 7 : an AIS MMSI number with 9 digits + # 8 : a URN number (a plain 24 bits number) with 8 digits. See + # http://www.dtic.mil/cjcs_directives/cdata/unlimit/3156_01.pdf + # 9 : a MIP OID number with 20 digits. See + # http://www.mip-site.org/publicsite (IR Annex D – DMWG, + # 20081211, Edition 3.7, Annex D Key Management for the MIP + # Data Model, (MIR Annex D - Key Management-JC3IEDM-3.0.9.pdf) + # 192 : a 7 digit number conforming to 'Nationaal Nummerplan + # Brandweer Nederland' + # 193 : a 6 digit number conforming to 'Nationaal Nummerplan + # Ambulancezorg Nederland' + # 194 : a 4 digit number in the range [1, 8191] + # + # other numbers are reserved + # + # Note: setting "number" to 4 or 6 is the same for olsrd: both mean 'use + # the main IP address, which is either an IPv4 or an IPv6 address, + # depending on the IP version under which olsrd is run. + # + # Note: Both the number and the identification are transported over OLSR, + # so care must be taken to keep the size of the identification down. + # + # Default: "4" (when olsrd is run under IPv4) + # "6" (when olsrd is run under IPv6) + # + # PlParam "nodeId" "4" + + + # + # RX Parameters + # + + # rxNonOlsrIf is a network interface on the host on which the plugin will + # listen for GPS multicasts. Multiple such interfaces can be + # specified by specifying the parameter multiple times. + # + # Default: none + # + # PlParam "rxNonOlsrIf" "" + + # rxAllowedSourceIpAddress is an IP address from which the plugin is + # allowed to process/parse GPS sentences. When + # this parameter is not configured then GPS + # sentences from ALL IP addresses are processed. + # Multiple IP addresses can be specified by + # specifying the parameter multiple times. + # + # Default: none + # + # PlParam "rxAllowedSourceIpAddress" "" + + # rxMcAddr is the multicast address on which the plugin will listen for GPS + # multicasts. + # + # Default: 224.0.0.224 (IPv4) or FF02:0:0:0:0:0:0:1 (IPv6) + # + # PlParam "rxMcAddr" "224.0.0.224" + + # rxMcPort is the UDP port on which the plugin will listen for GPS + # multicasts. + # + # Default: 2240 + # + # PlParam "rxMcPort" "2240" + + # positionFile is the file that contains the position information that the + # plugin should use. When this parameter is set then the + # file is read during olsrd startup. An example file is + # available in the doc directory of olsrd. + # + # Default: none + # + # PlParam "positionFile" "" + + # Specifies the period in milliseconds on which to read the positionFile + # (if it changed) and activate its new setting for the position. + # This setting is only relevant if positionFile has been configured. + # A setting of zero disables dynamic updates, the positionFile is then only + # read during olsrd startup. + # + # Default: 0 + # + # PlParam "positionFilePeriod" "0" + + + # + # TX Parameters + # + + # txNonOlsrIf is a network interface on the host on which the plugin will + # transmit GPS multicasts that were received through the OLSR + # network. Multiple such interfaces can be specified by + # specifying the parameter multiple times. + # + # Default: none + # + # PlParam "txNonOlsrIf" "" + + # txMcAddr is the multicast address on which the plugin will transmit GPS + # multicasts that were received through the OLSR network. + # + # Default: 224.0.0.224 (IPv4) or FF02:0:0:0:0:0:0:1 (IPv6) + # + # PlParam "txMcAddr" "224.0.0.224" + + # txMcPort is the UDP port on which the plugin will transmit GPS multicasts + # that were received through the OLSR network. + # + # Default: 2240 + # + # PlParam "txMcPort" "2240" + + # txTtl is the TTL that is used when transmitting GPS multicasts that were + # received through the OLSR network + # + # Default: 1 + # + # PlParam "txTtl" "1" + + # txNmeaMessagePrefix is the NMEA message prefix of GPS multicasts that the + # plugin transmits. It must be exactly 4 characters + # long. + # + # Default: NBSX + # + # PlParam "txNmeaMessagePrefix" "NBSX" + + + # + # Uplink Parameters + # + + # uplinkAddr is the IP address to which the plugin will transmit GPS + # position updates. When not set, no uplink messages will be + # sent. + # + # Default: none + # + # PlParam "uplinkAddr" "" + + # uplinkPort is the UDP port to which the plugin will transmit GPS position + # updates. Can't be the same as the downlink port. + # + # Default: 2241 + # + # PlParam "uplinkPort" "2241" + + # downlinkPort is the UDP port on which the plugin will receive GPS position + # updates. Can't be the same as the uplink port. + # The downlink is only active when a proper uplink has been + # configured. + # + # Default: 2242 + # + # PlParam "downlinkPort" "2242" + + + # + # OLSR Parameters + # + + # olsrTtl is the TTL that is used when sending messages over the OLSR + # networks. Setting this to 0 (zero) will disable distribution + # of position updates over the OLSR networks. + # + # Default: 64 + # + # PlParam "olsrTtl" "64" + + + # + # Update Parameters + # + + # updateIntervalStationary is the interval (in seconds) between position + # updates sent over the OLSR network when the + # node is stationary + # + # Default: 60 + # + # PlParam "updateIntervalStationary" "60" + + # updateIntervalMoving is the interval (in seconds) between position + # updates sent over the OLSR network when the + # node is moving + # + # Default: 5 + # + # PlParam "updateIntervalMoving" "5" + + # uplinkUpdateIntervalStationary is the interval (in seconds) between + # position updates sent over the uplink when + # the node is stationary + # + # Default: 180 + # + # PlParam "uplinkUpdateIntervalStationary" "180" + + # uplinkUpdateIntervalMoving is the interval (in seconds) between position + # updates sent over the OLSR network when the + # node is moving + # + # Default: 15 + # + # PlParam "uplinkUpdateIntervalMoving" "15" + + # gatewayDeterminationInterval is the interval (in seconds) on which + # determination of the best gateway is + # performed + # + # Default: 1 + # + # PlParam "gatewayDeterminationInterval" "1" + + # movingSpeedThreshold is the speed from which we consider the node is + # moving + # + # Default: 9 + # + # PlParam "movingSpeedThreshold" "9" + + # movingDistanceThreshold is the distance from the previous position from + # which we consider the node is moving + # + # Default: 50 + # + # PlParam "movingDistanceThreshold" "50" + + # dopMultiplier One of the situations that is seen as movement is when the + # current position with its uncertainty circle no longer + # overlaps the last transmitted position with its uncertainty + # circle. This parameter is used to adjust the sizes of these + # uncertainty circles: setting it to a value less than 1.0 + # will make both uncertainty circles smaller by this factor, + # resulting in earlier movement detection. Setting it to a + # value larger than 1.0 will detect movement later. + # + # Default: 2.5 + # + # PlParam "dopMultiplier" "2.5" + + # defaultHdop is the default value that is taken for HDOP (in meters) in + # determining whether we are moving when there is a position + # available but no HDOP. + # + # Default: 50 + # + # PlParam "defaultHdop" "50" + + # defaultVdop is the default value that is taken for VDOP (in meters) in + # determining whether we are moving when there is a position + # available but no VDOP. + # + # Default: 50 + # + # PlParam "defaultVdop" "50" + + # averageDepth is the depth of the position average list, or the number + # of positions that are averaged to obtain the average + # position + # + # Default: 5 + # + # PlParam "averageDepth" "5" + + # hysteresisCountToStationary is the number of position updates that + # effectuate a state transition from moving to + # stationary that must be received before the + # actual transition is taken + # + # Default: 17 + # + # PlParam "hysteresisCountToStationary" "17" + + # hysteresisCountToMoving is the number of position updates that effectuate + # a state transition from stationary to moving that + # must be received before the actual transition is + # taken + # + # Default: 5 + # + # PlParam "hysteresisCountToMoving" "5" + + # gatewayHysteresisCountToStationary is the number of times the gateway + # must be the same that effectuate a state transition from + # moving to stationary that must be received + # before the actual transition is taken + # + # Default: 17 + # + # PlParam "gatewayHysteresisCountToStationary" "17" + + # gatewayHysteresisCountToMoving is the number of gateway updates that + # effectuate a state transition from stationary to + # moving that must be received before the actual + # transition is taken + # + # Default: 5 + # + # PlParam "gatewayHysteresisCountToMoving" "5" + + + # + # Other Plugin Parameters + # + + # useDeDup determines whether duplicate message detection is to be + # performed. When 0 then no such detection is performed, when 1 + # then the detection is performed + # + # Default: true + # + # PlParam "useDeDup" "true" + + # deDupDepth the number of messages that are tracked to detect duplucates + # messages received from the OLSR network + # + # Default: 256 + # + # PlParam "deDupDepth" "256" + + # useLoopback determines whether the message that is sent over the OLSR + # network should be immediately looped back, thus pretending + # that the message (that is sent by this node) is received from + # the OLSR network. When 0 then no loopback is performed, when + # 1 then the loopback is performed + # + # Default: false + # + # PlParam "useLoopback" "true" +} diff --git a/lib/pud/olsrd.conf.sample b/lib/pud/olsrd.conf.sample deleted file mode 100644 index 906d5c2f..00000000 --- a/lib/pud/olsrd.conf.sample +++ /dev/null @@ -1,355 +0,0 @@ -LoadPlugin "/olsrd_pud.so.1.1.0" -{ - # nodeId contains the node identification. It first describes the semantics - # (meaning/code) of the identification and then specifies the node - # identification itself. - # For some codes the identification itself is not relevant and - # therefore ignored (specified if so). - # - # The format is "number,identification" - # - # "Number" is a number in the range 0-255, with the following - # meaning: - # 0 : MAC address of sending interface - # (identification is not relevant) - # 1 : an MSISDN number with 15 digits - # 2 : a Tetra number with 17 digits - # 3 : a DNS name - # (identification can be empty, in which case the hostname is - # used) - # 4 : IPv4 address (OLSR main address) of the sending node - # (identification is not relevant) - # 5 : an UUID number with 32 hexadecimal digits - # 6 : IPv6 address (OLSR main address) of the sending node - # (identification is not relevant) - # 7 : an AIS MMSI number with 9 digits - # 8 : a URN number (a plain 24 bits number) with 8 digits. See - # http://www.dtic.mil/cjcs_directives/cdata/unlimit/3156_01.pdf - # 9 : a MIP OID number with 20 digits. See - # http://www.mip-site.org/publicsite (IR Annex D – DMWG, - # 20081211, Edition 3.7, Annex D Key Management for the MIP - # Data Model, (MIR Annex D - Key Management-JC3IEDM-3.0.9.pdf) - # 192 : a 7 digit number conforming to 'Nationaal Nummerplan - # Brandweer Nederland' - # 193 : a 6 digit number conforming to 'Nationaal Nummerplan - # Ambulancezorg Nederland' - # 194 : a 4 digit number in the range [1, 8191] - # - # other numbers are reserved - # - # Note: setting "number" to 4 or 6 is the same for olsrd: both mean 'use - # the main IP address, which is either an IPv4 or an IPv6 address, - # depending on the IP version under which olsrd is run. - # - # Note: Both the number and the identification are transported over OLSR, - # so care must be taken to keep the size of the identification down. - # - # Default: "4" (when olsrd is run under IPv4) - # "6" (when olsrd is run under IPv6) - # - #PlParam "nodeId" "4" - - - # - # RX Parameters - # - - # rxNonOlsrIf is a network interface on the host on which the plugin will - # listen for GPS multicasts. Multiple such interfaces can be - # specified by specifying the parameter multiple times. - # - # Default: none - # - #PlParam "rxNonOlsrIf" "" - - # rxAllowedSourceIpAddress is an IP address from which the plugin is - # allowed to process/parse GPS sentences. When - # this parameter is not configured then GPS - # sentences from ALL IP addresses are processed. - # Multiple IP addresses can be specified by - # specifying the parameter multiple times. - # - # Default: none - # - #PlParam "rxAllowedSourceIpAddress" "" - - # rxMcAddr is the multicast address on which the plugin will listen for GPS - # multicasts. - # - # Default: 224.0.0.224 (IPv4) or FF02:0:0:0:0:0:0:1 (IPv6) - # - #PlParam "rxMcAddr" "224.0.0.224" - - # rxMcPort is the UDP port on which the plugin will listen for GPS - # multicasts. - # - # Default: 2240 - # - #PlParam "rxMcPort" "2240" - - # positionFile is the file that contains the position information that the - # plugin should use. When this parameter is set then the - # file is read during olsrd startup. An example file is - # available in the doc directory of olsrd. - # - # Default: none - # - #PlParam "positionFile" "" - - # Specifies the period in milliseconds on which to read the positionFile - # (if it changed) and activate its new setting for the position. - # This setting is only relevant if positionFile has been configured. - # A setting of zero disables dynamic updates, the positionFile is then only - # read during olsrd startup. - # - # Default: 0 - # - #PlParam "positionFilePeriod" "0" - - - # - # TX Parameters - # - - # txNonOlsrIf is a network interface on the host on which the plugin will - # transmit GPS multicasts that were received through the OLSR - # network. Multiple such interfaces can be specified by - # specifying the parameter multiple times. - # - # Default: none - # - #PlParam "txNonOlsrIf" "" - - # txMcAddr is the multicast address on which the plugin will transmit GPS - # multicasts that were received through the OLSR network. - # - # Default: 224.0.0.224 (IPv4) or FF02:0:0:0:0:0:0:1 (IPv6) - # - #PlParam "txMcAddr" "224.0.0.224" - - # txMcPort is the UDP port on which the plugin will transmit GPS multicasts - # that were received through the OLSR network. - # - # Default: 2240 - # - #PlParam "txMcPort" "2240" - - # txTtl is the TTL that is used when transmitting GPS multicasts that were - # received through the OLSR network - # - # Default: 1 - # - #PlParam "txTtl" "1" - - # txNmeaMessagePrefix is the NMEA message prefix of GPS multicasts that the - # plugin transmits. It must be exactly 4 characters - # long. - # - # Default: NBSX - # - #PlParam "txNmeaMessagePrefix" "NBSX" - - - # - # Uplink Parameters - # - - # uplinkAddr is the IP address to which the plugin will transmit GPS - # position updates. When not set, no uplink messages will be - # sent. - # - # Default: none - # - #PlParam "uplinkAddr" "" - - # uplinkPort is the UDP port to which the plugin will transmit GPS position - # updates. Can't be the same as the downlink port. - # - # Default: 2241 - # - #PlParam "uplinkPort" "2241" - - # downlinkPort is the UDP port on which the plugin will receive GPS position - # updates. Can't be the same as the uplink port. - # The downlink is only active when a proper uplink has been - # configured. - # - # Default: 2242 - # - #PlParam "downlinkPort" "2242" - - - # - # OLSR Parameters - # - - # olsrTtl is the TTL that is used when sending messages over the OLSR - # networks. Setting this to 0 (zero) will disable distribution - # of position updates over the OLSR networks. - # - # Default: 64 - # - #PlParam "olsrTtl" "64" - - - # - # Update Parameters - # - - # updateIntervalStationary is the interval (in seconds) between position - # updates sent over the OLSR network when the - # node is stationary - # - # Default: 60 - # - #PlParam "updateIntervalStationary" "60" - - # updateIntervalMoving is the interval (in seconds) between position - # updates sent over the OLSR network when the - # node is moving - # - # Default: 5 - # - #PlParam "updateIntervalMoving" "5" - - # uplinkUpdateIntervalStationary is the interval (in seconds) between - # position updates sent over the uplink when - # the node is stationary - # - # Default: 180 - # - #PlParam "uplinkUpdateIntervalStationary" "180" - - # uplinkUpdateIntervalMoving is the interval (in seconds) between position - # updates sent over the OLSR network when the - # node is moving - # - # Default: 15 - # - #PlParam "uplinkUpdateIntervalMoving" "15" - - # gatewayDeterminationInterval is the interval (in seconds) on which - # determination of the best gateway is - # performed - # - # Default: 1 - # - #PlParam "gatewayDeterminationInterval" "1" - - # movingSpeedThreshold is the speed from which we consider the node is - # moving - # - # Default: 9 - # - #PlParam "movingSpeedThreshold" "9" - - # movingDistanceThreshold is the distance from the previous position from - # which we consider the node is moving - # - # Default: 50 - # - #PlParam "movingDistanceThreshold" "50" - - # dopMultiplier One of the situations that is seen as movement is when the - # current position with its uncertainty circle no longer - # overlaps the last transmitted position with its uncertainty - # circle. This parameter is used to adjust the sizes of these - # uncertainty circles: setting it to a value less than 1.0 - # will make both uncertainty circles smaller by this factor, - # resulting in earlier movement detection. Setting it to a - # value larger than 1.0 will detect movement later. - # - # Default: 2.5 - # - #PlParam "dopMultiplier" "2.5" - - # defaultHdop is the default value that is taken for HDOP (in meters) in - # determining whether we are moving when there is a position - # available but no HDOP. - # - # Default: 50 - # - #PlParam "defaultHdop" "50" - - # defaultVdop is the default value that is taken for VDOP (in meters) in - # determining whether we are moving when there is a position - # available but no VDOP. - # - # Default: 50 - # - #PlParam "defaultVdop" "50" - - # averageDepth is the depth of the position average list, or the number - # of positions that are averaged to obtain the average - # position - # - # Default: 5 - # - #PlParam "averageDepth" "5" - - # hysteresisCountToStationary is the number of position updates that - # effectuate a state transition from moving to - # stationary that must be received before the - # actual transition is taken - # - # Default: 17 - # - #PlParam "hysteresisCountToStationary" "17" - - # hysteresisCountToMoving is the number of position updates that effectuate - # a state transition from stationary to moving that - # must be received before the actual transition is - # taken - # - # Default: 5 - # - #PlParam "hysteresisCountToMoving" "5" - - # gatewayHysteresisCountToStationary is the number of times the gateway - # must be the same that effectuate a state transition from - # moving to stationary that must be received - # before the actual transition is taken - # - # Default: 17 - # - #PlParam "gatewayHysteresisCountToStationary" "17" - - # gatewayHysteresisCountToMoving is the number of gateway updates that - # effectuate a state transition from stationary to - # moving that must be received before the actual - # transition is taken - # - # Default: 5 - # - #PlParam "gatewayHysteresisCountToMoving" "5" - - - # - # Other Plugin Parameters - # - - # useDeDup determines whether duplicate message detection is to be - # performed. When 0 then no such detection is performed, when 1 - # then the detection is performed - # - # Default: true - # - #PlParam "useDeDup" "true" - - # deDupDepth the number of messages that are tracked to detect duplucates - # messages received from the OLSR network - # - # Default: 256 - # - #PlParam "deDupDepth" "256" - - # useLoopback determines whether the message that is sent over the OLSR - # network should be immediately looped back, thus pretending - # that the message (that is sent by this node) is received from - # the OLSR network. When 0 then no loopback is performed, when - # 1 then the loopback is performed - # - # Default: false - # - #PlParam "useLoopback" "true" -} -- 2.20.1