Man Linux: Main Page and Category List

NAME

       olsrd.conf - configuration file for olsrd(8)

DESCRIPTION

       The  file olsrd.conf Which is located in /etc by default, contains run-
       time  configuration  for  the  Optimized  Link  State  Routing   daemon
       olsrd(8).    Olsrd   can   however   be  set  to  read  an  alternative
       configuration file at startup using the -f  command  line  argument.  A
       configuration  file parser/generator olsrd_cfgparser(2) can be built as
       both a standalone executable or a dynamically linked library  from  the
       olsrd  sources.  The DLL version can be used to easily create tools for
       generating/parsing olsrd configuration files.

       The configuration file consists of comments, single options and  option
       blocks.

COMMENTS

       Comments  are  everything  following  a  #  in  a  line.  This  data is
       discarded. Commenting out options is an easy way to make olsrd use  the
       default value for that option.

SINGLE OPTIONS

       Single options are single lines options that consists of a keword and a
       user supplied value. Note that a comment can follow such  a  option  on
       the same line. Valid single options are:

       DebugLevel [0-9]
              Controls  the  amount of debug output olsrd sends to stdout.  If
              set to 0, olsrd will detatch from the current process and run in
              the  background.  A value of 9 yields a maximum of debug output.
              Defaults to 0.

       IpVersion [4|6]
              Olsrd supports both IP version 4 and  6.  This  option  controls
              what IP version olsrd is to use. Defaults to 4.

       AllowNoInt [yes|no]
              Olsrd  supports  dynamic  configuration  of  network interfaces.
              This  means  that  interfaces  on  which  olsrd  runs,  can   be
              reconfigured  and  olsrd  will  update itself with no need to be
              restarted.  Olsrd  also  supports  removal  and   addittion   of
              interfaces  in  run-time.  This option specifies if olsrd should
              keep running if no network interfaces are available. Defaults to
              yes.

       TosValue [0-16]
              This  value  controls the type of service value to set in the IP
              header of OLSR control traffic. Defaults to 16.

       Willingness [0-7]
              Nodes participating in a OLSR routed network will announce their
              willingness  to act as relays for OLSR control traffic for their
              neighbors. This option specifies a fixed willingness value to be
              announced  by the local node.  4 is a neutral option here, while
              0 specifies that this node will never act  as  a  relay,  and  7
              specifies  that  this  node  will always act as such a relay. If
              this option is not set in the  configuration  file,  then  olsrd
              will  try  to  retrieve  information  about the system power and
              dynamically update willingness according to  this  info.  If  no
              such info can be retrieved willingness is set to 4.

       OlsrPort [>1000]
              If  set  olsr  uses  specified  port instead of its default IANA
              assigned port 698!

       RtProto [0|1-255]
              This setting configures the routing protocol ID to be used  when
              setting   routes   via   rtnetlink,  see  RTNETLINK(7)  for  the
              rtm_protocol keyword. Use 0  to  specify  the  operating  system
              default, e.g. RTPROT_BOOT on Linux). Defaults to 0.

       RtTableDefault [0|1-254]
              Defines  the  routing  table  for inserting a new default route.
              Defaults to 0 (use RtTable)

       RtTable [0|1-254]
              With Linux and BSD, more than one routing  table  exist  in  the
              system.  Together  with  a rules set that determines which table
              handles  what  packets,  these  system  functions   are   called
              ‘iproute2’  or  ‘Policy  Routing’.  You may want to read the for
              details.     Defaults     to     254     (or     ‘main’,     see
              /etc/iproute2/rt_tables) currently only supported under linux!

       UseHysteresis [yes|no]
              If set to yes hysteresis will be used as explained in section 14
              of RFC3626.

       HystScaling [0.01-0.99]
              Sets the scaling value used by the  hysteresis  algorithm.  This
              must  be  a  positive  floating  point  value  smaller than 1.0.
              Consult RFC3626 for details. The default value is 0.5.

       HystThrHigh [HystThrLow-0.99]
              This option sets the upper threshold for  accepting  a  link  in
              hysteresis  calculation.   The value must be higher than the one
              set as the lower threshold. Defaults to 0.8.

       HystThrLow [0.01-HystThrHigh]
              This option sets the lower  threshold  for  setting  a  link  to
              asymmetric  using  hysteresis.  The value must be lower than the
              one set as the upper threshold. Defaults to 0.3.

       Pollrate [0.1-10.0]
              This option sets the interval, in seconds, that the olsrd  event
              scheduler should be set to poll. A setting of 0.2 will set olsrd
              to poll for events every 0.2 seconds.  Defaults to 0.1.

       NicChgsPollInt[0.1-100.0]
              This option sets the interval, in seconds, that olsrd will check
              the   configured   interfaces   for  changes  in  configuration.
              Defaults to 2.5.

       TcRedundancy [0|1|2]
              This value controls the TC redundancy used by the local node  in
              TC message generation.  To enable a more robust understanding of
              the topology, nodes can be set to announce more than just  their
              MPR  selector  set  in  TC messages.  If set to 0 the advertised
              link set of the node is limited to the MPR selectors.  If set to
              1  the  advertised  link set of the node is the union of its MPR
              set and  its  MPR  selector  set.  Finally,  if  set  to  2  the
              advertised  link  set of the node is the full symmetric neighbor
              set of the node.  Defaults to 0.

       MprCoverage [1-]
              This value decides how many MPRs a node should attempt to select
              for  every  two  hop  neighbor.  Defaults  to  1 , and any other
              setting will severly reduce the optimization introduced  by  the
              MPR secheme!

       LinkQualityLevel [1-2]
              This setting decides the Link Quality scheme to use. If set to 0
              link quality is not regarded and olsrd runs in  "RFC3626  mode".
              If  set  to 1 link quality is used when calculating MPRs. If set
              to 2 routes will also be calculated based  on  distributed  link
              quality  information.   Note  that  a  setting  of 1 or 2 breaks
              RFC3626 compability!  This option should therefore only  be  set
              to  1  or  2 if such a setting is used by all other nodes in the
              network.

       LinkQualityFishEye [0|1]
              Enables(1) or disables(0)  use  of  the  experimental  Fish  Eye
              algorithm.

       ClearScreen    [yes|no]
              If  set  to  yes  and  olsrd is running with a debuglevel >0 the
              terminal to which output is sent(STDOUT)  is  cleared  prior  to
              writing  updated  tables. This makes it easier to follow changes
              in real-time by eye. If STDOUT is not a  terminal(eg.  it  is  a
              file), then no action is taken upon writing tables to STDOUT.

OPTION BLOCKS

       Option  blocks  are  configuration  options  that  holds a body of sub-
       options encapsulated in curled braces( {} ). Valid options are:

       IpcConnect {[sub-options]}
              Olsrd can allow processes to make a TCP connection to itself  on
              which  data  regarding the topology will be transmitted. This is
              typically used by GUI applications to  provide  a  user-friendly
              front-end  to  olsrd.  This  option block controls thees kind of
              connections.

              MaxConnections [0-5] This option specifies how many  connections
              that  can  exist  simoultneously.  Multiple connections have not
              been tested, and does not work! This option should only be  used
              to  control  wheter  or  not  processes  can connect to olsrd by
              setting it either to 0, which will tell olsrd not to  allow  any
              connections,  or  by setting it to a positive value. Defaults to
              0.

              Host [IPv4 address]

              This option specifies a single host that is allowed  to  connect
              to  olsrd.   By  default only the loopback address(127.0.0.1) is
              set to be allowed. So if you want to be  able  to  connect  from
              another  host  you  should  add  it  here.   This  option can be
              repeated to add multiple hosts.

              Net [IPv4 netaddress] [IPv4 netmask]

              Here you can specify an entire netrange of  IP  addresses  which
              olsrd  will  allow  TCP  connections  from.  This  option can be
              repeated to add multiple networks.

       Hna4 {[sub-options]}
              Hosts in a OLSR routed  network  can  announce  connecitivty  to
              external  networks  using HNA messages. This optionblock is used
              to set the IPv4 nteworks to be announced by this host.

              [IPv4 netaddress] [IPv4 netmask]

              Specifies a IPv4 network to announce in HNA  messages.  Multiple
              entries  can  be  added.  To  announce Internet connectivity set
              0.0.0.0 0.0.0.0

       Hna6 {[sub-options]}
              Hosts in a OLSR routed  network  can  announce  connecitivty  to
              external  networks  using HNA messages. This optionblock is used
              to set the IPv6 nteworks to be announced by this host.

              [IPv6 netaddress] [0-48]

              Specifies a IPv6 network to announce in HNA messages. The second
              value  is  the  prefix-length  of  the network address. Multiple
              entries can be added. To announce Internet connectivity set :: 0

       LoadPlugin "[plugin-name]" {[sub-options]}
              Specifies a plugin that olsrd is to load at startup.

              PlParam [key] [value]

              Sends  a  pair  of  parameters  to the plugin at initialization.
              Consult individual plugin documentation  to  find  the  possible
              parameters.

       Interface "[device-name1]" "[device-name2]" ... {[sub-options]}
              This  optionblock  specifies  one  or more network interfaces on
              which olsrd should run. Atleast one network interface block must
              be  specified  for  olsrd  to  run!   Various  parameters can be
              specified on individual  interfaces  or  groups  of  interfaces.
              This  optionblock  can  be  repeated  to  add multiple interface
              configurations.

              AutoDetectChanges [yes|no]

              Olsrd  can  autodetect  changes  in  interface   configurations(
              polling on the interval set by NicChgsPollInt ). This is Enabled
              by default but can be turned off pr. NIC to save CPU cycles.

              Ip4Broadcast [IPv4 address]

              Forces  the  given  IPv4  (broadcast)  address  to  be  used  as
              destination  address  for  all  outgoing  OLSR  traffic  on  the
              interface. One useful example  is  the  address  255.255.255.255
              Another  usefule  example may be to use the peer (unicast) ip of
              an ptp tunnel, olsr shall run on.  If this option  is  not  set,
              the broadcast address that the interface is configured with will
              be used.  This address will also be updated  in  run-time  if  a
              change  is  detected.   This  feature is only available in linux
              versions!

              Mode ["mesh"|"ether"] olsrd can be used on  wireless  interfaces
              and  ethernet.  To  prevent  unnecessary  packet  forwardings on
              switched ethernet interfaces the mode of an interface can be set
              to ether.  The default value of this option is mesh.

              Ip6AddrType [site-local|global]

              This  option  sets  what  IPv6  address  type  is  to be used in
              interface address detection. Defaults to site-local.

              Ip6MulticastSite [IPv6 address]

              Sets the destionation of outgoing OLSR traffic on this interface
              to  use  the  specified IPv6 multicast address as destination if
              the site-local address type is set on this interface.

              Ip6MulticastGlobal [IPv6 address]

              Sets the destionation of outgoing OLSR traffic on this interface
              to  use  the  specified IPv6 multicast address as destination if
              the global address type is set on this interface.

              HelloInterval [0.0-]

              Sets the interval on which HELLO messages will be generated  and
              transmitted on this interface.

              HelloValidityTime [0.0-]

              Sets  the  validity  time  to  be  announced  in  HELLO messages
              generated by this host on this interface.  This  value  must  be
              larger  than  than  the  HELLO  generation  interval to make any
              sense. Defaults to 3 * the generation interval.

              TcInterval [0.0-]

              Sets the interval on which TC messages  will  be  generated  and
              transmitted on this interface.

              TcValidityTime [0.0-]

              Sets  the validity time to be announced in TC messages generated
              by this host on this interface. This value must be  larger  than
              than the TC generation interval to make any sense. Defaults to 3
              * the generation interval.

              MidInterval [0.0-]

              Sets the interval on which MID messages will  be  generated  and
              transmitted on this interface.

              MidValidityTime [0.0-]

              Sets the validity time to be announced in MID messages generated
              by this host on this interface. This value must be  larger  than
              than  the MID generation interval to make any sense. Defaults to
              3 * the generation interval.

              HnaInterval [0.0-]

              Sets the interval on which HNA messages will  be  generated  and
              transmitted on this interface.

              HnaValidityTime [0.0-]

              Sets the validity time to be announced in HNA messages generated
              by this host on this interface. This value must be  larger  than
              than  the HNA generation interval to make any sense. Defaults to
              3 * the generation interval.

              Weight [0-]

              When multiple links  exist  between  hosts  the  weight  of  the
              interface  is  used  to determine the link to route by. Normally
              the weight is automatically calculated by  olsrd  based  on  the
              characteristics  of  the  interface,  but here you can specify a
              fixed value. Olsrd will choose links with the lowest value.

MISC

       The homepage of olsrd is http://www.olsr.org

FILES

       /etc/olsrd.conf

SEE ALSO

       olsrd(8)

(C)2004 Andreas Tonnesen           Mar 2009                      olsrd.conf(5)