the-art-of-command-line/README.md

275 lines
15 KiB
Markdown
Raw Normal View History

2015-05-21 01:39:58 +08:00
# The Art of Command Line
2015-05-21 00:02:38 +08:00
2015-05-21 01:39:58 +08:00
## Tips for Linux
2015-05-21 00:02:38 +08:00
2015-05-21 01:52:07 +08:00
This is a selection of command-line tips that I've found useful over the years when working on Linux. It's organized a bit like a journey, from command-line novice to expert. Some tips are elementary, and some sophisticated enough very few people know them.
2015-05-21 01:20:08 +08:00
2015-05-21 01:52:07 +08:00
The goals are brevity and broad coverage of important tips that a technical user will find useful or time-saving. It's a bit long, and users certainly don't need to know all of them, but I've done my best to review that each item is worth reading in terms of projected time savings, if you use Linux heavily. It's written for Linux, but many items apply equally to MacOS. Items are intentionally minimal, with the expectation you can use `man`, `apt-get`/`yum`, or Google for more background.
2015-05-21 01:20:08 +08:00
2015-05-21 01:46:49 +08:00
I originally wrote much of this as an answer [on Quora](http://www.quora.com/What-are-some-time-saving-tips-that-every-Linux-user-should-know), but given the interest there, it seems it's worth moving the list to Github, where people more talented than I can readily suggest improvements. If you see an error or something that could be better, please submit a PR!
2015-05-21 00:02:38 +08:00
## Basics
2015-05-21 01:39:58 +08:00
- Learn basic Bash. Actually, type `man bash` and at least skim the whole thing; it's pretty easy to follow and not that long. Alternate shells can be nice, but bash is powerful and always available (learning mainly zsh, fish, etc. restricts you in many situations).
2015-05-21 01:39:58 +08:00
- Learn vim. There's really no competition for random Linux editing (even if you use Emacs, a big IDE, or a modern hipster editor most of the time).
2015-05-21 01:39:58 +08:00
- Know ssh, and the basics of passwordless authentication, via `ssh-agent`, `ssh-add`, etc.
2015-05-21 01:39:58 +08:00
- Be familiar with bash job management: &, Ctrl-Z, Ctrl-C, `jobs`, `fg`, `bg`, `kill`, etc.
2015-05-21 01:39:58 +08:00
- Basic file management: `ls` and `ls -l` (in particular, learn what every column in `ls -l` means), `less`, `head`, `tail` and `tail -f`, `ln` and `ln -s` (learn the differences and advantages of hard versus soft links), `chown`, `chmod`, `du` (for a quick summary of disk usage: `du -sk *`), `df`, `mount`.
2015-05-21 01:39:58 +08:00
- Basic network management: `ip` or `ifconfig`, `dig`.
2015-05-21 01:39:58 +08:00
- Know regular expressions well, and the various flags to `grep`/`egrep`. The `-o`, `-A`, and `-B` options are worth knowing.
2015-05-21 01:39:58 +08:00
- Learn to use `apt-get` or `yum` (depending on distro) to find and install packages.
2015-05-21 00:02:38 +08:00
2015-05-21 01:20:08 +08:00
2015-05-21 00:02:38 +08:00
## Everyday use
- In bash, use Ctrl-R to search through command history.
2015-05-21 00:02:38 +08:00
- In bash, use Ctrl-W to kill the last word, and Ctrl-U to kill the line. See man readline for default keybindings in bash. There are a lot. For example Alt-. cycles through prevous arguments, and Alt-* expands a glob.
2015-05-21 00:02:38 +08:00
- To go back to the previous working directory: cd -
2015-05-21 00:02:38 +08:00
- If you are halfway through typing a command but change your mind, hit Alt-# to add a # at the beginning and enter it as a comment (or use Ctrl-A, #, enter). You can then return to it later via command history.
2015-05-21 01:39:58 +08:00
- Use `xargs` (or `parallel`). It's very powerful. Note you can control how many items execute per line (-L) as well as parallelism (-P). If you're not sure if it'll do the right thing, use xargs echo first. Also, -I{} is handy. Examples:
2015-05-21 01:20:08 +08:00
```
2015-05-21 00:02:38 +08:00
find . -name \*.py | xargs grep some_function
cat hosts | xargs -I{} ssh root@{} hostname
2015-05-21 01:20:08 +08:00
```
2015-05-21 00:02:38 +08:00
2015-05-21 01:39:58 +08:00
- `pstree -p` is a helpful display of the process tree.
2015-05-21 01:39:58 +08:00
- Use `pgrep` and `pkill` to find or signal processes by name (`-f` is helpful).
2015-05-21 01:39:58 +08:00
- Know the various signals you can send processes. For example, to suspend a process, use `kill -STOP [pid]`. For the full list, see man 7 signal
2015-05-21 00:02:38 +08:00
- Use nohup or disown if you want a background process to keep running forever.
2015-05-21 00:02:38 +08:00
- Check what processes are listening via netstat -lntp. See also lsof.
2015-05-21 01:39:58 +08:00
- In bash scripts, use set -x for debugging output.
- In bash scripts, use strict modes whenever possible. Use `set -e` to abort on errors. Use `set -o pipefail` as well, to be strict about errors (though this topic is a bit subtle). For more involved scripts, also use `trap`.
2015-05-21 00:02:38 +08:00
- In bash scripts, subshells (written with parentheses) are convenient ways to group commands. A common example is to temporarily move to a different working directory, e.g.
2015-05-21 01:20:08 +08:00
```
2015-05-21 00:02:38 +08:00
# do something in current dir
(cd /some/other/dir; other-command)
# continue in original dir
2015-05-21 01:20:08 +08:00
```
2015-05-21 00:02:38 +08:00
2015-05-21 01:39:58 +08:00
- In bash, note there are lots of kinds of variable expansion. Checking a variable exists: `${name:?error message}`. For example, if a bash script requires a single argument, just write `input_file=${1:?usage: $0 input_file}`. Arithmetic expansion: `i=$(( (i + 1) % 5 ))`. Sequences: `{1..10}`. Trimming of strings: `${var%suffix}` and `${var#prefix}`. For example if `var=foo.pdf`, then `echo ${var%.pdf}.txt` prints `foo.txt`.
2015-05-21 01:39:58 +08:00
- The output of a command can be treated like a file via `<(some command)`. For example, compare local /etc/hosts with a remote one:
2015-05-21 01:20:08 +08:00
```
2015-05-21 01:39:58 +08:00
diff /etc/hosts <(ssh somehost cat /etc/hosts)
2015-05-21 01:20:08 +08:00
```
2015-05-21 01:39:58 +08:00
- Know about "here documents" in bash, as in `cat <<EOF ...`.
2015-05-21 01:39:58 +08:00
- In Bash, redirect both standard output and standard error via: `some-command >logfile 2>&1`. Often, to ensure a command does not leave an open file handle to standard input, tying it to the terminal you are in, it is also good practice to add `</dev/null`.
2015-05-21 01:39:58 +08:00
- Use `man ascii` for a good ASCII table, with hex and decimal values.
2015-05-21 01:39:58 +08:00
- On remote ssh sessions, use `screen` or `dtach` to save your session, in case it is interrupted.
2015-05-21 00:02:38 +08:00
- In ssh, knowing how to port tunnel with -L or -D (and occasionally -R) is useful, e.g. to access web sites from a remote server.
2015-05-21 01:39:58 +08:00
- It can be useful to make a few optimizations to your ssh configuration; for example, this `~/.ssh/config` contains settings to avoid dropped connections in certain network environments, not require confirmation connecting to new hosts, forward authentication, and use compression (which is helpful with scp over low-bandwidth connections):
2015-05-21 01:20:08 +08:00
```
2015-05-21 00:02:38 +08:00
TCPKeepAlive=yes
ServerAliveInterval=15
ServerAliveCountMax=6
StrictHostKeyChecking=no
Compression=yes
ForwardAgent=yes
2015-05-21 01:20:08 +08:00
```
2015-05-21 00:02:38 +08:00
2015-05-21 01:39:58 +08:00
- To get the permissions on a file in octal form, which is useful for system configuration but not available in `ls` and easy to bungle, use something like
2015-05-21 01:20:08 +08:00
```
stat -c '%A %a %n' /etc/timezone
```
2015-05-21 00:02:38 +08:00
2015-05-21 01:52:07 +08:00
2015-05-21 00:02:38 +08:00
## Data processing
2015-05-21 01:39:58 +08:00
- To convert HTML to text: `lynx -dump -stdin`
2015-05-21 01:39:58 +08:00
- If you must handle XML, `xmlstarlet` is old but good.
2015-05-21 01:39:58 +08:00
- For JSON, use `jq`.
2015-05-21 01:39:58 +08:00
- For Amazon S3, `s3cmd` is convenient (albeit immature, with occasional misfeatures) and `s4cmd` is faster.
2015-05-21 00:02:38 +08:00
2015-05-21 01:39:58 +08:00
- Know about `sort` and `uniq` (including uniq's `-u` and `-d` options). See one-liners below.
2015-05-21 01:39:58 +08:00
- Know about `cut`, `paste`, and `join` to manipulate text files. Many people use `cut` but forget about `join`.
2015-05-21 00:02:38 +08:00
2015-05-21 01:39:58 +08:00
- Know that locale affects a lot of command line tools, including sorting order and performance. Most Linux installations will set `LANG` or other locale variables to a local setting like US English. This can make sort or other commands run many times slower. (Note that even if you use UTF-8 text, you can safely sort by ASCII order for many purposes.) To disable slow i18n routines and use traditional byte-based sort order, use `export LC_ALL=C` (in fact, consider putting this in your `~/.bashrc`).
2015-05-21 01:39:58 +08:00
- Know basic `awk` and `sed` for simple data munging. For example, summing all numbers in the third column of a text file: `awk '{ x += $3 } END { print x }'`. This is probably 3X faster and 3X shorter than equivalent Python.
2015-05-21 00:02:38 +08:00
- To replace all occurrences of a string in place, in one or more files:
2015-05-21 01:20:08 +08:00
```
perl -pi.bak -e 's/old-string/new-string/g' my-files-*.txt
2015-05-21 01:20:08 +08:00
```
2015-05-21 01:20:08 +08:00
- To rename many files at once according to a pattern, use rename. Or if you want something more general, repren may help.
```
2015-05-21 00:02:38 +08:00
rename 's/\.bak$//' *.bak
2015-05-21 01:20:08 +08:00
```
2015-05-21 00:02:38 +08:00
2015-05-21 01:39:58 +08:00
- Use `shuf` to shuffle or select random lines from a file.
2015-05-21 01:39:58 +08:00
- Know `sort`'s options. Know how keys work (`-t` and `-k`). In particular, watch out that you need to write `-k1,1` to sort by only the first field; `-k1` means sort according to the whole line.
2015-05-21 01:39:58 +08:00
- Stable sort (`sort -s`) can be useful. For example, to sort first by field 2, then secondarily by field 1, you can use `sort -k1,1 | sort -s -k2,2`
2015-05-21 00:02:38 +08:00
- If you ever need to write a tab literal in a command line in bash (e.g. for the -t argument to sort), press Ctrl-V <tab> or write $'\t' (the latter is better as you can copy/paste it).
2015-05-21 01:39:58 +08:00
- For binary files, use `hd` for simple hex dumps and `bvi` for binary editing.
2015-05-21 01:39:58 +08:00
- Also for binary files, `strings` (plus `grep`, etc.) lets you find bits of text.
2015-05-21 01:39:58 +08:00
- To convert text encodings, try `iconv`. Or `uconv` for more advanced use; it supports some advanced Unicode things. For example, this command lowercases and removes all accents (by expanding and dropping them):
2015-05-21 01:20:08 +08:00
```
2015-05-21 00:02:38 +08:00
uconv -f utf-8 -t utf-8 -x '::Any-Lower; ::Any-NFD; [:Nonspacing Mark:] >; ::Any-NFC; ' < input.txt > output.txt
2015-05-21 01:20:08 +08:00
```
2015-05-21 00:02:38 +08:00
2015-05-21 01:39:58 +08:00
- To split files into pieces, see `split` (to split by size) and `csplit` (to split by a pattern).
2015-05-21 00:02:38 +08:00
## System debugging
2015-05-21 01:39:58 +08:00
- For web debugging, `curl` and `curl -I` are handy, or their wget equivalents, or the more modern `httpie`.
2015-05-21 01:39:58 +08:00
- To know disk/cpu/network status, use `iostat`, `netstat`, `top` (or the better `htop`), and (especially) `dstat`. Good for getting a quick idea of what's happening on a system.
2015-05-21 01:39:58 +08:00
- To know memory status, run and understand the output of `free` and `vmstat`. In particular, be aware the "cached" value is memory held by the Linux kernel as file cache, so effectively counts toward the "free" value.
2015-05-21 01:39:58 +08:00
- Java system debugging is a different kettle of fish, but a simple trick on Oracle's and some other JVMs is that you can run `kill -3 <pid>` and a full stack trace and heap summary (including generational garbage collection details, which can be highly informative) will be dumped to stderr/logs.
2015-05-21 01:39:58 +08:00
- Use `mtr` as a better traceroute, to identify network issues.
2015-05-21 01:39:58 +08:00
- For looking at why a disk is full, `ncdu` saves time over the usual commands like `du -sk *`.
2015-05-21 01:39:58 +08:00
- To find which socket or process is using bandwidth, try `iftop` or `nethogs`.
2015-05-21 01:39:58 +08:00
- The `ab` tool (comes with Apache) is helpful for quick-and-dirty checking of web server performance. For more complex load testing, try `siege`.
2015-05-21 01:39:58 +08:00
- For more serious network debugging, `wireshark` or `tshark`.
2015-05-21 01:39:58 +08:00
- Know about `strace` and `ltrace`. These can be helpful if a program is failing, hanging, or crashing, and you don't know why, or if you want to get a general idea of performance. Note the profiling option (`-c`), and the ability to attach to a running process (`-p`).
2015-05-21 01:39:58 +08:00
- Know about `ldd` to check shared libraries etc.
2015-05-21 01:39:58 +08:00
- Know how to connect to a running process with `gdb` and get its stack traces.
2015-05-21 01:39:58 +08:00
- Use `/proc`. It's amazingly helpful sometimes when debugging live problems. Examples: `/proc/cpuinfo`, `/proc/xxx/cwd`, `/proc/xxx/exe`, `/proc/xxx/fd/`, `/proc/xxx/smaps`.
2015-05-21 01:39:58 +08:00
- When debugging why something went wrong in the past, `sar` can be very helpful. It shows historic statistics on CPU, memory, network, etc.
2015-05-21 01:39:58 +08:00
- For deeper systems and performance analyses, look at `stap` (systemtap) and `perf`.
2015-05-21 01:39:58 +08:00
- Confirm what Linux distribution you're using (works on most distros): `lsb_release -a`
2015-05-21 01:39:58 +08:00
- Use `dmesg` whenever something's acting really funny (it could be hardware or driver issues).
2015-05-21 00:02:38 +08:00
## One-liners
2015-05-21 01:39:58 +08:00
- It is remarkably helpful sometimes that you can do set intersection, union, and difference of text files via `sort`/`uniq`. Suppose `a` and `b` are text files that are already uniqued. This is fast, and works on files of arbitrary size, up to many gigabytes. (Sort is not limited by memory, though you may need to use the `-T` option if `/tmp` is on a small root partition.) See also the note about `LC_ALL` above.
2015-05-21 01:20:08 +08:00
```
cat a b | sort | uniq > c # c is a union b
cat a b | sort | uniq -d > c # c is a intersect b
cat a b b | sort | uniq -u > c # c is set difference a - b
2015-05-21 01:20:08 +08:00
```
- Summing all numbers in the third column of a text file (this is probably 3X faster and 3X less code than equivalent Python):
2015-05-21 01:20:08 +08:00
```
awk '{ x += $3 } END { print x }' myfile
2015-05-21 01:20:08 +08:00
```
2015-05-21 01:39:58 +08:00
- If want to see sizes/dates on a tree of files, this is like a recursive `ls -l` but is easier to read than `ls -lR`:
2015-05-21 01:20:08 +08:00
```
find . -type f -ls
```
2015-05-21 01:39:58 +08:00
- Use `xargs` or `parallel` whenever you can. Note you can control how many items execute per line (`-L`) as well as parallelism (`-P`). If you're not sure if it'll do the right thing, use xargs echo first. Also, `-I{}` is handy. Examples:
2015-05-21 01:20:08 +08:00
```
find . -name \*.py | xargs grep some_function
cat hosts | xargs -I{} ssh root@{} hostname
2015-05-21 01:20:08 +08:00
```
2015-05-21 01:39:58 +08:00
- Say you have a text file, like a web server log, and a certain value that appears on some lines, such as an `acct_id` parameter that is present in the URL. If you want a tally of how many requests for each `acct_id`:
2015-05-21 01:20:08 +08:00
```
cat access.log | egrep -o 'acct_id=[0-9]+' | cut -d= -f2 | sort | uniq -c | sort -rn
2015-05-21 01:20:08 +08:00
```
2015-05-21 01:39:58 +08:00
## Obscure but useful
2015-05-21 01:52:07 +08:00
- `expr`: perform arithmetic or boolean operations or evaluate regular expressions
- `m4`: simple macro processor
- `screen`: powerful terminal multiplexing and session persistence
- `yes`: print a string a lot
- `cal`: nice calendar
- `env`: run a command (useful in scripts)
- `look`: find English words (or lines in a file) beginning with a string
- `cut `and paste and join: data manipulation
- `fmt`: format text paragraphs
- `pr`: format text into pages/columns
- `fold`: wrap lines of text
- `column`: format text into columns or tables
- `expand `and unexpand: convert between tabs and spaces
- `nl`: add line numbers
- `seq`: print numbers
- `bc`: calculator
- `factor`: factor integers
- `nc`: network debugging and data transfer
- `dd`: moving data between files or devices
- `file`: identify type of a file
- `stat`: file info
- `tac`: print files in reverse
- `shuf`: random selection of lines from a file
- `comm`: compare sorted files line by line
- `hd` and `bvi`: dump or edit binary files
- `strings`: extract text from binary files
- `tr`: character translation or manipulation
- `iconv `or uconv: conversion for text encodings
- `split `and csplit: splitting files
- `7z`: high-ratio file compression
- `ldd`: dynamic library info
- `nm`: symbols from object files
- `ab`: benchrmarking web servers
- `strace`: system call debugging
- `mtr`: better traceroute for network debugging
- `cssh`: visual concurrent shell
- `wireshark `and tshark: packet capture and network debugging
- `host `and dig: DNS lookups
- `lsof`: process file descriptor and socket info
- `dstat`: useful system stats
- `iostat`: CPU and disk usage stats
- `htop`: improved version of top
- `last`: login history
- `w`: who's logged on
- `id`: user/group identity info
- `sar`: historic system stats
- `iftop `or nethogs: network utilization by socket or process
- `ss`: socket statistics
- `dmesg`: boot and system error messages
- `hdparm`: SATA/ATA disk manipulation/performance
- `lsb_release`: Linux distribution info
- `lshw`: hardware information
- `fortune`, `ddate`, and `sl`: um, well, it depends on whether you consider steam locomotives and Zippy quotations "useful"
2015-05-21 01:20:08 +08:00
## Disclaimer
Just because you *can* do something in Bash, doesn't necessarily mean you should. ;)