Merge branch 'master' of github.com:jaywcjlove/linux-command

command/head.md

@@ -1,30 +1,99 @@
 head
 ===
 
-在屏幕上显示指定文件的开头若干行
+显示文件的开头部分。
 
-## 补充说明
+## 概要
-
-**head命令** 用于显示文件的开头的内容。在默认情况下，head命令显示文件的头10行内容。
-
-### 语法
 
 ```shell
-head(选项)(参数)
+head [OPTION]... [FILE]...
 ```
 
-### 选项
+## 主要用途
+
+- 在未指定行数时默认显示前10行。
+- 处理多个文件时会在各个文件之前附加含有文件名的行。
+- 当没有文件或文件为`-`时，读取标准输入。
+
+## 选项
 
 ```shell
--n<数字>：指定显示头部内容的行数；
+-c, --bytes=[-]NUM       显示前NUM字节；如果NUM前有"-"，那么会打印除了文件末尾的NUM字节以外的其他内容。
--c<字符数>：指定显示头部内容的字符数；
+-n, --lines=[-]NUM       显示前NUM行而不是默认的10行；如果NUM前有"-"，那么会打印除了文件末尾的NUM行以外的其他行。
--v：总是显示文件名的头信息；
+-q, --quiet, --silent    不打印文件名行。
--q：不显示文件名的头信息。
+-v, --verbose            总是打印文件名行。
+-z, --zero-terminated    行终止符为NUL而不是换行符。
+--help                   显示帮助信息并退出。
+--version                显示版本信息并退出。
+
+NUM可以有一个乘数后缀：
+b 512
+kB 1000
+k 1024
+MB 1000*1000
+M 1024*1024
+GB 1000*1000*1000
+G 1024*1024*1024
+T、P、E、Z、Y等以此类推。
+
+也可以使用二进制前缀：
+KiB=K
+MiB=M
+以此类推。
 ```
 
-### 参数
+## 参数
 
-文件列表：指定显示头部内容的文件列表。
+FILE（可选）：要处理的文件，可以为一或多个。
 
+## 返回值
+
+返回0表示成功，返回非0值表示失败。
+
+## 例子
+
+```shell
+# 查看历史文件的前6行：
+[user2@pc ~]$ head -n 6 ~/.bash_history
+#1575425555
+cd ~
+#1575425558
+ls -lh
+#1575425562
+vi ~/Desktop/ZhuangZhu-74.txt
+```
+
+```shell
+# 查看多个文件：
+[user2@pc ~]$ head -n ~/.bash_history ~/.bashrc
+==> /allhome/user2/.bash_history <==
+#1575425555
+cd ~
+#1575425558
+ls -lh
+#1575425562
+vi ~/Desktop/ZhuangZhu-74.txt
+#1575425566
+uptime
+#1575425570
+find ~/ -maxdepth 3 -name 'test.sh' -exec lh {} \;
+
+==> /allhome/user2/.bashrc <==
+# .bashrc
+
+# forbid use Ctrl+D to exit shell.
+set -o ignoreeof
+
+# Source global definitions.
+if [ -f /etc/bashrc ]; then
+        . /etc/bashrc
+fi
+
+```
+
+
+### 注意
+
+1. 该命令是`GNU coreutils`包中的命令，相关的帮助信息请查看`man -s 1 head`，`info coreutils 'head invocation'`。
 
 <!-- Linux命令行搜索引擎：https://jaywcjlove.github.io/linux-command/ -->

command/nc.md

@@ -17,7 +17,7 @@ nc [-hlnruz][-g<网关...>][-G<指向器数目>][-i<延迟秒数>][-o<输出文
 ###  选项
 
 ```shell
--g<网关> 设置路由器跃程通信网关，最丢哦可设置8个。
+-g<网关> 设置路由器跃程通信网关，最多可设置8个。
 -G<指向器数目> 设置来源路由指向器，其数值为4的倍数。
 -h 在线帮助。
 -i<延迟秒数> 设置时间间隔，以便传送信息及扫描通信端口。

command/nl.md

@@ -1,94 +1,156 @@
 nl
 ===
 
-在Linux系统中计算文件内容行号
+为每一个文件添加行号。
 
-## 补充说明
+## 概要
-
-**nl命令** 读取 file 参数（缺省情况下标准输入），计算输入中的行号，将计算过的行号写入标准输出。在输出中，nl命令根据您在命令行中指定的标志来计算左边的行。输入文本必须写在逻辑页中。每个逻辑页有头、主体和页脚节（可以有空节）。除非使用`-p`选项，nl 命令在每个逻辑页开始的地方重新设置行号。可以单独为头、主体和页脚节设置行计算标志（例如，头和页脚行可以被计算然而文本行不能）。其默认的结果与`cat -n`有点不太一样， nl 可以将行号做比较多的显示设计，包括位数与是否自动补齐0等等的功能。
-
-###  语法
 
 ```shell
-nl (选项) (参数)
+nl [OPTION]... [FILE]...
 ```
 
-###  选项
+## 主要用途
+
+- 将每一个输入的文件添加行号后发送到标准输出。
+- 当没有文件或文件为`-`时，读取标准输入
+- 处理逻辑页（logical page）。
+
+## 选项
 
 ```shell
--b ：指定行号指定的方式，主要有两种：
+-b, --body-numbering=STYLE           使用STYLE 为body部分的行附加行号。
-    -b a ：表示不论是否为空行，也同样列出行号(类似 cat -n)；
+-d, --section-delimiter=CC           使用CC作为logical page的分隔符。
-    -b t ：如果有空行，空的那一行不要列出行号(默认值)；
+-f, --footer-numbering=STYLE         使用STYLE 为footer部分的行附加行号。
+-h, --header-numbering=STYLE         使用STYLE 为header部分的行附加行号。
+-i, --line-increment=NUMBER          行号递增间隔为NUMBER。
+-l, --join-blank-lines=NUMBER        连续NUMBER行的空行作为一行处理。
+-n, --number-format=FORMAT           根据FORMAT插入行号。
+-p, --no-renumber                    不要在每个部分重置行号。
+-s, --number-separator=STRING        在行号后添加字符串STRING。
+-v, --starting-line-number=NUMBER    每部分的起始行号。
+-w, --number-width=NUMBER            行号宽度为NUMBER。
+--help                               显示帮助信息并退出。
+--version                            显示版本信息并退出。
 
--n ：列出行号表示的方法，主要有三种：
-    -n ln ：行号在萤幕的最左方显示；
-    -n rn ：行号在自己栏位的最右方显示，且不加 0 ；
-    -n rz ：行号在自己栏位的最右方显示，且加 0 ；
 
--w ：行号栏位的占用的位数。
+默认选项为：-bt -d'\:' -fn -hn -i1 -l1 -nrn -sTAB -v1 -w6
--p ：在逻辑定界符处不重新开始计算。
+
+CC是由两个字符组成的，默认为\: ,第二个字符如果缺失则默认为:
+
+STYLE可以为下列可用值之一：
+
+a       所有行标记行号。
+t       仅为非空行标记行号。
+n       不标记行号。
+pBRE    符合基础正则表达式（BRE）的行会标记行号。
+
+FORMAT可以为下列可用值之一：
+
+ln    左对齐，不会在开始部分补充0以满足宽度。
+rn    右对齐，不会在开始部分补充0以满足宽度。
+rz    右对齐，会在开始部分补充0以满足宽度。
+
+logical page
+三部分组成（header， body， footer）
+起始标记（header \:\:\:， body \:\:， footer \:）
 ```
 
-###  实例
+## 参数
 
- **用 nl 列出 log2015.log 的内容** ：
+FILE（可选）：要处理的文件，可以为一或多个。
+
+## 返回值
+
+返回0表示成功，返回非0值表示失败。
+
+## 例子
 
 ```shell
-root@localhost [test]# nl log2015.log
+nl_logicalpage.txt：该文件用于说明nl命令处理逻辑页，内容如下：
-1 2015-01
+\:\:\:
-2 2015-02
+header_1
-
+\:\:
-3 ======[root@localhost test]#
+body_1
+\:
+footer_1
+\:\:\:
+header_2
+\:\:
+body_2
+\:
+footer_2
 ```
 
-说明：文件中的空白行，nl 不会加上行号
-
- **用 nl 列出 log2015.log 的内容，空本行也加上行号** ：
-
 ```shell
-[root@localhost test]# nl -b a log2015.log
+[user2@pc ~]$ nl nl_logicalpage.txt
-1 2015-01
-2 2015-02
-3
-4
-5 ======[root@localhost test]#
-```
 
- **让行号前面自动补上0，统一输出格式：** 
+       header_1
+
+     1	body_1
+
+       footer_1
+
+       header_2
+
+     1	body_2
+
+       footer_2
+
+[user2@pc ~]$ nl -v0 -fa -ha nl_logicalpage.txt
+
+     0	header_1
+
+     1	body_1
+
+     2	footer_1
+
+     0	header_2
+
+     1	body_2
+
+     2	footer_2
+
+[user2@pc ~]$ nl -p -fa -ha nl_logicalpage.txt
+
+     1	header_1
+
+     2	body_1
+
+     3	footer_1
+
+     4	header_2
+
+     5	body_2
+
+     6	footer_2
+```
 
 ```shell
-[root@localhost test]# nl -b a -n rz log2015.log
+nl_normal.txt：该文件用于说明nl命令处理普通文件，内容如下：
-000001 2015-01
+ZhuangZhu-74
-000002 2015-02
+2019-11-21
-000003 2015-03
+127.0.0.1
-000004 2015-04
-000005 2015-05
-000006 2015-06
-000007 2015-07
-000008 2015-08
-000009 2015-09
-000010 2015-10
-000011 2015-11
-000012 2015-12
-000013 =======
-
-[root@localhost test]# nl -b a -n rz -w 3 log2015.log
-001 2015-01
-002 2015-02
-003 2015-03
-004 2015-04
-005 2015-05
-006 2015-06
-007 2015-07
-008 2015-08
-009 2015-09
-010 2015-10
-011 2015-11
-012 2015-12
-013 =======
 ```
 
-说明：`nl -b a -n rz`命令行号默认为六位，要调整位数可以加上参数`-w 3`调整为3位。
+```shell
+[user2@pc ~]$ nl nl_normal.txt
+     1	ZhuangZhu-74
+     2	2019-11-21
+     3	127.0.0.1
 
+[user2@pc ~]$ nl -b p'1$' nl_normal.txt
+       ZhuangZhu-74
+     1	2019-11-21
+     2	127.0.0.1
+
+[user2@pc ~]$ nl -b p'^[A-Z]' nl_normal.txt
+     1	ZhuangZhu-74
+       2019-11-21
+       127.0.0.1
+```
+
+### 注意
+
+1. 该命令是`GNU coreutils`包中的命令，相关的帮助信息请查看`man -s 1 nl`，`info coreutils 'nl invocation'`。
 
 <!-- Linux命令行搜索引擎：https://jaywcjlove.github.io/linux-command/ -->

command/split.md

@@ -13,7 +13,7 @@ split
 -b：值为每一输出档案的大小，单位为 byte。
 -C：每一输出档中，单行的最大 byte 数。
 -d：使用数字作为后缀。
--l：值为每一输出档的列数大小。
+-l：值为每一输出档的行数大小。
 -a：指定后缀长度(默认为2)。
 ```