diff --git a/README.md b/README.md index c35ae47a..281580ca 100644 --- a/README.md +++ b/README.md @@ -12,42 +12,42 @@ source <(curl -fsSL https://raw.githubusercontent.com/oldratlee/useful-scripts/master/test-cases/self-installer.sh) ``` -更多下载&使用方式，参见[下载使用](install.md)。 +更多下载&使用方式，参见[下载使用](docs/install.md)。 :books: 脚本文档 ---------------------- -### [`Java`相关脚本](java.md) +### [`Java`相关脚本](docs/java.md) -1. [show-busy-java-threads.sh](java.md#beer-show-busy-java-threadssh) - 打印出在运行的`Java`进程中，消耗`CPU`最多的线程栈。用于`Java`的性能问题。 -1. [show-duplicate-java-classes](java.md#beer-show-duplicate-java-classes) - 找出`jar`文件和`class`目录中的重复类。用于`Java`类冲突问题。 -1. [find-in-jars.sh](java.md#beer-find-in-jarssh) +1. [show-busy-java-threads.sh](docs/java.md#beer-show-busy-java-threadssh) + 打印出在运行的`Java`进程中，消耗`CPU`最多的线程栈。用于快速排查`Java`的性能问题。 +1. [show-duplicate-java-classes](docs/java.md#beer-show-duplicate-java-classes) + 找出`jar`文件和`class`目录中的重复类。用于排查`Java`类冲突问题。 +1. [find-in-jars.sh](docs/java.md#beer-find-in-jarssh) 在目录下所有`jar`文件里，查找类或资源文件。 -### [`VCS`相关脚本](vcs.md) +### [`VCS`相关脚本](docs/vcs.md) -1. [swtrunk.sh](vcs.md#beer-swtrunksh) +1. [swtrunk.sh](docs/vcs.md#beer-swtrunksh) 自动`svn`工作目录从分支（`branches`）切换到主干（`trunk`）。 -1. [svn-merge-stop-on-copy.sh](vcs.md#beer-svn-merge-stop-on-copysh) +1. [svn-merge-stop-on-copy.sh](docs/vcs.md#beer-svn-merge-stop-on-copysh) 把指定的远程分支从刚新建分支以来的修改合并到本地`svn`目录或是另一个远程分支。 -1. [cp-svn-url.sh](vcs.md#beer-cp-svn-urlsh) +1. [cp-svn-url.sh](docs/vcs.md#beer-cp-svn-urlsh) 拷贝当前`svn`目录对应的远程分支到系统的粘贴板，省去`CTRL+C`操作。 -### [`Shell`相关脚本](shell.md) +### [`Shell`相关脚本](docs/shell.md) 包含`Shell`使用或命令加强的脚本。 -1. [console-text-color-themes.sh](shell.md#beer-console-text-color-themessh) +1. [console-text-color-themes.sh](docs/shell.md#beer-console-text-color-themessh) 显示`Terminator`的全部文字彩色组合的效果及其打印方式。 -1. [colorful-lines](shell.md#beer-colorful-lines) +1. [colorful-lines](docs/shell.md#beer-colorful-lines) 彩色`cat`出文件行，方便人眼区分不同的行。 -1. [echo-args.sh](shell.md#beer-echo-argssh) +1. [echo-args.sh](docs/shell.md#beer-echo-argssh) 输出脚本收到的参数，在控制台运行时，把参数值括起的括号显示成 **红色**，方便人眼查看。用于调试脚本参数输入。 -1. [tcp-connection-state-counter.sh](shell.md#beer-tcp-connection-state-countersh)： +1. [tcp-connection-state-counter.sh](docs/shell.md#beer-tcp-connection-state-countersh) 统计各个`TCP`连接状态的个数。用于方便排查系统连接负荷问题。 -1. [parseOpts.sh](shell.md#beer-parseoptssh) +1. [parseOpts.sh](docs/shell.md#beer-parseoptssh) 提供命令行选项解析函数`parseOpts`，支持选项的值有多个值（即数组）。 -1. [xpl and xpf](shell.md#beer-xpl-and-xpf) +1. [xpl and xpf](docs/shell.md#beer-xpl-and-xpf) 在文件浏览器中 打开/选中 指定的文件或文件夹。 diff --git a/docs/console-colorful-text.png b/docs/console-colorful-text.png new file mode 100644 index 00000000..ce0fa92e Binary files /dev/null and b/docs/console-colorful-text.png differ diff --git a/install.md b/docs/install.md similarity index 100% rename from install.md rename to docs/install.md diff --git a/java.md b/docs/java.md similarity index 97% rename from java.md rename to docs/java.md index a75eb9fe..8008f0a5 100644 --- a/java.md +++ b/docs/java.md @@ -1,7 +1,7 @@ :snail: `Java`相关脚本 ==================================== -:beer: [show-busy-java-threads.sh](show-busy-java-threads.sh) +:beer: [show-busy-java-threads.sh](../show-busy-java-threads.sh) ---------------------- 在排查`Java`的`CPU`性能问题时(`top us`值过高)，要找出`Java`进程中消耗`CPU`多的线程，并查看它的线程栈，从而找出导致性能问题的方法调用。 @@ -67,7 +67,7 @@ The stack of busy(26.1%) thread(24018/0x5dd2) of java process(23269) of user(adm [silentforce](https://github.com/silentforce)改进此脚本，增加对环境变量`JAVA_HOME`的判断。 -:beer: [show-duplicate-java-classes](show-duplicate-java-classes) +:beer: [show-duplicate-java-classes](../show-duplicate-java-classes) ---------------------- 找出`java`库（即`jar`文件）或`class`目录中的重复类。 @@ -154,7 +154,7 @@ class paths to find: [tgic](https://github.com/tg123)提供此脚本。友情贡献者的链接[commandlinefu.cn](http://commandlinefu.cn/)|[微博linux命令行精选](http://weibo.com/u/2674868673) -:beer: [find-in-jars.sh](find-in-jars.sh) +:beer: [find-in-jars.sh](../find-in-jars.sh) ---------------------- 在当前目录下所有`jar`文件里，查找类或资源文件。 diff --git a/shell.md b/docs/shell.md similarity index 94% rename from shell.md rename to docs/shell.md index ffcda34a..43a0923c 100644 --- a/shell.md +++ b/docs/shell.md @@ -3,7 +3,7 @@ 包含`Shell`使用或命令加强的脚本。 -:beer: [console-text-color-themes.sh](console-text-color-themes.sh) +:beer: [console-text-color-themes.sh](../console-text-color-themes.sh) ---------------------- 显示`Terminator`的全部文字彩色组合的效果及其打印方式。 @@ -23,7 +23,7 @@ colorEchoWithoutNewLine "4;33;40" "Hello world!" "Hello Hell!" ``` `console-text-color-themes.sh`的运行效果图如下： -![console-text-color-themes.sh的运行效果图](https://raw.github.com/wiki/oldratlee/useful-scripts/console-colorful-text.png) +![console-text-color-themes.sh的运行效果图](console-colorful-text.png) ### 贡献者 @@ -33,7 +33,7 @@ colorEchoWithoutNewLine "4;33;40" "Hello world!" "Hello Hell!" - [utensil](https://github.com/utensil)的[在Bash下输出彩色的文本](http://utensil.github.io/tech/2007/09/10/colorful-bash.html)，这是篇很有信息量很钻研的文章！ -:beer: [colorful-lines](colorful-lines) +:beer: [colorful-lines](../colorful-lines) ---------------------- 彩色`cat`出文件行，方便人眼区分不同的行。 @@ -60,7 +60,7 @@ file2 line2 注：上面显示中，没有彩色，在控制台上运行可以看出彩色效果。 -:beer: [echo-args.sh](echo-args.sh) +:beer: [echo-args.sh](../echo-args.sh) ---------------------- 在编写脚本时，常常要确认输入参数是否是期望的：参数个数，参数值（可能包含有人眼不容易发现的空格问题）。 @@ -86,7 +86,7 @@ $ ./echo-args.sh 1 " 2 foo " "3 3" 这样可以不改其它的程序，查看到输入参数的信息。 -:beer: [tcp-connection-state-counter.sh](tcp-connection-state-counter.sh) +:beer: [tcp-connection-state-counter.sh](../tcp-connection-state-counter.sh) ---------------------- 统计各个`TCP`连接状态的个数。 @@ -107,12 +107,12 @@ tcp-connection-state-counter.sh ```bash $ tcp-connection-state-counter.sh -ESTABLISHED 290 +ESTABLISHED 290 TIME_WAIT 212 -SYN_SENT 17 +SYN_SENT 17 ``` -:beer: [parseOpts.sh](parseOpts.sh) +:beer: [parseOpts.sh](../parseOpts.sh) ---------------------- 提供命令行选项解析函数`parseOpts`，支持选项的值有多个值（即数组）。 @@ -211,7 +211,7 @@ parseOpts "a,a-long|b,b-long:|c,c-long+" -a -b bv -- --c-long c.sh -p pv -q qv a [Khotyn Huang](https://github.com/khotyn)指出`bash` `3.0`下使用有问题，并提供`bash` `3.0`的测试机器。 -:beer: [xpl](xpl) and [xpf](xpf) +:beer: [xpl](../xpl) and [xpf](../xpf) ---------------------- * `xpl`：在文件浏览器中打开指定的文件或文件夹。 diff --git a/vcs.md b/docs/vcs.md similarity index 95% rename from vcs.md rename to docs/vcs.md index 285fc18b..5564a47a 100644 --- a/vcs.md +++ b/docs/vcs.md @@ -1,7 +1,7 @@ :snail: `VCS`相关脚本 ==================================== -:beer: [swtrunk.sh](swtrunk.sh) +:beer: [swtrunk.sh](../swtrunk.sh) ---------------------- `svn`工作目录从分支（`branches`）切换到主干（`trunk`）。 @@ -38,7 +38,7 @@ svn work dir /path/to/svn/work/dir1 switch from http://www.foo.com/project1/bran svn work dir /path/to/svn/work/dir2 switch from http://www.foo.com/project2/branches/feature1 to http://www.foo.com/project2/trunk ! ``` -:beer: [svn-merge-stop-on-copy.sh](svn-merge-stop-on-copy.sh) +:beer: [svn-merge-stop-on-copy.sh](../svn-merge-stop-on-copy.sh) ---------------------- 把指定的远程分支从刚新建分支以来的修改合并到本地`svn`目录或是另一个远程分支。 @@ -63,7 +63,7 @@ svn-merge-stop-on-copy.sh http://www.foo.com/project1/branches/feature1 http://w [姜太公](https://github.com/jiangjizhong)提供此脚本。 -:beer: [cp-svn-url.sh](cp-svn-url.sh) +:beer: [cp-svn-url.sh](../cp-svn-url.sh) ---------------------- 拷贝当前`svn`目录对应的远程分支到系统的粘贴板，省去`CTRL+C`操作。