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
RHEL: How to change a USER/GROUP UID/GID and all owned files
Viewed 2294 times since Sat, Jun 2, 2018
How to schedule crontab in Unix Operating Systems
Viewed 513 times since Fri, Jun 8, 2018
Używanie rsync poprzez Secure Shell
Viewed 836 times since Thu, May 24, 2018
Top 25 Best Linux Performance Monitoring and Debugging Tools
Viewed 1844 times since Sun, Sep 30, 2018
SSH: Execute Remote Command or Script – Linux
Viewed 393 times since Mon, Feb 18, 2019
Super Grub2 Disk
Viewed 651 times since Wed, May 22, 2019
logrotate Understanding logrotate utility
Viewed 256 times since Sun, Jan 12, 2020
OpenSSL: Find Out SSL Key Length – Linux Command Line
Viewed 428 times since Mon, Feb 18, 2019
RHEL: iSCSI target/initiator configuration on RHEL7
Viewed 1283 times since Sat, Jun 2, 2018
How to manage Linux password expiry with the chage command
Viewed 493 times since Tue, Sep 11, 2018