Update documentation and example config due to libevent's use of

hints.ai_flags = EVUTIL_AI_PASSIVE|EVUTIL_AI_ADDRCONFIG;
:: won't for HTTP listening if there is no global IPv6 address
configured.


git-svn-id: http://repo.ham.fi/svn/aprsc/trunk@836 3ce903b1-3385-4e86-93cd-f9a4a239f7ac
This commit is contained in:
Heikki Hannikainen 2012-09-10 04:12:19 +00:00
parent 76d15cc8ba
commit 74b7177ab1
2 changed files with 16 additions and 7 deletions

View File

@ -193,16 +193,21 @@ for IPv6, 0.0.0.0 means "all addresses" for IPv4. On Linux, Solaris and OS X
the :: IPv6 listener will also accept IPv4 connections happily, so you don't
usually need a separate IPv4 listener.
If you don't have a global IPv6 address (/sbin/ifconfig -a will not show an
IPv6 address with Scope:Global), using :: will not work, and you'll have to
use 0.0.0.0. The libevent2 http server which does HTTP address configuration
works like this.
The status page HTTP service is configured using HTTPStatus. Here's a
configuration example for the APRS-IS standard status port 14501:
HTTPStatus :: 14501
HTTPStatus 0.0.0.0 14501
The HTTP position upload service is configured using the HTTPUpload
directive. Here's an example for the APRS-IS standard position submission
port 8080:
HTTPUpload :: 8080
HTTPUpload 0.0.0.0 8080
Multiple HTTPStatus and HTTPUpload directives can be entered to listen on
multiple addresses or ports:

View File

@ -94,12 +94,16 @@ Listen "UDP submit" udpsubmit udp :: 8080
### HTTP server ##########
# HTTPStatus port provides a status view to web browsers.
# Again, :: is "all addresses" for IPv6, 0.0.0.0 for IPv4.
# On Linux and OS X you only need to bind ::, it will handle
# both IPv4 and IPv6 connections on all addresses.
HTTPStatus :: 14501
# IPv6+IPv4 support works slightly differently than in Listen:
# :: is "all addresses" for IPv6, 0.0.0.0 for IPv4, but
# :: only works if you actually have a global IPv6 address
# configured on the system.
# The example is for IPv4, change the address to :: if you have
# IPv6. For FreeBSD, or if you wish to support multiple specific
# ports/addresses, use multiple HTTPStatus directives for each.
HTTPStatus 0.0.0.0 14501
# HTTPUpload port allows position uploads over HTTP
HTTPUpload :: 8080
HTTPUpload 0.0.0.0 8080
### Environment ############
# When running this server as super-user, the server can (in many systems)