From 74b7177ab1fd9bf3c7b77d975c86bd173ac9af96 Mon Sep 17 00:00:00 2001 From: Heikki Hannikainen Date: Mon, 10 Sep 2012 04:12:19 +0000 Subject: [PATCH] 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 --- doc/CONFIGURATION.md | 9 +++++++-- src/aprsc.conf | 14 +++++++++----- 2 files changed, 16 insertions(+), 7 deletions(-) diff --git a/doc/CONFIGURATION.md b/doc/CONFIGURATION.md index 3d9dfaa..1746009 100644 --- a/doc/CONFIGURATION.md +++ b/doc/CONFIGURATION.md @@ -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: diff --git a/src/aprsc.conf b/src/aprsc.conf index 5f8b401..e9a2e2b 100644 --- a/src/aprsc.conf +++ b/src/aprsc.conf @@ -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)