From ee25588324ca61275782a3628dd1838dae58e69e Mon Sep 17 00:00:00 2001
From: murilo ijanc
Date: Wed, 25 Mar 2026 03:46:21 -0300
Subject: Add DNS SRV bootstrap discovery for automatic peer finding

tpd now queries _tesseras._udp.tesseras.net SRV records to discover
bootstrap peers when no -b flag is given. Add -n flag to disable this
automatic discovery for seed/isolated nodes.
---
 tpd.1 | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

(limited to 'tpd.1')

diff --git a/tpd.1 b/tpd.1
index 73a4114..5d9c4fe 100644
--- a/tpd.1
+++ b/tpd.1
@@ -22,6 +22,7 @@
 .Sh SYNOPSIS
 .Nm
 .Op Fl g
+.Op Fl n
 .Op Fl p Ar port
 .Op Fl d Ar dir
 .Op Fl s Ar sock
@@ -42,12 +43,23 @@ The options are as follows:
 Bootstrap peer address.
 This option can be specified multiple times to connect to
 several peers at startup.
+When specified, automatic SRV discovery is skipped.
 .It Fl d Ar dir
 Data directory for paste storage and identity key.
 The default is
 .Pa /var/tesseras-paste .
 .It Fl g
 Enable global NAT mode for public servers.
+.It Fl n
+Disable automatic bootstrap via DNS SRV discovery.
+By default, when no
+.Fl b
+peers are given,
+.Nm
+queries the SRV record at
+.Em _tesseras._udp.tesseras.net
+to discover bootstrap peers.
+This flag disables that behavior, useful for running an isolated node.
 .It Fl p Ar port
 UDP port for the DHT protocol.
 A value of 0 selects a random port.
@@ -60,6 +72,15 @@ inside the data directory.
 .It Fl w Ar http_port
 Enable the HTTP server on the specified port.
 .El
+.Sh BOOTSTRAP DISCOVERY
+When no
+.Fl b
+peers are specified and
+.Fl n
+is not set,
+.Nm
+automatically discovers bootstrap peers by querying the DNS SRV record
+.Em _tesseras._udp.tesseras.net .
 .Sh FILES
 .Bl -tag -width "/var/tesseras-paste/identity.key" -compact
 .It Pa /var/tesseras-paste/
@@ -84,6 +105,10 @@ Start with a bootstrap peer and HTTP interface:
 Start as a public server on port 6881:
 .Pp
 .Dl # tpd -g -p 6881
+.Pp
+Start an isolated node without automatic bootstrap:
+.Pp
+.Dl # tpd -n
 .Sh SEE ALSO
 .Xr tp 1
 .Sh AUTHORS
-- 
cgit v1.2.3