NAME

       horst.conf - configuration file for horst(8)

SYNOPSIS

       /etc/horst.conf

DESCRIPTION

       The  file  /etc/horst.conf  is the default configuration file. The configuration file consists of zero or
       more lines.  Each line must be either EMPTY, COMMENT or OPTION and must end with  a  new  line  character
       ('\n', ASCII 0xa).

       EMPTY lines must have zero or more spaces (' ', ASCII 0x20).

       COMMENT lines must begin with a hash sign ('#', ASCII 0x23).

       OPTION lines must be in the following form:

              option[=value]

       Options and their acceptable values are described below in section OPTIONS.

       Lines not matching the format described above will cause horst to exit with non-zero status.

OPTIONS

       channel=CHANNEL_NUMBER
              Set the initial channel number to which horst tunes the radio at startup.

       channel_dwell=MILLISECONDS
              Set the time horst scans each channel when channel_scan=1 is defined.

       channel_scan
              Make horst change/scan channels automatically in ascending numeric order.

       channel_scan_rounds=N
              Set  the  number of rounds horst scans the channel range when channel_scan=1 is defined. When N is
              reached, horst exits with zero status. If N is a negative number, horst scans  the  channel  range
              infinitely.

       channel_upper=CHANNEL_NUMBER
              Set  the  highest channel horst will change to when channel_scan=1 is defined. When CHANNEL_NUMBER
              is reached, the next channel will be 1.

       client=SERVER_ADDRESS
              Run horst in client mode and connect to a server running in SERVER_ADDRESS.

       control_pipe=FILEPATH
              Accept control commands on a named pipe.

       display_interval=MILLISECONDS
              Set the refresh interval of the user interface display. This option can be used to reduce CPU load
              by using longer intervals.

       display_view=history|essid|statistics|spectrum
              Set the initial display view.

       filter_bssid=BSSID[,BSSID]...
              Ignore all packets except packets belonging to BSSID.

       filter_mac=MAC_ADDRESS[,MAC_ADDRESS]...
              Ignore all packets except packets originating from MAC_ADDRESS.

       filter_mode=MODE[,MODE]...
              Ignore all packets/nodes except packets/nodes of mode MODE.

       filter_packet=PACKET_TYPE[,PACKET_TYPE]...
              Ignore all packets except packets of type PACKET_TYPE.

       interface=INTERFACE_NAME
              Set the wireless  interface  which  horst  uses  to  monitor  the  radio  spectrum.  If  interface
              INTERFACE_NAME  is  not already in monitor mode at startup, horst first tries to put the interface
              in monitor mode and if it fails, a temporary virtual monitor interface is added and used  instead.
              The  name  of  the  temporary  virtual  monitor  interface is in the form horst[0-9]+. The virtual
              interface created by horst is deleted at exit.

       add_monitor
              Always add virtual monitor interface. Don't try to set existing interface to monitor mode.

       mac_names=FILEPATH
              The file containing a mapping from MAC  addresses  to  host  names.  The  file  can  either  be  a
              dhcp.leases   file   from  dnsmasq  or  contain  mappings  in  the  form  "MAC<space>name"  (e.g.:
              "00:01:02:03:04:05 test") line by line.

       node_timeout=SECONDS
              Set the time after nodes will be removed if no frames have been received from them.

       outfile=FILEPATH
              Write information about each received packet to FILEPATH.

       port=PORT_NUMBER
              Set the port horst listens to when run in server mode or the port which horst connects to when run
              in client mode.

       quiet  Make horst less verbose and suppress the user interface.

       receive_buffer=BYTES
              Set the size of the receive buffer. This option can be used to tune memory consumption and  reduce
              packet loss under high load.

       server Run horst in server mode.

SEE ALSO

       horst(8)

                                               September 29, 2016                                  HORST.CONF(5)