Linux shell命令幫助格式詳解

2022-09-26 11:39:11 字數 2228 閱讀 4725

前言

linux shell命令通常可以通過-h或--help來列印幫助說明,或者通過man命令來檢視幫助,有時候我們也會給自己的程式寫簡單的幫助說明,其實幫助說明格式是有規律可循的

幫助示例

下面是git reset命令的幫助說明,通過man git-reset可以檢視

git reset [-q] [程式設計客棧--] ...

git reset (--patch | -p) [--] [...]

git reset [--soft | --mixed | --hard | --merge | --keep] [-q]

對於命令和引數大致有如下幾種型別

下面來一一介紹

引數型別解讀

原生引數

說明文件裡的字元即為命令需要使用的字元,比如以上命令的

git reset

這種引數在使用時必需指定,且和說明文件裡的一致

佔位引數

表示方式:<>

和原生引數類似,都是必需指定的,只不過佔位引數的實際字元是在使用時指定的,同時為了方便閱讀會用乙個描述詞彙來表示,並以<>包圍,比如

表示路徑,使用時可以指定為具體的路徑,而paths只是起乙個說明作用,有些幫助說明裡也會用大寫來表示佔位引數,比如將以上引數說明寫成paths

可選組合

表示方式:

括號裡的引數為可選引數,比如usage第二個裡面的[-q],則-q為可選引數

可選項和佔位引數也可以同時使用,如

表示該引數可以指定某次提交,也可以不指定

必選組合

表示方式:()

括號裡的引數必需指定,通常裡面會是一些互斥引數,比如

(--patch | -p)

表示--patch和-p這兩個引數必需指定乙個

互斥引數

表示方式:|

互斥引數一般都在()和裡,表示該引數只能指定其中乙個,比如

[--mixed | --soft | --hard | --merge | --keep]

重複引數

表示方式:...

表示前乙個引數可以被指定多個,比如

...是乙個佔位引數,使用時必需指定為路徑,...並表示可以指定多個路徑。重複引數的乙個典型使用場景就是移動檔案,將多個檔案移動到乙個目錄下,比如如下命令

git mv ovyxrgugurce>...

我們可以這樣使用

git mv -f a.cpp b.py dir

此時options對應為-f引數,source對應為a.cpp b.py,destination對應為dir

標記後續引數型別

表示方式:--

表示後續引數的某種型別,比如這裡如果使用如下命令

git reset -p -- xx

對比第乙個命令,這裡的xx對應的www.cppcns.com應該是引數,當我們指定--之後,則git會認為xx就是乙個路徑,那怕它是特殊符號或者路徑並不存在。這是shell命令的乙個通用方式,比如我們有乙個檔名為-h,如果想刪除這個檔案,執行

rm -h

肯定是無法刪除的,因為這時-h會被認為是rm的乙個引數選項,應該使用

rm -- -h

這時shell會將-h解釋為乙個檔名傳遞給rm命令

解讀實戰

最後來解釋乙個比較複雜的幫助說明

git cat-file (-t [--allow-unknown-type]|-s [--allow-unknown-type]|-e|-p||--textconv)

該命令引數由四個部分,其中git和cat-file為原生引數,()裡的為可選組合,為佔位引數

組合又由6部分組成,為互斥關係

-t [--allow-unknown-type]

-s [--allow-unknown-type]

-e-p

--textconv

因此該命令的幫助說明可以拆分如下

git cat-file -t

git cat-file -t --allow-unknown-type

git cat-file程式設計客棧 -s

git cat-file -s --allow-unknown-type

git cat-file -e

git cat-file -p

git cat-file 程式設計客棧pe>

git cat-file --textconv

總結本文標題: linux shell命令幫助格式詳解

本文位址:

Linux Shell命令 tr命令

在linux常用的命令中,我們可以通過使用tr,非常容易地實現 sed 的許多最基本功能。1 定義 日常操作中,tr用來從標準輸入中通過替換或刪除操作進行字元轉換。2 使用格式 tr c d s string1 to translate from string2 to translate to in...

Linux命令 幫助命令

命令名稱 man 命令英文原意 manual 命令所在路徑 usr bin man 執行許可權 所有使用者 功能描述 獲得幫助資訊 命令 配置檔案 語法 man 配置檔案名稱 命令 命令名稱 info 命令英文原意 information 命令所在路徑 usr bin info 執行許可權 所有使用...

linux命令 幫助命令

幫助命令 man 命令名稱 man 命令英文原意 manual 命令所在路徑 usr bin man 執行許可權 所有使用者 語法 man 命令或配置檔案 功能描述 獲得幫助資訊 範例 man ls 檢視 ls命令的幫助資訊 man services 檢視配置檔案 services 的幫助資訊 所有...