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
How to find your System details using inxi
Viewed 1450 times since Sat, Jun 2, 2018
Viewed 734 times since Fri, Jul 27, 2018
HowTo: Send Email from an SMTP Server using the Command Line
Viewed 644 times since Mon, Feb 18, 2019
How to Configure ‘FirewallD’ in RHEL/CentOS 7 and Fedora 21
Viewed 1048 times since Wed, Oct 9, 2019
FIO (Flexible I/O) – a benchmark tool for any operating system
Viewed 782 times since Wed, Jul 25, 2018
RHCS6: ’fencing’ basics
Viewed 969 times since Sun, Jun 3, 2018
How to use yum-cron to automatically update RHEL/CentOS Linux 6.x / 7.x
Viewed 2024 times since Tue, Dec 4, 2018
Linux Network (TCP) Performance Tuning with Sysctl
Viewed 4496 times since Fri, Aug 3, 2018
Top 20 OpenSSH Server Best Security Practices - good article
Viewed 801 times since Mon, Oct 1, 2018
RHEL: Crash kernel dumps configuration and analysis on RHEL 5
Viewed 1533 times since Sat, Jun 2, 2018