summaryrefslogtreecommitdiffstats
path: root/usr.bin/rdist/rdist.1
diff options
context:
space:
mode:
authorsteve <steve@FreeBSD.org>1997-11-16 13:26:03 +0000
committersteve <steve@FreeBSD.org>1997-11-16 13:26:03 +0000
commitc6944bfd2f1015f3c24d7edf3b00b59906ba7826 (patch)
tree8025f0de9e11b289e9ba7716011c18221135756e /usr.bin/rdist/rdist.1
parent2c2d3b03307816140f591feb46251497dfdddf8b (diff)
downloadFreeBSD-src-c6944bfd2f1015f3c24d7edf3b00b59906ba7826.zip
FreeBSD-src-c6944bfd2f1015f3c24d7edf3b00b59906ba7826.tar.gz
Note in manpage how extraneous output in initialization scripts
can cause rdist to fail. PR: bin/4954 Reviewed by: wollman Submitted by: jhs
Diffstat (limited to 'usr.bin/rdist/rdist.1')
-rw-r--r--usr.bin/rdist/rdist.119
1 files changed, 17 insertions, 2 deletions
diff --git a/usr.bin/rdist/rdist.1 b/usr.bin/rdist/rdist.1
index c8d7a29..e28f243 100644
--- a/usr.bin/rdist/rdist.1
+++ b/usr.bin/rdist/rdist.1
@@ -38,14 +38,14 @@
.Nm rdist
.Nd remote file distribution program
.Sh SYNOPSIS
-.Nm rdist
+.Nm
.Op Fl nqbRhivwy
.Op Fl P Ar rshcmd
.Op Fl f Ar distfile
.Op Fl d Ar var=value
.Op Fl m Ar host
.Op Ar name ...
-.Nm rdist
+.Nm
.Op Fl nqbRhivwy
.Op Fl P Ar rshcmd
.Fl c
@@ -402,6 +402,21 @@ A complaint about mismatch of
.Nm
version numbers may really stem
from some problem with starting your shell, e.g., you are in too many groups.
+.Pp
+.Nm Rdist
+relies on
+.Xr rcmd 3
+type remote services executing successfully and in silence.
+A common error is for non-interactive initialization scripts, like
+.Pa .cshrc ,
+to generate output (or to run other programs which generate output
+when not attached to a terminal -- the most frequent offender is
+.Xr stty 1 ) .
+This extra output will cause
+.Nm
+to fail with the error message:
+.Pp
+.Dl rdist: connection failed: version numbers don't match
.Sh BUGS
Source files must reside on the local host where
.Nm
OpenPOWER on IntegriCloud