summaryrefslogtreecommitdiffstats
path: root/bus/dbus-daemon.1.in
diff options
context:
space:
mode:
Diffstat (limited to 'bus/dbus-daemon.1.in')
-rw-r--r--bus/dbus-daemon.1.in15
1 files changed, 12 insertions, 3 deletions
diff --git a/bus/dbus-daemon.1.in b/bus/dbus-daemon.1.in
index a657d285..ce623f8b 100644
--- a/bus/dbus-daemon.1.in
+++ b/bus/dbus-daemon.1.in
@@ -221,13 +221,22 @@ the last address given in <listen> first. That is,
apps will try to connect to the last <listen> address first.
.PP
-A special case is using a port number of zero which means to
-pick up a random free port. The real used port number could be retrieved
-by using the --print-address command line parameter.
+A special case is using a port number of zero (or omitting the port),
+which means to choose an available port selected by the operating
+system. The port number chosen can be with the --print-address command
+line parameter and will be present in other cases where the server
+reports its own address, such as when DBUS_SESSION_BUS_ADDRESS is set.
.PP
Example: <listen>tcp:host=localhost,port=0</listen>
+.PP
+tcp addresses also allow an all_interfaces=true option, which will
+cause the bus to listen on all local address (INADDR_ANY) and not only
+the specified host. However, the specified host will still be used as
+the reported address of the server. The specified host should be a
+valid name of the local machine or weird stuff will happen.
+
.TP
.I "<auth>"