Linux1

A not so short introduction to the Linux command line =Introduction= Linux (sometimes called GNU/Linux) is an operating system, i.e. the middle man between you and the computer hardware. Therefore Linux is a full replacement for Microsoft Windows or Mac OS X. Linux comes with a range of graphical user interfaces where you can use the mouse to interact with the computer as you are used to. However, in most setup within the University (and particularly for the HPC facilities), you will not have access to this graphical user interface. Instead, you will be using Linux at the command line. Therefore this practical introduces some of the basic commands that you must know in order to carry out your research in a Linux based environment.

The user interface on a computer is technically called a shell. When using Linux at the command line, most often the bash shell is used. There are a range of shells (csh, zsh ...) for Linux with slightly different syntaxes. The bash shell is often the default and we will use bash syntax in this practical.

=Logging in= Login is performed via a bit of protocol called secure shell or ssh. There is a client for Microsoft Windows which should already be installed on your computer. If not, contact a computer officer. To login select the machine that you want to log into, for instance dylan.ggy.bris.ac.uk or bluecrystal.bris.ac.uk and then enter your username and password. the system will log you in and you will directly be taken to your home directory.

Although you used your password to login, it is important to note that there are other login options available. For instance, you can configure ssh to log you in automatically using authentication keys instead of using a password. This is very interesting when you want scripts to run automatically and perform operations on the network. This is really beyond the scope of this practical.

= Getting the content for this practical = Now that you are logged in a Linux system, it is time to get the practical content. The necessary files for this practical are hosted in a version control system. To obtain them, just type the following command: $ svn export http://source.ggy.bris.ac.uk/subversion-open/linux1/trunk linux1

The dollar sign "$" is called the shell prompt. You do not need to type it in. It is merely there to show that the shell is waiting for a command. When a line starts without a dollar, it means that it is an output from the shell. This is a very common convention that will be used throughout this practical.

This will fetch all necessary files and put them in a folder called linux1/. Ignore the cryptic syntax so far, an introduction to version control using subversion (svn) will be given later on.

=Navigation= To change directories (sometimes called folders), the command cd is used. It stands for ... "change directory" (!) To navigate to the directory containing the files for this practical, simply type: $ cd linux1

By doing this operation, you technically used a relative path. Indeed linux1</tt> is not the full directory location but merely its relative path from where you were before. To find out the absolute path of your current location, use the command pwd</tt> (print working directory):

$ pwd /gsa13/ggjpr/linux1

Obviously, the full path will depend on where your home directory is located. The absolute path starts at /</tt> called the root and then lists the branches of the directory tree leading to the current directory. Note that the directories are separated by slashes "/</tt>" and not backslashes as used by DOS in Microsoft Windows.

The cd</tt> command also accepts absolute paths. For instance: $ cd /gsa3/ggjpr $ pwd /gsa3/ggjpr $ cd /gsa3/ggjpr/linux1 $ pwd /gsa13/ggjpr/linux1

To help navigation, every directory on a Linux system contains two shortcuts:
 * .</tt> (yes, one single dot!) links to itself
 * ..</tt> (two consecutive dots) links to its parent

The ..</tt> shortcut especially is important as it allows you to go up one directory without using a full path: $ pwd /gsa13/ggjpr/linux1 $ cd .. $ pwd /gsa3/ggjpr $ cd .. $ pwd /gsa3

It is important to know that if you don't give an argument to cd</tt>, it will take you back to your home directory.

$ pwd /gsa3 $ cd $ pwd /gsa3/ggjpr

Furthermore, you can use cd</tt> with the argument "-</tt>" to simply go back where you were before, a it like the back button on a web browser. It only worksone level though so using it twice sends you back to where you started. For instance:

$ pwd /gsa13/ggjpr/linux1 $ cd $ pwd /gsa13/ggjpr $ cd - $ pwd /gsa13/ggjpr/linux1 $ cd - $ pwd /gsa13/ggjpr

= Listing a directory content =

The content of the directory can be listed with the command ls</tt> (for list). For example, let's go back in the linux1</tt> directory and list its content: $ cd linux1 $ ls file1 file2  folder1  folder2

So our linux1</tt> directory contains two files and two directories. Depending on the secure shell software and the Linux machine, you could also have a colourised output to differentiate easily between files and directories. By default, an alphabetical order is used when listing directory content but sometimes, the directories are listed together before the files.

The ls</tt> command also accepts some options to modify its behaviour. The options are listed after a dash "-</tt>". For instance, the "<tt>-r</tt>" option reverse the listing order: $ ls -r folder2 folder1 file2 file1

Files and folders can be hidden on Linux. To show hidden files, use <tt>ls</tt> with the "<tt>-a</tt>" option (for all): $ ls -a . ..  file1  file2  folder1  folder2  .hiddenfile  .hiddenfolder

You can see that:
 * the dot and dot dot shortcuts are actualy hidden folders
 * hidden files and folders also start with a dot ("<tt>.</tt>")

If you go in your home directory, there should be a few hidden files and folders already. They are usually used to store configuration information. Here is a typical home directory on a (heavily used) Linux system:

$ cd $ ls -a .             .gconfd            .mcoprc                      Templates ..            .gimp-2.4          .metacity                    .themes .adobe        .gnome             .mozilla                     .thumbnails .bash_history .gnome2            Music                        .thunderbird .bash_logout  .gnome2_private    .nautilus                    .tomboy .bash_profile .gstreamer-0.10    .openoffice.org2.0           .tomboy.log .bashrc       .gtk-bookmarks     Public                       .Trash bin           .gtkrc-1.2-gnome2  .pulse                       .unison .config       hydrostab          .pulse-cookie                unison.log Desktop       .ICEauthority      .qt                          Videos .dmrc         .icons             .recently-used.xbel          .viminfo Documents     linux1             .Skype                       .vimrc Download      .kde               skype-2.0.0.13-fc5.i586.rpm  .wapi .esd_auth     .libgda            .ssh                         .xine .evolution    linux.tgz          .subversion                  .xsession-errors .fontconfig   .local             systel90 fortran1      .macromedia        tecplot360-2008 .gconf        .mcop

Obviously you can ignore these files most of the time. This is why they are hidden.

When you want more detail about the files and directories, use the "-l" option to use the long listing format. Let's go ack n the <tt>linux1</tt> directory and try it:

$ cd linux1 $ ls -l total 32 -rw-r--r-- 1 jp jp  73 2008-02-01 10:43 file1 -rw-r--r-- 1 jp jp 284 2008-02-01 10:43 file2 drwxr-xr-x 2 jp jp 4096 2008-02-01 10:43 folder1 drwxr-xr-x 2 jp jp 4096 2008-02-01 21:30 folder2

The detailed output for each item starts with a big block which contains the file or directory permissions, the number of directories inside the directory, the file/directory owner, the file/directory group, the file size, the last modified date and time and eventually the file/directory name. The output might slightly vary between systems. Permissions, ownership and groups are explained later on. Note that the number of directories is one for files and at least 2 for directories (because dot and dot dot are always present).

The file size is given in bytes. To make it easier to read, it is possible to use the -h option (for human readable): $ ls -l -h total 32 -rw-r--r-- 1 jp jp  73 2008-02-04 12:46 file1 -rw-r--r-- 1 jp jp 284 2008-02-04 12:50 file2 drwxr-xr-x 2 jp jp 4.0K 2008-02-04 23:40 folder1 drwxr-xr-x 2 jp jp 4.0K 2008-02-04 23:41 folder2

Only the directory size has been change and you can see the K has been used for KiloBytes (KB). There is a more useful example in the folder2 directory.

$ cd folder2 $ ls -l total 120 -rw-r--r-- 1 jp jp 104448 2008-02-04 23:41 file4.doc -rwxr-xr-x 1 jp jp    48 2008-02-04 23:46 runme $ ls -l -h total 120K -rw-r--r-- 1 jp jp 102K 2008-02-04 23:41 file4.doc -rwxr-xr-x 1 jp jp  48 2008-02-04 23:46 runme

Note that 104,448 bytes is "rounded" to 102KB. This is not an error, it is simply that 1KB is 1,024 Bytes and not 1,000...

When several arguments are given to <tt>ls</tt>, they can be lumped together, therefore "<tt>ls -l -h</tt>" is identical to <tt>ls -lh</tt>".

There is a very useful combination of options for <tt>ls</tt>. To find the last file modified in a directory, use "<tt>ls -rtl</tt>". The "t" option use chronological order instead of alphabetical, "l" for long output and "r" for reverse, you end up with the youngest file or directory at the bottom of the list.

$ ls -rtl total 32 -rw-r--r-- 1 jp jp  73 2008-02-04 12:46 file1 -rw-r--r-- 1 jp jp 284 2008-02-04 12:50 file2 drwxr-xr-x 2 jp jp 4096 2008-02-04 23:40 folder1 drwxr-xr-x 2 jp jp 4096 2008-02-04 23:46 folder2

In the example above, the directory <tt>folder2</tt> contains the latest files.

= Getting help = As you have seen with the <tt>ls</tt> example, some commands have many functions and it is easy to lose track. Luckily it is usually quite easy to get help for most commands. Two helps systems are available with the commands <tt>man</tt> and <tt>info</tt>. Just use either, followed by the name of the command you want help for. For instance to find help about the <tt>ls</tt> command using the "<tt>man</tt>" system, type:: man ls

Use the arrows to navigate up and down line by line, the space bar to go down a whole screen height, and enter q to quit. You can also enter "<tt>/word</tt>" to look for the string "word".

Similarly you can use the "<tt>info</tt>" help system:

info ls

Use the arrows to navigate up and down line by line, the space bar to go down a whole screen height, and enter q to quit. You can use enter on a any link identified by an asterisk to be taken directly to that content. You can also enter "<tt>/word</tt>" to look for the string "word".

The <tt>info</tt> system is newer than <tt>man</tt> and probably its successor but <tt>man</tt> is still very popular. Now, to get more information about them, you could try "<tt>info man</tt>" for instance...

= Unix permissions =

We saw earlier on that the long output of <tt>ls</tt> contains a block about file permissions. To understand this block, you need to know that users on a Linux system are organised in groups. Each file or directory has an owner who is a user and also belongs to a group. For each file and directory on a Linux system, it is possible to give permissions or access rights to the owner of a file, to the group to which the file belongs to ... and also to the other users of the system (i.e. those who don't own the file or belong to the group).

The permissions that can be given are called rad access (r), write access (w) and execute access (x). The permissions are usually listed together so a file with "rwx" for a user means that the user has all right on that file. "r-x" means the user can read and execute but not write/modify. "r--" means read only access. Note that in order to be able to enter a directory, a user need both read and execute access ("r-x").

The output of <tt>ls -l</tt> is now easier to understand, for instance:

$ ls -l total 32 -rw-r--r-- 1 jp jp  73 2008-02-04 12:46 file1 -rw-r--r-- 1 jp jp 284 2008-02-04 12:50 file2 drwxr-xr-x 2 jp jp 4096 2008-02-04 23:40 folder1 drwxr-xr-x 2 jp jp 4096 2008-02-04 23:46 folder2

All files in this directory belong to the user <tt>jp</tt> and also the group <tt>jp</tt>. The user <tt>jp</tt> has read and write permissions on <tt>file1</tt> and <tt>file2</tt>, users belonging to the group <tt>jp</tt> and other users only have read access. For the two directories <tt>folder1</tt> and <tt>folder2</tt>, only the user <tt>jp</tt> can modify them. However, all users can enter them. Note that being able to modify a directory includes the right to add or remove files to the directory.

Often, the permissions are simplified (!) using a binary counting system where "--x" is 1, "-w-" is 2 and "r--" is 4. Therefore, "rwx" is 7 and "r-x" is 5. Using this system for the user, group and other users, the permissions of a file or directory can be sumarised as a 3 digit number. For instance, 755 can be used instead of "rwxr-xr-x" or 644 instead of "rw-r--r--". These two are the typical permissions for a directory and file respectively.

Note that on each line of the <tt>ls -l</tt> output, the first character marks the type of the entry, it is a dash "-" for a regular file, a "d" for a directory and it could be a "l" for a link. We will introduce links later.

The permissions on a file or directory can be changes with the command <tt>chmod</tt>.

$ chmod -r file1 $ ls -ltotal 48 --w--- 1 jp jp  73 2008-02-04 12:46 file1 -rw-r--r-- 1 jp jp 284 2008-02-04 12:50 file2 drwxr-xr-x 2 jp jp 4096 2008-02-04 23:40 folder1 drwxr-xr-x 2 jp jp 4096 2008-02-04 23:46 folder2 drwxr-xr-x 3 jp jp 4096 2008-02-05 01:36 folder_a drwxr-xr-x 2 jp jp 4096 2008-02-05 01:34 new-folder

To add read and execute access to the group but not the owner or the others, use $ chmod g+rx file1 $ ls -l --w-r-x--- 1 jp jp  73 2008-02-04 12:46 file1 -rw-r--r-- 1 jp jp 284 2008-02-04 12:50 file2 drwxr-xr-x 2 jp jp 4096 2008-02-04 23:40 folder1 drwxr-xr-x 2 jp jp 4096 2008-02-04 23:46 folder2 drwxr-xr-x 3 jp jp 4096 2008-02-05 01:36 folder_a drwxr-xr-x 2 jp jp 4096 2008-02-05 01:34 new-folder

Similarly, use the letter u for the user/owner, g for the group and o for the others. be careful, o is for the others, not the owner. <tt>chmod</tt> can also be used with a 3 digit permission summary too.

=Creating/deleting/modifying=

Creating directories and files
Now that we know about permissions, it is time to actually create a some content.

To create a directory, use the command <tt>mkdir</tt>:

$ mkdir new-folder $ ls file1 file2  folder1  folder2  new-folder

You can also create nested directory using the option "<tt>-p</tt>" (for create parents): $ mkdir -p folder_a/folder_b/folder_c $ ls file1 file2  folder1  folder2  folder_a  new-folder $ cd folder_a $ ls folder_b $ cd folder_b $ ls folder_c

To create a new empty file, use the command <tt>touch</tt> $ touch new_file $ ls -rtl total 4 -rw-r--r-- 1 jp jp 0 2008-02-05 01:38 new-file

New directories are usually created with the permissions 755 (rwxr-xr-x) and new files with 644 (rw-r--r--).

The <tt>touch</tt> command can actually be used to modify the time stamp of the file, i.e. it changes its latest modification date without changing its content.

2$ ls -rtl total 4 -rw-r--r-- 1 jp jp 0 2008-02-05 01:38 new-file bash-3.2$ touch new-file bash-3.2$ ls -rtl total 4 -rw-r--r-- 1 jp jp 0 2008-02-05 01:42 new-file

Deleting files or directories
To delete a file use the command <tt>rm</tt> (remove). For instance:

$ ls new-file $ rm new-file $ ls

Attention, there is no trash can when you use <tt>rm</tt>. When you delete something, it's gone for good! The option "-i" can be used to force <ttrm</tt> to ask for aconfirmation before actually deleting anything:

$ touch new-file $ rm: remove regular empty file `new-file'? y $ ls

On some systems, <tt>rm</tt> defaults to the "-i" option.

To delete a directory, use the option "-r". $ cd .. $ rm -r folder_c

"-r" is for recursive. When the directory is not empty, you cannot simply delete it.

$ cd ../.. $ rm -r folder_a $ ls file1 file2  folder1  folder2  new-folder

Note that if your system default to the "-i" option, deleting a directory is time conduming as a confirmation will be asked for each file/directory. It is therefore advisable to use option "-f" for force.

Editing files
To edit a file, you can simply use some of the files editors provided by the Linux machine. It varies with the system but often, the following editors are present: <tt>vim</tt>, <tt>emacs</tt>, <tt>nano</tt> and <tt>gedit</tt>. The first three will open in your secure shell window. <tt>vim</tt> and <tt>emacs</tt> are a bit daunting at first. To exit <tt>vim</tt> type "Escape" and then enter ":q". To exit <tt>emacs</tt> type control-x and then ctrl-c. <tt>nano</tt> is easier to use to start with.

<tt>gedit</tt> is actually a graphical text editor, i.e. it opens in its own window and you get a set of buttons/menus to save, copy, cut, paste etc... However, because you are not physically connected to the display of the an extra operation is required to allow that Linux machine to open a window on the screen of your PC. This is done with a piece of software called Exceed. You need to start Exceed from the start menu and then select "Edit->Settings->Profile" and tick the box "Tunnel X11 connections" under "Settings->Tunneling". The configuration only has to be done only once. However, Exceed has to be running for this to work.

On important thing to remember is that when you are connected to one of the local Linux machines, your files are also accessible directly on your computer. So you can edit them in MS Windows, using your favourite text editor and you don't really need to use any of the Linux file editors.

Copying directories and files
To copy a directory and file, use the command <tt>cp</tt> with the option "<tt>-r</tt>" for directories:

$ cp file1 file5 $ cp -r folder1 folder3 $ ls XXX

=Displaying content= Sometimes, you want to look a the content of a file but don't need to edit it. It is possible to display file content on Linux by a range of methods. The command <tt>cat</tt> simply displays the content of a file to the screen. It is quick but not appropriate for large files. <tt>head</tt> and <tt>tail</tt> can be used to look respectively at the top or the end of a file. Both commands usually default to the first or last 10 lines of the file althpugh this can be modified with an optional argument. These commands are very convenient when you know that what you are looking for is at the beginning or at the end of your file. $ head file2 This is file 2. This is another text file. It contains some text at the top.

$ tail file 2

and more text at the end, including the word Computing".

When you want access to the whole file, the commands <tt>more</tt> or <tt>less</tt> can be used. They both work in a similar way. As for <tt>info</tt>, <tt>less</tt> is a bit more modern and you can use the p and down arrows to navigate the file. With <tt>more</tt>, use the space bar to go down ne page. Try them both and see what is in the middle of <tt>file2</tt> for instance.

Attention, displaying content can only be done for text files. It will not work for binary files!. For instance, there is a word document in the <tt>folder2</tt> directory. Try to print the top of the file with <tt>head</tt> for instance and look at the results... It is actually dangerous to use <tt>cat</tt>, <tt>head</tt> or <tt>tail</tt> with binary files because the random garbage content could actually execute actions on the shell. So avoid looking inside binary files with these simple viewers.

=Comparing content= It is also possible to compare the content of two files or directories. For instance, the files <tt>file1</tt> and <tt>file5</tt> are identical so far. We could check it with the command <tt>diff</tt>.

$ diff file1 file5 $ # => no output, therefore files are identical

Now modify the file <tt>file5</tt> with a text editor and try again: $ ... modify file5 somehow ... $ 2$ diff file1 file5 1c1,2 < This file 1. It contains a bit of text including the word "PREHISTORIC". --- > This file 5. It contains a bit of text including the word "PREHISTORIC". > I added this into file5.

We can also use <tt>diff</tt> to compare directories. At the moment <tt>folder1</tt> and <tt>folder3</tt> should be the same. Let's check that:

$ diff folder1 folder3 $

Then add things to <tt>folder3</tt> and try again: $ touch folder3/another-file $ mkdir folder3/new-folder $ diff folder1 folder3 Only in folder3: another-file Only in folder3: new-folder

=Wild cards and bash completion= Before going further, it is time to introduce some f the time savers that make Linux such a powerful development environment. So far you have typed commands and fle names in full but Linux is clever enough to help you along the way either by completing the text for you in a similar way to predictive texting on a mobile phone, or by performing substitutions.

Completion is done with the tab key. When your press <TAB>, the shell tries to understand what are the possible choices and limits it for you. For instance try to type: ls fi<TAB> # (don't press enter!)

The shell knowns that the only content starting with "fi" have also the next letters in common and simply adds them for you. And you only have to add the last digit yourself.

If you hit <TAB> twice, it will actually show you a list of possible choices to help you go further. $ ls fi<TAB> <TAB> # => then becomes "ls file" file1 file2

Another time saver is the wildcard written as an asterisk or star "<tt>*</tt>". It basically matches any number of consecutive characters. For instance if you want to update the time stamp on both <tt>file1</tt> and <tt>file2</tt>, you could type either: $ touch file*

or even shorter

$ touch fi*

This is very useful way of minimising typing. Another important property: if there is only one directory in a directory, you can simply give the star argument to the <tt>cd</tt> command to go directly into it:

$ mkdir -p folder_a/folder_b/folder_c/folder_d/folder_e $ cd folder_a/*/*/*/* $ pwd /gsa13/ggjpr/linux1/folder_a/folder_b/folder_c/folder_d/folder_e

=Searching for things= Linux is a powerful environment to sift through many files and directories and find content. It is possible to search for files or directories (i.e. when you know (part of) their names or to search inside them for specific content.

Locating files and directories
There are two main ways of locating files and directories. the <tt>locate</tt> command can be used to search for whole files of folders containing a particular character string. Try for instance to locate "nano": locate nano /usr/bin/nano /usr/bin/rnano /usr/share/nano /usr/share/doc/nano-2.0.6 /usr/share/doc/nano-2.0.6/AUTHORS ... much more content...

You have the list of all files containing "nano" on your system. Unfortunately, the locate database is not updated very often and it probably would not find new files or folders. Try to locate the <tt>folder3</tt> for instance. The database is usually updated daily so <tt>locate</tt> would find <tt>folder3</t> if you looked tomorrow probably.

The <tt>find</tt> command can be used to recursively search a given path for a pattern. For instance, to search recursively, starting from the current directory and looking for the pattern "folder_b", use: $ find. -name 'folder_b' ./folder_a/folder_b

Wildcards can be used too, for instance:

$ find. -name 'fol*_*' ./folder_a ./folder_a/folder_b

Searching inside files and directories
The <tt>grep</tt> command can be used to look inside files. <tt>grep</tt> stands for Generalised Regular Expression Parser.The syntax is the following:

grep "pattern" list of files and directories to search

For instance, to look for the patter "PRE" inside the files and directories starting with "file", use:

$ grep PRE file* file1:This file 1. It contains a bit of text including the word "PREHISTORIC".

Note that grep is case sensitive by default and the "-i" option can be used to ignore the case.

$ grep pre file* $ # => no output, i.e. nothing found $ grep -i pre file* file1:This file 1. It contains a bit of text including the word "PREHISTORIC".

To search recursively through folder, use the "-r" option. Attention you need to make sure that the list of things to search through includes folders if you want them to be searched recursively! bash-3.2$ grep -ri pre f* file1:This file 1. It contains a bit of text including the word "PREHISTORIC". file5:This file 5. It contains a bit of text including the word "PREHISTORIC". folder1/file3:This file 1. It contains a bit of text including the word "PREHISTORIC". folder3/file3:This file 1. It contains a bit of text including the word "PREHISTORIC".

= A new type of file: symbolic links = You have noticed that <tt>folder1/file3</tt> contains the searched pattern above. Let's look in more detail at this file: $ ls -l folder1/file3 lrwxrwxrwx 1 jp jp 8 2008-02-04 23:40 folder1/file3 -> ../file1

<tt>file3</tt> is called a symbolic link and it links to <tt>file1</tt>. So it has the same content:

$ diff file1 folder1/file3 $ # => so no difference between the two files

Symbolic links are just "shortcuts" or different addresses/paths to the same content. You can edit <tt>file3</tt> and see the changes in <tt>file1</tt> automatically. the only exception is that you can delete the link (<tt>file3</tt>) and the target will stay.

To create a symbolic link, the command <tt>ln</tt> is used with the option "-s":

$ ln -s /gsa13/ggjpr/linux1/file2 folder2/newlink

= To go further = The Pragmatic Programming course continues with an introduction to the Fortran programming language: Fortran1.

Now that you know an small set of Linux commands, you can also learn how to put them together by reading Linux2.