扫二维码与项目经理沟通
我们在微信上24小时期待你的声音
解答本文疑问/技术咨询/运营咨询/技术建议/互联网交流
这篇文章主要介绍Linux中shell命令帮助格式的示例分析,文中介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们一定要看完!
为渝中等地区用户提供了全套网页设计制作服务,及渝中网站建设行业解决方案。主营业务为网站设计、网站建设、渝中网站设计,以传统方式定制建设网站,并提供域名空间备案等一条龙服务,秉承以专业、用心的态度为用户提供真诚的服务。我们深信只要达到每一位用户的要求,就会得到认可,从而选择与我们长期合作。这样,我们也可以走得更远!前言
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 []
我们可以这样使用
git mv -f a.cpp b.py dir
此时options对应为-f
参数,source对应为a.cpp b.py
,destination对应为dir
标记后续参数类型
表示方式:--
表示后续参数的某种类型,比如这里如果使用如下命令
git reset -p -- xx
对比第一个命令,这里的xx对应的应该是
参数,当我们指定--
之后,则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
以上是“Linux中shell命令帮助格式的示例分析”这篇文章的所有内容,感谢各位的阅读!希望分享的内容对大家有帮助,更多相关知识,欢迎关注创新互联行业资讯频道!
我们在微信上24小时期待你的声音
解答本文疑问/技术咨询/运营咨询/技术建议/互联网交流