sttp/ult/Using_Linux_Tools.rst
changeset 0 27e1f5bd2774
equal deleted inserted replaced
-1:000000000000 0:27e1f5bd2774
       
     1 Introducing Linux
       
     2 =================
       
     3 
       
     4 (Attribution : A significant chunk of the content under this section is based on data from Wikipedia and the Linux Documentation Project)
       
     5 
       
     6 Linux (usually pronounced ˈlɪnəks') is a generic term referring to Unix-like computer operating systems based on the Linux kernel, where a kernel is the intermediate layer between the hardware and the applications. The kernel is, on an abstract level, the core of (most) operating systems, that manages the various system resources. The development of the Linux OS is considered the basis for Free and Open Source Software (FOSS) collaboration since typically the underlying source code can be used, modified freely, and redistributed by anyone under the terms of the GNU (a recursive acronym for "GNU's Not Unix!") Global Public License (GPL) and other free software licences. This freedom to access and reuse various components of a system, is one of the primary reasons for the popularity of Linux.
       
     7 
       
     8 Linux is installed on a variety of computer hardware, that include mobile phones, embedded devices and supercomputers, but is infamous for its use in servers.
       
     9 
       
    10 The name "Linux"  comes from the Linux kernel, originally written in 1991 by Linus Torvalds. The rest of the system usually comprises components such as the Apache HTTP Server, the X Window System, the GNOME and KDE desktop environments, and utilities and libraries from the GNU Project (announced in 1983 by Richard Stallman). Commonly-used applications with desktop Linux systems include the Mozilla Firefox web-browser and the OpenOffice.org office application suite. The GNU contribution is the basis for the Free Software Foundation's preferred name GNU/Linux. The kernel's mascot is a penguin named "Tux". Mozilla Firefox and OpenOffice.org are open-source projects which can be run on most Operating Systems, including proprietary ones.
       
    11 
       
    12 Historical Background
       
    13 ----------------------
       
    14 
       
    15 Events leading to the creation
       
    16 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
       
    17 - The Unix operating system was developed in the 1960s and released for public use in 1970. Its accessibility and portability caused it to be widely adopted, copied and modified by academic institutions and businesses. Its design became influential to authors of other systems. Other free operating systems include the Berkeley Software Distribution (BSD), developed at the University of California at Berkeley, and MINIX which was released by Andrew S. Tanenbaum. The development and adoption of BSD and MINIX were limited due to various reasons, and this lack of a widely-adopted and free kernel triggered Linus Torvalds into starting his project.
       
    18 
       
    19 - In 1983, Richard Stallman started the GNU project with the goal of creating a free UNIX-like operating system. As part of this work, he wrote the GNU General Public License (GPL). By the early 1990s there was almost enough available software to create a full operating system. However, the GNU kernel, called Hurd, failed to attract enough attention from developers leaving GNU incomplete.
       
    20 
       
    21 The Creation of Linux
       
    22 ~~~~~~~~~~~~~~~~~~~~~~
       
    23 In 1991, Linus Torvalds began a project at the University of Helsinki that later became the Linux kernel. It was initially a terminal (command-line) emulator, which Torvalds used to access the large UNIX servers of the university. He wrote the program targeting just the hardware he was using and independent of an operating system because he wanted to use the functions of his computer with an 80386 processor. Development was done on Minix using the GNU C compiler. This application is still the main choice for compiling Linux today (although the code can be built with other compilers, such as the Intel C Compiler).
       
    24 
       
    25 Torvalds continues to direct the development of the kernel. Stallman heads the Free Software Foundation, which in turn supports the GNU components. Finally, individuals and corporations develop third-party non-GNU components, which constitute a vast body of work and including kernel modules, and user applications and libraries. Linux vendors and communities combine and distribute the kernel, GNU components, and non-GNU components, with additional package management software in the form of Linux distributions.
       
    26 
       
    27 
       
    28 Design and Implications
       
    29 ------------------------
       
    30 
       
    31 A Linux-based system is a modular Unix-like operating system, deriving much of its basic design from principles established in Unix earlier. Such a system uses a monolithic kernel, called the Linux kernel, which handles process control, networking, and peripheral and file system access. Device drivers are integrated directly with the kernel. Separate projects that interface with the kernel provide much of the system's higher-level functionality. The GNU userland is an important part of most Linux-based systems, providing the most common implementation of the C library, a popular shell, and many of the common Unix tools which carry out many basic operating system tasks. The graphical user interface (or GUI) used by most Linux systems is based on the "X Window System".
       
    32 
       
    33 User Interface
       
    34 ~~~~~~~~~~~~~~
       
    35 Users can control a Linux-based system through a command line interface (or CLI), a graphical user interface (or GUI), or through controls attached to the associated hardware (this is common for embedded systems). For desktop systems, the default mode is usually the GUI. On desktop machines, "KDE", "GNOME" and "Xfce" are the most popular user interfaces,though a variety of additional user interfaces exist. Most popular user interfaces run on top of the "X Window System" (or X), which enables a graphical application running on one machine to be displayed and controlled from another in a network.
       
    36 
       
    37 A Linux system also provides a CLI of some sort through a shell, which is the traditional way of interacting with a Unix system. A Linux distribution specialized for servers may use the CLI as its only interface. A “headless system” (system run without even a monitor) can be controlled by the command line via a remote-control protocol such as SSH or telnet. The CLI is particularly suited for automation of repetitive or delayed tasks, and provides very simple inter-process communication. A graphical terminal emulator program is often used to access the CLI from a Linux desktop.
       
    38 
       
    39 Development
       
    40 ~~~~~~~~~~~
       
    41 The primary difference between Linux and many other popular contemporary operating systems is that the Linux kernel and other components are free and open source software. Linux is not the only such operating system, although it is by far the most widely used. Some free and open source software licenses are based on the principle of "copyleft", a kind of reciprocity: any work derived from a copyleft piece of software must also be copyleft itself. The most common free software license, the GNU GPL, is a form of copyleft, and is used for the Linux kernel and many of the components from the GNU project.
       
    42 
       
    43 Linux based distributions are intended by developers for interoperability with other operating systems and established computing standards. Linux systems adhere to POSIX, SUS, ISO and ANSI standards where possible, although to date only one Linux distribution has been POSIX.1 certified, Linux-FT.Free software projects, although developed in a collaborative fashion, are often produced independently of each other. The fact that the software licenses explicitly permit redistribution, however, provides a basis for larger scale projects that collect the software produced by stand-alone projects and make it available all at once in the form of a Linux distribution.
       
    44 
       
    45 A Linux distribution, commonly called a "distro", is a project that manages a remote collection of system software and application software packages available for download and installation through a network connection. This allows the user to adapt the operating system to his/her specific needs. Distributions are maintained by individuals, loose-knit teams, volunteer organizations, and commercial entities. A distribution can be installed using a CD that contains distribution-specific software for initial system installation and configuration. A package manager such as Synaptic or YAST allows later package upgrades and installations. A distribution is responsible for the default configuration of the installed Linux kernel, general system security, and more generally integration of the different software packages into a coherent whole.
       
    46 
       
    47 Community
       
    48 ~~~~~~~~~
       
    49 A distribution is largely driven by its developer and user communities. Some vendors develop and fund their distributions on a volunteer basis. Examples include Debian and the Debian-based, Ubuntu. Others maintain a community version of their commercial distributions, as Red Hat does with Fedora.
       
    50 
       
    51 In many cities and regions, local associations known as Linux Users Groups (LUGs) seek to promote their preferred distribution and by extension free software. They hold meetings and provide free demonstrations, training, technical support, and operating system installation to new users. Many Internet communities also provide support to Linux users and developers. Most distributions and free software / open source projects have IRC (Internet Relay Chat) chatrooms or newsgroups. Online forums are another means for support. Linux distributions host mailing lists; commonly there will be a specific topic such as usage or development for a given list. All these can be found simply by running an appropriate search on Google.
       
    52 
       
    53 Although Linux distributions are generally available without charge, several large corporations sell, support, and contribute to the development of the components of the system and of free software. These include Dell, IBM, HP, Oracle, Sun Microsystems, Novell, Nokia. A number of corporations, notably Red Hat, have built their entire business around Linux distributions.
       
    54 
       
    55 Can I make a profit out of running a business involving Linux?
       
    56 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
       
    57 
       
    58 The answer is, "Yes!". The free software licenses, on which the various software packages of a distribution built on the Linux kernel are based, explicitly accommodate and encourage commercialization; the relationship between a Linux distribution as a whole and individual vendors may be seen as symbiotic. One common business model of commercial suppliers is charging for support, especially for business users. A number of companies also offer a specialized business version of their distribution, which adds proprietary support packages and tools to administer higher numbers of installations or to simplify administrative tasks. Another business model is to give away the software in order to sell hardware. Examples of corporations that are extensively (and sometimes exclusively) open-source and Linux-powered , with successful revenue generation models involving these, are Google, SUN, Mozilla, etc.
       
    59 
       
    60 Programming on Linux
       
    61 ~~~~~~~~~~~~~~~~~~~~
       
    62 Most Linux distributions support dozens of programming languages. The most common collection of utilities for building both Linux applications and operating system programs is found within the GNU toolchain, which includes the GNU Compiler Collection (GCC) and the GNU build system. Amongst others, GCC provides compilers for Ada, C, C++, Java, and Fortran. The Linux kernel itself is written to be compiled with GCC. Proprietary compilers for Linux include the Intel C++ Compiler, Sun Studio, and IBM XL C/C++ Compiler.
       
    63 
       
    64 Most distributions also include support for PHP, Perl, Ruby, Python and other dynamic languages. Examples of languages that are less common, but still supported, are C# via the Mono project, sponsored by Novell, and Scheme. A number of Java Virtual Machines and development kits run on Linux, including the original Sun Microsystems JVM (HotSpot), and IBM's J2SE RE, as well as many open-source projects like Kaffe.
       
    65 
       
    66 The two main frameworks for developing graphical applications are those of GNOME and KDE. These projects are based on the GTK+ and Qt widget toolkits, respectively, which can also be used independently of the larger framework. Both support a wide variety of languages. There are a number of Integrated Development Environments (IDEs) available including Anjuta, Code::Blocks, Eclipse, KDevelop, Lazarus, MonoDevelop, NetBeans, and Omnis Studio while the long-established editors Vim and Emacs remain popular.
       
    67 
       
    68 Reasons for Using Linux
       
    69 -----------------------
       
    70 - Linux is free:
       
    71 
       
    72 As in "free beer". Linux can be downloaded in its entirety from the Internet completely for free. No registration fees, no costs per user, free updates, and freely available source code in case you want to change the behavior of your system.
       
    73 Most of all, Linux is free as in "free speech":
       
    74 The license commonly used is the GNU Public License (GPL). The license says that anybody who may want to do so, has the right to change Linux and eventually to redistribute a changed version, on the one condition that the code is still available after redistribution. In practice, you are free to grab a kernel image and sell the new code, as long as your customers can still have a copy of that code.
       
    75 
       
    76 - Linux is portable to any hardware platform:
       
    77 
       
    78 A vendor, who wants to sell a new type of computer and who does not know what kind of OS his/her new machine will run, can take a Linux kernel and make it work on his/her hardware, because documentation related to this activity is freely available.
       
    79 
       
    80 - Linux was made to keep on running:
       
    81 
       
    82 As with UNIX, a Linux system expects to run without rebooting all the time. That is why a lot of tasks are being executed at night or scheduled automatically for other times, resulting in higher availability during busier periods and a more balanced use of the hardware. This property allows for Linux to be applicable to environments where people do not have the time or the possibility to control their systems constantly.
       
    83 
       
    84 - Linux is secure and versatile:
       
    85 
       
    86 The security model used in Linux is based on the UNIX idea of security, which is known to be robust and of proven quality. But Linux is not only safe from attacks from the Internet: it will adapt equally to other situations, utilizing the same high standards for security.
       
    87 
       
    88 - Linux is scalable:
       
    89 
       
    90 From a Palmtop with 2 MB of memory to a petabyte storage cluster with hundreds of nodes: add or remove the appropriate packages and Linux fits all. One does not need a supercomputer anymore,because you can use Linux to do big things using the building blocks provided with the system. If one wants to do little things, such as making an operating system for an embedded processor or just recycling your old 486, Linux will do that as well.
       
    91 
       
    92 - The Linux OS and Linux applications have very short debug−times:
       
    93 
       
    94 Because Linux has been developed and tested by thousands of people, both errors and people to fix them are found very quickly. It often happens that there are only a couple of hours between discovery and fixing of a bug.
       
    95 
       
    96 Getting Started
       
    97 ================
       
    98 
       
    99 Logging in, activating the user interface and logging out
       
   100 ----------------------------------------------------------
       
   101 In order to work on a Linux system directly, one needs to provide a user name and password. You always need to authenticate to the system. Most PC−based Linux systems have two basic modes for a system to run in: either quick and clean in text console mode,which includes with mouse, multitasking and multi−user features, or in graphical console mode, which looks better but eats more system resources.
       
   102 
       
   103 Graphical Mode
       
   104 ~~~~~~~~~~~~~~
       
   105 This is the default nowadays on most desktop computers. You know you will be connecting to the system using graphical mode when you are first asked for your user name, and then to type your password.
       
   106 
       
   107 To log in, make sure the mouse pointer is in the login window, provide your user name and password to the system and click *OK* or press *Enter*.
       
   108 It is generally considered a bad idea to connect (graphically) using the root user name, the system adminstrator's account, since the use of graphics includes running a lot of extra programs, in root's case with a lot of extra permissions. To keep all risks as low as possible, use a normal user account to connect graphically. But there are enough risks to keep this in mind as a general advice, for all use of the root account: only log in as root when extra privileges are required.
       
   109 
       
   110 After entering your user name/password combination, it can take a little while before the graphical environment is started, depending on the CPU speed of your computer, on the software you use and on your personal settings.
       
   111 
       
   112 To continue, you will need to open a *terminal window* or *xterm* for short (X being the name for the underlying software supporting the graphical environment). This program can be found in the *Applications−>Utilities->System Tools* or *Internet menu*, depending on what window manager you are using. There might be icons that you can use as a shortcut to get an *xterm* window as well, and clicking the right mouse button on the desktop background will usually present you with a menu containing a terminal window application.
       
   113 
       
   114 While browsing the menus, you will notice that a lot of things can be done without entering commands via the keyboard. For most users, the good old point−n−click method of dealing with the computer will do. But for those who want to enter the "heart" of the system, a tool stronger than a mouse will be required to handle the various tasks. This tool is the shell, and when in graphical mode, we activate our shell by opening a terminal window.
       
   115 
       
   116 A terminal window should always show a command prompt when you open one. This terminal shows a standard prompt, which displays the user's login name, and the current working directory, represented by the twiddle (~)
       
   117 
       
   118 Another common form for a prompt is this one:
       
   119 [user@host dir]
       
   120 
       
   121 In the above example, *user* will be your login name, *hosts* the name of the machine you are working on, and *dir* an indication of your current location in the file system. Prompts can display all kinds of information, but they are not part of the commands you are giving to your system. To disconnect from the system in graphical mode, you need to close all terminal windows and other applications. After that, hit the *logout* icon or find *Log Out* in the menu. Closing everything is not really necessary, and the system can do this for you, but session management might put all currently open applications back on your screen when you connect again, which takes longer and is not always the desired effect. However, this behavior is configurable.
       
   122 
       
   123 When you see the login screen again, asking to enter user name and password, logout was successful.
       
   124 
       
   125 Text Mode
       
   126 ~~~~~~~~~
       
   127 One is in text mode when the whole screen is black, showing (in most cases white) characters. A text mode login screen typically shows some information about the machine you are working on, the name of the machine and a prompt waiting for you to log in.
       
   128 
       
   129 The login is different from a graphical login, in that you have to hit the *Enter* key after providing your user name, because there are no buttons on the screen that you can click with the mouse. Then you should type your password, followed by another *Enter*. You will not see any indication that you are entering something, not even an asterisk, and you won't see the cursor move. But this is normal on Linux and is done for security
       
   130 reasons.
       
   131 
       
   132 When the system has accepted you as a valid user, you may get some more information, called the *message of the day*, which can be anything. Additionally, it is popular on UNIX systems to display a fortune cookie, which contains some general wise or unwise (this is up to you) thoughts. After that, you will be given a shell, indicated with the same prompt that you would get in graphical mode.
       
   133 
       
   134 Also in text mode: log in as root only to do setup and configuration that absolutely requires administrator privileges, such as adding users, installing software packages, and performing network and other system configuration. Once you are finished, immediately leave the special account and resume your work as a non−privileged user.
       
   135 
       
   136 Logging out is done by entering the *logout* command, followed by Enter. You are successfully disconnected from the system when you see the login screen again.Don't power−off the computer after logging out. It is not meant to be shut off without application of the proper procedures for halting the system. Powering it off without going through the halting process might cause severe damage!
       
   137 
       
   138 Basic Commands
       
   139 ===============
       
   140 
       
   141 ls
       
   142 ---
       
   143 
       
   144 When invoked without any arguments, *ls* lists the files in the current working directory. A directory that is not the current working directory can be specified and ls will list the files there. The user also may specify any list of files and directories. In this case, all files and all contents of specified directories will be listed. The name *ls* is derived from *list segments* which was used in earlier systems.
       
   145 
       
   146 Files whose names start with "." are not listed, unless the *-a* flag is specified or the files are specified explicitly.
       
   147 
       
   148 Without options, *ls* displays files in a bare format. This bare format however makes it difficult to establish the type, permissions, and size of the files. The most common options to reveal this information or change the list of files are:
       
   149 
       
   150     * *-l* long format, displaying Unix file types, permissions, number of hard links, owner, group, size, date, and filename
       
   151     * *-F* appends a character revealing the nature of a file, for example, * for an executable, or / for a directory. Regular files have no suffix.
       
   152     * *-a* lists all files in the given directory, including those whose names start with "." (which are hidden files in Unix). By default, these files are excluded from the list.
       
   153     * *-R* recursively lists subdirectories. The command ls -R / would therefore list all files.
       
   154     * *-d* shows information about a symbolic link or directory, rather than about the link's target or listing the contents of a directory.
       
   155     * *-t* sort the list of files by modification time.
       
   156     * *-h* print sizes in human readable format. (e.g., 1K, 234M, 2G, etc.)
       
   157 
       
   158 In some environments, providing the option *--color* (for GNU ls) or *-G* (FreeBSD ls) causes ls to highlight different types of files with different colors, instead of with characters as *-F* would. To determine what color to use for a file, GNU *ls* checks the Unix file type, the file permissions, and the file extension, while FreeBSD *ls* checks only the Unix file type and file permissions.::
       
   159 
       
   160 	$ ls
       
   161 	jeeves.rst psmith.html blandings.html
       
   162 	$ ls -l
       
   163 	drwxr--r--   1 plum  editors   4096  jeeves
       
   164 	-rw-r--r--   1 plum  editors  30405  psmith
       
   165 	-r-xr-xr-x   1 plum  plum      8460  blandings
       
   166 
       
   167 Here "$" actually is the beginning of the prompt. This is typical in most Unix-based systems.
       
   168 
       
   169 date
       
   170 -----
       
   171 
       
   172 The Unix date command displays the time and date. The super-user can use it to set the system clock.
       
   173 
       
   174 With no options, the date command displays the current date and time, including the abbreviated day name, abbreviated month name, day of the month, the time separated by colons, the timezone name, and the year. For example::
       
   175 
       
   176 	$date
       
   177 	Tue Sep  8 12:01:45 IST 2009
       
   178 
       
   179 On some systems to set the current date and time to September 8, 2004 01:22 you type::
       
   180 
       
   181 	$date --set="20040908 01:22"
       
   182 
       
   183 In order to view the various options for the *date* command, type::
       
   184 
       
   185 	$man date
       
   186 
       
   187 This will take you to the "Manual" page comprising of all the details on the *date* command. You can return to the terminal from the "man" page by pressing the *Esc* key in the keyboard and typing ":q" in that order. 
       
   188 
       
   189 cd
       
   190 ---
       
   191 
       
   192 This stands for "change directory". When one wants to go up to the parent directory, bypassing the tree of directories one has entered, “ cd ..” can be used.
       
   193 
       
   194 One dot '.' represents the current directory while two dots '..' represent the parent directory.
       
   195 
       
   196 “ cd -” will return you to the previous directory (a bit like an “undo”).
       
   197 
       
   198 You can also use cd absolute path or cd relative path (see below):
       
   199 
       
   200 Absolute paths:
       
   201 
       
   202     An “ absolute path” is easily recognised from the leading forward slash, /. The / means that you start at the top level directory and continue down.
       
   203 
       
   204 For example to get to /boot/grub you would type::
       
   205 
       
   206 	$cd /boot/grub
       
   207 
       
   208 This is an absolute path because you start at the top of the hierarchy and go downwards from there (it doesn't matter where in the filesystem you were when you typed the command).
       
   209 
       
   210 Relative paths:
       
   211 
       
   212     A “ relative path” doesn't have a preceding slash. Use a relative path when you start from a directory below the top level directory structure. This is dependent on where you are in the filesystem.
       
   213 
       
   214     For example if you are in root's home directory and want to get to /root/music, you type::
       
   215 
       
   216 	$ cd music
       
   217 
       
   218 Please note that there is no / using the above cd command. Using a / would cause this to be an absolute path, working from the top of the hierarchy downward.
       
   219 
       
   220 who
       
   221 ----
       
   222 
       
   223 The standard Unix command *who* displays a list of users who are currently logged into a computer.
       
   224 
       
   225 The *who* command is related to the command *w*, which provides the same information but also displays additional data and statistics.::
       
   226 
       
   227 	$who
       
   228 	beeblebrox tty7         2009-09-08 10:50 (:0)
       
   229 	beeblebrox pts/0        2009-09-08 11:25 (:0.0)
       
   230 	dumbledore pts/1        2009-09-08 18:11 (potter.xyz.in)
       
   231 	beeblebrox pts/2        2009-09-08 18:53 (:0.0)
       
   232 
       
   233 
       
   234 The command can be invoked with the arguments *am i* or *am I* (so it is invoked as *who am i* or * who am I*), showing information about the current terminal only (see the *-m* option below, of which this invocation is equivalent).
       
   235 
       
   236 In order to find out the various options that can be appended to the *who* command, check the *man* page by typing out the following in the terminal::
       
   237 
       
   238 	$man who
       
   239 
       
   240 This will take you to the "Manual" page containing details about the *who* command
       
   241 
       
   242 mkdir
       
   243 -----
       
   244 
       
   245 This command is used to make a new directory. Normal usage is as straightforward as follows::
       
   246 
       
   247 	$mkdir name_of_directory
       
   248 
       
   249 Where *name_of_directory* is the name of the directory one wants to create. When typed as above (ie. normal usage), the new directory would be created within the current directory. On Unix, multiple directories can be specified, and *mkdir* will try to create all of them.
       
   250 
       
   251 Options
       
   252 ~~~~~~~
       
   253 
       
   254 On Unix-like operating systems, *mkdir* takes options. Three of the most common options are:
       
   255 
       
   256     * *-p*: will also create all directories leading up to the given directory that do not exist already. If the given directory already exists, ignore the error.
       
   257     * *-v*: display each directory that mkdir creates. Most often used with -p.
       
   258     * *-m*: specify the octal permissions of directories created by mkdir.
       
   259 
       
   260 *-p* is most often used when using mkdir to build up complex directory hierarchies, in case a necessary directory is missing or already there. -m is commonly used to lock down temporary directories used by shell scripts.
       
   261 
       
   262 Examples
       
   263 ~~~~~~~~
       
   264 
       
   265 An example of *-p* in action is::
       
   266 
       
   267 	$mkdir -p /tmp/a/b/c
       
   268 
       
   269 If */tmp/a* exists but */tmp/a/b* does not, mkdir will create */tmp/a/b* before creating */tmp/a/b/c*.
       
   270 
       
   271 And an even more powerful command, creating a full tree at once (this however is a Shell extension, nothing mkdir does itself)::
       
   272 
       
   273 	$mkdir -p tmpdir/{trunk/sources/{includes,docs},branches,tags}
       
   274 
       
   275 This will create:
       
   276 
       
   277 tmpdir 	- branches
       
   278 	- tag
       
   279 	- trunk	- sources - includes
       
   280 			  - docs
       
   281 
       
   282 Getting Help
       
   283 ============
       
   284 
       
   285 apropos and whatis
       
   286 -------------------
       
   287 
       
   288 This is a command to search the manual pages files in Unix and Unix-like operating systems. ::
       
   289 
       
   290 	$ apropos grep
       
   291 	egrep       egrep (1)       Search a file for a pattern using full regular expressions
       
   292 	fgrep       fgrep (1)       Search a file for a fixed-character	string
       
   293 	fmlgrep     fmlgrep (1)     Search a file for a pattern
       
   294 	grep        grep (1)        Search a file for a pattern
       
   295 	gzgrep      gzgrep (1)      Search a possibly compressed file for a regular expression
       
   296 	nisgrep     nismatch (1)    Utilities for searching NIS+ tables
       
   297 	pgrep       pgrep (1)       Find or signal a process by name or other attribute
       
   298 	zgrep       zgrep (1)       Search a possibly compressed file for a regular expression
       
   299 	...
       
   300 
       
   301 In this example, the user uses *apropos* to search for the string "grep", and apropos returns the indicated *man* pages that include the term "grep".
       
   302 
       
   303 A short index of explanations for commands is available using the *whatis* command, like in the examples below::
       
   304 
       
   305 	$whatis ls
       
   306 	ls (1) 		 - list directory contents
       
   307 
       
   308 This displays short information about a command, and the first section in the collection of man pages that contains an appropriate page.
       
   309 
       
   310 If you don't know where to get started and which man page to read, *apropos* gives more information. Say that you do not know how to start a browser, then you could enter the following command::
       
   311 
       
   312 	$apropos browser
       
   313 	gmusicbrowser (1)    - Jukebox for large collections of audio files
       
   314 	infobrowser (1)      - read Info documents
       
   315 	libsmbclient (7)     - An extension library for browsers and that 		can be used...
       
   316 	opera (1)            - a standards-compliant graphical Web browser
       
   317 	sensible-browser (1) - sensible editing, paging, and web browsing
       
   318 	smbtree (1)          - A text based smb network browser
       
   319 	tvtk_doc (1)         - A GUI based TVTK documentation search browser.
       
   320 	viewres (1)          - graphical class browser for Xt
       
   321 	w3m (1)              - a text based Web browser and pager
       
   322 	www-browser (1)      - a text based Web browser and pager
       
   323 	...
       
   324 
       
   325 man
       
   326 ----
       
   327 
       
   328 Man pages (short for "manual pages") are the extensive documentation that comes preinstalled with almost all substantial Unix and Unix-like operating systems. The Unix command used to display them is *man*. Each page is a self-contained document.
       
   329 
       
   330 To read a manual page for a Unix command, one can use::
       
   331 
       
   332 	$ man <command_name>
       
   333 
       
   334 at a shell prompt; for example, "man ftp". In order to simplify navigation through the output, *man* generally uses the less terminal pager.
       
   335 
       
   336 Pages are traditionally referred to using the notation "name(section)"; for example, ftp(1). The same page name may appear in more than one section of the manual, this can occur when the names of system calls, user commands, or macro packages coincide. Two examples are *man(1)* and *man(7)*, or *exit(2)* and *exit(3)*. The syntax for accessing the non-default manual section varies between different man implementations. On Linux and *BSD, for example, the syntax for reading *printf(3)* is::
       
   337 
       
   338 	$man 3 printf
       
   339 
       
   340 Another example::
       
   341 
       
   342 	$man man
       
   343 
       
   344 The previous example will take you to the "Manual" page entry about manual pages!
       
   345 
       
   346 Layout
       
   347 ~~~~~~
       
   348 
       
   349 All man pages follow a common layout that is optimized for presentation on a simple ASCII text display, possibly without any form of highlighting or font control. Sections present may include:
       
   350 
       
   351 NAME
       
   352     The name of the command or function, followed by a one-line description of what it does.
       
   353 SYNOPSIS
       
   354     In the case of a command, you get a formal description of how to run it and what command line options it takes. For program functions, a list of the parameters the function takes and which header file contains its definition. For experienced users, this may be all the documentation they need.
       
   355 DESCRIPTION
       
   356     A textual description of the functioning of the command or function.
       
   357 EXAMPLES
       
   358     Some examples of common usage.
       
   359 SEE ALSO
       
   360     A list of related commands or functions.
       
   361 
       
   362 Other sections may be present, but these are not well standardized across man pages. Common examples include: OPTIONS, EXIT STATUS, ENVIRONMENT, KNOWN BUGS, FILES, AUTHOR, REPORTING BUGS, HISTORY and COPYRIGHT.
       
   363 
       
   364 These days virtually every Unix command line application comes with its man page, and many Unix users perceive a lack of man pages as a sign of low quality; indeed, some projects, such as Debian, go out of their way to write man pages for programs lacking one. Few alternatives to *man* have enjoyed much popularity, with the possible exception of the GNU project's "info" system, an early and simple hypertext system.
       
   365 
       
   366 However, the format of a single page for each application, the lack of classification within the sections and the relatively unsophisticated formatting facilities have motivated the development of alternative documentation systems, such as the previously mentioned "info" system.
       
   367 
       
   368 Most Unix GUI applications (particularly those built using the GNOME and KDE development environments) now provide end-user documentation in HTML and include embedded HTML viewers such as yelp for reading the help within the application.
       
   369 
       
   370 Usually the man pages are written in English. Translations into other languages can be also available on the system.
       
   371 
       
   372 The default format of the man pages is troff, with either the macro package man (appearance oriented) or on some systems mdoc (semantic oriented). This makes it possible to typeset a man page to PostScript, PDF and various other formats for viewing or printing.
       
   373 
       
   374 info
       
   375 -----
       
   376 
       
   377 *info* is a software utility which forms a hypertextual, multipage documentation and help viewer working on a command line interface, useful when there is no GUI available.
       
   378 
       
   379 The syntax is ::
       
   380 	
       
   381 	$ info <command_name>
       
   382 
       
   383 *info* processes info files, which are Texinfo formatted files, and presents the documentation as a tree, with simple commands to traverse the tree and to follow cross references. For instance
       
   384 
       
   385     - *n* goes to the next page.
       
   386     - *p* goes to the previous page.
       
   387     - *u* goes to the upper page.
       
   388     - *l* goes to the last(visited) node
       
   389     - To follow a cross reference, the cursor can be moved over a link (a word preceded by a `*`) and enter pressed.
       
   390 
       
   391 info was initially written for use with GNU/Linux and then ported to other Unix-like operating systems.
       
   392 
       
   393 --help
       
   394 -------
       
   395 
       
   396 Most GNU commands support the --help, which gives a short explanation about how to use the command and a list of available options. Below is the output of this option with the *cat* command::
       
   397 
       
   398 	$ userprompt@host: cat --help
       
   399 	Usage: cat [OPTION] [FILE]...
       
   400 	Concatenate FILE(s), or standard input, to standard output.
       
   401 
       
   402 	  -A, --show-all           equivalent to -vET
       
   403 	  -b, --number-nonblank    number nonempty output lines
       
   404 	  -e                       equivalent to -vE
       
   405 	  -E, --show-ends          display $ at end of each line
       
   406 	  -n, --number             number all output lines
       
   407 	  -s, --squeeze-blank      suppress repeated empty output lines
       
   408 	  -t                       equivalent to -vT
       
   409 	  -T, --show-tabs          display TAB characters as ^I
       
   410 	  -u                       (ignored)
       
   411 	  -v, --show-nonprinting   use ^ and M- notation, except for LFD and 		  TAB
       
   412 	  --help     display this help and exit
       
   413       	  --version  output version information and exit
       
   414 
       
   415 	With no FILE, or when FILE is -, read standard input.
       
   416 
       
   417 	Examples:
       
   418 	  cat f - g  Output f's contents, then standard input, then g's 	  contents.
       
   419 	  cat        Copy standard input to standard output.
       
   420 
       
   421 	Report bugs to <bug-coreutils@gnu.org>.
       
   422 
       
   423 
       
   424 Basic file handling
       
   425 ===================
       
   426 
       
   427 cp
       
   428 ---
       
   429 
       
   430 *cp* is the command entered in a Unix shell to copy a file from one place to another, possibly on a different filesystem. The original file remains unchanged, and the new file may have the same or a different name.
       
   431 
       
   432 Usage
       
   433 ~~~~~
       
   434 
       
   435 To copy a file to another file::
       
   436 
       
   437 	$ cp [ -f ] [ -H ] [ -i ] [ -p ][ -- ] SourceFile TargetFile
       
   438 
       
   439 To copy a file to a directory::
       
   440 
       
   441 	$ cp [ -f ] [ -H ] [ -i ] [ -p ] [ -r | -R ] [ -- ] SourceFile ... 		TargetDirectory
       
   442 
       
   443 To copy a directory to a directory::
       
   444 
       
   445 	$ cp [ -f ] [ -H ] [ -i ] [ -p ] [ -- ] { -r | -R } 
       
   446 	SourceDirectory ... TargetDirectory
       
   447 
       
   448 Flags
       
   449 ~~~~~
       
   450 
       
   451 *-f* (force) – specifies removal of the target file if it cannot be opened for write operations. The removal precedes any copying performed by the cp command.
       
   452 
       
   453 *-P* – makes the cp command copy symbolic links. The default is to follow symbolic links, that is, to copy files to which symbolic links point.
       
   454 
       
   455 *-i* (interactive) – prompts you with the name of a file to be overwritten. This occurs if the TargetDirectory or TargetFile parameter contains a file with the same name as a file specified in the SourceFile or SourceDirectory parameter. If you enter y or the locale's equivalent of y, the cp command continues. Any other answer prevents the cp command from overwriting the file.
       
   456 
       
   457 *-p* (preserve) – duplicates the following characteristics of each SourceFile/SourceDirectory in the corresponding TargetFile and/or TargetDirectory:
       
   458 
       
   459     * The time of the last data modification and the time of the last access.
       
   460     * The user ID and group ID (only if it has permissions to do this)
       
   461     * The file permission bits and the SUID and SGID bits.
       
   462 
       
   463 *-R* (recursive) – copy directories (recursively copying all the contents)
       
   464 
       
   465 Examples
       
   466 ~~~~~~~~
       
   467 
       
   468 To make a copy of a file in the current directory, enter::
       
   469 
       
   470     $ cp prog.c prog.bak
       
   471 
       
   472 This copies prog.c to prog.bak. If the prog.bak file does not already exist, the cp command creates it. If it does exist, the cp command replaces it with a copy of the prog.c file.
       
   473 
       
   474 To copy a file in your current directory into another directory, enter::
       
   475 
       
   476     $ cp zaphod /home/books/hhgg
       
   477 
       
   478 This copies the jones file to /home/books/hhgg/zaphod.
       
   479 
       
   480 To copy a file to a new file and preserve the modification date, time, and access control list associated with the source file, enter::
       
   481 
       
   482     $ cp -p martin_luther_king martin_luther_king.jr
       
   483 
       
   484 This copies the *martin_luther_king* file to the *martin_luther_king.jr* file. Instead of creating the file with the current date and time stamp, the system gives the *martin_luther_king.jr* file the same date and time as the *martin_luther_king* file. The *martin_luther_king.jr* file also inherits the *martin_luther_king* file's access control protection.
       
   485 
       
   486 To copy all the files in a directory to a new directory, enter::
       
   487 
       
   488     $ cp /home/galactica/clients/* /home/hhgg/customers
       
   489 
       
   490 This copies only the files in the clients directory to the customers directory.
       
   491 
       
   492 To copy a directory, including all its files and subdirectories, to another directory, enter:
       
   493 
       
   494     $ cp -R /home/hhgg/clients /home/hhgg/customers
       
   495 
       
   496 This copies the clients directory, including all its files, subdirectories, and the files in those subdirectories, to the customers/clients directory.
       
   497 
       
   498 To copy a specific set of files of any extension to another directory, enter::
       
   499 
       
   500     $ cp zaphod arthur ford /home/hhgg/clients
       
   501 
       
   502 This copies the *zaphod*, *arthur*, and *ford* files in your current working directory to the /home/hhgg/clients directory.
       
   503 
       
   504 To use pattern-matching characters to copy files, enter::
       
   505 
       
   506     $ cp programs/*.py .
       
   507 
       
   508 This copies the files in the programs directory that end with *.py* to the current directory, signified by the single "." (dot). You must type a space between the *py* and the final dot.
       
   509 
       
   510 mv
       
   511 ---
       
   512 
       
   513 *mv* (short for move) is a Unix command that moves one or more files or directories from one place to another. The original file is deleted, and the new file may have the same or a different name. If possible (i.e. when the original and new files are on the same file system), *mv* will rename the file instead. Write permission is required on all directories being modified.
       
   514 
       
   515 Conflicting existing file
       
   516 ~~~~~~~~~~~~~~~~~~~~~~~~~~
       
   517 
       
   518 In all cases, when a file is moved to have the name of an existing file (in the same directory), the existing file is deleted. If the existing file is not writable but is in a directory that is writable, then the mv command asks for confirmation if possible (i.e. if run from a terminal) before proceeding, unless the -f (force) option is used.
       
   519 
       
   520 Differences with copy and delete
       
   521 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
       
   522 
       
   523 Note that, usually, when moving files within the same volume, moving (and/or renaming) is not the same as simply copying and then deleting the original. When moving a file, the link is simply removed from the old parent directory and added to the new parent directory. However, the file itself is untouched (i.e. it has the same inodes and resides at the same place on the disk). For example, you cannot copy a file you cannot read, but you can move (and/or rename) it (provided you have write permission to its old and new parent directories). Also, suppose there is a non-empty directory you do not have write permission to. You cannot delete this directory (since you cannot delete its contents); but you can move (and/or rename) it. Also, since moving between filenames on a single volume does not involve copying, it is faster and does not place strain of lots of reads and writes on the disk. Moving files across different volumes, however, does necessitate copying and deleting.
       
   524 
       
   525 Examples
       
   526 ~~~~~~~~
       
   527 ::
       
   528 
       
   529 	$ mv myfile mynewfilename    renames a file
       
   530 	$ mv myfile otherfilename    renames a file and deletes the existing 		file "myfile"
       
   531 	$ mv myfile /myfile          moves 'myfile' from the current 		directory to the root directory
       
   532 	$ mv myfile dir/myfile       moves 'myfile' to 'dir/myfile' relative 		to the current directory
       
   533 	$ mv myfile dir              same as the previous command (the 		filename is implied to be the same)
       
   534 	$ mv myfile dir/myfile2      moves 'myfile' to dir and renames it to 		'myfile2'
       
   535 	$ mv foo bar baz dir         moves multiple files to directory dir
       
   536 	$ mv --help                  shows a very concise help about the 		syntax of the command
       
   537 	$ man mv                     prints an extensive user manual for 		'mv' in the terminal
       
   538 
       
   539 In all cases, the file or files being moved or renamed can be a directory.
       
   540 
       
   541 Note that when the command is called with two arguments (as *mv name1 name2* or *mv name1 /dir/name2*), it can have three different effects, depending on whether *name2* does not exist, is an existing file, or is an existing directory. If the user intends to refer to an existing directory, */.* (or in some Unix versions */* is sufficient) may be appended to the name to force the system to check this. To move a file to a new directory, the directory must be created first.
       
   542 
       
   543 rm
       
   544 ---
       
   545 
       
   546 *rm* (short for "remove") is one of several basic Unix command lines that operates on files. It is used to delete files from a filesystem. The data is not actually destroyed. Only the index listing where the file is stored is destroyed, and the storage is made available for reuse. There are undelete utilities that will attempt to reconstruct the index and can bring the file back if the parts were not reused.
       
   547 
       
   548 Here's example to remove a file named "foo" from a directory, here shown with the -i option::
       
   549 
       
   550   	$ rm -i foo
       
   551     	remove foo? y
       
   552 
       
   553 Options
       
   554 ~~~~~~~
       
   555 
       
   556 Common options that rm accepts include:
       
   557 
       
   558     * *-r*, which removes directories, removing the contents recursively beforehand (so as not to leave files without a directory to reside in) ("recursive")
       
   559     * *-i*, which asks for every deletion to be confirmed ("interactive")
       
   560     * *-f*, which ignores non-existent files and overrides any confirmation prompts ("force")
       
   561     * *-v*, which shows what is being removed as it happens ("verbose")
       
   562 
       
   563 *rm* is often aliased to "rm -i" so as to avoid accidental deletion of files. If a user still wishes to delete a large number of files without confirmation, they can manually cancel out the -i argument by adding the -f option (as the option specified later on the expanded command line "rm -i -f" takes precedence).
       
   564 
       
   565 *rm -rf* (variously, rm -rf /, rm -rf `*`, and others) is frequently used in jokes and anecdotes about Unix disasters. The rm -rf variant of the command, if run by a superuser on the root directory, would cause the contents of every writable mounted filesystem on the computer to be deleted.
       
   566 
       
   567 *rm* is often used in conjunction with xargs to supply a list of files to delete::
       
   568 
       
   569 	xargs rm < filelist
       
   570 
       
   571 When *rm* is used on a symbolic link, it deletes the link, but does not affect the target of the link.
       
   572 
       
   573 Permissions
       
   574 ~~~~~~~~~~~
       
   575 
       
   576 Usually, on most filesystems, deleting a file requires write permission on the parent directory (and execute permission, in order to enter the directory in the first place). (Note that, confusingly for beginners, permissions on the file itself are irrelevant. However, GNU rm asks for confirmation if a write-protected file is to be deleted, unless the -f option is used.)
       
   577 
       
   578 To delete a directory (with rm -r), one must delete all of its contents recursively. This requires that one must have read and write and execute permission to that directory (if it's not empty) and all non-empty subdirectories recursively (if there are any). The read permissions are needed to list the contents of the directory in order to delete them. This sometimes leads to an odd situation where a non-empty directory cannot be deleted because one doesn't have write permission to it and so cannot delete its contents; but if the same directory were empty, one would be able to delete it.
       
   579 
       
   580 If a file resides in a directory with the sticky bit set, then deleting the file requires one to be the owner of the file.
       
   581 
       
   582 
       
   583 Command Line Arguments
       
   584 =======================
       
   585 
       
   586 In computer command line interfaces, a command line argument is an argument sent to a program being called. In general, a program can take any number of command line arguments, which may be necessary for the program to run, or may even be ignored, depending on the function of that program.
       
   587 
       
   588 For example, in Unix and Unix-like environments, an example of a command-line argument is::
       
   589 
       
   590 	rm file.s
       
   591 
       
   592 "file.s" is a command line argument which tells the program rm to remove the file "file.s".
       
   593 
       
   594 Programming languages such as C, C++ and Java allow a program to interpret the command line arguments by handling them as string parameters in the main function.
       
   595 
       
   596 A command line option or simply *option* (also known as a command line parameter, flag, or a switch) is an indication by a user that a computer program should change its default output.
       
   597 
       
   598 Long options are introduced via "--", and are typically whole words. For example, *ls --long --classify --all*. Arguments to long options are provided with "=", as *ls --block-size=1024*. Some Unix programs use long options with single dashes, for example MPlayer as in *mplayer -nosound*.
       
   599 
       
   600 Linux also uses "--" to terminate option lists. For example, an attempt to delete a file called *-file1* by using *rm -file1* may produce an error, since rm may interpret *-file1* as a command line switch. Using *rm -- -file1* removes ambiguity.
       
   601 
       
   602 Basic Text Processing
       
   603 ======================
       
   604 
       
   605 head
       
   606 -----
       
   607 
       
   608 *head* is a program on Unix and Unix-like systems used to display the first few lines of a text file or piped data. The command syntax is::
       
   609 
       
   610 	$ head [options] <file_name>
       
   611 
       
   612 By default, *head* will print the first 10 lines of its input to the standard output. The number of lines printed may be changed with a command line option. The following example shows the first 20 lines of filename::
       
   613 
       
   614 	$ head -n 20 filename
       
   615 
       
   616 This displays the first 5 lines of all files starting with *foo*::
       
   617 
       
   618 	$ head -n 5 foo*
       
   619 
       
   620 Some versions omit the n and just let you say -5.
       
   621 
       
   622 Flags
       
   623 ~~~~~
       
   624 ::
       
   625 
       
   626 	-c <x number of bytes> Copy first x number of bytes.
       
   627 
       
   628 Other options: *sed*
       
   629 
       
   630 Many early versions of Unix did not have this command, and so documentation and books had *sed* do this job::
       
   631 
       
   632 	sed 5q foo
       
   633 
       
   634 This says to print every line (implicit), and quit after the fifth.
       
   635 
       
   636 
       
   637 tail
       
   638 ----
       
   639 
       
   640 *tail* is a program on Unix and Unix-like systems used to display the last few lines of a text file or piped data.
       
   641 
       
   642 The command-syntax is::
       
   643 
       
   644 	$ tail [options] <file_name>
       
   645 
       
   646 By default, *tail* will print the last 10 lines of its input to the standard output. With command line options the number of lines printed and the printing units (lines, blocks or bytes) may be changed. The following example shows the last 20 lines of filename::
       
   647 
       
   648 	$ tail -n 20 filename
       
   649 
       
   650 This example shows the last 15 bytes of all files starting with *foo*::
       
   651 
       
   652 	$ tail -c 15 foo*
       
   653 
       
   654 This example shows all lines of filename from the second line onwards::
       
   655 
       
   656 	$ tail -n +2 filename
       
   657 
       
   658 Using an older syntax (still used in Sun Solaris as the -n option is not supported), the last 20 lines and the last 50 bytes of filename can be shown with the following command::
       
   659 
       
   660 	$ tail -20 filename
       
   661 	$ tail -50c filename
       
   662 
       
   663 However this syntax is now obsolete and does not conform with the POSIX 1003.1-2001 standard. Even if still supported in current versions, when used with other options (like -f, see below), these switches could not work at all.
       
   664 
       
   665 File monitoring
       
   666 ~~~~~~~~~~~~~~~
       
   667 
       
   668 *tail* has a special command line option *-f* (follow) that allows a file to be monitored. Instead of displaying the last few lines and exiting, tail displays the lines and then monitors the file. As new lines are added to the file by another process, tail updates the display. This is particularly useful for monitoring log files. The following command will display the last 10 lines of messages and append new lines to the display as new lines are added to messages::
       
   669 
       
   670 	$ tail -f /var/adm/messages
       
   671 
       
   672 To interrupt tail while it is monitoring, break-in with *Ctrl+C*. This command can be run "in the background" with &, see job control.
       
   673 
       
   674 If you have a command's result to monitor, you can use the *watch* command.
       
   675 
       
   676 
       
   677 cut
       
   678 ----
       
   679 
       
   680 In computing, *cut* is a Unix command line utility which is used to extract sections from each line of input — usually from a file.
       
   681 
       
   682 Extraction of line segments can typically be done by *bytes (-b), characters (-c)*, or *fields (-f)* separated by a *delimiter (-d — the tab character by default)*. A range must be provided in each case which consists of one of N, N-M, N- (N to the end of the line), or -M (beginning of the line to M), where N and M are counted from 1 (there is no zeroth value). Since version 6, an error is thrown if you include a zeroth value. Prior to this the value was ignored and assumed to be 1.
       
   683 
       
   684 Assuming a file named file containing the lines::
       
   685 
       
   686 	foo:bar:baz:qux:quux
       
   687 	one:two:three:four:five:six:seven
       
   688 	alpha:beta:gamma:delta:epsilon:zeta:eta:teta:iota:kappa:lambda:mu
       
   689 
       
   690 To output the fourth through tenth characters of each line::
       
   691 
       
   692 	$ cut -c 4-10 file
       
   693 
       
   694 This gives the output::
       
   695 
       
   696 	:bar:ba
       
   697 	:two:th
       
   698 	ha:beta
       
   699 
       
   700 To output the fifth field through the end of the line of each line using the colon character as the field delimiter::
       
   701 
       
   702 	$ cut -d : -f 5- file
       
   703 
       
   704 This gives the output::
       
   705 
       
   706 	quux
       
   707 	five:six:seven
       
   708 	epsilon:zeta:eta:teta:iota:kappa:lambda:mu
       
   709 
       
   710 paste
       
   711 ------
       
   712 
       
   713 *paste* is a Unix command line utility which is used to join files horizontally (parallel merging) by outputting lines consisting of the sequentially corresponding lines of each file specified, separated by tabs, to the standard output. It is effectively the horizontal equivalent to the utility *cat* command which operates on the vertical plane of two or more files.
       
   714 
       
   715 To paste several columns of data together into the file *www* from files *who*, *where*, and *when*::
       
   716 
       
   717 	$ paste who where when > www
       
   718 
       
   719 If the files contain:
       
   720 
       
   721 +-----------+------------+------------+
       
   722 |   who     |   where    |    when    |
       
   723 +===========+============+============+
       
   724 |  Batman   | GothamCity | January 3  |
       
   725 +-----------+------------+------------+	
       
   726 | Trillian  | Andromeda  | February 4 |
       
   727 +-----------+------------+------------+
       
   728 |  Jeeves   | London     |  March 19  |
       
   729 +-----------+------------+------------+	
       
   730 
       
   731 This creates the file named *www* containing::
       
   732 
       
   733 	Batman            GothamCity       January 3
       
   734 	Trillian          Andromeda        February 4
       
   735 	Jeeves            London           March 19
       
   736 
       
   737 Shell Meta Characters
       
   738 ======================
       
   739 
       
   740 Unix recognizes certain special characters, called "meta characters," as command directives. The shell meta characters are recognized anywhere they appear in the command line, even if they are not surrounded by blank space. For that reason, it is safest to only use the characters A-Z, a-z, 0-9, and the period, dash, and underscore characters when naming files and directories on Unix. If your file or directory has a shell meta character in the name, you will find it difficult to use the name in a shell command.
       
   741 
       
   742 The shell meta characters include:
       
   743 
       
   744 \ / < > ! $ % ^ & * | { } [ ] " ' ` ~ ; 
       
   745 
       
   746 Different shells may differ in the meta characters recognized.
       
   747 
       
   748 As an example,
       
   749 ::
       
   750 
       
   751 	$ ls file.*
       
   752 
       
   753 run on a directory containing the files file, file.c, file.lst, and myfile would list the files file.c and file.lst. However,::
       
   754 
       
   755 	$ ls file.?
       
   756 
       
   757 run on the same directory would only list file.c because the ? only matches one character, no more, no less. This can save you a great deal of typing time. For example, if there is a file called california_cornish_hens_with_wild_rice and no other files whose names begin with 'c', you could view the file without typing the whole name by typing this::
       
   758 
       
   759 	$ more c*
       
   760 
       
   761 because the c* matches that long file name.
       
   762 
       
   763 Filenames containing metacharacters can pose many problems and should never be intentionally created. If you do find that you've created a file with metacharacters, and you would like to remove it, you have three options. You may use wildcards to match metacharacter, use the \  to directly enter the filename, or put the command in double quotes (except in the case of double quotes within the file name, these must be captured with one of the first two methods). For example, deleting a file named `"``*`|more`"` can be accomplished with::
       
   764 
       
   765 	$ rm ??more
       
   766 
       
   767 or::
       
   768 
       
   769 	$ rm $\backslash$*$\backslash$|more
       
   770 
       
   771 or::
       
   772 
       
   773 	$ rm ''*|more'' 
       
   774 
       
   775 
       
   776 Looking At Files
       
   777 ================
       
   778 
       
   779 cat
       
   780 ---
       
   781 
       
   782 The *cat* command is a standard Unix program used to concatenate and display files. The name is from "catenate", a synonym of *concatenate*.
       
   783 
       
   784 The Single Unix Specification specifies the behavior that the contents of each of the files given in sequence as arguments will be written to the standard output in the same sequence, and mandates one option, -u, where each byte is printed as it is read.
       
   785 
       
   786 If the filename is specified as -, then *cat* will read from standard input at that point in the sequence. If no files are specified, *cat* will read from standard input entered.
       
   787 
       
   788 Jargon File Definition
       
   789 ~~~~~~~~~~~~~~~~~~~~~~
       
   790 
       
   791 The Jargon File version 4.4.7 lists this as the definition of *cat*::
       
   792 
       
   793    1. To spew an entire file to the screen or some other output sink without
       
   794  	pause (syn. blast).
       
   795 
       
   796    2. By extension, to dump large amounts of data at an unprepared target or
       
   797  	with no intention of browsing it carefully. Usage: considered silly.
       
   798  	Rare outside Unix sites. See also dd, BLT.
       
   799 
       
   800 	Among Unix fans, *cat(1)* is considered an excellent example of
       
   801  	user-interface design, because it delivers the file contents without 
       
   802 	such verbosity as spacing or headers between the files, and because 
       
   803 	it does not require the files to consist of lines of text, but works 
       
   804 	with any sort of data.
       
   805 
       
   806 	Among Unix critics, *cat(1)* is considered the canonical example of 
       
   807 	bad user-interface design, because of its woefully unobvious name. 
       
   808 	It is far more often used to blast a single file to standard output 
       
   809 	than to concatenate two or more files. The name cat for the former 
       
   810 	operation is just as unintuitive as, say, LISP's cdr.
       
   811 
       
   812 	Of such oppositions are holy wars made...
       
   813 
       
   814 Useless Use of 'cat'
       
   815 ~~~~~~~~~~~~~~~~~~~~
       
   816 
       
   817 UUOC (from comp.unix.shell on Usenet) stands for “Useless Use of cat”. As it is observed on *comp.unix.shell*, “The purpose of cat is to concatenate (or 'catenate') files. If it's only one file, concatenating it with nothing at all is a waste of time, and costs you a process.”
       
   818 
       
   819 Nevertheless one sees people doing::
       
   820 
       
   821 	$ cat file | some_command and its args ...
       
   822 
       
   823 instead of the equivalent and cheaper::
       
   824 
       
   825 	<file some_command and its args ...
       
   826 
       
   827 or (equivalently and more classically)::
       
   828 
       
   829 	some_command and its args ... <file
       
   830 
       
   831 Since 1995, occasional awards for UUOC have been given out. The activity of fixing instances of UUOC is sometimes called 'demoggification'.
       
   832 
       
   833 Amongst many, it is still considered safer to use *cat* for such cases given that the < and > keys are next to each other in many popular keyboard mappings. While the risk might be low, the impact of using > instead of < can be high and prohibitive.
       
   834 
       
   835 zcat
       
   836 ~~~~~
       
   837 
       
   838 *zcat* is a Unix program similar to *cat*, that decompresses individual files and concatenates them to standard output. Traditionally *zcat* operated on files compressed by compress but today it is usually able to operate on *gzip* or even *bzip2* archives. On such systems, it is equivalent to *gunzip -c*
       
   839 
       
   840 more
       
   841 -----
       
   842 
       
   843 In computing, *more* is a command to view (but not modify) the contents of a text file one screen at a time (terminal pager). It is available on Unix and Unix-like systems, DOS, OS/2 and Microsoft Windows. Programs of this sort are called pagers.
       
   844 
       
   845 Usage
       
   846 ~~~~~
       
   847 
       
   848 The command-syntax is::
       
   849 
       
   850 	$ more [options] [file_name]
       
   851 
       
   852 If no file name is provided, *more* looks for input from stdin.
       
   853 
       
   854 Once *more* has obtained input, it displays as much as can fit on the current screen and waits for user input to advance, with the exception that a form feed (^L) will also cause *more* to wait at that line, regardless of the amount of text on the screen. In the lower-left corner of the screen is displayed the text "--More--" and a percentage, representing the percent of the file that *more* has paged through. (This percentage includes the text displayed on the current screen.) When *more* reaches the end of a file (100%) it exits. The most common methods of navigating through a file are *Enter*, which advances the output by one line, and *Space*, which advances the output by one screen.
       
   855 
       
   856 There are also other commands that can be used while navigating through the document; consult *more*'s *man* page for more details.
       
   857 
       
   858 *Options* are typically entered before the file name, but can also be entered in the environment variable *$MORE*. Options entered in the actual command line will override those entered in the *$MORE* environment variable. Available options may vary between Unix systems.
       
   859 
       
   860 less
       
   861 -----
       
   862 
       
   863 *less* is a terminal pager program on Unix, Windows and Unix-like systems used to view (but not change) the contents of a text file one screen at a time. It is similar to *more*, but has the extended capability of allowing both forward and backward navigation through the file. Unlike most Unix text editors/viewers, *less* does not need to read the entire file before starting, resulting in faster load times with large files.
       
   864 
       
   865 Usage
       
   866 ~~~~~~
       
   867 
       
   868 *less* can be invoked with options to change its behaviour, for example, the number of lines to display on the screen. A few options vary depending on the operating system. While *less* is displaying the file, various commands can be used to navigate through the file. These commands are based on those used by both *more* and *vi*. It is also possible to search for character patterns in the file.
       
   869 
       
   870 By default, *less* displays the contents of the file to the standard output (one screen at a time). If the file name argument is omitted, it displays the contents from standard input (usually the output of another command through a pipe). If the output is redirected to anything other than a terminal, for example a pipe to another command, less behaves like cat.
       
   871 
       
   872 The command-syntax is::
       
   873 
       
   874 	$ less [options] file_name
       
   875 
       
   876 Frequently Used Options
       
   877 ~~~~~~~~~~~~~~~~~~~~~~~
       
   878 
       
   879     * -g: Highlights just the current match of any searched string.
       
   880 
       
   881     * -I: Case-insensitive searches.
       
   882 
       
   883     * -M: Shows more detailed prompt, including file position.
       
   884 
       
   885     * -N: Shows line numbers (useful for source code viewing).
       
   886 
       
   887     * -S: Disables line wrap ("chop long lines"). Long lines can be seen by side scrolling.
       
   888 
       
   889     * -?: Shows help.
       
   890 
       
   891 Frequently Used Commands
       
   892 ~~~~~~~~~~~~~~~~~~~~~~~~
       
   893 
       
   894     * [Arrows]/[Page Up]/[Page Down]/[Home]/[End]: Navigation.
       
   895 
       
   896     * [Space bar]: Next page.
       
   897 
       
   898     * b: Previous page.
       
   899 
       
   900     * ng: Jump to line number n. Default is the start of the file.
       
   901 
       
   902     * nG: Jump to line number n. Default is the end of the file.
       
   903 
       
   904     * /pattern: Search for pattern. Regular expressions can be used.
       
   905 
       
   906     * '^ or g: Go to start of file.
       
   907 
       
   908     * '$ or G: Go to end of file.
       
   909 
       
   910     * s: Save current content (got from another program like grep) in a file.
       
   911 
       
   912     * =: File information.
       
   913 
       
   914     * h: Help.
       
   915 
       
   916     * q: Quit.
       
   917 
       
   918 Examples 
       
   919 ~~~~~~~~~
       
   920 ::
       
   921 
       
   922 	$ less -M readme.txt                     #Read "readme.txt."
       
   923 	$ less +F /var/log/mail.log              #Follow mode for log
       
   924 	$ file * | less                          #Easier file analysis.
       
   925 	$ grep -i void *.c | less -I -p void     #Case insensitive search 		                                          for "void" in all .c files
       
   926 
       
   927 Directory Structure
       
   928 ====================
       
   929 
       
   930 In the File Hierarchy Standard (FHS) all files and directories appear under the root directory "/", even if they are stored on different physical devices. Note however that some of these directories may or may not be present on a Unix system depending on whether certain subsystems, such as the X Window System, are installed.
       
   931 
       
   932 The majority of these directories exist in all UNIX operating systems and are generally used in much the same way; however, the descriptions here are those used specifically for the FHS, and are not considered authoritative for platforms other than Linux.
       
   933 
       
   934 +---------------+------------------------------------------------+
       
   935 |   Directory   |             Description                        |
       
   936 +===============+================================================+
       
   937 | /             | Primary hierarchy root and root directory of   |
       
   938 |               | the entire file system hierarchy.              |
       
   939 +---------------+------------------------------------------------+
       
   940 | /bin/         | Essential command binaries that need to be     |
       
   941 |               | available in single user mode; for all users,  |
       
   942 |               | e.g., *cat*, *ls*, *cp*.                       |
       
   943 +---------------+------------------------------------------------+
       
   944 | /boot/        | Boot loader files, e.g., *kernels*, *initrd*;  |
       
   945 |               | often a separate partition.                    |
       
   946 +---------------+------------------------------------------------+
       
   947 | /dev/         | Essential devices, e.g., /dev/null             |
       
   948 +---------------+------------------------------------------------+
       
   949 | /etc/         | Host-specific system-wide configuration files  |
       
   950 |               | (the name comes from *et cetera*)              |
       
   951 +---------------+------------------------------------------------+
       
   952 | /home/        | User's home directories, containing saved      |
       
   953 |               | files, personal settings, etc.; often a        |
       
   954 |               | separate partition.                            |
       
   955 +---------------+------------------------------------------------+
       
   956 | /lib/         | Libraries essential for the binaries in        |
       
   957 |               | */bin/* and */sbin/*                           |
       
   958 +---------------+------------------------------------------------+
       
   959 | /media/       | Mount points for removable media such as       |
       
   960 |               | CD-ROMs, external hard disks, USB sticks, etc. |
       
   961 +---------------+------------------------------------------------+
       
   962 | /mnt/         | Temporarily mounted file systems               |
       
   963 +---------------+------------------------------------------------+
       
   964 | /opt/         | Optional application software packages         |
       
   965 +---------------+------------------------------------------------+
       
   966 | /proc/        | Virtual filesystem documenting kernel and      |
       
   967 |               | process status as text files; e.g., uptime,    |
       
   968 |               | network. In Linux, corresponds to a *Procfs*   |
       
   969 |               | mount.                                         |
       
   970 +---------------+------------------------------------------------+
       
   971 | /root/        | Home directory for the root user               |
       
   972 +---------------+------------------------------------------------+
       
   973 | /sbin/        | Essential system binaries; e.g., *init*,       |
       
   974 |               | *route*, *mount*.                              |
       
   975 +---------------+------------------------------------------------+
       
   976 | /srv/         | Site-specific data which is served by the      |
       
   977 |               | system.                                        |
       
   978 +---------------+------------------------------------------------+
       
   979 | /tmp/         | Temporary files. Often not preserved between   |
       
   980 |               | system reboots.                                |
       
   981 +---------------+------------------------------------------------+
       
   982 | /usr/         | Secondary hierarchy for read-only user data;   |
       
   983 |               | contains the majority of (multi-)user          |
       
   984 |               | utilities and applications.                    |
       
   985 +---------------+------------------------------------------------+
       
   986 | /var/         | Variable files - files whose content is        |
       
   987 |               | expected to continually change during normal   |
       
   988 |               | operation of the system - such as logs, spool  |
       
   989 |               | files, and temporary e-mail files.             |
       
   990 |               | Sometimes a separate partition.                |
       
   991 +---------------+------------------------------------------------+
       
   992 
       
   993 
       
   994 man hier
       
   995 ---------
       
   996 
       
   997 This is the manual page on the UNIX filesystem. The syntax for this is::
       
   998 
       
   999 	$ man hier
       
  1000 
       
  1001 ls -l
       
  1002 -----
       
  1003 
       
  1004 Shows you huge amounts of information (permissions, owners, size, and when last modified) for folders and files. The syntax is ::
       
  1005 
       
  1006 	$ ls -l
       
  1007 
       
  1008 This can be done after entering the required directory. 
       
  1009 
       
  1010 Permissions and Ownership
       
  1011 =========================
       
  1012 
       
  1013 chmod
       
  1014 ------
       
  1015 
       
  1016 The *chmod* command (abbreviated from 'change mode') is a shell command and C language function in Unix and Unix-like environments. When executed, it can change file system modes of files and directories. The modes include permissions and special modes.A chmod command first appeared in AT&T Unix version 1, and is still used today on Unix-like machines.
       
  1017 
       
  1018 Usage
       
  1019 ~~~~~
       
  1020 
       
  1021 The *chmod* command options are specified like this:
       
  1022 ::
       
  1023 
       
  1024 	$ chmod [options] mode[,mode] file1 [file2 ...]
       
  1025 
       
  1026 To view what the permissions currently are, type:
       
  1027 ::
       
  1028 
       
  1029 	$ ls -l file
       
  1030 
       
  1031 Command line options
       
  1032 ~~~~~~~~~~~~~~~~~~~~
       
  1033 
       
  1034 The *chmod* command has a number of command line options that affect its behavior. The most common options are:
       
  1035 
       
  1036     * -R: Changes the modes of directories and files recursively
       
  1037 
       
  1038     * -v: Verbose mode; lists all files as they are being processed
       
  1039 
       
  1040 Symbolic modes
       
  1041 +++++++++++++++
       
  1042 
       
  1043 To the *chmod* utility, all permissions and special modes are represented by its mode parameter. One way to adjust the mode of files or directories is to specify a symbolic mode. The symbolic mode is composed of three components, which are combined to form a single string of text:
       
  1044 ::
       
  1045 
       
  1046 	$ chmod [references][operator][modes] file1 ...
       
  1047 
       
  1048 The references (or classes) are used to distinguish the users to whom the permissions apply. If no references are specified it defaults to “all” but modifies only the permissions allowed by the umask. The references are represented by one or more of the following letters:
       
  1049 
       
  1050 +--------------+--------+---------------------------------------------+
       
  1051 | Reference    | Class  |                Description                  |
       
  1052 +==============+========+=============================================+
       
  1053 |      u       | user   | the owner of the file                       |
       
  1054 +--------------+--------+---------------------------------------------+
       
  1055 |      g       | group  | users who are members of the file's group   |
       
  1056 +--------------+--------+---------------------------------------------+
       
  1057 |      o       | others | users who are not hte owner of the file or  |
       
  1058 |              |        | members of the group                        |
       
  1059 +--------------+--------+---------------------------------------------+
       
  1060 |      a       | all    | all three of the above; is the same as *ugo*|
       
  1061 +--------------+--------+---------------------------------------------+
       
  1062 
       
  1063 The *chmod* program uses an operator to specify how the modes of a file should be adjusted. The following operators are accepted:
       
  1064 
       
  1065 +--------------+------------------------------------------------------+
       
  1066 | Operator     |                      Description                     |
       
  1067 +==============+======================================================+
       
  1068 | +            | adds the specified modes to the specified classes    |
       
  1069 +--------------+------------------------------------------------------+
       
  1070 | -            | removes the specified modes from the specified       |
       
  1071 |              | classes                                              |
       
  1072 +--------------+------------------------------------------------------+
       
  1073 | =            | the modes specified are to be made the exact modes   |
       
  1074 |              | for the specified classes                            |
       
  1075 +--------------+------------------------------------------------------+
       
  1076 
       
  1077 The modes indicate which permissions are to be granted or taken away from the specified classes. There are three basic modes which correspond to the basic permissions:
       
  1078 
       
  1079 +-----+--------------+------------------------------------------------+
       
  1080 |Mode |    Name      |                 Description                    |
       
  1081 +=====+==============+================================================+
       
  1082 | r   | read         | read a file or list a directory's contents     |
       
  1083 +-----+--------------+------------------------------------------------+
       
  1084 | w   | write        | write to a file or directory                   |   
       
  1085 +-----+--------------+------------------------------------------------+
       
  1086 | x   | execute      | execute a file or recurse a directory tree     |
       
  1087 +-----+--------------+------------------------------------------------+
       
  1088 | X   | special      | which is not a permission in itself but rather |
       
  1089 |     | execute      | can be used instead of 'x'. It applies execute |
       
  1090 |     |              | permissions to directories regardless of their |
       
  1091 |     |              | current permissions and applies execute        |
       
  1092 |     |              | permissions to a file which already has at     |
       
  1093 |     |              | least 1 execute permission bit already set     |
       
  1094 |     |              | (either user, group or other). It is only      |
       
  1095 |     |              | really useful when used with '+' and usually   |
       
  1096 |     |              | in combination with the *-R* option for giving |
       
  1097 |     |              | group or other access to a big directory tree  |
       
  1098 |     |              | without setting execute permission on normal   |
       
  1099 |     |              | files (such as text files), which would        |
       
  1100 |     |              | normally happen if one just used 'chmod -R     |
       
  1101 |     |              | a+rx .', whereas with 'X' one can do 'chmod -R |
       
  1102 |     |              | a+rX .' instead.                               |
       
  1103 +-----+--------------+------------------------------------------------+
       
  1104 | s   | setuid/gid   | are Unix access rights flags that allow users  |
       
  1105 |     |              | to run an executable with the permissions of   |
       
  1106 |     |              | the executable's owner or group.They are often |
       
  1107 |     |              | used to allow users on a computer system to run| 
       
  1108 |     |              | programs with temporarily elevated privileges  | 
       
  1109 |     |              | in order to perform a specific task. While the |
       
  1110 |     |              | assumed user id or group id privileges provided|
       
  1111 |     |              | are not always elevated, at a minimum they are | 
       
  1112 |     |              | specific.They are needed for tasks that require|
       
  1113 |     |              | higher privileges than those which a common    |
       
  1114 |     |              | user has, such as changing his or her login    |  
       
  1115 |     |              | password.                                      |
       
  1116 +-----+--------------+------------------------------------------------+
       
  1117 | t   | sticky       | The most common use of the sticky bit today is |
       
  1118 |     |              | on directories, where, when set, items inside  |
       
  1119 |     |              | the directory can be renamed or deleted only by|
       
  1120 |     |              | the item's owner, the directory's owner, or the| 
       
  1121 |     |              | superuser; without the sticky bit set, any user|
       
  1122 |     |              | with write and execute permissions for the     |
       
  1123 |     |              | directory can rename or delete contained files,| 
       
  1124 |     |              | regardless of owner.                           |
       
  1125 +-----+--------------+------------------------------------------------+
       
  1126 
       
  1127 The combination of these three components produces a string that is understood by the chmod command. Multiple changes can be specified by separating multiple symbolic modes with commas.
       
  1128 
       
  1129 Symbolic examples
       
  1130 +++++++++++++++++
       
  1131 
       
  1132 Add the 'read' and 'write' permissions to the 'user' and 'group' classes of a directory:
       
  1133 ::
       
  1134 
       
  1135 	$ chmod ug+rw mydir
       
  1136 	$ ls -ld mydir
       
  1137 	drw-rw----   2 starwars  yoda  96 Dec 8 12:53 mydir
       
  1138 
       
  1139 For a file, remove *write* permissions for all classes:
       
  1140 ::
       
  1141 
       
  1142 	$ chmod a-w myfile
       
  1143 	$ ls -l myfile
       
  1144 	-r-xr-xr-x   2 starwars  yoda 96 Dec 8 12:53 myfile
       
  1145 
       
  1146 Set the permissions for the *u*ser and the *g*roup to read and execute only (no write permission) on *mydir*.
       
  1147 ::
       
  1148 
       
  1149 	$ chmod ug=rx mydir
       
  1150 	$ ls -ld mydir
       
  1151 	dr-xr-x---   2 starwars  yoda 96 Dec 8 12:53 mydir
       
  1152 
       
  1153 Octal numbers
       
  1154 +++++++++++++
       
  1155 
       
  1156 The *chmod* command also accepts three and four-digit octal numbers representing modes. Using a three-digit octal number to set the modes of a file named myfile :
       
  1157 ::
       
  1158 
       
  1159 	$ chmod 664 myfile
       
  1160 	$ ls -l myfile
       
  1161 	-rw-rw-r--  1   57 Jul  3 10:13  myfile
       
  1162 
       
  1163 Since the *setuid*, *setgid* and *sticky* bits are not set, this is equivalent to:
       
  1164 ::
       
  1165 
       
  1166 	$ chmod 0664 myfile
       
  1167 
       
  1168 Special modes
       
  1169 +++++++++++++
       
  1170 
       
  1171 The *chmod* command is also capable of changing the additional permissions or special modes of a file or directory. The symbolic modes use **s** to represent the *setuid* and *setgid* modes, and **t** to represent the sticky mode. The modes are only applied to the appropriate classes, regardless of whether or not other classes are specified.
       
  1172 
       
  1173 Most operating systems support the specification of special modes using octal modes, but some do not. On these systems, only the symbolic modes can be used.
       
  1174 
       
  1175 Redirection and Piping
       
  1176 =======================
       
  1177 
       
  1178 In computing, *redirection* is a function common to most command-line interpreters, including the various Unix shells that can redirect standard streams to user-specified locations.
       
  1179 
       
  1180 Programs do redirection with the *dup2(2)* system call, or its less-flexible but higher-level stdio analogues, *freopen(3)* and *popen(3)*.
       
  1181 
       
  1182 Redirecting standard input and standard output
       
  1183 -----------------------------------------------
       
  1184 
       
  1185 Redirection is usually implemented by placing certain characters between commands. Typically, the syntax of these characters is as follows::
       
  1186 
       
  1187 	$ command1 > file1
       
  1188 
       
  1189 executes *command1*, placing the output in file1. Note that this will truncate any existing data in *file1*. To append output to the end of the file, use the >> operator.::
       
  1190 
       
  1191 	$ command1 < file1
       
  1192 
       
  1193 executes *command1*, using *file1* as the source of input (as opposed to the keyboard).::
       
  1194 
       
  1195 	$ command1 < infile > outfile
       
  1196 
       
  1197 combines the two capabilities: *command1* reads from *infile* and writes to *outfile*
       
  1198 
       
  1199 Piping
       
  1200 -------
       
  1201 
       
  1202 Programs can be run together such that one program reads the output from another with no need for an explicit intermediate file:
       
  1203 A pipeline of three programs run on a text terminal::
       
  1204 
       
  1205 	$ command1 | command2
       
  1206 
       
  1207 executes *command1*, using its output as the input for *command2* (commonly called piping, since the "|" character is known as a "pipe").
       
  1208 
       
  1209 This is equivalent to using two redirects and a temporary file::
       
  1210 
       
  1211 	$ command1 > tempfile
       
  1212 	$ command2 < tempfile
       
  1213 	$ rm tempfile
       
  1214 
       
  1215 A good example for command piping is combining *echo* with another command to achieve something interactive in a non-interactive shell, e.g.::
       
  1216 
       
  1217 	$ echo -e "user\npass" | ftp localhost
       
  1218 
       
  1219 This runs the ftp client with input user, press return, then pass.
       
  1220 
       
  1221 Redirecting to and from the standard file handles
       
  1222 --------------------------------------------------
       
  1223 
       
  1224 In Unix shells derived from the original Bourne shell, the first two actions can be further modified by placing a number (the file descriptor) immediately before the character; this will affect which stream is used for the redirection. The Unix standard I/O streams are:
       
  1225 
       
  1226 +------------+-------------+------------------------+
       
  1227 |   Handle   |    Name     |      Description       |
       
  1228 +============+=============+========================+
       
  1229 | 0          |   stdin     |    Standard input      |
       
  1230 +------------+-------------+------------------------+
       
  1231 | 1          |   stdout    |    Standard output     |
       
  1232 +------------+-------------+------------------------+
       
  1233 | 2          |   stderr    |    Standard error      |
       
  1234 +------------+-------------+------------------------+
       
  1235 
       
  1236 For example:
       
  1237 ::
       
  1238 
       
  1239 	$ command1 2> file1
       
  1240 
       
  1241 executes *command1*, directing the standard error stream to *file1*.
       
  1242 
       
  1243 In shells derived from *csh* (the C shell), the syntax instead appends the & character to the redirect characters, thus achieving a similar result.
       
  1244 
       
  1245 Another useful capability is to redirect one standard file handle to another. The most popular variation is to merge standard error into standard output so error messages can be processed together with (or alternately to) the usual output. Example:
       
  1246 ::
       
  1247 
       
  1248 	$ find / -name .profile > results 2>&1
       
  1249 
       
  1250 will try to find all files named *.profile*. Executed without redirection, it will output hits to *stdout* and errors (e.g. for lack of privilege to traverse protected directories) to *stderr*. If standard output is directed to file results, error messages appear on the console. To see both hits and error messages in file results, merge *stderr* (handle 2) into *stdout* (handle 1) using 2>&1 .
       
  1251 
       
  1252 It's possible use 2>&1 before ">" but it doesn't work. In fact, when the interpreter reads 2>&1, it doesn't know yet where standard output is redirected and then standard error isn't merged.
       
  1253 
       
  1254 If the merged output is to be piped into another program, the file merge sequence 2>&1 must precede the pipe symbol, thus:
       
  1255 ::
       
  1256 
       
  1257 	$ find / -name .profile 2>&1 | less
       
  1258 
       
  1259 A simplified form of the command:
       
  1260 ::
       
  1261 
       
  1262 	$ command > file 2>&1
       
  1263 
       
  1264 is:
       
  1265 ::
       
  1266 
       
  1267 	$ command &>file
       
  1268 
       
  1269 or:
       
  1270 ::
       
  1271 
       
  1272 	$command >&file
       
  1273 
       
  1274 Chained pipelines
       
  1275 ------------------
       
  1276 
       
  1277 The redirection and piping tokens can be chained together to create complex commands. For example:
       
  1278 ::
       
  1279 
       
  1280 	$ ls | grep '\.sh' | sort > shlist
       
  1281 
       
  1282 lists the contents of the current directory, where this output is filtered to only contain lines which contain *.sh*, sort this resultant output lexicographically, and place the final output in *shlist*. This type of construction is used very commonly in shell scripts and batch files.
       
  1283 
       
  1284 Redirect to multiple outputs
       
  1285 -----------------------------
       
  1286 
       
  1287 The standard command *tee* can redirect output from a command to several destinations.
       
  1288 ::
       
  1289 
       
  1290 	$ ls -lrt | tee xyz
       
  1291 
       
  1292 This directs the file list output to both standard output as well as to the file *xyz*.
       
  1293 
       
  1294 More Text Processing
       
  1295 ====================
       
  1296 
       
  1297 grep
       
  1298 -----
       
  1299 
       
  1300 *grep* is a command line text search utility originally written for Unix. The name is taken from the first letters in *global / regular expression / print*, a series of instructions for the *ed* text editor. The *grep* command searches files or standard input globally for lines matching a given regular expression, and prints them to the program's standard output.
       
  1301 
       
  1302 Usage
       
  1303 ~~~~~~
       
  1304 
       
  1305 This is an example of a common *grep* usage:
       
  1306 ::
       
  1307 
       
  1308 	$ grep apple fruitlist.txt
       
  1309 
       
  1310 In this case, *grep* prints all lines containing 'apple' from the file *fruitlist.txt*, regardless of word boundaries; therefore lines containing 'pineapple' or 'apples' are also printed. The *grep* command is case sensitive by default, so this example's output does not include lines containing 'Apple' (with a capital A) unless they also contain 'apple'.
       
  1311 
       
  1312 Like most Unix commands, *grep* accepts command line arguments to change this and many other behaviors. For example:
       
  1313 ::
       
  1314 
       
  1315 	$ grep -i apple fruitlist.txt
       
  1316 
       
  1317 This prints all lines containing 'apple' regardless of capitalization. The '-i' argument tells *grep* to be case insensitive, or to ignore case.
       
  1318 
       
  1319 To print all lines containing 'apple' as a word ('pineapple' and 'apples' will not match):
       
  1320 ::
       
  1321 
       
  1322 	$ grep -w apple fruitlist.txt
       
  1323 
       
  1324 Regular expressions can be used to match more complicated queries.
       
  1325 
       
  1326 Variations
       
  1327 +++++++++++
       
  1328 
       
  1329 There are countless implementations and derivatives of *grep* available for many operating systems. Early variants of *grep* included *egrep* and *fgrep*. The former applies an extended regular expression syntax that was added to Unix after Ken Thompson's original regular expression implementation. The latter searches for any of a list of 'fixed' strings using the Aho-Corasick algorithm. These variants are embodied in most modern *grep* implementations as command-line switches (and standardized as -E and -F in POSIX). In such combined implementations, *grep* may also behave differently depending on the name by which it is invoked, allowing *fgrep*, *egrep*, and *grep* to be links to the same program.
       
  1330 
       
  1331 *pcregrep* is an implementation of *grep* that uses Perl regular expression syntax.
       
  1332 
       
  1333 Other commands contain the word 'grep' to indicate that they search (usually for regular expression matches). The *pgrep* utility, for instance, displays the processes whose names match a given regular expression.
       
  1334 
       
  1335 tr
       
  1336 --
       
  1337 
       
  1338 *tr* (abbreviated from *translate* or *transliterate*) is a command in Unix-like operating systems.
       
  1339 
       
  1340 When executed, the program reads from the standard input and writes to the standard output. It takes as parameters two sets of characters, and replaces occurrences of the characters in the first set with the corresponding elements from the other set. For example,
       
  1341 ::
       
  1342 
       
  1343 	$ tr 'abcd' 'jkmn' 
       
  1344 
       
  1345 maps 'a' to 'j', 'b' to 'k', 'c' to 'm', and 'd' to 'n'.
       
  1346 
       
  1347 Sets of characters may be abbreviated by using character ranges. The previous example could be written:
       
  1348 ::
       
  1349 
       
  1350 	$ tr 'a-d' 'jkmn'
       
  1351 
       
  1352 In POSIX compliant versions of *tr* the set represented by a character range depends on the locale's collating order, so it is safer to avoid character ranges in scripts that might be executed in a locale different from that in which they were written. Ranges can often be replaced with POSIX character sets such as [:alpha:].
       
  1353 
       
  1354 The *-c* flag complements the first set of characters.
       
  1355 ::
       
  1356 
       
  1357 	$ tr -cd '[:alnum:]' 
       
  1358 
       
  1359 therefore removes all non-alphanumeric characters.
       
  1360 
       
  1361 The *-s* flag causes tr to compress sequences of identical adjacent characters in its output to a single token. For example,
       
  1362 ::
       
  1363 
       
  1364 	$ tr -s '\n' '\n'
       
  1365 
       
  1366 replaces sequences of one or more newline characters with a single newline.
       
  1367 
       
  1368 The *-d* flag causes tr to delete all tokens of the specified set of characters from its input. In this case, only a single character set argument is used. The following command removes carriage return characters, thereby converting a file in DOS/Windows format to one in Unix format.
       
  1369 ::
       
  1370 
       
  1371 	$ tr -d '\r'
       
  1372 
       
  1373 Most versions of *tr*, including GNU *tr* and classic Unix *tr*, operate on single byte characters and are not Unicode compliant. An exception is the Heirloom Toolchest implementation, which provides basic Unicode support.
       
  1374 
       
  1375 Ruby and Perl also have an internal *tr* operator, which operates analogously. Tcl's *string map* command is more general in that it maps strings to strings while *tr* maps characters to characters.
       
  1376 
       
  1377 Elementary Regex
       
  1378 =================
       
  1379 
       
  1380 In computing, regular expressions provide a concise and flexible means for identifying strings of text of interest, such as particular characters, words, or patterns of characters. A regular expression (often shortened to regex or regexp) is written in a formal language that can be interpreted by a regular expression processor, a program that either serves as a parser generator or examines text and identifies parts that match the provided specification.
       
  1381 
       
  1382 Regular expressions are used by many text editors, utilities, and programming languages to search and manipulate text based on patterns. For example, Perl, Ruby and Tcl have a powerful regular expression engine built directly into their syntax. Several utilities provided by Unix distributions—including the editor *ed* and the filter *grep* — were the first to popularize the concept of regular expressions.
       
  1383 
       
  1384 Traditional Unix regular expression syntax followed common conventions but often differed from tool to tool. The IEEE POSIX *Basic Regular Expressions* (BRE) standard (released alongside an alternative flavor called Extended Regular Expressions or ERE) was designed mostly for backward compatibility with the traditional (Simple Regular Expression) syntax but provided a common standard which has since been adopted as the default syntax of many Unix regular expression tools, though there is often some variation or additional features. Many such tools also provide support for ERE syntax with command line arguments.
       
  1385 
       
  1386 In the BRE syntax, most characters are treated as literals — they match only themselves (i.e., a matches "a"). The exceptions, listed below, are called metacharacters or metasequences.
       
  1387 
       
  1388 +-------------+------------------------------------------------------------+
       
  1389 |Metacharacter|                            Description                     |
       
  1390 +=============+============================================================+
       
  1391 | .           | Matches any single character (many applications exclude    | 
       
  1392 |             | newlines, and exactly which characters are considered      | 
       
  1393 |             | newlines is flavor, character encoding, and platform       |
       
  1394 |             | specific, but it is safe to assume that the line feed      |
       
  1395 |             | character is included). Within POSIX bracket expressions,  |
       
  1396 |             | the dot character matches a literal dot. For example, a.c  |
       
  1397 |             | matches abc, etc., but [a.c] matches only a, ., or         |
       
  1398 |             | c.                                                         |
       
  1399 +-------------+------------------------------------------------------------+
       
  1400 | [ ]         | A bracket expression. Matches a single character that is   | 
       
  1401 |             | contained within the brackets. For example, [abc] matches  |
       
  1402 |             | a, b, or c. [a-z] specifies a range which matches any      |
       
  1403 |             | lowercase letter from a to z. These forms can be mixed:    |
       
  1404 |             | [abcx-z] matches a, b, c, x, y, or z, as does              |
       
  1405 |             | [a-cx-z]. The - character is treated as a literal character|
       
  1406 |             | if it is the last or the first character within the        |
       
  1407 |             | brackets, or if it is escaped with a backslash: [abc-],    |
       
  1408 |             | [-abc], or [a\-bc].                                        |
       
  1409 +-------------+------------------------------------------------------------+
       
  1410 | [^ ]        | Matches a single character that is not contained within the|
       
  1411 |             | brackets. For example, [^abc] matches any character other  |
       
  1412 |             | than a, b, or c. [^a-z] matches any single character       |
       
  1413 |             | that is not a lowercase letter from a to z. As above,      |
       
  1414 |             | literal characters and ranges can be mixed.                |
       
  1415 +-------------+------------------------------------------------------------+
       
  1416 | ^           | Matches the starting position within the string. In        |
       
  1417 |             | line-based tools, it matches the starting position of any  |
       
  1418 |             | line.                                                      |
       
  1419 +-------------+------------------------------------------------------------+
       
  1420 | $           | Matches the ending position of the string or the position  |
       
  1421 |             | just before a string-ending newline. In line-based tools,  |
       
  1422 |             | it matches the ending position of any line.                |
       
  1423 +-------------+------------------------------------------------------------+
       
  1424 | `*`         | Matches the preceding element zero or more times. For      |
       
  1425 |             | example, ab*c matches "ac", "abc", "abbbc", etc. [xyz]*    |
       
  1426 |             | matches "", "x", "y", "z", "zx", "zyx", "xyzzy", and so on.|
       
  1427 |             | \(ab\)* matches "", "ab", "abab", "ababab", and so on.     |
       
  1428 +-------------+------------------------------------------------------------+
       
  1429 | ?           | Matches the preceding element zero or one time. For        |
       
  1430 |             | example, ba? matches "b" or "ba".                          |
       
  1431 +-------------+------------------------------------------------------------+
       
  1432 | `+`         | Matches the preceding element one or more times. For       |
       
  1433 |             | example, ba+ matches "ba", "baa", "baaa", and so on.       |
       
  1434 +-------------+------------------------------------------------------------+
       
  1435 | `|`         | The choice (aka alternation or set union) operator matches |
       
  1436 |             | either the expression before or the expression after the   |
       
  1437 |             | operator. For example, abc|def matches "abc" or "def".     |
       
  1438 +-------------+------------------------------------------------------------+
       
  1439 
       
  1440 Lazy quantification
       
  1441 --------------------
       
  1442 
       
  1443 The standard quantifiers in regular expressions are greedy, meaning they match as much as they can, only giving back as necessary to match the remainder of the regex. For example, someone new to regexes wishing to find the first instance of an item between < and > symbols in this example:
       
  1444 ::
       
  1445 
       
  1446 	Another whale explosion occurred on <January 26>, <2004>.
       
  1447 
       
  1448 ...would likely come up with the pattern <.*>, or similar. However, this pattern will actually return "<January 26>, <2004>" instead of the "<January 26>" which might be expected, because the `*` quantifier is greedy — it will consume as many characters as possible from the input, and "January 26>, <2004" has more characters than "January 26".
       
  1449 
       
  1450 Though this problem can be avoided in a number of ways (e.g., by specifying the text that is not to be matched: <[^>]*>), modern regular expression tools allow a quantifier to be specified as *lazy* (also known as non-greedy, reluctant, minimal, or ungreedy) by putting a question mark after the quantifier (e.g., <.*?>), or by using a modifier which reverses the greediness of quantifiers (though changing the meaning of the standard quantifiers can be confusing). By using a lazy quantifier, the expression tries the minimal match first. Though in the previous example lazy matching is used to select one of many matching results, in some cases it can also be used to improve performance when greedy matching would require more backtracking.
       
  1451 
       
  1452 One Liners
       
  1453 ===========
       
  1454 
       
  1455 A *one-liner* is textual input to the command-line of an operating system shell that performs some function in just one line of input.
       
  1456 
       
  1457 The one liner can be
       
  1458 
       
  1459    1. An expression written in the language of the shell.
       
  1460    2. The invocation of an interpreter together with program source for the interpreter to run.
       
  1461    3. The invocation of a compiler together with source to compile and 	  
       
  1462       instructions for executing the compiled program.
       
  1463 
       
  1464 Certain dynamic scripting languages such as AWK, sed, and perl have traditionally been adept at expressing one-liners. Specialist shell interpreters such as these Unix shells or the Windows PowerShell, allow for the construction of powerful one-liners.
       
  1465 
       
  1466 The use of the phrase one-liner has been widened to also include program-source for any language that does something useful in one line.
       
  1467 
       
  1468 The word *One-liner* has two references in the index of the book *The AWK Programming Language* (the book is often referred to by the abbreviation TAPL). It explains the programming language AWK, which is part of the Unix operating system. The authors explain the birth of the One-liner paradigm with their daily work on early Unix machines:
       
  1469 ::
       
  1470 
       
  1471     “The 1977 version had only a few built-in variables and predefined functions. It was designed for writing short programs [...] Our model was that an invocation would be one or two lines long, typed in and used immediately. Defaults were chosen to match this style [...] We, being the authors, knew how the language was supposed to be used, and so we only wrote one-liners.”
       
  1472 
       
  1473 Notice that this original definition of a One-liner implies immediate execution of the program without any compilation. So, in a strict sense, only source code for interpreted languages qualifies as a One-liner. But this strict understanding of a One-liner was broadened in 1985 when the IOCCC introduced the category of Best One Liner for C, which is a compiled language.
       
  1474 
       
  1475 The TAPL book contains 20 examples of One-liners (A Handful of Useful awk One-Liners) at the end of the book's first chapter.
       
  1476 
       
  1477 Here are the first few of them:
       
  1478 
       
  1479    1. Print the total number of input lines:
       
  1480 
       
  1481       END { print NR }
       
  1482 
       
  1483    2. Print the tenth input line:
       
  1484 
       
  1485       NR == 10
       
  1486 
       
  1487    3. Print the last field of every input line:
       
  1488 
       
  1489       { print $NF }
       
  1490 
       
  1491 One-liners are also used to show off the differential expressive power of programming languages. Frequently, one-liners are used to demonstrate programming ability. Contests are often held to see who can create the most exceptional one-liner.
       
  1492 
       
  1493 The following example is a C program (a winning entry in the "Best one-liner" category of the IOCCC, here split to two lines for presentation).::
       
  1494 	
       
  1495 	main(int c,char**v){return!m(v[1],v[2]);}m(char*s,char*t){return
       
  1496 	*t-42?*s?63==*t|*s==*t&&m(s+1,t+1):!*t:m(s,t+1)||*s&&m(s+1,t);}
       
  1497 
       
  1498 This one-liner program is a *glob pattern matcher*. It understands the glob characters '*' meaning 'zero or more characters' and '?' meaning exactly one character, just like most Unix shells.
       
  1499 
       
  1500 Run it with two args, the string and the glob pattern. The exit status is 0 (shell true) when the pattern matches, 1 otherwise. The glob pattern must match the whole string, so you may want to use * at the beginning and end of the pattern if you are looking for something in the middle. Examples::
       
  1501 
       
  1502 	$ prog foo 'f??'; echo $?
       
  1503 
       
  1504 	$ prog 'best short program' '??st*o**p?*'; echo $?
       
  1505 
       
  1506 Here is a one line shell script to show directories:
       
  1507 
       
  1508 ::
       
  1509 
       
  1510 	$ ls -R | grep ":$" | sed -e 's/:$//' -e 's/[^-][^\/]*\//--/g' -e 's/^/   /' -e 's/-/|/' 
       
  1511 
       
  1512 
       
  1513