Terminal basics · Lesson 30 of 34 · 8 minutes

Output capture contract

Print a predictable marker, capture it, and read it back.

Open the lab Course map

Mastery 0/3Run itExplain itApply it

learner@clairos:~ $

↑ history · Tab complete · Ctrl+C cancel · Esc, Tab to leaveExit 0

Your objectives

Hints are always available. Wrong turns never cost XP.

1
Capture a terminal marker
Run printf terminal-ready | tee lab/terminal-ready.txt.
Hint & worked example
Format data deliberately, including separators and final newlines. Copy a stream both to a file and standard output; -a appends.
The command outcome must match the task, including successful access or the explicitly requested failure.
```
printf terminal-ready | tee lab/terminal-ready.txt
```
Remember: A format string controls output; a newline is data, not an automatic guarantee. tee can overwrite a file even though the output is also visible on screen.
2
Read the captured marker
Run cat lab/terminal-ready.txt.
Hint & worked example
Read one or more files to standard output without editing their contents.
The command outcome must match the task, including successful access or the explicitly requested failure.
```
cat lab/terminal-ready.txt
```
Remember: Reading a source file should precede changing it; avoid printing real secrets.
3
Count the captured output
Run wc -l lab/terminal-ready.txt.
Hint & worked example
Count input. -l counts newline characters, -w counts whitespace-delimited words, and -c counts bytes.
The command outcome must match the task, including successful access or the explicitly requested failure.
```
wc -l lab/terminal-ready.txt
```
Remember: Text without a final newline may have fewer counted lines than visible rows.

Understand the pattern

Proving where command output was written helps operators explain what they know before they change anything.

printf: Format data deliberately, including separators and final newlines.
A format string controls output; a newline is data, not an automatic guarantee.
tee: Copy a stream both to a file and standard output; -a appends.
tee can overwrite a file even though the output is also visible on screen.
cat: Read one or more files to standard output without editing their contents.
Reading a source file should precede changing it; avoid printing real secrets.
wc: Count input. -l counts newline characters, -w counts whitespace-delimited words, and -c counts bytes.
Text without a final newline may have fewer counted lines than visible rows.

Worked example and expected result

$ printf terminal-ready | tee lab/terminal-ready.txt

terminal-ready

Exit status: 0. The command completed successfully in the training fixture.

$ cat lab/terminal-ready.txt

terminal-ready

Exit status: 0. The command completed successfully in the training fixture.

$ wc -l lab/terminal-ready.txt

0 lab/terminal-ready.txt

Exit status: 0. The command completed successfully in the training fixture.

Try a variation

Repeat this workflow in the sandbox with a different scratch filename. Keep the system fixtures unchanged and compare the observed output with your expectation before moving on.

Explain it

In “Output capture contract”, which interpretation is safe?Reading a source file should precede changing it; avoid printing real secrets.A command appearing in history proves it completed successfully.A successful first check guarantees that every dependent service is healthy.

Apply it elsewhere

Before adapting the cat workflow from “Output capture contract” to another server, what should you do?Paste the training paths unchanged into production.Skip output inspection whenever the command is familiar.Confirm the current directory, target identity, permissions, and the installed command behavior first.

Keep the momentum.

Complete the lab, then explain and apply the pattern.

Next: Absolute and relative path report Try an incident drill

Anonymous lesson and mastery progress lasts for this session. Sign in to keep synced lesson XP between sessions; mastery stays device-local. No speed bonus, lost lives, or hint penalties.

Keep learning

GNU Coreutils manual · GNU Bash manual