Getting Started with BASH A Bash Tutorial
What is the Bash Shell?
The GNU Bourne-Again SHell (BASH) incorporates features from the C Shell (csh) and the Korn Shell (ksh) and conforms to the POSTIX 2 shell specifications. It provides a Command Line Interface (CLI) for working on *nix systems and is the most common shell used on Linux systems. Useful bash features will be the subject of the rest of this document.
Bash's Configuration Files
In your home directory, 3 files have a special meaning to Bash, allowing you to set up your environment automatically when you log in and when you invoke another Bash shell, and allow you to execute commands when you log out. These files may exist in your home directory, but that depends largely on the Linux distro you're using and how your sysadmin (if not you) has set up your account. If they're missing, Bash defaults to /etc/profile. You can easily create these files yourself using your favorite texteditor. They are:
- .bash_profile : read and the commands in it executed by Bash every time you log in to the system
- .bashrc : read and executed by Bash every time you start a subshell
- .bash_logout : read and executed by Bash every time a login shell exits
Bash allows 2 synonyms for .bash_profile : .bash_login and .profile. These are derived from the C shell's file named .login and from the Bourne shell and Korn shell files named .profile. Only one of these files is read when you log in. If .bash_profile isn't there, Bash will look for .bash_login. If that is missing too, it will look for .profile. .bash_profile is read and executed only when you start a login shell (that is, when you log in to the system). If you start a subshell (a new shell) by typing bash at the command prompt, it will read commands from .bashrc. This allows you to separate commands needed at login from those needed when invoking a subshell. However, most people want to have the same commands run regardless of whether it is a login shell or a subshell. This can be done by using the source command from within .bash_profile to execute .bashrc. You would then simply place all the commands in .bashrc. |
These files are useful for automatically executing commands like: set, alias, unalias, and setting the PS(1-4) variables, which can all be used to modify your bash environment.
You can use the
source command to apply the changes that you have just made in a configuration file. For example if you add an alias to
/etc/profile to apply the changes to your current session execute:
Active aliases can be viewed by executing the
alias command. Some common files that may modify aliases are: ~/.bashrc, ~/.bash_profile, ~/.profile, /etc/bashrc, /etc/profile, files in /etc/profile.d.
Modifying the Bash Shell with the set Command
Two options that can be set using the
set command that will be of some interest to the common user are "-o vi" and "-o emacs". As with all of the environment modifying commands these can be typed at the command prompt or inserted into the appropriate file mentioned above.
Set Emacs Mode in Bash
This is usually the default editing mode when in the bash environment and means that you are able to use commands like those in Emacs (defined in the Readline library) to move the cursor, cut and paste text, or undo editing.
Commands to take advantage of bash's Emacs Mode:
ctrl-a | Move cursor to beginning of line | ctrl-e | Move cursor to end of line | meta-b | Move cursor back one word | meta-f | Move cursor forward one word | ctrl-w | Cut the last word | ctrl-u | Cut everything before the cursor | ctrl-k | Cut everything after the cursor | ctrl-y | Paste the last thing to be cut | ctrl-_ | Undo |
NOTE: ctrl- = hold control, meta- = hold meta (where meta is usually the
alt or
escape key).
A combination of ctrl-u to cut the line combined with ctrl-y can be very helpful. If you are in middle of typing a command and need to return to the prompt to retrieve more information you can use ctrl-u to save what you have typed in and after you retrieve the needed information ctrl-y will recover what was cut.
Set Vi Mode in Bash
Vi mode allows for the use of vi like commands when at the bash prompt. When set to this mode initially you will be in insert mode (be able to type at the prompt unlike when you enter vi). Hitting the
escape key takes you into command mode.
Commands to take advantage of bash's Vi Mode:
h | Move cursor left | l | Move cursor right | A | Move cursor to end of line and put in insert mode | 0 | (zero) Move cursor to beginning of line (doesn't put in insert mode) | i | Put into insert mode at current position | a | Put into insert mode after current position | dd | Delete line (saved for pasting) | D | Delete text after current cursor position (saved for pasting) | p | Paste text that was deleted | j | Move up through history commands | k | Move down through history commands | u | Undo |
Useful Commands and Features
The commands in this section are non-mode specific, unlike the ones listed above.
Flip the Last Two Characters
If you type like me your fingers spit characters out in the wrong order on occasion.
ctrl-t swaps the order that the last two character appear in.
Searching Bash History
As you enter commands at the CLI they are saved in a file ~./.bash_history. From the bash prompt you can browse the most recently used commands through the least recently used commands by pressing the up arrow. Pressing the down arrow does the opposite.
If you have entered a command a long time ago and need to execute it again you can search for it. Type the command 'ctrl-r' and enter the text you want to search for.
Dealing with Spaces
First, I will mention a few ways to deal with spaces in directory names, file names, and everywhere else.
Using the Backslash Escape Sequence
One option is to use bash's escape character
\. Any space following the backslash is treated as being part of the same string. These commands create a directory called "foo bar" and then remove it.
$ mkdir foo\ bar $ rm -r foo\ bar |
The backslash escape sequence can also be used to decode commands embedded in strings which can be very useful for scripting or modifying the command prompt as discussed later.
Using Single/Double Quotes with Spaces and Variables
Single and double quotes can also be used for dealing with spaces.
$ touch 'dog poo' $ rm "dog poo" |
The difference between single and double quotes being that in double quotes the
$,
\, and
' characters still preserve their special meanings. Single quotes will take the
$ and
\ literally and regard the
' as the end of the string. Here's an example:
$ MY_VAR='This is my text' $ echo $MY_VAR This is my text $ echo "$MY_VAR" This is my text $ echo '$MY_VAR' $MY_VAR |
The string following the
$ character is interpreted as being a variable except when enclosed in single quotes as shown above.
Lists Using { and }
The characters
{ and
} allow for list creation. In other words you can have a command be executed on each item in the list. This is perhaps best explained with examples:
$ touch {temp1,temp2,temp3,temp4} |
This will create/modify the files temp1, temp2, temp3, and temp4 and as in the example above when the files share common parts of the name you can do:
$ mv temp{1,2,3,4} ./foo\ bar/ |
This will move all four of the files into a directory 'foo bar'.
Executing Multiple Commands in Sequence
This is a hefty title for a simple task. If you want to run three commands, one right after the other, you can type them on a single line:
$ ./configure; make; make install OR $ ./configure && make && make install |
With the first if the ./configure fails the other two commands will continue to execute. With the second the commands following the && will only execute if the command previous finishes without error. Thus, the second would be most useful for this example because there is no reason to run 'make' or 'make install' if the configuration fails.
Piping Output from One Command to Another
Piping allows the user to do several fantastic thing by combining utilities. I will cover only very basic uses for piping. I most commonly use the pipe command,
|, to pipe text that is output from one command through the
grep command to search for text.
Examples:
See if a program, centericq, is running:
- $ ps ax | grep centericq
25824 pts/2 S 0:18 centericq Count the number of files in a directory (nl counts things):
- $ ls | nl
1 #.emacs# 2 BitchX 3 Outcast double cd.lst 4 bm.shader 5 bmtexturesbase.pk3
If my memory serves using RPM to check if a package is installed:
- $ rpm -qa | grep package_name
A more advance example:
- $ cat /etc/passwd | awk -F: '{print $1 "\t" $6}' | sort > ./users
This sequence takes the information if the file passwd, pipes it to awk, which takes the first and sixth fields (the user name and home directory respectively), pipes these fields separated by a tab ("\t") to sort, which sorts the list alphabetically, and puts it into a file called users. |
Aliasing Commands
If you have used UNIX for a while, you will know that there are many commands available and that some of them have very cryptic names and/or can be invoked with a truckload of options and arguments. So, it would be nice to have a feature allowing you to rename these commands or type something simple instead of a list of options. Bash provides such a feature : the alias . Aliasses can be defined on the command line, in .bash_profile, or in .bashrc, using this form :
This means that name is an alias for command. Whenever name is typed as a command, Bash will substitute command in its place. Note that there are no spaces on either side of the equal sign. Quotes around command are necessary if the string being aliassed consists of more than one word. A few examples :
alias ls='ls -aF --color=always' alias ll='ls -l' alias search=grep alias mcd='mount /mnt/cdrom' alias ucd='umount /mnt/cdrom' alias mc='mc -c' alias ..='cd ..' alias ...='cd ../..' | The first example ensures that ls always uses color if available, that dotfiles are listed as well,that directories are marked with a / and executables with a *. To make ls do the same on FreeBSD, the alias would become :
To see what aliasses are currently active, simply type alias at the command prompt and all active aliasses will be listed. To "disable" an alias type unalias followed by the alias name. |
Altering the Command Prompt Look and Information
Bash has the ability to change how the command prompt is displayed in information as well as colour. This is done by setting the PS1 variable. There is also a PS2 variable. It controls what is displayed after a second line of prompt is added and is usually by default '> '. The PS1 variable is usually set to show some useful information by the Linux distribution you are running but you may want to earn style points by doing your own modifications.
Here are the backslash-escape special characters that have meaning to bash:
\a an ASCII bell character (07)
\d the date in "Weekday Month Date" format
(e.g., "Tue May 26")
\e an ASCII escape character (033)
\h the hostname up to the first `.'
\H the hostname
\j the number of jobs currently managed by the shell
\l the basename of the shell's terminal device name
\n newline
\r carriage return
\s the name of the shell, the basename of $0
(the portion following the final slash)
\t the current time in 24-hour HH:MM:SS format
\T the current time in 12-hour HH:MM:SS format
\@ the current time in 12-hour am/pm format
\u the username of the current user
\v the version of bash (e.g., 2.00)
\V the release of bash, version + patchlevel
(e.g., 2.00.0)
\w the current working directory
\W the basename of the current working direcory
\! the history number of this command
\# the command number of this command
\$ if the effective UID is 0, a #, otherwise a $
\nnn the character corresponding to the octal number nnn
\\ a backslash
\[ begin a sequence of non-printing characters,
which could be used to embed a terminal control
sequence into the prompt
\] end a sequence of non-printing characters
|
Colours In Bash:
Black 0;30 Dark Gray 1;30
Blue 0;34 Light Blue 1;34
Green 0;32 Light Green 1;32
Cyan 0;36 Light Cyan 1;36
Red 0;31 Light Red 1;31
Purple 0;35 Light Purple 1;35
Brown 0;33 Yellow 1;33
Light Gray 0;37 White 1;37
|
Here is an example borrowed from the Bash-Prompt-HOWTO:
PS1="\[\033[1;34m\][\$(date +%H%M)][\u@\h:\w]$\[\033[0m\] " |
This turns the text blue, displays the time in brackets (very useful for not losing track of time while working), and displays the user name, host, and current directory enclosed in brackets. The "\[\033[0m\]" following the $ returns the colour to the previous foreground colour.
How about command prompt modification thats a bit more "pretty":
PS1="\[\033[1;30m\][\[\033[1;34m\]\u\[\033[1;30m\]@\[\033[0;35m\]\h\[\033[1;30m\]] \[\033[0;37m\]\W \[\033[1;30m\]\$\[\033[0m\] " |
This one sets up a prompt like this: [user@host] directory $
Break down:
\[\033[1;30m\] - Sets the color for the characters that follow it. Here 1;30 will set them to Dark Gray.
\u \h \W \$ - Look to the table above
\[\033[0m\] - Sets the colours back to how they were originally.
|
Each user on a system can have their own customized prompt by setting the PS1 variable in either the .bashrc or .profile files located in their home directories.
FUN STUFF!
A quick note about
bashish. It allows for adding themes to a terminal running under a GUI. Check out the site for some screen-shots of what it can do.
Also, the program
fortune is a must [At least I have considered it so every since my Slackware days (it is default)]. It doesn't have anything to do with bash and is a program that outputs a quote to the screen. Several add-ons are available to make it say stuff about programming, the xfiles, futurama, starwars, and more. Just add a line in your /etc/profile like this to brighten your day when you log into your computer:
CDargs - Shell Bookmarks
Impress your friends and colleagues with lightening fast directory switching using the
CDargs bookmarking tool. CDargs is not exclusive to BASH, but is a great addition and works on *nix based systems, including OS X.
Download CDargs here in source or rpm.
CDargs allow for setting named marks in directories and moving to them quickly using the
cdb command or a ncurses view.
Install
- Compile / install source
- Move cdargs-bash.sh to /etc
- Add this line to your users .bashrc file
source /etc/cdargs-bash.sh |
Relogin or run source ~/.bashrcUsage
mark
Mark a directory that you want to get to quickly in the future. Move to the desired directory and type
mark <name> or simply
mark to have it take the name of the current directory. You can also mark a directory using the ncurses tool. Run
cdargs or
cdb to start the ncurses tool. Add a new mark by pressing
a.
cdb
Now you have a bunch of marked directories. Simply type
cdb <name of a mark> to move to the marked directory. Alternatively use
cdb and navigate with arrows or number to the desired mark.
manage
Start the ncurses tool
cdb. Some useful keys to thump:
a add new mark
d delete mark
e edit mark
right left arrows move in and out of directories
l list the files in the highlighted directory
c make a copy of a mark
enter go to selected directory / mark |
You can also edit the
~/.cdargs text file directly to manage marks
Basic and Extended Bash Completion
Basic Bash Completion will work in any bash shell. It allows for completion of:
- File Names
- Directory Names
- Executable Names
- User Names (when they are prefixed with a ~)
- Host Names (when they are prefixed with a @)
- Variable Names (when they are prefixed with a $)
This is done simply by pressing the tab key after enough of the word you are trying to complete has been typed in. If when hitting tab the word is not completed there are probably multiple possibilities for the completion. Press tab again and it will list the possibilities.
Note that when completing a user name using '~' the resulting completion will be the user's home directory. E.g. "ls ~myus" would complete to "ls ~myuser/" and executing it would show the contents of the myuser's home directory.
Extended Programmable Bash Completion is a program that you can install to complete much more than the names of the things listed above. With extended bash completion you can, for example, complete the name of a computer you are trying to connect to with
ssh or
scp. It achieves this by looking through the known_hosts file and using the hosts listed there for the completion. This is greatly customizable and the package and more information can be found
here.
Configuration of Programmable Bash Completion is done in
/etc/bash_completion. Here is a list of completions that are in my
bash_completion file by default.
- completes on signal names
- completes on network interfaces
- expands tildes in pathnames
- completes on process IDs
- completes on process group IDs
- completes on user IDs
- completes on group IDs
- ifconfig(8) and iwconfig(8) helper function
- bash alias completion
- bash export completion
- bash shell function completion
- bash complete completion
- service completion
- chown(1) completion
- chgrp(1) completion
- umount(8) completion
- mount(8) completion
- Linux rmmod(8) completion
- Linux insmod(8), modprobe(8) and modinfo(8) completion
- man(1) completion
- renice(8) completion
- kill(1) completion
- Linux and FreeBSD killall(1) completion
- GNU find(1) completion
- Linux ifconfig(8) completion
- Linux iwconfig(8) completion
- RedHat & Debian GNU/Linux if{up,down} completion
- Linux ipsec(8) completion (for FreeS/WAN)
- Postfix completion
- cvs(1) completion
- rpm completion
- apt-get(8) completion
- chsh(1) completion
- chkconfig(8) completion
- user@host completion
- host completion based on ssh's known_hosts
- ssh(1) completion
- scp(1) completion
- rsync(1) completion
- Linux route(8) completion
- GNU make(1) completion
- GNU tar(1) completion
- jar(1) completion
- Linux iptables(8) completion
- tcpdump(8) completion
- autorpm(8) completion
- ant(1) completion
|
- mysqladmin(1) completion
- gzip(1) completion
- bzip2(1) completion
- openssl(1) completion
- screen(1) completion
- lftp(1) bookmark completion
- ncftp(1) bookmark completion
- gdb(1) completion
- Postgresql completion
- psql(1) completion
- createdb(1) completion
- dropdb(1) completion
- gcc(1) completion
- Linux cardctl(8) completion
- Debian dpkg(8) completion
- Debian GNU dpkg-reconfigure(8) completion
- Debian Linux dselect(8) completion
- Java completion
- PINE address-book completion
- mutt completion
- Debian reportbug(1) completion
- Debian querybts(1) completion
- update-alternatives completion
- Python completion
- Perl completion
- rcs(1) completion
- lilo(8) completion
- links completion
- FreeBSD package management tool completion
- FreeBSD kernel module commands
- FreeBSD portupgrade completion
- FreeBSD portinstall completion
- Slackware Linux removepkg completion
- look(1) completion
- ypcat(1) and ypmatch(1) completion
- mplayer(1) completion
- KDE dcop completion
- wvdial(1) completion
- gpg(1) completion
- iconv(1) completion
- dict(1) completion
- cdrecord(1) completion
- mkisofs(8) completion
- mc(1) completion
- yum(8) completion
- yum-arch(8) completion
- ImageMagick completion
|
Links
- Bash Prompt HOWTO
- Bash Reference Manual
- Customizing your Bash environment
- Working more productively with bash 2.x
- Advancing in the Bash Shell
- Bash - Bourne Again SHell
- What's GNU: Bash - The GNU Shell
- Bash Tips in Gentoo Forums
- bash(1) - Linux man page
- BASHISH
- CDargs
- Bash Reference Manual
- Extending BASH completion
Learn About Bash Scripting:
- Bash by example, Part 1
- Bash by example, Part 2
- Bash by example, Part 3
- Advanced Bash-Scripting Guide
- A quick guide to writing scripts using the bash shell
- Greg's wiki Bash Guide
- Greg's wiki Bash FAQ
- Bash Hackers Wiki
- Bash Pitfalls - Shows common bash scripting errors
Additionally #bash on irc.freenode.org is a great place to ask questions and learn more about bash.
Contributions
Thanks
Michael Klement for notes on using bash completion with user names.
Thanks
Andrew Hart for letting me know about the non recursive rm mistake when deleting a directory.
Thanks
Paul Carey for pointing out a bash color code error.
Thanks
Matt Spaulding for the scoop on CDargs.
Thanks
Thomas for pointing out the difference between ; and && when executing multiple commands on one line.
Thanks
Bruce Langston for the correction for the BASHISH URL under Links.
Thanks
Scott Pedigo for additional 'alias' information.
Thanks
Steve Long for additional links and references.
Translations
Corrections, comments, questions e-mail: scott@hypexr.orgLast Modified: October 05 2012.
Top of Page
|