From 1bd4ecc1256f38d7ab0da736434d46762507348b Mon Sep 17 00:00:00 2001
From: Havoc Pennington <hp@redhat.com>
Date: Fri, 8 Jun 2007 20:43:35 +0000
Subject: 2007-06-08  Havoc Pennington  <hp@redhat.com>

	* backport fix to allow a server to use port=0 or omit port so
	the port can be auto-selected by the OS
---
 bus/dbus-daemon.1.in | 11 +++++++++++
 1 file changed, 11 insertions(+)

(limited to 'bus')

diff --git a/bus/dbus-daemon.1.in b/bus/dbus-daemon.1.in
index 5c846836..acee933a 100644
--- a/bus/dbus-daemon.1.in
+++ b/bus/dbus-daemon.1.in
@@ -210,6 +210,9 @@ a transport name plus possible parameters/options.
 .PP
 Example: <listen>unix:path=/tmp/foo</listen>
 
+.PP
+Example: <listen>tcp:host=localhost,port=1234</listen>
+
 .PP
 If there are multiple <listen> elements, then the bus listens 
 on multiple addresses. The bus will pass its address to 
@@ -217,6 +220,14 @@ started services or other interested parties with
 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.
+
+.PP
+Example: <listen>tcp:host=localhost,port=0</listen>
+
 .TP
 .I "<auth>"
 
-- 
cgit