summaryrefslogtreecommitdiffstats
path: root/net/tesseras-paste/pkg/README
diff options
context:
space:
mode:
authormurilo ijanc2026-03-25 00:55:30 -0300
committermurilo ijanc2026-03-25 00:55:30 -0300
commit90af880c4f43b8c5708af6712d94afc610f451df (patch)
treef796f108a00d9451ff84070656e9caa7b9181c8d /net/tesseras-paste/pkg/README
downloadports-90af880c4f43b8c5708af6712d94afc610f451df.tar.gz
add net/tesseras-paste portHEADmain
OpenBSD port for tesseras-paste 0.1.0, a decentralized pastebin built on tesseras-dht. Includes rc.d script, _tpd daemon user, man pages for tp(1) and tpd(1), and pkg-readme.
Diffstat (limited to 'net/tesseras-paste/pkg/README')
-rw-r--r--net/tesseras-paste/pkg/README58
1 files changed, 58 insertions, 0 deletions
diff --git a/net/tesseras-paste/pkg/README b/net/tesseras-paste/pkg/README
new file mode 100644
index 0000000..ff86ffd
--- /dev/null
+++ b/net/tesseras-paste/pkg/README
@@ -0,0 +1,58 @@
++-----------------------------------------------------------------------
+| Running ${PKGSTEM} on OpenBSD
++-----------------------------------------------------------------------
+
+Daemon Setup
+============
+
+Enable and start the tpd(1) daemon:
+
+ # rcctl enable tpd
+ # rcctl start tpd
+
+To connect to a bootstrap peer:
+
+ # rcctl set tpd flags "-b host:port"
+ # rcctl restart tpd
+
+Multiple bootstrap peers can be specified:
+
+ # rcctl set tpd flags "-b host1:port -b host2:port"
+
+To enable the HTTP interface on port 8080:
+
+ # rcctl set tpd flags "-b host:port -w 8080"
+
+To run as a public server on a fixed UDP port:
+
+ # rcctl set tpd flags "-g -p 6881 -b host:port"
+
+Data Directory
+==============
+
+Paste data and the node identity key are stored in
+${LOCALSTATEDIR}/tesseras-paste/, owned by the _tpd user.
+
+Socket Permissions
+==================
+
+The tp(1) client communicates with tpd(1) via a Unix domain socket at
+${LOCALSTATEDIR}/tesseras-paste/daemon.sock. To allow a regular user to
+use tp(1), add them to the _tpd group:
+
+ # usermod -G _tpd <username>
+
+The user must log out and back in for the group change to take effect.
+
+Client Usage
+============
+
+Store a paste (default TTL 24h):
+
+ $ echo "hello world" | tp put
+
+Retrieve a paste:
+
+ $ tp get <key>
+
+See tp(1) and tpd(1) for full documentation.