Skip to content

Commit 16d8b4a

Browse files
committed
doc: Add troubleshooting tip about nc -N
Closes: #11
1 parent 9c35c04 commit 16d8b4a

File tree

1 file changed

+8
-2
lines changed

1 file changed

+8
-2
lines changed

README.md

+8-2
Original file line numberDiff line numberDiff line change
@@ -392,7 +392,9 @@ You could also set up a shell alias to make setting up the Clipper tunnel more c
392392

393393
You should only need to re-run this command if the connection is interrupted for some reason.
394394

395-
### Fixing `remote port forwarding failed for listen port 8377`
395+
# Troubleshooting
396+
397+
## Fixing `remote port forwarding failed for listen port 8377`
396398

397399
This message can be emitted when the remote host you're connecting to already has something bound to the requested port. If there is a competing service that you can't move to another port, Clipper can be configured to use a different port with the `--port` switch, described above.
398400

@@ -411,14 +413,18 @@ Do not do this as root, as you will lock yourself out of your server.
411413

412414
Consult the netstat man page for more details (supported options may vary depending on the host operating system).
413415

414-
### Fixing `remote port forwarding failed` when using UNIX domain sockets
416+
## Fixing `remote port forwarding failed` when using UNIX domain sockets
415417

416418
Just as with TCP port forwarding, forwarding can fail when using UNIX domain sockets if a stale socket doesn't get automatically cleaned up (or overwritten, as *should* be the case when you use `StreamLocalBindUnlink=yes`).
417419

418420
In this case, the fix is to remove the stale socket on the remote host. For example, assuming a socket in `$HOME/.clipper.sock` on the remote host, `$HOST`:
419421

420422
$ ssh $HOST rm .clipper.sock
421423

424+
## Fixing delays when sending data to Clipper via `nc`
425+
426+
It's [been reported](https://github.com/wincent/clipper/issues/11) that on some systems sending data to Clipper via `nc` may be affected by an annoying delay. Reportedly, adding the `-N` switch to `nc` may address this issue.
427+
422428
# "Reverse" Clipper
423429

424430
Clipper helps you get content into your local clipboard from other, possibly remote, processes. To send content in the other direction, just paste normally. Note that to make this pleasant in an environment like Vim, you may want to set up bracketed paste mode; see [my dotfiles for an example](https://github.com/wincent/wincent/blob/3b0b2950cdcb09d23c87f0167c207d8c837cb1b2/.vim/plugin/term.vim#L93-114) of how this can be done.

0 commit comments

Comments
 (0)