diff --git a/FREEBSD.readme b/FREEBSD.readme index 732940d..a59d39e 100644 --- a/FREEBSD.readme +++ b/FREEBSD.readme @@ -1,4 +1,10 @@ -FreeBSD users will need to change the Perl shebangs at the top of the executables from #!/usr/bin/perl +Syncoid assumes a bourne style shell on remote hosts. Using (t)csh (the default for root under FreeBSD) +will cause syncoid to fail cryptically due to 2>&1 output redirects. + +To use syncoid successfully with FreeBSD targets, you must use the chsh command to change the root shell: + root@bsd:~# chsh -s /bin/sh + +FreeBSD users will also need to change the Perl shebangs at the top of the executables from #!/usr/bin/perl to #!/usr/local/bin/perl in most cases. Sorry folks, but if I set this with #!/usr/bin/env perl as suggested, then nothing works properly @@ -11,14 +17,3 @@ 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/README.md b/README.md index b4558c0..21432ac 100644 --- a/README.md +++ b/README.md @@ -39,6 +39,8 @@ And its /etc/sanoid/sanoid.conf might look something like this: Which would be enough to tell sanoid to take and keep 36 hourly snapshots, 30 dailies, 3 monthlies, and no yearlies for all datasets under data/images (but not data/images itself, since process_children_only is set). Except in the case of data/images/win7, which follows the same template (since it's a child of data/images) but only keeps 4 hourlies for whatever reason. +For more full details on sanoid.conf settings see [Wiki page](https://github.com/jimsalterjrs/sanoid/wiki/Sanoid#options). + **Note**: Be aware that if you don't specify some interval options the defaults will be used (from /etc/sanoid/sanoid.defaults.conf) ##### Sanoid Command Line Options