Changes

Jump to: navigation, search

Tutorial5: Redirection

1,215 bytes added, 16:54, 14 October 2020
INVESTIGATION 3: ISSUING MULTIPLE UNIX/LINUX COMMANDS
<br>
===Main Objectives of this Practice Tutorial===
 
:* Understand the purpose of the following file manipulation commands: '''cut''', '''tr''', and '''wc'''
:* Define the terms '''Standard Input''' ('''stdin'''), '''Standard Output''' ('''stdout'''), and '''Standard Error''' ('''stderr''')
:* Understand the purposes of the redirection symbols '''>''', '''>>''', '''2>''', '''2>>''', and '''|''' (pipe)
:* Define Understand the purpose of the the following file manipulation commands: '''cut/dev/null''', '''tr''', file and the '''wcHere Document'''
:* Define the term '''pipeline command''' and explain how a pipeline command functions
= KEY CONCEPTS =
 
===Additional File Manipulation Commands===
 
Before proceeding, there are some additional regular file manipulation commands that you can use with redirection<br>(in addition to the other regular file manipulation commands introduced in week 2).
 
These commands are displayed in the table below:
 
<table cellpadding="5" width="55%"><tr><th style="border-bottom: 1px solid black;text-align:left;">Linux Command</th><th style="border-bottom: 1px solid black;text-align:left;">Purpose</th></tr><tr valign="top"><td>'''cut'''</td><td>Used to '''extract''' fields and characters from records. The option '''-c''' option is used to cut by a character or a range of characters. The '''-f''' option indicates the field number or field range to display (this may require using the '''-d''' option to indicate the field separator (delimiter) which is tab by default).<br><br>''Examples:''<br><span style="font-family:courier;font-weight:bold;">cut -f2 filename</span> - extract 2nd field from all records in file<br><span style="font-family:courier;font-weight:bold;">cut -d' ' -f2,5 filename</span> - extract 2nd and 5th field<br><span style="font-family:courier;font-weight:bold;">cut -d' ' -f1-3,5 filename</span> - extract 1st to 3rd and 5th fields<br><span style="font-family:courier;font-weight:bold;">cut -c3-5 filename</span> - extract 3rd to 5th characters</td></tr><tr valign="top"><td>'''tr'''</td><td>Used to '''translate''' characters to different characters.<br><br>''Examples:''<br><span style="font-family:courier;font-weight:bold;">tr "[a-z]" "[A-Z]" < filename</span> - translate lower to upper case<br><span style="font-family:courier;font-weight:bold;">tr "a-z" "A-Z" < filename</span> - same as above (non-System V servers)<br><span style="font-family:courier;font-weight:bold;">tr ':' ' ' < filename</span> - translate all colons to spaces<br><span style="font-family:courier;font-weight:bold;">tr ' ' '\n' < filename</span> - translate all spaces to newline characters<br><br></td></tr><tr valign="top"><td><span style="font-family:courier;font-weight:bold;">wc</span></td><td>Displays various '''counts''' of the contents of a file.<br><br>''Examples:''<br><span style="font-family:courier;font-weight:bold;">wc -l filename</span> - displays number of lines in file<br><span style="font-family:courier;font-weight:bold;">wc -c filename</span> - displays number of characters in file<br><span style="font-family:courier;font-weight:bold;">wc -w filename</span> - displays number of words in fil<br></td></tr></table>
 
===Redirection (Standard Input, Standard Output, Standard Error)===
<i>''... '''standard Standard streams''' are preconnected '''input and output communication channels ''' between a computer program and its environment when it begins execution. The three input/output (I/O) connections are called '''standard input''' ('''stdin'''), '''standard output''' ('''stdout''') and '''standard error''' ('''stderr'''). Originally I/O happened via a physically connected system console (input via keyboard, output via monitor), but standard streams '''abstract''' this. When a command is executed via an interactive shell, the streams are typically connected to the text terminal on which the shell is running, but can be changed with '''redirection''' or a '''pipeline'''. ''</i>
Reference: https://en.wikipedia.org/wiki/Standard_streams
[[Image:stdin-symbol.png|thumb|right|250px|The '''standard input''' ('''stdin''') symbol that describes where a Unix/Linux command receives '''input''']]
'''Standard input''' ('''stdin''') is a term which describes from where a command receives '''input'''.<br>This would apply only to Unix/Linux commands that accept stdin input <br>(like ''cat'', ''more'', ''less'', ''sort'', ''grep'', ''head'', ''tail'', ''tr'', ''cut'', ''wc'', etc.).<br> 
''Examples:''
<table align="right"><tr><td>[[Image:stdout-symbol-1.png|thumb|right|250px|The '''standard input''' ('''stdin''') symbol with one greater than sign '''overwrites ''' existing file content with command output]]</td><td>[[Image:stdout-symbol-2.png|thumb|right|250px|The '''standard input''' ('''stdin''') symbol with two greater than signs '''add ''' command's output to '''bottom ''' of existing file's contents.]]</td></tr></table>'''Standard output''' ('''stdout''') describes where a command sends itits '''s output'''.<br>In the examples below, output from a command is sent to the '''monitor''', unless it is sent to a '''text file'''.
<table align="right"><tr><td>[[Image:stderr-symbol-1.png|thumb|right|250px|The '''standard error''' ('''sterr''') symbol with one greater than sign '''overwrites ''' existing file content with command's '''error message'''.]]</td><td>[[Image:stderr-symbol-2.png|thumb|right|250px|The '''standard error''' ('''stderr''') symbol with two greater than signs '''add ''' command's error message to '''bottom ''' of existing file's contents.]]</td></tr></table>
'''Standard Error''' ('''stderr''') describes where a command sends it's error messages. In the examples below we issue the pwd in capitals on purpose to generate an error message, which can be redirected to a '''text file'''.
<span style="font-family:courier;font-weight:bold">PWD<br>PWD 2> error-message.txt<br>PWD 2 >> error-messages.txt<br>PWD 2> /dev/null</span>
The '''/dev/null''' file (sometimes called the '''bit bucket''' or '''black hole''') is a special system file<br>that discards '''discard''' all data written into it. This is useful to discard unwanted command output.
<br><br>
[[Image:Here Document.png|thumb|right|150px175px|The '''Here Document''' allows a user to redirect stdin from <u>within </u> the command itself.]]
In Linux, the '''Here Document''' allows a user to redirect stdin from within the command itself.
<span style="font-family:courier;font-weight:bold">cat <<+<br>Line 1<br>Line 2<br>Line 3<br>+<br><br>
 
===Additional File Manipulation Commands===
 
There are some additional regular file manipulation commands that you can use with redirection<br>(in addition to the other regular file manipulation commands introduced in week 2).
 
These commands are displayed in the table below:
 
<table cellpadding="5" width="55%"><tr><th style="border-bottom: 1px solid black;text-align:left;">Linux Command</th><th style="border-bottom: 1px solid black;text-align:left;">Purpose</th></tr><tr valign="top"><td>'''cut'''</td><td>Used to extract fields and characters from records. The option '''-c''' option is used to cut by a character or a range of characters. The '''-f''' option indicates the field number or field range to display (this may require using the '''-d''' option to indicate the field separator (delimiter) which is tab by default.<br><br>''Examples:''<br><span style="font-family:courier;font-weight:bold;">cut -f2 filename</span> - extract 2nd field from all records in file<br><span style="font-family:courier;font-weight:bold;">cut -d' ' -f2,5 filename</span> - extract 2nd and 5th field<br><span style="font-family:courier;font-weight:bold;">cut -d' ' -f1-3,5 filename</span> - extract 1st to 3rd and 5th fields<br><span style="font-family:courier;font-weight:bold;">cut -c3-5 filename</span> - extract 3rd to 5th characters</td></tr><tr valign="top"><td>'''tr'''</td><td>Used to translate characters to different characters.<br><br>''Examples:''<br><span style="font-family:courier;font-weight:bold;">tr "[a-z]" "[A-Z]" < filename</span> - translate lower to upper case<br><span style="font-family:courier;font-weight:bold;">tr "a-z" "A-Z" < filename</span> - same as above (non-System V servers)<br><span style="font-family:courier;font-weight:bold;">tr ':' ' ' < filename</span> - translate all colons to spaces<br><span style="font-family:courier;font-weight:bold;">tr ' ' '\n' < filename</span> - translate all spaces to newline characters<br><br></td></tr><tr valign="top"><td><span style="font-family:courier;font-weight:bold;">wc</span></td><td>Displays various counts of the contents of a file.<br><br>''Examples:''<br><span style="font-family:courier;font-weight:bold;">wc -l filename</span> - displays number of lines in file<br><span style="font-family:courier;font-weight:bold;">wc -c filename</span> - displays number of characters in file<br><span style="font-family:courier;font-weight:bold;">wc -w filename</span> - displays number of words in fil<br></td></tr></table>
<br><br>
===Piping (Using Pipes)===
[[Image:pipe-diagram-1.png|thumb|right|450px|A '''pipeline command''' sends a command's '''standard output''' directly to '''standard input''' of other command(s) without having to create temporary files.]]
'''Pipeline Command:''' Having commands send their s'''tandard output''' <u>directly</u> to '''standard input''' of other commands WITHOUT having to use '''temporary''' files.
 
Pipes that are used in a '''pipeline command''' are represented by the '''pipe''' "|" symbol.<br>
A few simple commands can be '''combined''' to form a more <u>powerful</u> command line.<br>
Pipes that are used in a '''pipeline command''' are represented by the '''pipe''' "|" symbol. Commands to the '''right''' of the pipe symbol are referred to as '''filters'''. They are referred to as ''filters'' since those commands are used to '''modify''' the stdin that was sent from stdout of the <u>previous command</u>. Many commands can be "piped" together, but these commands (filters) must be chained in a specific order, depending on what you wish to accomplish
[[Image:tee-diagram-1.png|thumb|right|250px|The '''tee''' utility can be used to '''split ''' the flow of information. For example to save in a file as well as display on a screen. <br>(Image licensed under [https://creativecommons.org/licenses/by-sa/3.0/ cc])]]
The '''tee''' utility can be used to split the flow of information. The tee option '''-a''' can be used to add content to the bottom of an existing file as opposed to overwriting the file's previous contents.
''Example:''
<span style="font-family:courier;font-weight:bold">sleep 5; ls</span> (''Note: each command will be executed when the previous command has terminated'')
''Example:''
<span style="font-family:courier;font-weight:bold">(echo "Who is on:"; w) > whoson</span><br>('''''Note:''' <u>all</u> command output is sent to a file'')
<br>
In this section, you will learn how to redirect ''standard input'', ''standard output '' and ''standard error '' when issuing Unix / Linux commands.
'''Perform the Following Steps:'''
# '''Login''' to your matrix account and issue a command to '''confirm''' you are located in your '''home''' directory.<br><br># Issue the following Linux command to create the following directory: <span style="color:blue;font-weight:bold;font-family:courier;">mkdir ~/redirect</span><br><br>
# Change to the '''~/redirect''' directory and confirm that you changed to that directory.<br><br>
# Use a text editor to create a file in your current directory called '''data.txt''' and enter the following text displayed below:<br><br><span style="font-family:courier;font-weight:bold">This is line 1<br>This is line 2<br>This is line 3</span><br><br>
# Save editing changes and exit the text editor.<br><br>
# Issue the following Linux command: <span style="color:blue;font-weight:bold;font-family:courier;">tr 'a-z' 'A-Z' < data.txt</span><br><br>What does this command do?<br><br># Issue the following Linux command: <span style="color:blue;font-weight:bold;font-family:courier;">tr 'a-z' 'A-Z' < data.txt > output.txt</span><br><br>What does this command do? What are the contents of the file ''output.txt''?<br><br># Issue the following Linux command: <span style="color:blue;font-weight:bold;font-family:courier;">tr 'a-z' 'A-Z' > output.txt < data.txt</span><br><br>What does this command do? Is there any difference in terms of this command and the previous command issued?<br><br># Issue the following Linux command: <span style="color:blue;font-weight:bold;font-family:courier;">tr 'a-z' 'A-Z' >> output.txt < data.txt</span><br><br>What happens to the content of the '''output.txt ''' file? Why?<br><br>
# Issue the following Linux command: <span style="color:blue;font-weight:bold;font-family:courier;">tail -2 < data.txt > output.txt</span><br><br>What does this command do? Check the contents of the '''output.txt''' file to confirm.<br><br>
# Issue the following Linux command: <span style="color:blue;font-weight:bold;font-family:courier;">tail -2 > output2.txt < data.txt </span><br><br>Why does this command render the same results as the previous command?<br>Try explaining how the command works in terms of '''stdin''' and then '''stdout'''.<br><br>
# Issue the following Linux command: <span style="color:blue;font-weight:bold;font-family:courier;">cut -f1-3 cars > field123.txt</span><br><br>What did this command do?<br><br>
# Issue the following Linux command: <span style="color:blue;font-weight:bold;font-family:courier;">cut -f1,5 cars > field15.txt</span><br><br>What did this command do?<br><br>
# Issue the following Linux command: <span style="color:blue;font-weight:bold;font-family:courier;">wc cars > count1.txt</span><br><br>What information does the '''count1.txt ''' file contain?<br><br># Issue the following Linux command: <span style="color:blue;font-weight:bold;font-family:courier;">wc cars > count2.txt</span><br><br>What information does the '''count2.txt ''' file contain?<br><br># Issue the following Linux command: <span style="color:blue;font-weight:bold;font-family:courier;">ls -l > listing.txt</span><br><br>What information does the '''count2.txt ''' file contain?<br><br>
# Issue the following Linux command: <span style="color:blue;font-weight:bold;font-family:courier;">pwd > listing.txt</span><br><br>What happenned to the original contents of the file called '''listing.txt'''?<br><br>
# Issue the following Linux command (use 2 greater-than signs): <span style="color:blue;font-weight:bold;font-family:courier;">date >> listing.txt</span><br><br>What information does the '''listing.txt''' file contain?<br><br>
# Issue the following Linux command: <span style="color:blue;font-weight:bold;font-family:courier;">cat listing.txt cars > combined.txt</span><br><br>What information does the '''combined.txt''' file contain?<br><br>'''NOTE''': The '''cat''' command stands for "'''concatenate'''" which means to '''combine''' contents of multiple files into a single file. This is why the command is called "cat".<br><br>
# Issue the following Linux command: <span style="color:blue;font-weight:bold;font-family:courier;">cat listing.txt cars murray 2> result.txt</span><br><br>What information does the '''result.txt''' file contain?<br><br>
# Issue the following Linux command: <span style="color:blue;font-weight:bold;font-family:courier;">cat listing.txt cars murray > myoutput.txt 2> result.txt</span><br><br>What is displayed on the monitor? what do those files contain?<br><br>The '''Here Document''' allows you to redirect stdin from with the Linux command itself. Let's get some practice using the Here Document.<br><br>
# Issue the following Linux command:<br><span style="color:blue;font-weight:bold;font-family:courier;">cat <<+<br>line 1<br>line 2<br>line 3<br>+</span><br><br>What do you notice?<br><br>
# Issue the following Linux command:<br><span style="color:blue;font-weight:bold;font-family:courier;">grep 2 <<+<br>line 1<br>line 2<br>line 3<br>+</span><br><br>What do you notice? How does this differ from the previous command? Why?<br><br>
=INVESTIGATION 2: REDIRECTION USING PIPES =
In this section, you will learn to issue '''pipeline commands and learn how ''' to perform tasks<br>using issue Linux commands with or without the generation of having to generate temporary files.
'''Perform the Following Steps:'''
# Change to your Confirm that you are still located in the '''home~/redirect''' directory and confirm that you are now in your home directory.<br><br># Issue the '''ls''' command to view the contents of your '''~/redirect''' directory.<br><br>These are all temporary files that you created in your previous investigation.<br>The '''problem''' with creating temporary files, is that they take up space on your server,<br>and should be removed.<br><br># Issue the following Linux command to remove all temporary files in your ''redirect'' directory: <span style="color:blue;font-weight:bold;font-family:courier;">rm -r ~/redirect</span><br>and confirm that you have removed this directory and its contents.<br><br>'''NOTE:''' You will be issuing a '''pipeline command ''' which will use the pipe symbol "|"<br>that will send the stdout from a command as stdin into another commandwithout having to create temporary files.<br><br># Issue the follow Linux '''pipeline command''': <span style="color:blue;font-weight:bold;font-family:courier;">ls /bin | more</span><br><br>What happened?<br><br># Issue the following Linux '''pipeline command''': <span style="color:blue;font-weight:bold;font-family:courier;">ls /bin | who</span><br><br>What happened? Why is the result different than antipated?[[Image:pipe-diagram-1.png|thumb|right|350px|]]<br><br>'''NOTE:''' When issuing pipeline commands, commands to the right of the pipe symbol must be designed to <u>accept stdin</u> '''standard input'''. Since the ''who '' command does not, you did NOT see the contents of the '''/bin''' directory but only information relating to the ''who'' command. Therefore, the '''order''' of which you build your pipeline command and the '''type of command''' that is used as a ''filter'' is extremely important!<br><br># Issue the following Linux command: <span style="color:blue;font-weight:bold;font-family:courier;">cp ls /bin/?? > listing.txt</span><br><br>
# Issue the following Linux command: <span style="color:blue;font-weight:bold;font-family:courier;">sort -r listing.txt</span><br><br>
# Issue the following Linux command to remove the listing file: <span style="color:blue;font-weight:bold;font-family:courier;">rm listing.txt</span><br><br>
# Issue the following Linux '''pipeline command''': <span style="color:blue;font-weight:bold;font-family:courier;">ls /bin/?? | sort -r</span><br><br>You should notice that the output from this pipeline command is the same output<br>from the command you issued in '''step #67'''<br><br># Issue the following Linux '''pipeline command''': <span style="color:blue;font-weight:bold;font-family:courier;">ls /bin/?? | sort -r | more</span><br><br>What is different with this pipeline command as opposed to the <u>previous </u> pipeline command?<br><br>
# Issue the '''ls''' command.<br><br>You should notice that no files have been created. Let's get practice issuing more pipeline commands<br>using commands (previously learned or new) to be used as filters.<br><br>
# Issue the following Linux '''pipeline command''': <span style="color:blue;font-weight:bold;font-family:courier;">ls /bin/?? | sort -r | head -5</span><br><br>What did you notice?<br><br># Issue the following Linux '''pipeline command''': <span style="color:blue;font-weight:bold;font-family:courier;">ls /bin/???? | sort -r | grep r | tail -2</span><br><br>What did you notice?<br><br># Issue the following Linux '''pipeline command''': <span style="color:blue;font-weight:bold;font-family:courier;">ls /bin/???? | sort -r | grep r | cut -c1-3</span><br><br># Issue the following Linux '''pipeline command''':<br><span style="color:blue;font-weight:bold;font-family:courier;">ls /bin/???? | tee unsorted.txt | sort -r | tee sorted.txt | tee unmatched.txt | grep r | tail -2</span><br><br>What did you notice?<br><br>
# Check the files that were created to see how the '''tee''' command was used in the previous pipeline command.<br><br>
# Change to your home directory.<br><br>
'''Perform the Following Steps:'''
# Issue a Linux command to change to your home directory.<br><br>
# Confirm you are located in your '''home''' directory.<br><br>
# Issue the following Linux commands (using semicolon to separate each command): <span style="color:blue;font-weight:bold;font-family:courier;">cal;pwd;date</span><br><br>Note the from the output the order of how each of those commands were processed.<br><br>
# Issue the following Linux commands: <span style="color:blue;font-weight:bold;font-family:courier;">(cal;pwd;date)</span><br><br>Was there any difference in the output of this command as opposed to the previous command?<br><br>Let's see how grouping affects working with redirection.<br><br># Issue the following Linux commands: <span style="color:blue;font-weight:bold;font-family:courier;">cal;pwd;date > output.txt</span><br><br># Issue a Linux command to view the contents of the file called '''output.txt'''<br><br>What do you notice?<br><br>Let's use grouping to make modification to the previous command<br><br># Issue the following Linux commands: <span style="color:blue;font-weight:bold;font-family:courier;">(cal;pwd;date) > output.txt</span><br><br># Issue a Linux command to view the contents of the file called '''output.txt'''<br><br>What do you notice? What did grouping the three Linux commands do?<br><br>
# Issue the following Linux pipeline command (using \ at the end of most lines):<br><span style="color:blue;font-family:courier;font-weight:bold">echo "This will be split over multiple \<br>lines. Note that the shell will realize \<br>that a pipe requires another command, so \<br>it will automatically go to the next line" |tr '[a-z]' '[A-Z]'</span><br><br>Did the command work? What does this command do?<br><br>
# After you complete the Review Questions sections to get additional practice, then work on your '''online assignment 2 '''<br>and complete '''section3 ''' labelled: '''Redirection and Pipes'''.
<br><br>
Your instructor may take-up these questions during class. It is up to the student to attend classes in order to obtain the answers to the following questions. Your instructor will NOT provide these answers in any other form (eg. e-mail, etc).
When answering Linux command questions, refer to the following Inverted Tree diagramDiagram. The linux directory is contained in your home directory. Assume that you just logged into your Matrix account. Directories are <u>underlined</u>.
[[Image:week5-dir.png|thumb|left|300px|]]
'''Review Questions:'''
# Write a single Linux command to provide a detailed listing of all files in the '''/bin ''' directory, sending the output to a file called listing.txt in the “projects” “'''projects'''” directory (append output to existing file and use a relative pathname)# Write a single Linux command to redirect the stderr from the command:<br>'''cat a.txt b.txt c.txt ''' to a file called '''error.txt ''' contained in the “assignments” “'''assignments'''” directory. (overwrite previous file’s contents and use only relative pathnames) # Write a single Linux command: '''cat ~/a.txt ~/b.txt ~/c.txt ''' and redirect stdout to a file called “good.txt” to the “tests” directory and stderr to a file called “bad“'''bad.txt” txt'''” to the “tests” “'''tests'''” directory. (overwrite previous contents for both files and use only relative-to-home pathnames).# Write a single Linux command to redirect the stdout from the command:<br>'''cat a.txt b.txt c.txt ''' to a file called wrong.txt contained in the “projects” “'''projects'''” directory and throw-out any standard error messages so they don’t appear on the screen (append output to existing file and use only relative pathnames).<br><br># Write a single Linux '''pipeline command ''' to display a detailed listing of the “projects “directory '''projects''' directory but pause one screen at a time to view and navigate through all of the directory contents. Use a relative-to-home pathname.# Write a single Linux '''pipeline command ''' to display the sorted contents (in reverse alphabetical order) of the “linux” “'''linux'''” directory. Use a relative pathname.# Assume that the text file called “'''.answers.txt” txt'''” contains 10 lines. Write a single Linux pipeline command to only displays lines 5 through 8 for this file. Use only relative pathnames.# Write a single Linux '''pipeline command ''' to only display the contents of the “assignments” “'''assignments'''” directory whose filenames match the pattern “murray” “'''murray'''” (both upper or lowercase). Use an absolute pathname.# Write a single Linux '''pipeline command ''' to display the number of characters contained in the file called “'''.answers.txt”txt'''”. Use a relative-to-home pathname.# Write a single Linux '''pipeline command ''' to display the number of lines contained in the file called “questions“'''questions.txt”txt'''”. Use a relative pathname.# Write a single Linux '''pipeline command ''' to display only the first 10 characters of each filename contained in your current directory. Also, there is will be a lot of output, so also pause at each screenful so you can navigate throughout the display contents. Use a relative pathname.
# Create a '''table''' listing each Linux command, useful options that were mentioned in this tutorial for the following Linux commands: '''cut''' , '''tr''' , '''wc''' , and '''tee'''.
[[Category:ULI101]]
13,420
edits

Navigation menu