Big rearrangement to add debconf support.

/etc/default/dump1090-mutability is now generated in postinst,
if it doesn't exist, from a template in /usr/share/dump1090-mutability.
Subsequently, the config file is updated in place if debconf-driven
changes are made.

Static HTML/javascript have moved to a "html" subdir to avoid exposing
the template via the webserver.

debian/dump1090-mutability.templates

@@ -0,0 +1,231 @@
+Template: dump1090-mutability/auto-start
+Description: Start dump1090 automatically?
+ dump1090 can be started automatically via an init-script.
+ Otherwise, the init-script does nothing; you must run dump1090 by hand.
+Type: boolean
+Default: true
+
+Template: dump1090-mutability/run-as-user
+Description: User to run dump1090 as:
+ When started automatically, dump1090 runs as an unprivileged system user. 
+ This user will be created if it does not yet exist.
+Type: string
+Default: dump1090
+
+Template: dump1090-mutability/log-file
+Description: Path to log to:
+ When started automatically, dump1090 will log its output somewhere. This
+ log will contain any startup errors, and periodic statistics reports.
+Type: string
+Default: /var/log/dump1090-mutability.log
+
+Template: dump1090-mutability/rtlsdr-device
+Description: RTL-SDR dongle to use:
+ If you have only one dongle connected, select 0. If you have more than one
+ dongle connected, select the index of the dongle to use (0 is the first
+ dongle). If you want to run dump1090 in "net only" mode, select "none".
+Type: select
+Choices: none, 0, 1, 2, 3, 4, 5
+Default: 0
+
+Template: dump1090-mutability/rtlsdr-gain
+Description: RTL-SDR gain, in dB:
+ The tuner gain used by dump1090 can be provided as a value in dB, or
+ "max" to use the maximum gain available, or "agc" to use the tuner's AGC to
+ control the gain. If unsure, choose "max".
+Type: string
+Default: max
+
+Template: dump1090-mutability/rtlsdr-ppm
+Description: RTL-SDR frequency correction, in PPM:
+ The oscillator in each RTL-SDL dongle is not perfectly accurate. You can
+ choose a correction factor, in parts-per-million, to correct for this. The
+ correction factor varies from dongle to dongle, and also varies with operating
+ temperature. You can find a suitable value with "rtl_test -p" or "kalibrate".
+ If you don't know the value for your dongle, choose 0.
+Type: string
+Default: 0
+
+Template: dump1090-mutability/rtlsdr-oversample
+Description: Enable oversampling at 2.4MHz?
+ Originally, dump1090 would decode incoming signals by sampling at 2MHz. Newer
+ versions also support sampling at 2.4MHz. This may increase the number of
+ decodable messages, but takes slightly more CPU and is not as well tested.
+Type: boolean
+Default: false
+
+Template: dump1090-mutability/decode-fixcrc
+Description: Fix detected CRC errors?
+ dump1090 can fix unambiguous single-bit CRC errors detected in received
+ messages. This allows weaker messages to be decoded. It can slightly increase
+ the rate of undetected errors, but this is not usually significant.
+Type: boolean
+Default: true
+
+Template: dump1090-mutability/decode-phase-enhance
+Description: Apply phase enhancement?
+ dump1090 can attempt to correct for messages that are received
+ out-of-phase from the sampling rate, at the expense of taking more CPU.
+Type: boolean
+Default: true
+
+Template: dump1090-mutability/decode-aggressive
+Description: Aggressively fix more errors?
+ dump1090 can apply more aggressive corrections to received messages,
+ primarily correcting two-bit CRC errors.
+ .
+ Use with caution! This can significantly increase the rate of undetected
+ message errors (i.e. increase the rate of garbled decoded messages)
+Type: boolean
+Default: false
+
+Template: dump1090-mutability/decode-lat
+Description: Latitude of receiver, in decimal degrees:
+ If the location of the receiver is provided, dump1090 can do
+ local position decoding in cases where insufficient position messages are
+ received for unambiguous global position decoding.
+Type: string
+Default:
+
+Template: dump1090-mutability/decode-lon
+Description: Longitude of receiver, in decimal degrees:
+ If the location of the receiver is provided, dump1090 can do
+ local position decoding in cases where insufficient position messages are
+ received for unambiguous global position decoding.
+Type: string
+Default:
+
+Template: dump1090-mutability/net-http-port
+Description: Port for internal webserver (0 disables):
+ dump1090 can provide an internal webserver that serves a basic "virtual
+ radar" map.
+ .
+ It is generally a better idea to use an external webserver, but if you
+ really want to use the internal one, you can select a port to listen
+ on here.
+Type: string
+Default: 0
+
+Template: dump1090-mutability/net-ri-port
+Description: Port for AVR-format input connections (0 disables):
+ dump1090 can accept connections to receive data from other sources in 
+ several formats. This setting controls the port dump1090 will listen
+ on for AVR ("raw") format input connections.
+Type: string
+Default: 30001
+
+Template: dump1090-mutability/net-ro-port
+Description: Port for AVR-format output connections (0 disables):
+ dump1090 can forward ADS-B messages to other software in several formats.
+ This setting controls the port dump1090 will listen on for AVR ("raw")
+ format output connections.
+Type: string
+Default: 30002
+
+Template: dump1090-mutability/net-bi-port
+Description: Port for Beast-format input connections (0 disables):
+ dump1090 can accept connections to receive data from other sources in 
+ several formats. This setting controls the port dump1090 will listen
+ on for Beast ("binary") format input connections.
+Type: string
+Default: 30004
+
+Template: dump1090-mutability/net-bo-port
+Description: Port for Beast-format output connections (0 disables):
+ dump1090 can forward ADS-B messages to other software in several formats.
+ This setting controls the port dump1090 will listen on for Beast ("binary")
+ format output connections.
+Type: string
+Default: 30005
+
+Template: dump1090-mutability/net-sbs-port
+Description: Port for SBS-format output connections (0 disables):
+ dump1090 can forward ADS-B messages to other software in several formats.
+ This setting controls the port dump1090 will listen on for SBS BaseStation
+ format output connections.
+Type: string
+Default: 30003
+
+Template: dump1090-mutability/net-fatsv-port
+Description: Port for FATSV-format output connections (0 disables):
+ dump1090 can forward ADS-B messages to other software in several formats.
+ This setting controls the port dump1090 will listen on for FlightAware TSV
+ format output connections.
+Type: string
+Default: 10001
+
+Template: dump1090-mutability/net-heartbeat
+Description: Seconds between heartbeat messages (0 disables):
+ If there is no other data sent on a network connection, dump1090 can
+ periodically send an empty heartbeat message to ensure that the
+ connection stays established. This setting controls the interval
+ betweeen heartbeat messages.
+Type: string
+Default: 60
+
+Template: dump1090-mutability/net-out-size
+Description: Minimum output message size:
+ To avoid sending many small network messages, output connections will
+ accumulate data waiting to be sent until either a minimum size is reached
+ or a maximum delay is reached. This setting controls the minimum size,
+ in bytes.
+Type: string
+Default: 500
+
+Template: dump1090-mutability/net-out-interval
+Description: Maximum output buffering time:
+ To avoid sending many small network messages, output connections will
+ buffer data waiting to be sent until either a minimum size is reached
+ or a maximum delay is reached. This setting controls the maximum delay,
+ in seconds.
+Type: string
+Default: 1
+
+Template: dump1090-mutability/net-buffer
+Description: SO_SNDBUF size:
+ Here you can specify the TCP send buffer size to use on network connections.
+Type: select
+Choices: 65536, 131072, 262144
+Default: 262144
+
+Template: dump1090-mutability/net-bind-address
+Description: Interface address to bind to (blank for all interfaces):
+ If you want to limit incoming connections to a particular interface,
+ specify the interface address here. A blank value will bind to the wildcard
+ address, allowing connections on all interfaces.
+ .
+ The default value of 127.0.0.1 will allow connections only on localhost,
+ i.e. only connections that originate on the same machine.
+Type: string
+Default: 127.0.0.1
+
+Template: dump1090-mutability/stats-interval
+Description: Interval between logging stats, in seconds:
+ dump1090 will periodically log message reception stats to its logfile.
+ This setting controls how often that is done.
+Type: string
+Default: 3600
+
+Template: dump1090-mutability/json-dir
+Description: Directory to write JSON aircraft state to:
+ dump1090 periodicallys write a list of aircraft, in JSON format, for use
+ by the virtual radar view when using an external webserver. This setting
+ controls the directory to write to.
+ .
+ As this is written frequently (by default, once a second), you should
+ probably select a location that is not on a sdcard. The default path
+ under /run is on tmpfs and will not write to the sdcard.
+Type: string
+Default: /run/dump1090-mutability
+
+Template: dump1090-mutability/json-interval
+Description: Interval between writing JSON aircraft state, in seconds:
+ Here you can control how often the JSON state is updated.
+Type: string
+Default: 1
+
+Template: dump1090-mutability/extra-args
+Description: Extra arguments to pass to dump1090:
+ Here you can add any extra arguments you want to pass to dump1090.
+Type: string
+Default: