Portable scripting (POSIX compliance) in Bash Scripting - Cheat Sheet & Quick Revision

Recall & Review

beginner

What does POSIX compliance mean in scripting?

POSIX compliance means writing scripts that follow a standard set of rules so they work on many different Unix-like systems without changes.

beginner

Why should you avoid using Bash-specific features in portable scripts?

Because Bash-specific features may not exist in other shells, making the script fail on systems without Bash or with different shells.

beginner

Which shell is commonly used as the standard for POSIX-compliant scripts?

The 'sh' shell is the standard shell for POSIX-compliant scripts.

intermediate

Give an example of a command or syntax to avoid for POSIX compliance.

Avoid using '[[ ... ]]' for tests; instead, use '[ ... ]' which is POSIX compliant.

intermediate

How can you check if your script is POSIX compliant?

You can run your script with 'sh' instead of 'bash' and test it on different Unix-like systems or use tools like 'shellcheck' with POSIX mode.

Which shell should you use to write a POSIX-compliant script?

A sh

B bash

C zsh

D fish

The 'sh' shell is the POSIX standard shell, ensuring portability across systems.

Which test syntax is POSIX compliant?

A [ condition ]

B [[ condition ]]

C (( condition ))

D { condition }

The single bracket [ ] is POSIX compliant; double brackets [[ ]] are Bash-specific.

What is a risk of using Bash-specific features in scripts?

A Script becomes shorter

B Script runs faster

C Script may not run on systems without Bash

D Script uses less memory

Bash-specific features may not be supported on other shells, causing script failure.

Which command helps check shell scripts for POSIX compliance?

A gcc

B shellcheck

C make

D awk

'shellcheck' is a tool that can analyze shell scripts and warn about non-POSIX usage.

What should you do to ensure your script is portable?

A Write scripts only for your machine

B Use Bash-only features

C Use system-specific commands

D Use only POSIX standard commands and syntax

Using POSIX standard commands and syntax ensures the script runs on many systems.

Explain what POSIX compliance means for shell scripting and why it is important.

Think about how scripts run on different systems.

List some common Bash features to avoid when writing POSIX-compliant scripts and suggest POSIX alternatives.

Focus on test syntax and shell features.

Practice

1. Which shebang line is best for writing a portable POSIX-compliant shell script?

easy

A. #!/bin/sh

B. #!/bin/bash

C. #!/usr/bin/env bash

D. #!/bin/zsh

Solution

1. Step 1: Understand shebang purpose

   The shebang line tells the system which shell to use to run the script.

2. Step 2: Identify POSIX-compliant shell

   "/bin/sh" is the standard POSIX shell available on most Unix-like systems, ensuring portability.

3. Final Answer:

   #!/bin/sh -> Option A

4. Quick Check:

   POSIX shell = #!/bin/sh [OK]

Hint: Use #!/bin/sh for best portability across Unix systems [OK]

Common Mistakes:

• Using #!/bin/bash which may not exist on all systems
• Using #!/usr/bin/env bash which depends on env and bash presence
• Using #!/bin/zsh which is not POSIX standard

2. Which of the following is a POSIX-compliant way to write an if statement in a shell script?

easy

A. if [[ $var -eq 1 ]]; then echo yes; fi

B. if [ $var -eq 1 ]; then echo yes; fi

C. if (( $var == 1 )); then echo yes; fi

D. if test $var = 1; then echo yes; fi

Solution

1. Step 1: Identify POSIX test syntax

   POSIX shell supports the single bracket [ ] syntax for tests.

2. Step 2: Check each option

   if [ $var -eq 1 ]; then echo yes; fi uses [ $var -eq 1 ] which is POSIX compliant. if [[ $var -eq 1 ]]; then echo yes; fi uses [[ ]] which is bash-specific. if (( $var == 1 )); then echo yes; fi uses (( )) which is arithmetic syntax in bash. if test $var = 1; then echo yes; fi uses test but with = for numbers, which is string comparison, not numeric.

3. Final Answer:

   if [ $var -eq 1 ]; then echo yes; fi -> Option B

4. Quick Check:

   POSIX if test = [ ] syntax [OK]

Hint: Use single brackets [ ] for tests in POSIX scripts [OK]

Common Mistakes:

• Using [[ ]] which is not POSIX
• Using (( )) arithmetic syntax not POSIX
• Using = for numeric comparison instead of -eq

3. What will be the output of this POSIX-compliant script snippet?

count=3
while [ $count -gt 0 ]; do
  echo $count
  count=$((count - 1))
done

medium

A. 3
2
1

B. 3
2
1
0

C. 1
2
3

D. Error: syntax not supported

Solution

1. Step 1: Understand the loop condition

   The loop runs while count is greater than 0.

2. Step 2: Trace the loop iterations

   Initial count=3, prints 3, decrements to 2; prints 2, decrements to 1; prints 1, decrements to 0; loop ends.

3. Final Answer:

   3 2 1 -> Option A

4. Quick Check:

   Loop prints 3 to 1, stops before 0 [OK]

Hint: Loop runs while count > 0, prints then decrements [OK]

Common Mistakes:

• Expecting 0 to print
• Confusing -gt with -ge
• Thinking $(( )) is not POSIX (it is)

4. This script is intended to print all files in the current directory. What is the error?

for file in $(ls); do
  echo $file
 done

medium

A. The echo command is not POSIX compliant

B. Missing 'do' keyword in the for loop

C. Using $(ls) can break on filenames with spaces

D. Incorrect variable name 'file' used in loop

Solution

1. Step 1: Analyze command substitution usage

   Using $(ls) splits output on whitespace, breaking on filenames with spaces.

2. Step 2: Identify safer alternative

   Using 'for file in *' is POSIX compliant and handles spaces better.

3. Final Answer:

   Using $(ls) can break on filenames with spaces -> Option C

4. Quick Check:

   $(ls) splits on spaces, unsafe for filenames [OK]

Hint: Avoid $(ls); use 'for file in *' for portability [OK]

Common Mistakes:

• Thinking 'do' is missing (it is present)
• Assuming variable name matters
• Believing echo is not POSIX compliant

5. You want to write a POSIX-compliant shell script using only built-in shell commands (no external utilities like grep, cat, wc) that reads lines from a file and counts how many lines contain the word 'error'. Which approach is portable and correct?

hard

A. grep -c 'error' filename

B. for line in $(cat filename); do if echo $line | grep -q 'error'; then count=$((count+1)); fi; done; echo $count

C. cat filename | grep 'error' | wc -l

D. while read line; do case "$line" in *error*) count=$((count+1)) ;; esac; done < filename; echo $count

Solution

1. Step 1: Evaluate each option for POSIX compliance and correctness

   A: grep -c 'error' filename uses external grep utility. C: cat filename | grep 'error' | wc -l uses external cat, grep, wc utilities. B: while read line; do case "$line" in *error*) count=$((count+1)) ;; esac; done < filename; echo $count uses a while read loop with case pattern matching, fully POSIX compliant pure shell and handles lines safely. D: for line in $(cat filename); do if echo $line | grep -q 'error'; then count=$((count+1)); fi; done; echo $count uses for loop over $(cat filename) which breaks on spaces and uses external cat/grep.

2. Step 2: Choose the safest and most portable method

   while read line; do case "$line" in *error*) count=$((count+1)) ;; esac; done < filename; echo $count is the best because it reads line by line safely and uses POSIX shell features only.

3. Final Answer:

   while read line; do case "$line" in *error*) count=$((count+1)) ;; esac; done < filename; echo $count -> Option D

4. Quick Check:

   Line-by-line read with case is portable and safe [OK]

Hint: Use while read and case for safe POSIX line processing [OK]

Common Mistakes:

• Using external grep instead of pure shell constructs
• Using for loop over command substitution breaking on spaces
• Using unnecessary cat in pipelines