1 SC2326

Vidar Holen edited this page 2023-07-30 19:53:02 -07:00

Table of Contents

• ! is not allowed in the middle of pipelines. Use command group as in cmd | { ! cmd; } if necessary.
• Problematic code:
• Correct code:
• Rationale:
• Exceptions:
• Related resources:

! is not allowed in the middle of pipelines. Use command group as in cmd | { ! cmd; } if necessary.

Problematic code:

cat | ! tee /dev/full

Correct code:

Either negate the entire pipeline (this is equivalent unless pipefail is set):

! cat | tee /dev/full

Or use a command group to negate a single stage:

cat | { ! tee /dev/full; }

Rationale:

POSIX specifies that a status negation operator ! is only used to negate the status of an entire pipeline, not individual stages.

By default the status of a pipeline is that of the last command, so use ! in front of the pipeline to negate as necessary.

If you have set the option pipefail to OR the status of each stage together, and want to negate the status of only a single stage, you can use negate inside a { ! command group; }.

Exceptions:

Ksh supports ! in front of individual pipeline stages. ShellCheck does not warn when the shebang declares that the script will run with Ksh.

Related resources:

• Help by adding links to BashFAQ, StackOverflow, man pages, POSIX, etc!

ShellCheck

• Installation

  • CentOS6
  • More Installation Guides

• Usage

  • Directive
  • Ignore

• Integrating and extending

  • Misc. contributions
  • Azure Pipelines
  • Buildkite
  • CircleCI
  • DevGuide
  • Integration
  • JUnit
  • Phabricator
  • TravisCI
  • GitLab CI
  • Drone
  • GitHub Actions

• Severity

• Template

Each individual ShellCheck warning has its own wiki page like SC1000. Use GitHub Wiki's "Pages" feature above to find a specific one, or see Checks.