vmail-stack/bin/vmail-forwards-get.sh

#!/bin/bash
#
# vmail-stack
# https://git.stack-source.com/msb/vmail-stack
# Copyright (c) 2022 Matthew Saunders Brown <matthewsaundersbrown@gmail.com>
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)

# load include file
source $(dirname $0)/vmail.sh

help()
{
  thisfilename=$(basename -- "$0")
  echo "$thisfilename"
  echo "Get email forwards data from vmail database."
  echo ""
  echo "usage: $thisfilename [-e email|-f forward|-d domain] [-c] [-t] [-h]"
  echo ""
  echo "  -h            Print this help."
  echo "  -e <email>    Email address to get forwarding for."
  echo "  -f <forward>  Return info for specific forward."
  echo "  -d <domain>   Get all forwards for specified domain."
  echo "  -c            Output in csv format."
  echo "  -t            Use tabs instead of tables for output, do not display column headers."
  echo ""
  echo "                Search term is optional. If nothing specified all forwards for all email acccounts for all domains will be returned."
  echo "                Enter email address to get forward info for that email address."
  echo "                Enter forwarding address (in full email address format) with the -f option to get address(es) that forward to specified address."
  echo "                Enter domain name to get all forwards for all email addresses under that domain."
  exit
}

vmail:getoptions "$@"

# set initial db query data
dbcmd="mysql --defaults-extra-file=$MYSQL_CONNECTION_INFO_FILE"
dbcmdopts="-e"
dbquery="SELECT mbox, domain, forward_to, save_local FROM vm_forwards"
#  AND vm_forwards.forward_to='$mbox@$domain'"
# build query
if [[ -n $forward ]]; then
  # search for specific forward to address
  dbquery="$dbquery WHERE forward_to='$forward'"
elif [[ -n $domain ]]; then
  # add specific domain
  dbquery="$dbquery WHERE domain='$domain'"
  if [[ -n "$mbox" ]]; then
    # search for forward for specific email address
    dbquery="$dbquery AND mbox='$mbox'"
  fi
fi

# set order by
dbquery="$dbquery ORDER BY domain, mbox, forward_to;";

# execute mysql query
eval $dbcmd $dbcmdopts "\"$dbquery\"" $csv