From b29b3654328974aaee4f5dfc65af1d861274f3e2 Mon Sep 17 00:00:00 2001
From: June McEnroe <june@causal.agency>
Date: Fri, 7 Sep 2018 20:27:41 -0400
Subject: Add pbd.1

---
 bin/pbd.1 | 52 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 52 insertions(+)
 create mode 100644 bin/pbd.1

(limited to 'bin/pbd.1')

diff --git a/bin/pbd.1 b/bin/pbd.1
new file mode 100644
index 00000000..4de31faf
--- /dev/null
+++ b/bin/pbd.1
@@ -0,0 +1,52 @@
+.Dd $Mdocdate$
+.Dt PBD 1
+.Os "Causal Agency"
+.Sh NAME
+.Nm pbd ,
+.Nm pbcopy ,
+.Nm pbpaste ,
+.Nm open
+.Nd macOS pasteboard daemon
+.Sh SYNOPSIS
+.Nm pbd
+.Nm pbcopy
+.Nm pbpaste
+.Nm open Ar
+.Sh DESCRIPTION
+.Nm pbd
+is a daemon which pipes into macOS
+.Xr pbcopy 1 ,
+from
+.Xr pbpaste 1
+and invokes
+.Xr open 1
+in response to messages
+sent over TCP port 7062.
+.Pp
+The socket can be forwarded through
+.Xr ssh 1
+and the stub implementations of
+.Nm pbcopy ,
+.Nm pbpaste
+and
+.Nm open
+can be used remotely
+to access the local pasteboard
+and open URLs.
+.Pp
+Forwarding can be configured with:
+.Bd -literal
+RemoteForward 7062 127.0.0.1:7062
+.Ed
+.Sh EXAMPLES
+.Bd -literal
+pbd &
+ssh -R 7062:127.0.0.1:7062 tux.local
+pbpaste
+.Ed
+.Sh SEE ALSO
+.Xr open 1 ,
+.Xr pbcopy 1 ,
+.Xr pbpaste 1 ,
+.Xr ssh 1 ,
+.Xr ssh_config 5
-- 
cgit 1.4.1