1、问题

今日在维护集群环境的时候，遇到了一个小问题，rsync 向集群中的机器传输文件的时候报错：

protocol version mismatch -- is your shell clean?
(see the rsync man page for an explanation)
rsync error: protocol incompatibility (code 2) at compat.c(171) [sender=3.0.6]

又翻了下 man rsync，发现官方对这个问题有如下的解释：

DIAGNOSTICS

rsync occasionally produces error messages that may seem a little cryptic. The one that seems to cause the most confusion is "protocol version mismatch -- is your shell clean?".

This message is usually caused by your startup scripts or remote shell facility producing unwanted garbage on the stream that rsync is using for its transport. The way to diagnose this problem is to run your remote shell like this:

ssh remotehost /bin/true > out.dat

then look at out.dat. If everything is working correctly then out.dat should be a zero length file. If you are getting the above error from rsync then you will probably find that out.dat contains some text or data. Look at the contents and try to work out what is producing it. The most common cause is incorrectly configured shell startup scripts (such as .cshrc or .profile) that contain output statements for non-interactive logins.

按照提示，ssh remotehost /bin/true > out.dat 执行过后输出的正是远程机器上 .bashrc 设置里的一条 echo 提示语句。

注释掉，然后再次测试，即可正常运行了。

2、原因

那么，这儿问题就来了（问题当然不是挖掘机哪家强 - _ - 。。。），rsync 和 .bashrc 有半毛钱关系呢？

哈哈，欲听后事如何，且听我慢慢道来~

原因是 rsync 在传输数据之前，会先与远端进行一次 ssh 登录认证，而当 .bashrc文件有输出的时候，rsync 客户端解析返回的数据包会出现混乱，于是乎就会出现文中开头提到的报错：客户端和远端的协议版本不兼容/不匹配了。

需要说明的是：

远端 sshd 进程是通过“bash –c”的方式来执行命令（即"非交互式的非登录shell"）

但在执行命令之前，ssh的那一次登录本身是“非交互式的登录shell”，非交互式的登录shell （bash –l xxx.sh）载入的信息列表及顺序如下：

/etc/profile
~/.bash_profile （ ->  ~/.bashrc  ->  /etc/bashrc）
~/.bash_login
~/.profile
$BASH_ENV

所以 ssh 的时候会载入“~/.bash_profile”,

让我们再来看一下 .bash_profile 的内容：

cat ~/.bash_profile
# .bash_profile

# Get the aliases and functions
if [ -f ~/.bashrc ]; then
        . ~/.bashrc  # .bashrc 默认又会加载 /etc/bashrc
fi

# User specific environment and startup programs

PATH=$PATH:$HOME/bin

export PATH

3、解决方案

既然都找到原因了，那怎么解决呢？

有同学会问，我本来就是要让用户登录的时候有登录提示的呀？现在为了 rsync 岂不是得禁掉？

那这里就又引入了另一个知识点：交互式shell和飞交互式shell、登录shell和非登录shell 的区别

什么是交互式的呢？就像我们平时通过命令行做事一样，你敲一个命令，终端解析执行完之后给你一个结果，这样一种交互式的形式。那么，平时我们接触的Shell基本上都是交互式的，如gnome-terminal打开一个Shell以及通过Ctrl+alt+1等切换过去的文本终端。交互式Shell下, "echo $-"返回的字符串中包含i，否则不包含。也可以通过在bash后面加-i参数打开一个交互式的Shell，具体可以看man bash。bash后面加-c参数执行命令打开的是非交互式Shell，可以用以下命令验证：

bash -c ‘echo $-‘  # 返回hBc

回到本小节开头的问题，咱们可以用如下方式去区分一个命令是处于登录shell还是非登录shell：

[[ $- == *i* ]] && echo ‘This is interactive shell.‘

针对文中开头的问题，咱们加上如上的判断，就可以做到登录的时候有提示，同时 rsync 也不会报错了，可谓一举两得。

好了，今天的内容就到这儿了，其实 shell 作为一门古老的编程语言以及随着 linux 版本的多样化发展、不断的演变，”坑“很多，却也值得让人细细探索~

4、Refer：

[1] 什么是交互式登录 Shell [[ $- != *i* ]] && return

http://kodango.com/what-is-interactive-and-login-shell

[2] linux下的bash与sh 详解以及例子

http://bbs.chinaunix.net/thread-1068678-1-1.html

[3] 登录shell,交互式非登录shell,非交互式shell

http://bbs.chinaunix.net/thread-2018339-1-1.html

[4] Shell 默认选项 himBH 的解释

http://kodango.com/explain-shell-default-options

rsync error: protocol incompatibility / mismatch ?