描述
在最简单的情况是,
diff
比较两个文件的内容
(源文件 和
目标文件).
文件名可以是 -
由标准输入设备读入的文本.
作为特别的情况是, diff -
-
比较一份标准输入的它自己的拷贝
如果 源文件
是一个目录和
目标文件
不是(目录), diff
会比较在
源文件(目录)
里的文件的中和
目标文件同名的(文件),
反过来也一样.
非目录文件不能是
-.
如果 源文件 和
目标文件 都是目录,
diff
比较两个目录中相应的文件,
依照字母次序排序;这个比较是不会递归的,除非给出
-r 或者 --recursive. diff
不把一个目录的内容看为它是一个文件来比较。被指定的文件不
能是标准的输入,
因为标准的输入是无名的并且"有一样的名字的文
件"的观点不适用。
diff 的选项由 -, 开始
所以正常地
源文件(名) 和
目标文件(名)
不可以用 - 开头.
然而, --
可以被它视为保留的即使作为文件名的开头(
they begin with -.)
选项
下面是 GNU所接受的
diff
的所有选项的概要.
大多数的选项有两个相同的名字,一个是单个的
跟在 - 后面字母,
另一个是由 --
引出的长名字.
多个单字母选项(除非它们产生歧义)能够组合为单行的命令行语法
-ac 是等同于 -a -c.
长命名的选项能被缩短到他们的名字的任何唯一的前缀.
用 ([ 和 ])
括起来显示选项产生歧义的选项
- -行数(一个整数)
- 显示上下文 行数
(一个整数).
这个选项自身没有指定输出格式,这是没有效果的,除非和
-c 或者 -u 组合使用.
这是已废置的选项,对于正确的操作,
上下文至少要有两行。
- -a
- 所有的文件都视为文本文件来逐行比较,甚至他们似乎不是文本文件.
- -b
- 忽略空格引起的变化.
- -B
- 忽略插入删除空行引起的变化.
- --brief
- 仅报告文件是否相异,在乎差别的细节.
- -c
- 使用上下文输出格式.
- -C
行数(一个整数)
-
- --context[=lines]
- 使用上下文输出格式,显示以指定
行数 (一个整数),
或者是三行(当
行数 没有给出时.
对于正确的操作,
上下文至少要有两行.
- --changed-group-format=format
- 使用 format
输出一组包含两个文件的不同处的行,其格式是
if-then-else .
- -d
- 改变算法也许发现变化的一个更小的集合.这会使
diff 变慢 (有时更慢).
- -D name
- 合并 if-then-else 格式输出,
预处理宏(由name参数提供)条件.
- -e
-
- --ed
- 输出为一个有效的 ed
脚本.
- --exclude=pattern
- 比较目录的时候,忽略和目录中与
pattern(样式)
相配的.
- --exclude-from=file
- 比较目录的时候,忽略和目录中与任何包含在
file(文件)
的样式相配的文件和目录.
- --expand-tabs
- 在输出时扩展tab为空格,保护输入文件的tab对齐方式
- -f
- 产生一个很象 ed
脚本的输出,但是但是在他们在文件出现的顺序有改变
- -F regexp
- 在上下文和统一格式中,对于每一大块的不同,显示出匹配
regexp.
的一些前面的行.
- --forward-ed
- 产生象 ed
脚本的输出,但是它们在文件出现的顺序有改变。
- -h
- 这选项现在已没作用,它呈现Unix的兼容性.
- -H
- 使用启发规则加速操作那些有许多离散的小差异的大文件.
- --horizon-lines=lines
- 比较给定行数的有共同前缀的最后行,和有共同或缀的最前行.
- -i
- 忽略大小写.
- -I regexp
- 忽略由插入,删除行(由regexp
参数提供参考)带来的改变.
- --ifdef=name
- 合并 if-then-else 格式输出,
预处理宏(由name参数提供)条件.
- --ignore-all-space
- 在比较行的时候忽略空白.
- --ignore-blank-lines
- 忽略插入和删除空行
- --ignore-case
- 忽略大小写.
- --ignore-matching-lines=regexp
- 忽略插入删除行(由regexp
参数提供参考).
- --ignore-space-change
- 忽略空白的数量.
- --initial-tab
- 在文本行(无论是常规的或者格式化的前后文关系)前输出tab代替空格.
引起的原因是tab对齐方式看上去象是常规的一样.
- -l
- 产生通过 pr
编码的输出.
- -L label
-
- --label=label
- 使用 label
给出的字符在文件头代替文件名输出.
- --left-column
- 以并列方式印出两公共行的左边
- --line-format=format
- 使用 format
输出所有的行,在
if-then-else 格式中.
- --minimal
- 改变算法也许发现变化的一个更小的集合.这会使
diff 变慢 (有时更慢).
- -n
- 输出 RC-格式 diffs;
除了每条指令指定的行数受影响外
象 -f 一样。
- -N
-
- --new-file
- 在目录比较中,如果那个文件只在其中的一个目录中找到,那么它被视为在
另一个目录中是一个空文件.
- --new-group-format=format
- 使用 format 以if-then-else
格式输出只在第二个文件中取出的一个行组
- --new-line-format=format
- 使用 format 以if-then-else
格式输出只在第二个文件中取出的一行
- --old-group-format=format
- 使用 format 以if-then-else
格式输出只在第一个文件中取出的一个行组
- --old-line-format=format
- 使用 format 使用 format
以if-then-else
格式输出只在第一个文件中取出的一行
- -p
- 显示带有c函数的改变.
- -P
- 在目录比较中,如果那个文件只在其中的一个目录中找到,那么它被视为在
另一个目录中是一个空文件.
- --paginate
- 产生通过 pr
编码的输出.
- -q
- 仅报告文件是否相异,不报告详细的差异.
- -r
- 当比较目录时,递归比较任何找到的子目录.
- --rcs
- 输出 RC-格式 diffs;
除了每条指令指定的行数受影响外
象 -f 一样。
- --recursive
- 当比较目录时,递归比较任何找到的子目录.
- --report-identical-files
-
- -s
- 报告两个文件相同.
- -S file
- 当比较目录时,由
file 开始.
这用于继续中断了的比较.
- --sdiff-merge-assist
- 打印附加的信息去帮助
sdiff. sdiff 在运行 diff
时使用这些选项.
这些选项不是特意为使用者直接使用而准备的。
- --show-c-function
- 显示带有c函数的改变.
- --show-function-line=regexp
- 在上下文和统一的格式,对于每一大块的差别,显示出匹配
regexp. 的一些前面的行
- --side-by-side
- 使用并列的输出格式.
- --speed-large-files
- 使用启发规则加速操作那些有许多离散的小差异的大文件.
- --starting-file=file
- 当比较目录时,由
file 开始.
这用于继续中断了的比较.
- --suppress-common-lines
- 在并列格式中不印出公共行。
- -t
- 在输出时扩展tab为空格,保护输入文件的tab对齐方式
- -T
- 在文本行(无论是常规的或者格式化的前后文关系)前输出tab代替空格.引起的原因
是tab对齐方式看上去象是常规的一样.
- --text
- 所有的文件都视为文本文件来逐行比较,甚至他们似乎不是文本文件.
- -u
- 使用统一的输出格式.
- --unchanged-group-format=format
- 使用 format
输出两个文件的公共行组,其格式是if-then-else.
- --unchanged-line-format=format
- 使用 format
输出两个文件的公共行,其格式是if-then-else.
- --unidirectional-new-file
- 在目录比较中,如果那个文件只在其中的一个目录中找到,那么它被视为在
另一个目录中是一个空文件.
- -U lines
-
- --unified[=lines]
- 使用前后关系格式输出,显示以指定
行数 (一个整数),
或者是三行(当
行数 没有给出时.
对于正确的操作,
上下文至少要有两行.
- -v
-
- --version
- 输出 diff 版本号.
- -w
- 在比较行时忽略空格
- -W columns
-
- --width=columns
- 在并列格式输出时,使用指定的列宽.
- -x pattern
- 比较目录的时候,忽略和目录中与
pattern(样式)
相配的.
- -X file
- 比较目录的时候,忽略和目录中与任何包含在
file(文件)
的样式相配的文件和目录.
- -y
- 使用并列格式输出
参考
cmp(1), comm(1), diff3(1), ed(1), patch(1), pr(1), sdiff(1).
退出状态为0意味着没有差别,
1意味着有一些不同。
2意味很有问题(许多差异)
Scorpio <rawk@chinese.com>
《中国Linux论坛man手册页翻译计划》:
http://cmpp.linuxforum.net
跋
本页面中文版由中文
man 手册页计划提供。
中文 man
手册页计划:https://github.com/man-pages-zh/manpages-zh