Linux – How to check the exit status of several piped commands

As piping in bash commands is common and very usefull, controling the exit status of each piped commands in bash scripting can be vital, especially for backups.

I was checking by a customer the backups of a critical MySQL instance and was surprised even stunned that the return status of all of them was always  successfull when tested but physically on disk, the dumps were all empty.
No valid backups since a long time meaning no possible recovery.
Oups! How can it be?
I immediately opened the backup script with “vi” and had a look to the used statement which was the following:
mysqldump -u $USERNAME -p $PASS $DBNAME | bzip2 -9c -c > Dump.sql.gz
Now, what if the backup failed and the bzip2 command succeeded?
In fact, the exit status will be the one of the last command.
echo $?

And this will be always successfull.

So, the  solution to check the exit status of a particular command in piped commands is to use an inbuilt linux variable called  PIPESTATUS.
PIPESTATUS is an array variable which contain the exit status of every piped commands.
In our case,
echo ${PIPESTATUS[0]} will refer to the backup  and will be greater than 0 if it fails
echo ${PIPESTATUS[1]} will refer to the compression
echo ${PIPESTATUS[*]} or echo ${PIPESTATUS[@]} will give you the status of both.
So, one solution in our example could be:
mysqldump -u $USERNAME -p $PASS $DBNAME | bzip2 -9c -c > Dump.sql.gz
if [ ${PIPESTATUS[0]} -ne "0" ]
    echo "the MySQL Database backup failed with Error: ${PIPESTATUS[0]}";
    echo "The MySQL Database backup was successfull!";
0 (0)
Article Rating (No Votes)
Rate this article
There are no attachments for this article.
There are no comments for this article. Be the first to post a comment.
Full Name
Email Address
Security Code Security Code
Related Articles RSS Feed
Logowanie za pomocą kluczy Secure Shell
Viewed 865 times since Thu, May 24, 2018
Top 20 OpenSSH Server Best Security Practices - good article
Viewed 562 times since Mon, Oct 1, 2018
Using IOzone for Linux disk performance analysis
Viewed 2407 times since Wed, Jul 25, 2018
Linux File Systems (mkfs, mount, fstab) ext4
Viewed 801 times since Sat, Jun 2, 2018
SSH Essentials: Working with SSH Servers, Clients, and Keys
Viewed 1141 times since Wed, Jun 27, 2018
Learn how to align an SSD on Linux
Viewed 99 times since Fri, May 15, 2020
logrotate How log rotation works with logrotate
Viewed 751 times since Sun, Jan 12, 2020
RHEL: Allowing users to ’su’ to "root" / Allowing ’root’ to login directly to the system using ’ssh’
Viewed 898 times since Sat, Jun 2, 2018
Przekazywanie portów TCP rinetd
Viewed 1951 times since Thu, May 24, 2018
LVM basic
Viewed 725 times since Sat, Jun 2, 2018