Most popular computer operating systems, like Microsoft Windows and Mac OS X, offer primarily (but not exclusively) graphical user interfaces. The user interacts with files and programs by pointing and clicking with a mouse. Unix, which is a considerably older operating system than Windows or OS X, also offers a graphical user interface (more than one, actually), but Unix originally presented a ''command line interface'', in which the user interacts with the operating system by typing commands at a text prompt and reading textual output from programs. The command line interface is alive and well in Unix today, and many Unix users consider it the most powerful and efficient system for basic operations like navigating through directories and handling files.

3

4

= Terminology =

5

In this document, we use the term Unix to refer to a family of operating systems. The look and feel of the graphical interfaces of these systems, as well as the file system layout, may differ significantly from one system to the next, but they all have their (conceptual) roots in the original Unix developed at Bell Labs. This family of operating systems includes Linux (also called GNU/Linux) distributions like Debian, Red Hat, and Ubuntu, as well as Sun Solaris. Mac OS X is a curious case; many of its users never touch the command line interface, but all the commands described below are all available in OS X. Many entertaining arguments about whether OS X is a true Unix can be found in programmer internet forums. Microsoft Windows offers a different command line interface than Unix, but a program called [http://www.cygwin.com/ Cygwin] provides a Unix interface for Windows.[[BR]][[BR]]

6

We also use the abbreviation OS to mean "operating system".

7

8

= Opening a Terminal =

9

In a modern Unix OS (that is, one with a graphical user interface) the command line interface is accessed through a program called a terminal. Below we show how to run a terminal program in some of the more popular graphical Unix environments, including GNOME and KDE, available in most Linux distributions, as well as Mac OS X.

10

11

=== GNOME ===

12

In the GNOME desktop, click the Applications menu (typically in the upper left corner); in the Accessories menu, choose Terminal.[[BR]]

13

[[image(gnome_terminal.png)]]

14

15

=== KDE ===

16

In the KDE desktop, click the main menu (with K superimposed over a gear), typically in the lower left corner; in the System menu, choose Konsole (the KDE terminal program).[[BR]]

17

[[image(kde_konsole.png)]]

18

19

=== Mac OS X ===

20

In a Finder window, choose the Utilities folder.[[BR]]

21

[[image(osx_utilities.png)]][[BR]][[BR]]

22

In the Utilities folder, select the Terminal application.[[BR]]

23

[[image(osx_terminal.png)]][[BR]]

24

25

== A new window ==

26

The steps listed above should produce a new window on the screen, with a prompt and possibly a cursor. The prompt might be a simple character, like '''$''' or '''%''', or it might be the name of the computer and a number showing how many commands have been entered, like {{{coates[1]}}}. Regardless of the color of the window or cursor or the wording of the prompt, this terminal window is a Unix command line interface.

27

28

= Shell =

29

The prompt in a terminal window is the output of a program called the shell. The shell is the Unix command interpreter. (It is actually a separate program from the terminal window program, but the shell starts automatically when a terminal window opens and exits when the terminal window closes). Unix offers several different shells, but for most of what we cover in this document, the differences between the shells are negligible.

30

[[BR]][[BR]]

31

-

The shell reads the characters typed next to the prompt in the terminal, until Enter or Return is typed. After Enter or Return, the shell interprets all the input characters as a command, runs the command, returns any text output from the command to be displayed in the terminal, and, finally, displays a new prompt, waiting for the next command.

+

The shell reads the characters typed next to the prompt in the terminal, until the user hits either the Enter key or the Return key. After Enter or Return, the shell interprets all the input characters as a command, runs the command, returns any text output from the command to be displayed in the terminal, and, finally, displays a new prompt, waiting for the next command.

32

33

= File names and directories =

34

Unix file names may contain letters (a-z, A-Z), numbers (0-9), and a few other characters, like the dot (.) and underscore (_). Certain characters should ''not'' be used in a file name, like slash (/), asterisk (*), ampersand (&), percent (%), and space ( ). These characters have special meaning in the Unix file system, or to the shell, and should be avoided in file names. Files whose names begin with a dot (.) are handled specially by some of the commands considered below.

35

[[BR]][[BR]]

36

Unix files live in directories, which are analogous to folders in Microsoft Windows. A directory is simply a collection of files. All directories exist in a hierarchy, which begins at the ''root directory'', which is denoted by a slash (/). The ''full path'' of a file indicates its position in the directory hierarchy. For example, the full paths {{{/file1}}} and {{{/file2}}} refer to two separate files, {{{file1}}} and {{{file2}}}, which both reside in the root directory (hence the {{{/}}} in the full path). The full path always begins with {{{/}}}. As another example, consider the full paths {{{/dir1/file1}}} and {{{/dir1/dir2/file2}}}. These paths refer, again, to two separate files, but in this case the files exist in different directories. The first file, {{{file1}}} lives in the directory {{{dir1}}}, which lives in the root directory {{{/}}}. The second file, {{{file2}}}, lives in the directory {{{dir2}}}, which is a subdirectory of {{{dir1}}}. Note that the slash (/) separates directory names in the full path, as well as representing the root directory.

37

[[BR]][[BR]]

38

Directory names follow the same rules as file names.

39

40

= Basic commands =

41

This section introduces the basic Unix command line ''utilities'', programs designed to do one specific task. The example images show a grey terminal window with black text and a prompt of the form {{{coates[N]}}}, where {{{N}}} is the number of commands which have been entered already.

42

[[BR]]

43

[[image(ex_terminal.png)]]

44

45

== ls - list files ==

46

Perhaps the most basic of all Unix commands, ''ls'' lists the files in a directory. If no argument is given to ls, as in this example

47

[[BR]]

48

[[image(ex_ls.png)]]

49

[[BR]]

50

certain files in the current directory are shown. Which files are shown and which are not shown? Read on...

51

52

=== ls -a ===

53

Files whose name begins with dot (.) are ''not'' shown by default in the output of ls. Such files are called ''hidden files'' or ''dot files''. To see the hidden files in a directory, use the -a argument to ls. This example shows the additional output from ls, listing the hidden files which were not reported by the first invocation of ls.

54

[[BR]]

55

[[image(ex_ls-a.png)]]

56

[[BR]]

57

Two entries always appear in the output of ls -a, even in empty directories which contain no files: {{{.}}} and {{{..}}}, which are shortcuts to the current directory and the parent directory, respectively.

58

59

=== ls -F ===

60

Some of the results listed in the output of ls are subdirectories, while others are simply files. In order to distinguish between files and directories we can use the -F argument (also called a ''flag'') to ls.

61

[[BR]]

62

[[image(ex_ls-f.png)]]

63

[[BR]][[BR]]

64

Arguments can be grouped together. For example, {{{ls -a -F}}} and {{{ls -F -a}}} both list all files, including hidden files, and add a trailing slash (/) to

65

directory names. The order of arguments (e.g. {{{-a -F}}} vs {{{-F -a}}}) does not matter.

66

[[BR]]

67

[[image(ex_ls-a-f.png)]]

68

69

=== ls ''path'' ===

70

The ls command also accepts a directory argument. This example shows a listing of the files in specific subdirectories of the current directory. Note that the -F flag adds a trailing slash (/) to the names of directories.

71

[[BR]]

72

[[image(ex_ls-f-path.png)]]

73

[[BR]]

74

[[BR]]

75

The shortcut {{{..}}} can be used to see the files in the parent directory.

76

[[BR]]

77

[[image(ex_ls-f-parent.png)]]

78

[[BR]]

79

80

== pwd - print working directory ==

81

82

== cd - change directory ==

83

~

84

85

== mkdir - create new directory ==

86

87

== cp - copy ==

88

89

== mv - move (rename) ==

90

91

== rm - remove (delete) ==

92

93

== rmdir - remove directory ==

94

95

== clear - clear screen ==

96

97

== cat - display file ==

98

99

== man - manual ==

100

101

== Slightly more advanced topics ==

102

=== grep - search ===

103

=== | - pipe output ===

104

=== {{{<>}}} - redirect ===

105

=== *, ? - wildcards ===

106

=== ssh - remote access ===

107

108

= Links =

109

== Other useful Topics ==

110

* [/topics/SoftwareDevelopment Software Development]

111

* [/resources/5923 Using Subversion], a source code version management system