From faf825003fbb7448be5a566fe1c238711a031298 Mon Sep 17 00:00:00 2001 From: Eric Coutu Date: Sun, 29 Apr 2018 15:06:31 -0400 Subject: [PATCH] Document compatibility with (t)csh shells Also, recommend installing mbuffer on FreeBSD systems when remote user is using bourne compatible shell. --- FREEBSD.readme | 11 +++++++++++ INSTALL | 4 +++- 2 files changed, 14 insertions(+), 1 deletion(-) diff --git a/FREEBSD.readme b/FREEBSD.readme index 9960201..732940d 100644 --- a/FREEBSD.readme +++ b/FREEBSD.readme @@ -11,3 +11,14 @@ If you don't want to have to change the shebangs, your other option is to drop a root@bsd:~# ln -s /usr/local/bin/perl /usr/bin/perl After putting this symlink in place, ANY perl script shebanged for Linux will work on your system too. + +Syncoid assumes a bourne style shell on remote hosts. Using (t)csh (the default for root under FreeBSD) +has some known issues: + +* If mbuffer is present, syncoid will fail with an "Ambiguous output redirect." error. So if you: + root@bsd:~# ln -s /usr/local/bin/mbuffer /usr/bin/mbuffer + make sure the remote user is using an sh compatible shell. + +To change to a compatible shell, use the chsh command: + +root@bsd:~# chsh -s /bin/sh diff --git a/INSTALL b/INSTALL index 1492546..33b510d 100644 --- a/INSTALL +++ b/INSTALL @@ -9,7 +9,7 @@ is not available on either end of the transport. On Ubuntu: apt install pv lzop mbuffer On CentOS: yum install lzo pv mbuffer lzop -On FreeBSD: pkg install pv lzop +On FreeBSD: pkg install pv mbuffer lzop FreeBSD notes: FreeBSD may place pv and lzop in somewhere other than /usr/bin ; syncoid currently does not check path. @@ -19,6 +19,8 @@ FreeBSD notes: FreeBSD may place pv and lzop in somewhere other than or similar, as appropriate, to create links in /usr/bin to wherever the utilities actually are on your system. + See note about mbuffer in FREEBSD.readme + SANOID ------