NAME

       checkbashisms - check for bashisms in /bin/sh scripts

SYNOPSIS

       checkbashisms script ...
       checkbashisms --help|--version

DESCRIPTION

       checkbashisms,  based  on one of the checks from the lintian system, performs basic checks
       on /bin/sh shell scripts for the possible presence of bashisms.  It takes the names of the
       shell scripts on the command line, and outputs warnings if possible bashisms are detected.

       Note  that the definition of a bashism in this context roughly equates to "a shell feature
       that is not required to be supported by POSIX"; this means that some issues flagged may be
       permitted under optional sections of POSIX, such as XSI or User Portability.

       In  cases  where  POSIX  and  Debian  Policy  disagree,  checkbashisms  by  default allows
       extensions permitted by Policy but may also provide options for stricter checking.

OPTIONS

       --help, -h
              Show a summary of options.

       --newline, -n
              Check for "echo -n" usage (non POSIX but required by Debian Policy 10.4.)

       --posix, -p
              Check for issues which are non POSIX but required to be supported by Debian  Policy
              10.4 (implies -n).

       --force, -f
              Force each script to be checked, even if it would normally not be (for instance, it
              has a bash or non POSIX shell shebang or appears to be a shell wrapper).

       --lint, -l
              Act like a linter, for integration into a text editor. Possible  bashisms  will  be
              printed in stdout, like so:

              {filename}:{lineno}:1: warning: possible bashism; {explanation}

       --extra, -x
              Highlight  lines  which,  whilst  they  do  not  contain bashisms, may be useful in
              determining whether a particular issue is a false positive which  may  be  ignored.
              For  example, the use of "$BASH_ENV" may be preceded by checking whether "$BASH" is
              set.

       --early-fail, -e
              Exit right after a first error is seen.

       --version, -v
              Show version and copyright information.

EXIT VALUES

       The exit value will be 0  if  no  possible  bashisms  or  other  problems  were  detected.
       Otherwise it will be the sum of the following error values:

       1      A possible bashism was detected.

       2      A  file  was skipped for some reason, for example, because it was unreadable or not
              found.  The warning message will give details.

       4      No bashisms were detected in a bash script.

SEE ALSO

       lintian(1)

AUTHOR

       checkbashisms was originally written as a shell script by Yann Dirson  <dirson@debian.org>
       and rewritten in Perl with many more features by Julian Gilbey <jdg@debian.org>.