id	summary	reporter	owner	description	type	status	priority	milestone	component	version	resolution	keywords	cc
252	"deprecate tub.listenOn(""tcp:0"")"	Brian Warner		"We're moving towards less auto-magic allocation/detection and more pre-allocated ports and user-supplied hostnames/IP-addresses. The practice of automatically detecting locally-attached interfaces only works when the other machine you're talking to is on the same network (and with NAT, this is usually not true). And the automatic detection makes things less predictable.

So the plan is to deprecate the following:

* `Listener.getPortnum()`
* `tub.setLocationAutomatically()`
* `tub.listenOn(""tcp:0"")`. Or rather, you could still do that, but without `.getPortnum()` there's no way to find out the port that got allocated. So you should always choose the port number first.
* #137 is WONTFIXed, which would have added `Tub.listenOn(portfile=)`

And we're adding `foolscap.util.allocate_tcp_port()` (which doesn't block) to help applications perform the allocation ahead of time.
"	task	new	major	eventually	network	0.9.1