learning
/
linux-command
mirror of https://github.com/jaywcjlove/linux-command.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

fix(curl,time): 格式化内容，并参考 #359 #352 修改文档 (#488)

This commit is contained in:
丛林意志 2023-04-25 00:27:10 +08:00 committed by GitHub
parent 5eed550c2f
commit 9c38fcf583
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 249 additions and 178 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

353
command/curl.md
View File

@ -16,109 +16,109 @@ curl(选项)(参数)
### 选项
```bash
-a/--append # 上传文件时，附加到目标文件
-A/--user-agent # 设置用户代理发送给服务器
-anyauth # 可以使用“任何”身份验证方法
-b/--cookie # cookie字符串或文件读取位置
     --basic # 使用HTTP基本验证
-B/--use-ascii # 使用ASCII /文本传输
-c/--cookie-jar # 操作结束后把cookie写入到这个文件中
-C/--continue-at # 断点续传
-d/--data # HTTP POST方式传送数据
     --data-ascii # 以ascii的方式post数据
     --data-binary # 以二进制的方式post数据
     --negotiate # 使用HTTP身份验证
     --digest # 使用数字身份验证
     --disable-eprt # 禁止使用EPRT或LPRT
     --disable-epsv # 禁止使用EPSV
-D/--dump-header # 把header信息写入到该文件中
     --egd-file # 为随机数据(SSL)设置EGD socket路径
     --tcp-nodelay # 使用TCP\_NODELAY选项
-e/--referer # 来源网址
-E/--cert # 客户端证书文件和密码 (SSL)
     --cert-type # 证书文件类型 (DER/PEM/ENG) (SSL)
     --key # 私钥文件名 (SSL)
     --key-type # 私钥文件类型 (DER/PEM/ENG) (SSL)
     --pass # 私钥密码 (SSL)
     --engine # 加密引擎使用 (SSL). "--engine list" for list
     --cacert # CA证书 (SSL)
     --capath # CA目录 (made using c\_rehash) to verify peer against (SSL)
     --ciphers # SSL密码
     --compressed # 要求返回是压缩的形势 (using deflate or gzip)
     --connect-timeout # 设置最大请求时间
     --create-dirs # 建立本地目录的目录层次结构
     --crlf # 上传是把LF转变成CRLF
-f/--fail # 连接失败时不显示http错误
     --ftp-create-dirs # 如果远程目录不存在，创建远程目录
     --ftp-method \[multicwd/nocwd/singlecwd] # 控制CWD的使用
     --ftp-pasv # 使用 PASV/EPSV 代替端口
     --ftp-skip-pasv-ip # 使用PASV的时候,忽略该IP地址
     --ftp-ssl # 尝试用 SSL/TLS 来进行ftp数据传输
     --ftp-ssl-reqd # 要求用 SSL/TLS 来进行ftp数据传输
-F/--form # 模拟http表单提交数据
     --form-string # 模拟http表单提交数据
-g/--globoff # 禁用网址序列和范围使用{}和\[]
-G/--get # 以get的方式来发送数据
-H/--header # 自定义头信息传递给服务器
     --ignore-content-length # 忽略的HTTP头信息的长度
-i/--include # 输出时包括protocol头信息
-I/--head # 只显示请求头信息
-j/--junk-session-cookies # 读取文件进忽略session cookie
     --interface # 使用指定网络接口/地址
     --krb4 # 使用指定安全级别的krb4
-k/--insecure # 允许不使用证书到SSL站点
-K/--config # 指定的配置文件读取
-l/--list-only # 列出ftp目录下的文件名称
     --limit-rate # 设置传输速度
     --local-port # 强制使用本地端口号
-m/--max-time # 设置最大传输时间
     --max-redirs # 设置最大读取的目录数
     --max-filesize # 设置最大下载的文件总量
-M/--manual # 显示全手动
-n/--netrc # 从netrc文件中读取用户名和密码
     --netrc-optional # 使用 .netrc 或者 URL来覆盖-n
     --ntlm # 使用 HTTP NTLM 身份验证
-N/--no-buffer # 禁用缓冲输出
-o/--output # 把输出写到该文件中
-O/--remote-name # 把输出写到该文件中，保留远程文件的文件名
-p/--proxytunnel # 使用HTTP代理
     --proxy-anyauth # 选择任一代理身份验证方法
     --proxy-basic # 在代理上使用基本身份验证
     --proxy-digest # 在代理上使用数字身份验证
     --proxy-ntlm # 在代理上使用ntlm身份验证
-P/--ftp-port # 使用端口地址，而不是使用PASV
-q # 作为第一个参数，关闭 .curlrc
-Q/--quote # 文件传输前，发送命令到服务器
-r/--range # 检索来自HTTP/1.1或FTP服务器字节范围
--range-file # 读取（SSL）的随机文件
-R/--remote-time # 在本地生成文件时，保留远程文件时间
     --retry # 传输出现问题时，重试的次数
     --retry-delay # 传输出现问题时，设置重试间隔时间
     --retry-max-time # 传输出现问题时，设置最大重试时间
-s/--silent # 静默模式。不输出任何东西
-S/--show-error # 显示错误
     --socks4 # 用socks4代理给定主机和端口
     --socks5 # 用socks5代理给定主机和端口
     --stderr #  
-t/--telnet-option # Telnet选项设置
     --trace # 对指定文件进行debug
     --trace-ascii # Like --跟踪但没有hex输出
     --trace-time # 跟踪/详细输出时，添加时间戳
-T/--upload-file # 上传文件
     --url # Spet URL to work with
-u/--user # 设置服务器的用户和密码
-U/--proxy-user # 设置代理用户名和密码
-w/--write-out \[format] # 什么输出完成后
-x/--proxy # 在给定的端口上使用HTTP代理
-X/--request # 指定什么命令
-y/--speed-time # 放弃限速所要的时间，默认为30
-Y/--speed-limit # 停止传输速度的限制，速度时间
-a --append # 上传文件时，附加到目标文件
-A --user-agent # 设置用户代理发送给服务器
-anyauth # 可以使用“任何”身份验证方法
-b --cookie # cookie字符串或文件读取位置
     --basic # 使用HTTP基本验证
-B --use-ascii # 使用ASCII /文本传输
-c --cookie-jar # 操作结束后把cookie写入到这个文件中
-C --continue-at # 断点续传
-d --data # HTTP POST方式传送数据
     --data-ascii # 以ascii的方式post数据
     --data-binary # 以二进制的方式post数据
     --negotiate # 使用HTTP身份验证
     --digest # 使用数字身份验证
     --disable-eprt # 禁止使用EPRT或LPRT
     --disable-epsv # 禁止使用EPSV
-D --dump-header # 把header信息写入到该文件中
     --egd-file # 为随机数据(SSL)设置EGD socket路径
     --tcp-nodelay # 使用TCP\_NODELAY选项
-e --referer # 来源网址
-E --cert # 客户端证书文件和密码 (SSL)
     --cert-type # 证书文件类型 (DER/PEM/ENG) (SSL)
     --key # 私钥文件名 (SSL)
     --key-type # 私钥文件类型 (DER/PEM/ENG) (SSL)
     --pass # 私钥密码 (SSL)
     --engine # 加密引擎使用 (SSL). "--engine list" for list
     --cacert # CA证书 (SSL)
     --capath # CA目录 (made using c\_rehash) to verify peer against (SSL)
     --ciphers # SSL密码
     --compressed # 要求返回是压缩的形势 (using deflate or gzip)
     --connect-timeout # 设置最大请求时间
     --create-dirs # 建立本地目录的目录层次结构
     --crlf # 上传是把LF转变成CRLF
-f --fail # 连接失败时不显示http错误
     --ftp-create-dirs # 如果远程目录不存在，创建远程目录
     --ftp-method \[multicwd/nocwd/singlecwd] # 控制CWD的使用
     --ftp-pasv # 使用 PASV/EPSV 代替端口
     --ftp-skip-pasv-ip # 使用PASV的时候,忽略该IP地址
     --ftp-ssl # 尝试用 SSL/TLS 来进行ftp数据传输
     --ftp-ssl-reqd # 要求用 SSL/TLS 来进行ftp数据传输
-F --form # 模拟http表单提交数据
     --form-string # 模拟http表单提交数据
-g --globoff # 禁用网址序列和范围使用{}和\[]
-G --get # 以get的方式来发送数据
-H --header # 自定义头信息传递给服务器
     --ignore-content-length # 忽略的HTTP头信息的长度
-i --include # 输出时包括protocol头信息
-I --head # 只显示请求头信息
-j --junk-session-cookies # 读取文件进忽略session cookie
     --interface # 使用指定网络接口/地址
     --krb4 # 使用指定安全级别的krb4
-k --insecure # 允许不使用证书到SSL站点
-K --config # 指定的配置文件读取
-l --list-only # 列出ftp目录下的文件名称
     --limit-rate # 设置传输速度
     --local-port # 强制使用本地端口号
-m --max-time # 设置最大传输时间
     --max-redirs # 设置最大读取的目录数
     --max-filesize # 设置最大下载的文件总量
-M --manual # 显示全手动
-n --netrc # 从netrc文件中读取用户名和密码
     --netrc-optional # 使用 .netrc 或者 URL来覆盖-n
     --ntlm # 使用 HTTP NTLM 身份验证
-N --no-buffer # 禁用缓冲输出
-o --output # 把输出写到该文件中
-O --remote-name # 把输出写到该文件中，保留远程文件的文件名
-p --proxytunnel # 使用HTTP代理
     --proxy-anyauth # 选择任一代理身份验证方法
     --proxy-basic # 在代理上使用基本身份验证
     --proxy-digest # 在代理上使用数字身份验证
     --proxy-ntlm # 在代理上使用ntlm身份验证
-P --ftp-port # 使用端口地址，而不是使用PASV
-q # 作为第一个参数，关闭 .curlrc
-Q --quote # 文件传输前，发送命令到服务器
-r --range # 检索来自HTTP/1.1或FTP服务器字节范围
--range-file # 读取（SSL）的随机文件
-R --remote-time # 在本地生成文件时，保留远程文件时间
     --retry # 传输出现问题时，重试的次数
     --retry-delay # 传输出现问题时，设置重试间隔时间
     --retry-max-time # 传输出现问题时，设置最大重试时间
-s --silent # 静默模式。不输出任何东西
-S --show-error # 显示错误
     --socks4 # 用socks4代理给定主机和端口
     --socks5 # 用socks5代理给定主机和端口
     --stderr #  
-t --telnet-option # Telnet选项设置
     --trace # 对指定文件进行debug
     --trace-ascii # Like --跟踪但没有hex输出
     --trace-time # 跟踪/详细输出时，添加时间戳
-T --upload-file # 上传文件
     --url <url> # 要使用的 URL
-u --user # 设置服务器的用户和密码
-U --proxy-user # 设置代理用户名和密码
-w --write-out \[format] # 什么输出完成后
-x --proxy # 在给定的端口上使用HTTP代理
-X --request # 指定什么命令
-y --speed-time # 放弃限速所要的时间，默认为30
-Y --speed-limit # 停止传输速度的限制，速度时间
```
### 实例
**文件下载**
#### **文件下载**
curl命令可以用来执行下载、发送各种HTTP请求，指定HTTP头部等操作。如果系统没有curl可以使用`yum install curl`安装，也可以下载安装。curl是将下载文件输出到stdout，将进度信息输出到stderr，不显示进度信息使用`--silent`选项。
@ -141,7 +141,7 @@ curl http://example.com/test.iso -o filename.iso --progress
######################################### 100.0%
```
**不输出错误和进度信息**
#### **不输出错误和进度信息**
`-s` 参数将不输出错误和进度信息。
@ -153,9 +153,10 @@ curl -s https://www.example.com
如果想让 curl 不产生任何输出，可以使用下面的命令。
```shell
curl -s -o /dev/null https://google.com
curl -s -o /dev/null https://example.com
```
**断点续传**
#### **断点续传**
curl能够从特定的文件偏移处继续下载，它可以通过指定一个便宜量来下载部分文件：
@ -166,19 +167,19 @@ curl URL/File -C 偏移量
curl -C -URL
```
**使用curl设置参照页字符串**
#### **使用curl设置参照页字符串**
参照页是位于HTTP头部中的一个字符串，用来表示用户是从哪个页面到达当前页面的，如果用户点击网页A中的某个连接，那么用户就会跳转到B网页，网页B头部的参照页字符串就包含网页A的URL。
使用`--referer`选项指定参照页字符串：
使用 `--referer` 选项指定参照页字符串：
```shell
curl --referer http://www.google.com http://wangchujiang.com
curl --referer http://www.example.com http://example.com
```
**用curl设置用户代理字符串**
#### **用curl设置用户代理字符串**
有些网站访问会提示只能使用IE浏览器来访问，这是因为这些网站设置了检查用户代理，可以使用curl把用户代理设置为IE，这样就可以访问了。使用`--user-agent`或者`-A`选项：
有些网站访问会提示只能使用IE浏览器来访问，这是因为这些网站设置了检查用户代理，可以使用curl把用户代理设置为IE，这样就可以访问了。使用 `--user-agent` 或者 `-A` 选项：
```shell
curl URL --user-agent "Mozilla/5.0"
@ -188,10 +189,10 @@ curl URL -A "Mozilla/5.0"
其他HTTP头部信息也可以使用curl来发送，使用`-H`"头部信息" 传递多个头部信息，例如：
```shell
curl -H "Host:wangchujiang.com" -H "accept-language:zh-cn" URL
curl -H "Host:example.com" -H "accept-language:zh-cn" URL
```
**curl的带宽控制和下载配额**
#### **curl的带宽控制和下载配额**
使用`--limit-rate`限制curl的下载速度：
@ -214,76 +215,81 @@ curl --limit-rate 200k https://example.com
# 上面命令将带宽限制在每秒 200K 字节。
```
**用curl进行认证**
#### **用curl进行认证**
使用curl选项 -u 可以完成HTTP或者FTP的认证，可以指定密码，也可以不指定密码在后续操作中输入密码：
```shell
curl -u user:pwd http://wangchujiang.com
curl -u user http://wangchujiang.com
curl -u user:pwd http://example.com
curl -u user http://example.com
```
**只打印响应头部信息**
#### **只打印响应头部信息**
通过`-I`或者`-head`可以只打印出HTTP头部信息：
```shell
[root@localhost text]# curl -I http://wangchujiang.com
[root@localhost text]# curl -I http://example.com
HTTP/1.1 200 OK
Server: nginx/1.2.5
date: Mon, 10 Dec 2012 09:24:34 GMT
Content-Encoding: gzip
Accept-Ranges: bytes
Age: 275552
Cache-Control: max-age=604800
Content-Type: text/html; charset=UTF-8
Connection: keep-alive
Vary: Accept-Encoding
X-Pingback: http://wangchujiang.com/xmlrpc.php
Date: Mon, 24 Apr 2023 14:39:36 GMT
Etag: "3147526947+gzip"
Expires: Mon, 01 May 2023 14:39:36 GMT
Last-Modified: Thu, 17 Oct 2019 07:18:26 GMT
Server: ECS (sec/96EE)
X-Cache: HIT
Content-Length: 648
```
**get请求**
#### **GET 请求**
```shell
curl "http://www.wangchujiang.com" # 如果这里的URL指向的是一个文件或者一幅图都可以直接下载到本地
curl -i "http://www.wangchujiang.com" # 显示全部信息
curl -l "http://www.wangchujiang.com" # 显示页面内容
curl -v "http://www.wangchujiang.com" # 显示get请求全过程解析
curl "http://www.example.com" # 如果这里的URL指向的是一个文件或者一幅图都可以直接下载到本地
curl -i "http://www.example.com" # 显示全部信息
curl -l "http://www.example.com" # 显示页面内容
curl -v "http://www.example.com" # 显示get请求全过程解析
```
**post请求**
#### **POST 请求**
```shell
$ curl -d "param1=value1&param2=value2" "http://www.wangchujiang.com/login"
$ curl -d "param1=value1&param2=value2" "http://www.example.com/login"
curl -d'login=emma＆password=123' -X POST https://wangchujiang.com/login
$ curl -d'login=emma＆password=123' -X POST https://example.com/login
# 或者
$ curl -d 'login=emma' -d 'password=123' -X POST https://wangchujiang.com/login
$ curl -d 'login=emma' -d 'password=123' -X POST https://example.com/login
```
`--data-urlencode` 参数等同于 `-d`，发送 `POST` 请求的数据体，区别在于会自动将发送的数据进行 `URL` 编码。
```shell
curl --data-urlencode 'comment=hello world' https://wangchujiang.com/login
curl --data-urlencode 'comment=hello world' https://example.com/login
# 上面代码中，发送的数据hello world之间有一个空格，需要进行 URL 编码。
```
**读取本地文本文件的数据，向服务器发送**
#### **发送本地文件中的文字**
```shell
curl -d '@data.txt' https://wangchujiang.com/upload
curl -d '@data.txt' https://example.com/upload
# 读取data.txt文件的内容，作为数据体向服务器发送。
```
**json格式的post请求**
#### **JSON 格式的 POST 请求**
```shell
curl -l -H "Content-type: application/json" -X POST -d '{"phone":"13521389587","password":"test"}' http://wangchujiang.com/apis/users.json
curl -l -H "Content-type: application/json" -X POST -d '{"phone":"13888888888","password":"test"}' http://example.com/apis/users.json
```
**向服务器发送 Cookie**
#### **向服务器发送 Cookie**
使用`--cookie "COKKIES"`选项来指定cookie，多个cookie使用分号分隔：
```shell
curl http://wangchujiang.com --cookie "user=root;pass=123456"
curl http://example.com --cookie "user=root;pass=123456"
```
将cookie另存为一个文件，使用`--cookie-jar`选项：
@ -292,95 +298,94 @@ curl http://wangchujiang.com --cookie "user=root;pass=123456"
curl URL --cookie-jar cookie_file
```
`-b` 参数用来向服务器发送 Cookie。
```shell
curl -b 'foo=bar' https://taobao.com
curl -b 'foo=bar' https://example.com
# 上面命令会生成一个标头Cookie: foo=bar，向服务器发送一个名为foo、值为bar的 Cookie。
```
```shell
curl -b 'foo1=bar' -b 'foo2=baz' https://taobao.com
curl -b 'foo1=bar' -b 'foo2=baz' https://example.com
# 上面命令发送两个 Cookie。
```shell
curl -b cookies.txt https://www.taobao.com
curl -b cookies.txt https://www.example.com
# 上面命令读取本地文件 cookies.txt，里面是服务器设置的 Cookie（参见-c参数），将其发送到服务器。
```
**Cookie 写入一个文件**
#### **Cookie 写入一个文件**
```shell
curl -c cookies.txt https://www.taobao.com
curl -c cookies.txt https://www.example.com
# 上面命令将服务器的 HTTP 回应所设置 Cookie 写入文本文件cookies.txt。
```
**请求的来源**
#### **请求的来源**
`-e` 参数用来设置 `HTTP` 的标头 `Referer`，表示请求的来源。
```shell
curl -e 'https://taobao.com?q=example' https://www.example.com
# 上面命令将Referer标头设为 https://taobao.com?q=example。
curl -e 'https://example.com?q=example' https://www.example.com
# 上面命令将Referer标头设为 https://example.com?q=example。
```
`-H` 参数可以通过直接添加标头 `Referer`，达到同样效果。
```shell
curl -H 'Referer: https://taobao.com?q=example' https://www.example.com
curl -H 'Referer: https://example.com?q=example' https://www.example.com
```
**上传二进制文件**
#### **上传二进制文件**
`-F` 参数用来向服务器上传二进制文件。
```shell
curl -F 'file=@photo.png' https://taobao.com/profile
curl -F 'file=@photo.png' https://example.com/profile
# 上面命令会给 HTTP 请求加上标头 Content-Type: multipart/form-data ，然后将文件photo.png作为file字段上传。
```
`-F` 参数可以指定 `MIME` 类型。
```shell
curl -F 'file=@photo.png;type=image/png' https://taobao.com/profile
curl -F 'file=@photo.png;type=image/png' https://example.com/profile
# 上面命令指定 MIME 类型为image/png，否则 curl 会把 MIME 类型设为 application/octet-stream。
```
`-F` 参数也可以指定文件名。
```shell
curl -F 'file=@photo.png;filename=me.png' https://taobao.com/profile
curl -F 'file=@photo.png;filename=me.png' https://example.com/profile
# 上面命令中，原始文件名为photo.png，但是服务器接收到的文件名为me.png。
```
**设置请求头**
#### **设置请求头**
`-H` 参数添加 `HTTP` 请求的标头。
```shell
curl -H 'Accept-Language: en-US' https://google.com
curl -H 'Accept-Language: en-US' https://example.com
# 上面命令添加 HTTP 标头 Accept-Language: en-US。
```
```shell
curl -H 'Accept-Language: en-US' -H 'Secret-Message: xyzzy' https://google.com
curl -H 'Accept-Language: en-US' -H 'Secret-Message: xyzzy' https://example.com
# 上面命令添加两个 HTTP 标头。
```
```shell
curl -d '{"login": "emma", "pass": "123"}' -H 'Content-Type: application/json' https://google.com/login
curl -d '{"login": "emma", "pass": "123"}' -H 'Content-Type: application/json' https://example.com/login
# 上面命令添加 HTTP 请求的标头是 Content-Type: application/json，然后用 -d 参数发送 JSON 数据。
```
**跳过 SSL 检测**
#### **跳过 SSL 检测**
```shell
curl -k https://www.example.com
# 上面命令不会检查服务器的 SSL 证书是否正确。
```
**请求跟随服务器的重定向**
#### **请求跟随服务器的重定向**
`-L` 参数会让 `HTTP` 请求跟随服务器的重定向。`curl` 默认不跟随重定向。
@ -388,7 +393,26 @@ curl -k https://www.example.com
curl -L -d 'tweet=hi' https://api.example.com/tweet
```
**调试参数**
值得注意的是，这种重定向方式不适用于在返回的 HTML 中的重定向，比如这种是不被 curl 识别的重定向(这部分内容由 `curl -v -L <url>` 生成)
```curl
* Connected to example.com (*.*.*.*) port 80 (#0)
> GET / HTTP/1.1
> Host: example.com
> User-Agent: curl/8.0.1
> Accept: */*
>
< HTTP/1.1 200 OK
....
< Content-Type: text/html
<
<html>
<meta http-equiv="refresh" content="0;url=http://www.example.com/">
</html>
```
#### **调试参数**
`-v` 参数输出通信的整个过程，用于调试。
@ -398,17 +422,16 @@ curl -v https://www.example.com
```
```shell
$ curl --trace - https://www.example.com
curl --trace - https://www.example.com
```
**获取本机外网ip**
#### **获取本机外网 IP**
```shell
curl ipecho.net/plain
```
**使用 curl 测试网站加载速度**
#### **使用 curl 测试网站加载速度**
命令有一个鲜为人知的选项，`-w`，该选项在请求结束之后打印本次请求的统计数据到标准输出。
@ -428,7 +451,6 @@ Total Time:\t\t\t%{time_total}s\n
curl 提供了很多置换变量，可以在格式化字符串中通过 `%{var}` 的形式使用。完整的变量列表可以在 `curl` 的 `manpage` 中查看。简单介绍一下我们使用的这几个变量：
- `url_effective`: 执行完地址重定向之后的最终 URL；
- `time_namelookup`: 从请求开始至完成名称解析所花的时间，单位为秒，下同；
- `time_redirect`: 执行所有重定向所花的时间；
@ -441,7 +463,7 @@ curl 提供了很多置换变量，可以在格式化字符串中通过 `%{var}`
然后执行请求，通过 @filename 指定保存了格式化字符串的文件：
```shell
$ curl -L -s -w @fmt.txt -o /dev/null http://www.google.com
curl -L -s -w @fmt.txt -o /dev/null http://www.example.com
```
输出：
@ -459,10 +481,10 @@ Start-transfer Time: 0.260115s
Total Time: 0.467691s
```
### 要求返回是压缩的状态
#### **要求返回是压缩的状态**
```shell
▶ curl --compressed -o- -L https://yarnpkg.com/install.sh | bash
$ curl --compressed -o- -L https://yarnpkg.com/install.sh | bash
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 54 100 54 0 0 42 0 0:00:01 0:00:01 --:--:-- 42
@ -484,6 +506,3 @@ Installing Yarn!
100 647 100 647 0 0 1283 0 --:--:-- --:--:-- --:--:-- 1283
100 832 100 832 0 0 1107 0 --:--:-- --:--:-- --:--:-- 812k
```

74
command/time.md
View File

@ -5,24 +5,28 @@ time
## 补充说明
**time命令** 用于统计给定命令所花费的总时间。
`time` 命令是用来确定一个给定的命令需要运行多长时间。它对于测试你的脚本和命令的性能很有用。
### 语法
例如，如果你有两个不同的脚本在做同样的工作，你想知道哪一个表现得更好，你可以用 Linux 的时间命令来确定每个脚本的执行时间。
该指令是 shell 内指令，也是一个软件包，**对于软件包的说明在这篇文档靠下的部分**
## 语法
```shell
time(参数)
time <指令>
```
### 参数
## 参数
指令：指定需要运行的额指令及其参数。
### 实例
## 实例
当测试一个程序或比较不同算法时，执行时间是非常重要的，一个好的算法应该是用时最短的。所有类UNIX系统都包含time命令，使用这个命令可以统计时间消耗。例如：
```shell
[root@localhost ~]# time ls
$ time ls
anaconda-ks.cfg install.log install.log.syslog satools text
real 0m0.009s
@ -30,13 +34,56 @@ user 0m0.002s
sys 0m0.007s
```
输出的信息分别显示了该命令所花费的real时间、user时间和sys时间。
这里的输出会因为使用的发行版本不同而导致展示的结果不同，比如：
* real时间是指挂钟时间，也就是命令开始执行到结束的时间。这个短时间包括其他进程所占用的时间片，和进程被阻塞时所花费的时间。
* user时间是指进程花费在用户模式中的CPU时间，这是唯一真正用于执行进程所花费的时间，其他进程和花费阻塞状态中的时间没有计算在内。
* sys时间是指花费在内核模式中的CPU时间，代表在内核中执系统调用所花费的时间，这也是真正由进程使用的CPU时间。
```shell
# Bash
real 0m33.961s
user 0m0.340s
sys 0m0.940s
shell内建也有一个time命令，当运行time时候是调用的系统内建命令，因为系统内建的功能有限，所以需要时间其他功能需要使用time命令可执行二进制文件`/usr/bin/time`。
# Zsh
0.34s user 0.94s system 4% cpu 33.961 total
# GNU time (sh)
0.34user 0.94system 0:33.96elapsed 4%CPU (0avgtext+0avgdata 6060maxresident)k
0inputs+201456outputs (0major+315minor)pagefaults 0swaps
```
`real` 或者 `total` 或者 `elapsed`（挂钟时间）是指从调用开始到结束的时间。它是指从你按下回车键的那一刻开始，到命令完成的那一刻为止的时间。
user - 在用户模式下花费的CPU时间。
system 或 sys - 在内核模式下花费的CPU时间。
## 软件包
接下来的部分是关于 `time` 软件包提供的 `/usr/bin/time` 二进制可执行程序，而不是 shell 内建的 time 命令。
### 软件包的语法
一些 shells（例如 `bash` ）有一个内置的 `time` 命令，提供类似的关于时间和可能的其他资源的使用信息。
要访问真正的命令，可能需要指定其路径名（类似于`/usr/bin/time`）。
```shell
time [options] command [arguments...]
```
### 软件包指令参数
-f format, --format=format
指定输出格式，可能覆盖环境变量TIME中指定的格式。
-p, --portability
使用可移植的输出格式。
-o file, --output=file
不将结果发送到stderr，而是覆盖指定的文件。
-a, --append
(与-o一起使用。)不覆盖而是附加。
-v, --verbose
对程序知道的所有信息进行非常详细的输出。
-q, --quiet
不报告异常的程序终止（当命令被信号终止时）或非零退出状态。
### 软件包实例
使用`-o`选项将执行时间写入到文件中：
@ -74,3 +121,8 @@ shell内建也有一个time命令，当运行time时候是调用的系统内建
`%w` | 进程主动进行上下文切换的次数，例如等待I/O操作完成。
`%c` | 进程被迫进行上下文切换的次数（由于时间片到期）。
## 参考资料
- Linux Time Command | Linuxize <https://linuxize.com/post/linux-time-command/>
- time(1) — Arch manual pages <https://man.archlinux.org/man/time.1>
- Time - ArchWiki <https://wiki.archlinux.org/title/time>