test/scripts/socket_test.sh

   1 #! /bin/bash
   2 #
   3 # socket_test.sh -- script to run socket tests.
   4 #
   5 script_dir="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
   6 vpp_dir="$WS_ROOT/build-root/install-vpp-native/vpp/bin/"
   7 vpp_debug_dir="$WS_ROOT/build-root/install-vpp_debug-native/vpp/bin/"
   8 vpp_shm_dir="/dev/shm/"
   9 vpp_run_dir="/run/vpp"
  10 lib64_dir="$WS_ROOT/build-root/install-vpp-native/vpp/lib64/"
  11 lib64_debug_dir="$WS_ROOT/build-root/install-vpp_debug-native/vpp/lib64/"
  12 dpdk_devbind="/usr/share/dpdk/usertools/dpdk-devbind.py"
  13 docker_vpp_dir="/vpp/"
  14 docker_app_dir="/vpp/"
  15 docker_lib64_dir="/vpp-lib64/"
  16 docker_os="ubuntu"
  17 vcl_ldpreload_lib="libvcl_ldpreload.so.0.0.0"
  18 user_gid="$(id -g)"
  19 vpp_app="vpp"
  20 sock_srvr_app="sock_test_server"
  21 sock_clnt_app="sock_test_client"
  22 sock_srvr_addr="127.0.0.1"
  23 sock_srvr_port="22000"
  24 iperf_srvr_app="iperf3 -V4d -s"
  25 iperf_clnt_app="iperf3 -V4d -c \$srvr_addr"
  26 gdb_in_emacs="gdb_in_emacs"
  27 vcl_config="vcl.conf"
  28 vcl_config_dir="$WS_ROOT/src/vcl/"
  29 docker_vcl_config_dir="/etc/vpp/"
  30 xterm_geom="100x60"
  31 bash_header="#! /bin/bash"
  32 tmp_cmdfile_prefix="/tmp/socket_test_cmd"
  33 cmd1_file="${tmp_cmdfile_prefix}1.$$"
  34 cmd2_file="${tmp_cmdfile_prefix}2.$$"
  35 cmd3_file="${tmp_cmdfile_prefix}3.$$"
  36 vpp_eth_name="enp0s8"
  37 tmp_vpp_exec_file="/tmp/vpp_config.$$"
  38 tmp_gdb_cmdfile_prefix="/tmp/gdb_cmdfile"
  39 def_gdb_cmdfile_prefix="$WS_ROOT/extras/gdb/gdb_cmdfile"
  40 tmp_gdb_cmdfile_vpp="${tmp_gdb_cmdfile_prefix}_vpp.$$"
  41 tmp_gdb_cmdfile_client="${tmp_gdb_cmdfile_prefix}_vcl_client.$$"
  42 tmp_gdb_cmdfile_server="${tmp_gdb_cmdfile_prefix}_vcl_server.$$"
  43 get_docker_server_ip4addr='srvr_addr=$(docker network inspect bridge | grep IPv4Address | awk -e '\''{print $2}'\'' | sed -e '\''s,/16,,'\'' -e '\''s,",,g'\'' -e '\''s/,//'\'')'
  44 #' single quote to fix the confused emacs colorizer.
  45 trap_signals="SIGINT SIGTERM EXIT"
  46
  47 # Set default values for imported environment variables if they don't exist.
  48 #
  49 VPP_GDB_CMDFILE="${VPP_GDB_CMDFILE:-${def_gdb_cmdfile_prefix}.vpp}"
  50 VPPCOM_CLIENT_GDB_CMDFILE="${VPPCOM_CLIENT_GDB_CMDFILE:-${def_gdb_cmdfile_prefix}.vppcom_client}"
  51 VPPCOM_SERVER_GDB_CMDFILE="${VPPCOM_SERVER_GDB_CMDFILE:-${def_gdb_cmdfile_prefix}.vppcom_server}"
  52
  53 usage() {
  54     cat <<EOF
  55 Usage: socket_test.sh OPTIONS TEST
  56 TESTS:
  57   nk, native-kernel   Run server & client on host using kernel.
  58   nv, native-vcl      Run vpp, server & client on host using VppComLib.
  59   np, native-preload  Run vpp, server & client on host using LD_PRELOAD.
  60   dk, docker-kernel   Run server & client in docker using kernel stack.
  61   dv, docker-vcl      Run vpp on host, server & client in docker using VppComLib.
  62   dp, docker-preload  Run vpp on host, server & client in docker using LD_PRELOAD.
  63
  64 OPTIONS:
  65   -h                  Print this usage text.
  66   -l                  Leave ${tmp_cmdfile_prefix}* files after test run.
  67   -b                  Run bash after application exit.
  68   -d                  Run the vpp_debug version of all apps.
  69   -c                  Set VCL_CONFIG to use the vcl_test.conf file.
  70   -i                  Run iperf3 for client/server app in native tests.
  71   -n                  Name of ethernet for VPP to use in multi-host cfg.
  72   -6                  Use ipv6 addressing.
  73   -f                  Full thru host stack vpp configuration.
  74   -m c[lient]         Run client in multi-host cfg (server on remote host)
  75      s[erver]         Run server in multi-host cfg (client on remote host)
  76   -e a[ll]            Run all in emacs+gdb.
  77      c[lient]         Run client in emacs+gdb.
  78      s[erver]         Run server in emacs+gdb.
  79      v[pp]            Run vpp in emacs+gdb.
  80   -g a[ll]            Run all in gdb.
  81      c[lient]         Run client in gdb.
  82      s[erver]         Run server in gdb.
  83      v[pp]            Run vpp in gdb.
  84   -t                  Use tabs in one xterm if available (e.g. xfce4-terminal).
  85
  86 OPTIONS passed to client/server:
  87   -S <ip address>     Server IP address.
  88   -P <server port>    Server Port number.
  89   -E <data>           Run Echo test.
  90   -N <num-writes>     Test Cfg: number of writes.
  91   -R <rxbuf-size>     Test Cfg: rx buffer size.
  92   -T <txbuf-size>     Test Cfg: tx buffer size.
  93   -U                  Run Uni-directional test.
  94   -B                  Run Bi-directional test.
  95   -I <num-tst-socks>  Send data over multiple test sockets in parallel.
  96   -V                  Test Cfg: Verbose mode.
  97   -X                  Exit client/server after running test.
  98
  99 Environment variables:
 100   VCL_CONFIG                Pathname of vppcom configuration file.
 101   VPP_GDB_CMDFILE            Pathname of gdb command file for vpp.
 102   VPPCOM_CLIENT_GDB_CMDFILE  Pathname of gdb command file for client.
 103   VPPCOM_SERVER_GDB_CMDFILE  Pathname of gdb command file for server.
 104 EOF
 105     exit 1
 106 }
 107
 108 declare -i emacs_vpp=0
 109 declare -i emacs_client=0
 110 declare -i emacs_server=0
 111 declare -i gdb_vpp=0
 112 declare -i gdb_client=0
 113 declare -i gdb_server=0
 114 declare -i perf_vpp=0
 115 declare -i perf_client=0
 116 declare -i perf_server=0
 117 declare -i leave_tmp_files=0
 118 declare -i bash_after_exit=0
 119 declare -i iperf3=0
 120 declare -i use_ipv6=0
 121
 122 while getopts ":hitlbcd6fn:m:e:g:p:E:I:N:P:R:S:T:UBVX" opt; do
 123     case $opt in
 124         h) usage ;;
 125         l) leave_tmp_files=1
 126            ;;
 127         b) bash_after_exit=1
 128            ;;
 129         i) iperf3=1
 130            ;;
 131         6) use_ipv6=1
 132            ;;
 133         f) full_thru_host_stack_vpp_cfg=1
 134            ;;
 135         t) xterm_geom="180x40"
 136            use_tabs="true"
 137            ;;
 138         c) VCL_CONFIG="${vcl_config_dir}vcl_test.conf"
 139            ;;
 140         d) title_dbg="-DEBUG"
 141            vpp_dir=$vpp_debug_dir
 142            lib64_dir=$lib64_debug_dir
 143            ;;
 144         e) if [ $OPTARG = "a" ] || [ $OPTARG = "all" ] ; then
 145                emacs_client=1
 146                emacs_server=1
 147                emacs_vpp=1
 148            elif [ $OPTARG = "c" ] || [ $OPTARG = "client" ] ; then
 149                emacs_client=1
 150            elif [ $OPTARG = "s" ] || [ $OPTARG = "server" ] ; then
 151                emacs_server=1
 152            elif [ $OPTARG = "v" ] || [ $OPTARG = "vpp" ] ; then
 153                emacs_vpp=1
 154            else
 155                echo "ERROR: Option -e unknown argument \'$OPTARG\'" >&2
 156                usage
 157            fi
 158            title_dbg="-DEBUG"
 159            vpp_dir=$vpp_debug_dir
 160            lib64_dir=$lib64_debug_dir
 161            ;;
 162         n) vpp_eth_name="$OPTARG"
 163            ;;
 164         m) if [ $OPTARG = "c" ] || [ $OPTARG = "client" ] ; then
 165                multi_host="client"
 166            elif [ $OPTARG = "s" ] || [ $OPTARG = "server" ] ; then
 167                multi_host="server"
 168            else
 169                echo "ERROR: Option -e unknown argument \'$OPTARG\'" >&2
 170                usage
 171            fi
 172            ;;
 173         g) if [ $OPTARG = "a" ] || [ $OPTARG = "all" ] ; then
 174                gdb_client=1
 175                gdb_server=1
 176                gdb_vpp=1
 177            elif [ $OPTARG = "c" ] || [ $OPTARG = "client" ] ; then
 178                gdb_client=1
 179            elif [ $OPTARG = "s" ] || [ $OPTARG = "server" ] ; then
 180                gdb_server=1
 181            elif [ $OPTARG = "v" ] || [ $OPTARG = "vpp" ] ; then
 182                gdb_vpp=1
 183            else
 184                echo "ERROR: Option -g unknown argument \'$OPTARG\'" >&2
 185                usage
 186            fi
 187            ;;
 188         p) if [ $OPTARG = "a" ] || [ $OPTARG = "all" ] ; then
 189                perf_client=1
 190                perf_server=1
 191                perf_vpp=1
 192            elif [ $OPTARG = "c" ] || [ $OPTARG = "client" ] ; then
 193                perf_client=1
 194            elif [ $OPTARG = "s" ] || [ $OPTARG = "server" ] ; then
 195                perf_server=1
 196            elif [ $OPTARG = "v" ] || [ $OPTARG = "vpp" ] ; then
 197                perf_vpp=1
 198            else
 199                echo "ERROR: Option -p unknown argument \'$OPTARG\'" >&2
 200                usage
 201            fi
 202            echo "WARNING: -p options TBD"
 203            ;;
 204         S) sock_srvr_addr="$OPTARG"
 205            ;;
 206         P) sock_srvr_port="$OPTARG"
 207            ;;
 208 E|I|N|R|T) sock_clnt_options="$sock_clnt_options -$opt \"$OPTARG\""
 209            ;;
 210   U|B|V|X) sock_clnt_options="$sock_clnt_options -$opt"
 211            ;;
 212        \?)
 213            echo "ERROR: Invalid option: -$OPTARG" >&2
 214            usage
 215            ;;
 216         :)
 217            echo "ERROR: Option -$OPTARG requires an argument." >&2
 218            usage
 219            ;;
 220     esac
 221 done
 222
 223 shift $(( $OPTIND-1 ))
 224 while ! [[ $run_test ]] && (( $# > 0 )) ; do
 225     case $1 in
 226         "nk" | "native-kernel")
 227             run_test="native_kernel" ;;
 228         "np" | "native-preload")
 229             run_test="native_preload" ;;
 230         "nv" | "native-vcl")
 231             sock_srvr_app="vcl_test_server"
 232             sock_clnt_app="vcl_test_client"
 233             run_test="native_vcl" ;;
 234         "dk" | "docker-kernel")
 235             run_test="docker_kernel" ;;
 236         "dp" | "docker-preload")
 237             run_test="docker_preload" ;;
 238         "dv" | "docker-vcl")
 239             sock_srvr_app="vcl_test_server"
 240             sock_clnt_app="vcl_test_client"
 241             run_test="docker_vcl" ;;
 242         *)
 243             echo "ERROR: Unknown option '$1'!" >&2
 244             usage ;;
 245     esac
 246     shift
 247 done
 248
 249 if [ -z "$VCL_DEBUG" ] ; then
 250     if [ "$title_dbg" = "-DEBUG" ] ; then
 251         VCL_DEBUG=1
 252     else
 253         VCL_DEBUG=0
 254     fi
 255 fi
 256
 257 VCL_LDPRELOAD_LIB_DIR="${VCL_LDPRELOAD_LIB_DIR:-$lib64_dir}"
 258
 259 if [ -z "$WS_ROOT" ] ; then
 260     echo "ERROR: WS_ROOT environment variable not set!" >&2
 261     echo "       Please set WS_ROOT to VPP workspace root directory." >&2
 262     exit 1
 263 fi
 264
 265 if [[ "$(grep bin_PROGRAMS $WS_ROOT/src/vcl.am)" = "" ]] ; then
 266     $WS_ROOT/extras/vagrant/vcl_test.sh $WS_ROOT $USER
 267     (cd $WS_ROOT; make build)
 268 fi
 269
 270 if [ ! -d $vpp_dir ] ; then
 271     echo "ERROR: Missing VPP$title_dbg bin directory!" >&2
 272     echo "       $vpp_dir" >&2
 273     env_test_failed="true"
 274 fi
 275
 276 if [[ $run_test =~ .*"_preload" ]] ; then
 277    if [ ! -d $lib64_dir ] ; then
 278        echo "ERROR: Missing VPP$title_dbg lib64 directory!" >&2
 279        echo "       $lib64_dir" >&2
 280    elif [ ! -d $VCL_LDPRELOAD_LIB_DIR ] ; then
 281        echo "ERROR: Missing VCL LD_PRELOAD Library directory!" >&2
 282        echo "       $VCL_LDPRELOAD_LIB_DIR" >&2
 283        env_test_failed="true"
 284    elif [ ! -f $VCL_LDPRELOAD_LIB_DIR/$vcl_ldpreload_lib ] ; then
 285        echo "ERROR: Missing VCL LD_PRELOAD library!" >&2
 286        echo "       $VCL_LDPRELOAD_LIB_DIR/$vcl_ldpreload_lib" >&2
 287        env_test_failed="true"
 288    fi
 289 fi
 290
 291 if [ ! -f $vpp_dir$vpp_app ] ; then
 292     echo "ERROR: Missing VPP$title_dbg Application!" >&2
 293     echo "       $vpp_dir$vpp_app" >&2
 294     env_test_failed="true"
 295 fi
 296
 297 if [ ! -f $vpp_dir$sock_srvr_app ] && [ ! $iperf3 -eq 1 ] ; then
 298     echo "ERROR: Missing$title_dbg Socket Server Application!" >&2
 299     echo "       $vpp_dir$sock_srvr_app" >&2
 300     env_test_failed="true"
 301 fi
 302
 303 if [ ! -f $vpp_dir$sock_clnt_app ] && [ ! $iperf3 -eq 1 ] ; then
 304     echo "ERROR: Missing$title_dbg Socket Client Application!" >&2
 305     echo "       $vpp_dir$sock_clnt_app" >&2
 306     env_test_failed="true"
 307 fi
 308
 309 if [[ $run_test =~ "docker_".* ]] ; then
 310     if [ $emacs_client -eq 1 ] || [ $emacs_server -eq 1 ] || [ $gdb_client -eq 1 ] || [ $gdb_server -eq 1 ] ; then
 311
 312         echo "WARNING: gdb is not currently supported in docker."
 313         echo "         Ignoring client/server gdb options."
 314         emacs_client=0
 315         emacs_server=0
 316         gdb_client=0
 317         gdb_server=0
 318     fi
 319 fi
 320
 321 if [[ $run_test =~ .*"_vcl" ]] && [ $iperf3 -eq 1 ] ; then
 322     echo "ERROR: Invalid option 'i' for test $run_test!"
 323     echo "       iperf3 is not compiled with the VCL library."
 324     env_test_failed="true"
 325 fi
 326
 327 if [ -n "$multi_host"] && [ ! -f "$dpdk_devbind" ] ; then
 328     echo "ERROR: Can't find dpdk-devbind.py!"
 329     echo "       Run \"cd \$WS_ROOT; make dpdk-install-dev\" to install it."
 330     echo
 331     env_test_failed="true"
 332 fi
 333
 334 if [ -n "$full_thru_host_stack_vpp_cfg" ] && [ -n "$multi_host" ] ; then
 335     echo "ERROR: Invalid options, cannot specify both \"-f\" and \"-m $multi_host\"!"
 336     echo
 337     env_test_failed="true"
 338 fi
 339
 340 if [ -n "$env_test_failed" ] ; then
 341     exit 1
 342 fi
 343
 344 if [ -f "$VCL_CONFIG" ] ; then
 345     vcl_config="$(basename $VCL_CONFIG)"
 346     vcl_config_dir="$(dirname $VCL_CONFIG)/"
 347     api_prefix="$(egrep -s '^\s*api-prefix \w+' $VCL_CONFIG | tail -1 | awk -e '{print $2}')"
 348     if [ -n "$api_prefix" ] ; then
 349         api_segment=" api-segment { gid $user_gid prefix $api_prefix }"
 350     fi
 351 fi
 352 if [ -n "$VCL_APP_NAMESPACE_ID" ] && [ -n "$VCL_APP_NAMESPACE_SECRET" ] ; then
 353     namespace_id="$VCL_APP_NAMESPACE_ID"
 354     namespace_secret="$VCL_APP_NAMESPACE_SECRET"
 355 fi
 356
 357 if [ -z "$api_segment" ] ; then
 358     api_segment=" api-segment { gid $user_gid }"
 359 fi
 360 vpp_args="unix { interactive full-coredump coredump-size unlimited exec $tmp_vpp_exec_file}${api_segment}"
 361
 362 if [ $iperf3 -eq 1 ] ; then
 363     app_dir="$(dirname $(which iperf3))/"
 364     srvr_app=$iperf_srvr_app
 365     clnt_app=$iperf_clnt_app
 366     if [[ $run_test =~ "docker_".* ]] ; then
 367         unset -v app_dir
 368         sock_srvr_port=5201
 369         docker_app_dir="networkstatic/"
 370         unset -v docker_os
 371     fi
 372 else
 373     app_dir="$vpp_dir"
 374     srvr_app="$sock_srvr_app $sock_srvr_port"
 375     clnt_app="$sock_clnt_app${sock_clnt_options} \$srvr_addr $sock_srvr_port"
 376 fi
 377
 378
 379 verify_no_vpp() {
 380     local grep_for_vpp="ps -eaf|grep -v grep|grep \"bin/vpp\""
 381
 382     if [ -n "$api_prefix" ] ; then
 383         grep_for_vpp="$grep_for_vpp|grep \"prefix $api_prefix\""
 384     fi
 385     local running_vpp="$(eval $grep_for_vpp)"
 386     if [ -n "$running_vpp" ] ; then
 387         echo "ERROR: Please kill the following vpp instance(s):"
 388         echo
 389         echo $running_vpp
 390         echo
 391         exit 1
 392     fi
 393     clean_devshm="$vpp_shm_dir*db $vpp_shm_dir*global_vm $vpp_shm_dir*vpe-api $vpp_shm_dir[0-9]*-[0-9]* $vpp_shm_dir*:segment[0-9]*"
 394     sudo rm -f $clean_devshm
 395     devshm_files="$(ls -l $clean_devshm 2>/dev/null | grep $(whoami))"
 396     if [ "$devshm_files" != "" ] ; then
 397         echo "ERROR: Please remove the following $vpp_shm_dir files:"
 398         for file in "$devshm_files" ; do
 399             echo "  $file"
 400         done
 401         exit 1
 402     fi
 403     if [ ! -d "$vpp_run_dir" ] ; then
 404         sudo mkdir $vpp_run_dir
 405         sudo chown root:$USER $vpp_run_dir
 406     fi
 407     if [ -n "$full_thru_host_stack_vpp_cfg" ] ; then
 408         sock_srvr_addr=172.16.1.1
 409         client_namespace_id="1"
 410         client_namespace_secret="5678"
 411         server_namespace_id="0"
 412         server_namespace_secret="1234"
 413         cat <<EOF >> $tmp_vpp_exec_file
 414 session enable
 415 create loop inter
 416 create loop inter
 417 set inter state loop0 up
 418 set inter ip table loop0 0
 419 set inter ip address loop0 172.16.1.1/24
 420 set inter state loop1 up
 421 set inter ip table loop1 1
 422 set inter ip address loop1 172.16.2.1/24
 423 app ns add id 0 secret 1234 sw_if_index 1
 424 app ns add id 1 secret 5678 sw_if_index 2
 425 ip route add 172.16.1.1/32 table 1 via lookup in table 0
 426 ip route add 172.16.2.1/32 table 0 via lookup in table 1
 427 EOF
 428
 429     elif [ -n "$multi_host" ] ; then
 430         vpp_eth_pci_id="$(ls -ld /sys/class/net/$vpp_eth_name/device | awk '{print $11}' | cut -d/ -f4)"
 431         if [ -z "$vpp_eth_pci_id" ] ; then
 432             echo "ERROR: Missing ethernet interface $vpp_eth_name!"
 433             usage
 434         fi
 435         printf -v bus "%x" "0x$(echo $vpp_eth_pci_id | cut -d: -f2)"
 436         printf -v slot "%x" "0x$(echo $vpp_eth_pci_id | cut -d: -f3 | cut -d. -f1)"
 437         printf -v func "%x" "0x$(echo $vpp_eth_pci_id | cut -d. -f2)"
 438
 439         vpp_eth_kernel_driver="$(basename $(ls -l /sys/bus/pci/devices/$vpp_eth_pci_id/driver | awk '{print $11}'))"
 440         if [ -z "$vpp_eth_kernel_driver" ] ; then
 441             echo "ERROR: Missing kernel driver for $vpp_eth_name!"
 442             usage
 443         fi
 444         case $vpp_eth_kernel_driver in
 445             e1000)
 446                 vpp_eth_ifname="GigabitEthernet$bus/$slot/$func" ;;
 447             ixgbe)
 448                 vpp_eth_ifname="TenGigabitEthernet$bus/$slot/$func" ;;
 449             i40e)
 450                 vpp_eth_ifname="FortyGigabitEthernet$bus/$slot/$func" ;;
 451             *)
 452                 echo "ERROR: Unknown ethernet kernel driver $vpp_eth_kernel_driver!"
 453                 usage ;;
 454         esac
 455
 456         vpp_eth_ip4_addr="$(ip -4 -br addr show $vpp_eth_name | awk '{print $3}')"
 457         if [ -z "$vpp_eth_ip4_addr" ] ; then
 458             if [ "$multi_host" = "server" ] ; then
 459                 vpp_eth_ip4_addr="10.10.10.10/24"
 460             else
 461                 vpp_eth_ip4_addr="10.10.10.11/24"
 462             fi
 463         fi
 464         if [ $use_ipv6 -eq 1 ] && [ -z "$vpp_eth_ip6_addr" ] ; then
 465             echo "ERROR: No inet6 address configured for $vpp_eth_name!"
 466             usage
 467         fi
 468         vpp_args="$vpp_args plugins { path ${lib64_dir}vpp_plugins } dpdk { dev $vpp_eth_pci_id }"
 469
 470         sudo ifconfig $vpp_eth_name down 2> /dev/null
 471         echo "Configuring VPP to use $vpp_eth_name ($vpp_eth_pci_id), inet addr $vpp_eth_ip4_addr"
 472
 473         cat <<EOF >> $tmp_vpp_exec_file
 474 set int state $vpp_eth_ifname up
 475 set int ip addr $vpp_eth_ifname $vpp_eth_ip4_addr
 476 EOF
 477
 478     fi
 479
 480     if [ -z "$full_thru_host_stack_vpp_cfg" ] && [ -n "$namespace_id" ] ; then
 481         cat <<EOF >> $tmp_vpp_exec_file
 482 session enable
 483 app ns add id $namespace_id secret $namespace_secret sw_if_index 0
 484 EOF
 485     fi
 486
 487     cat <<EOF >> $tmp_vpp_exec_file
 488 show version
 489 show version verbose
 490 show cpu
 491 show int
 492 EOF
 493 }
 494
 495 verify_no_docker_containers() {
 496     if (( $(which docker | wc -l) < 1 )) ; then
 497         echo "ERROR: docker is not installed!"
 498         echo "See https://docs.docker.com/engine/installation/linux/ubuntu/"
 499         echo " or https://docs.docker.com/engine/installation/linux/centos/"
 500         exit 1
 501     fi
 502     if (( $(docker ps | wc -l) > 1 )) ; then
 503         echo "ERROR: Run the following to kill all docker containers:"
 504         echo "docker kill \$(docker ps -q)"
 505         echo
 506         docker ps
 507         exit 1
 508     fi
 509 }
 510
 511 set_pre_cmd() {
 512     # arguments
 513     #   $1 : emacs flag
 514     #   $2 : gdb flag
 515     #   $3 : optional LD_PRELOAD library pathname
 516     local -i emacs=$1
 517     local -i gdb=$2
 518
 519     if [ $emacs -eq 1 ] ; then
 520         write_gdb_cmdfile $tmp_gdb_cmdfile $gdb_cmdfile $emacs $3
 521         pre_cmd="$gdb_in_emacs "
 522     elif [ $gdb -eq 1 ] ; then
 523         write_gdb_cmdfile $tmp_gdb_cmdfile $gdb_cmdfile $emacs $3
 524         pre_cmd="gdb -x $tmp_gdb_cmdfile --args "
 525     elif [ -z $3 ] ; then
 526         unset -v pre_cmd
 527     else
 528         docker_ld_preload="-e LD_PRELOAD=$3 "
 529         pre_cmd="LD_PRELOAD=$3 "
 530     fi
 531 }
 532
 533 write_script_header() {
 534     # arguments
 535     #   $1 : command script file
 536     #   $2 : gdb command file
 537     #   $3 : title
 538     #   $4 : optional command string (typically "sleep 2")
 539     echo "$bash_header" > $1
 540     echo -e "#\n# $1 generated on $(date)\n#" >> $1
 541     if [ $leave_tmp_files -eq 0 ] ; then
 542         if [ -n "$multi_host" ] ; then
 543             echo "trap \"rm -f $1 $2 $tmp_vpp_exec_file; sudo $dpdk_devbind -b $vpp_eth_kernel_driver $vpp_eth_pci_id; sudo ifconfig $vpp_eth_name up\" $trap_signals" >> $1
 544         else
 545             echo "trap \"rm -f $1 $2 $tmp_vpp_exec_file\" $trap_signals" >> $1
 546         fi
 547     fi
 548     if [ -n "$VCL_CONFIG" ] ; then
 549         echo "export VCL_CONFIG=${vcl_config_dir}${vcl_config}" >> $1
 550     fi
 551     if [ -n "$VCL_API_PREFIX" ] ; then
 552         echo "export VCL_API_PREFIX=$VCL_API_PREFIX" >> $1
 553     fi
 554     if [ -n "$VCL_DEBUG" ] ; then
 555         echo "export VCL_DEBUG=$VCL_DEBUG" >> $1
 556     fi
 557     if [ -n "$LDP_DEBUG" ] ; then
 558         echo "export LDP_DEBUG=$LDP_DEBUG" >> $1
 559     fi
 560     if [ -n "$VCOM_APP_NAME" ] ; then
 561         echo "export VCOM_APP_NAME=$VCOM_APP_NAME" >> $1
 562     fi
 563     if [ -n "$VCOM_SID_BIT" ] ; then
 564         echo "export VCOM_SID_BIT=$VCOM_SID_BIT" >> $1
 565     fi
 566     if [ -n "$namespace_id" ] ; then
 567         echo "export VCL_APP_NAMESPACE_ID=\"$namespace_id\"" >> $1
 568         echo "export VCL_APP_NAMESPACE_SECRET=\"$namespace_secret\"" >> $1
 569     fi
 570     if [ -n "$VCL_APP_SCOPE_LOCAL" ] || [ -z "$multi_host" ] &&
 571            [ -z "$full_thru_host_stack_vpp_cfg" ] ; then
 572         echo "export VCL_APP_SCOPE_LOCAL=true" >> $1
 573     fi
 574     if [ -n "$VCL_APP_SCOPE_GLOBAL" ] || [ -n "$multi_host" ] ||
 575            [ -n "$full_thru_host_stack_vpp_cfg" ] ; then
 576         echo "export VCL_APP_SCOPE_GLOBAL=true" >> $1
 577     fi
 578     if [ -n "$VCL_APP_PROXY_TRANSPORT_TCP" ] ; then
 579         echo "export VCL_APP_PROXY_TRANSPORT_TCP=true" >> $1
 580     fi
 581     if [ -n "$VCL_APP_PROXY_TRANSPORT_UDP" ] ; then
 582         echo "export VCL_APP_PROXY_TRANSPORT_UDP=true" >> $1
 583     fi
 584     if [ "$pre_cmd" = "$gdb_in_emacs " ] ; then
 585         if [ -n "$multi_host" ] && [[ $3 =~ "VPP".* ]] ; then
 586             cat <<EOF >> $1
 587 $gdb_in_emacs() {
 588     sudo emacs --eval "(gdb \"gdb -x $2 -i=mi --args \$*\")" --eval "(setq frame-title-format \"$3\")"
 589 }
 590 EOF
 591         else
 592             cat <<EOF >> $1
 593 $gdb_in_emacs() {
 594     emacs --eval "(gdb \"gdb -x $2 -i=mi --args \$*\")" --eval "(setq frame-title-format \"$3\")"
 595 }
 596 EOF
 597         fi
 598     fi
 599     if [ -n "$4" ] ; then
 600         echo "$4" >> $1
 601     fi
 602 }
 603
 604 write_script_footer() {
 605     # arguments
 606     #   $1 : command script file
 607     #   $2 : perf flag indicating to run bash before exit
 608     local -i perf=$2
 609     if [ $bash_after_exit -eq 1 ] || [ $perf -eq 1 ] ; then
 610         echo "bash" >> $1
 611     fi
 612 }
 613
 614 write_gdb_cmdfile() {
 615     # arguments
 616     #   $1 : gdb command file
 617     #   $2 : User specified gdb cmdfile
 618     #   $3 : emacs flag
 619     #   $4 : optional LD_PRELOAD library pathname.
 620     local -i emacs=$3
 621
 622     echo "# $1 generated on $(date)" > $1
 623     echo "#" >> $1
 624     echo "set confirm off" >> $1
 625     if [ -n "$4" ] ; then
 626         echo "set exec-wrapper env LD_PRELOAD=$4" >> $1
 627         # echo "start" >> $1
 628     fi
 629
 630     if [ ! -f $2 ] ; then
 631         echo -n "# " >> $1
 632     fi
 633     echo "source $2" >> $1
 634     if [ $emacs -eq 0 ] ; then
 635         echo "run" >> $1
 636     fi
 637 }
 638
 639 native_kernel() {
 640     banner="Running NATIVE-KERNEL socket test"
 641     if [ -z "$multi_host" ] || [ "$multi_host" = "server" ] ; then
 642         title1="SERVER$title_dbg (Native-Kernel Socket Test)"
 643         tmp_gdb_cmdfile=$tmp_gdb_cmdfile_server
 644         gdb_cmdfile=$VPPCOM_SERVER_GDB_CMDFILE
 645         set_pre_cmd $emacs_server $gdb_server
 646         write_script_header $cmd1_file $tmp_gdb_cmdfile "$title1"
 647         echo "${pre_cmd}${app_dir}${srvr_app}" >> $cmd1_file
 648         write_script_footer $cmd1_file $perf_server
 649         chmod +x $cmd1_file
 650     fi
 651
 652     if [ -z "$multi_host" ] || [ "$multi_host" = "client" ] ; then
 653         title2="CLIENT$title_dbg (Native-Kernel Socket Test)"
 654         tmp_gdb_cmdfile=$tmp_gdb_cmdfile_client
 655         gdb_cmdfile=$VPPCOM_CLIENT_GDB_CMDFILE
 656         set_pre_cmd $emacs_client $gdb_client
 657         write_script_header $cmd2_file $tmp_gdb_cmdfile "$title2" "sleep 2"
 658         echo "srvr_addr=\"$sock_srvr_addr\"" >> $cmd2_file
 659         echo "${pre_cmd}${app_dir}${clnt_app}" >> $cmd2_file
 660         write_script_footer $cmd2_file $perf_client
 661         chmod +x $cmd2_file
 662
 663     fi
 664 }
 665
 666 native_preload() {
 667     verify_no_vpp
 668     banner="Running NATIVE-PRELOAD socket test"
 669     ld_preload="$VCL_LDPRELOAD_LIB_DIR/$vcl_ldpreload_lib "
 670
 671     title1="VPP$title_dbg (Native-Preload Socket Test)"
 672     tmp_gdb_cmdfile=$tmp_gdb_cmdfile_vpp
 673     gdb_cmdfile=$VPP_GDB_CMDFILE
 674     set_pre_cmd $emacs_vpp $gdb_vpp
 675     write_script_header $cmd1_file $tmp_gdb_cmdfile "$title1"
 676     if [ -n "$multi_host" ] && [ $emacs_vpp -eq 0 ] ; then
 677         echo -n "sudo " >> $cmd1_file
 678     fi
 679     echo "${pre_cmd}$vpp_dir$vpp_app $vpp_args " >> $cmd1_file
 680     write_script_footer $cmd1_file $perf_vpp
 681     chmod +x $cmd1_file
 682
 683     if [ -z "$multi_host" ] || [ "$multi_host" = "server" ] ; then
 684         title2="SERVER$title_dbg (Native-Preload Socket Test)"
 685         tmp_gdb_cmdfile=$tmp_gdb_cmdfile_server
 686         gdb_cmdfile=$VPPCOM_SERVER_GDB_CMDFILE
 687         set_pre_cmd $emacs_server $gdb_server $ld_preload
 688         if [ -n "$full_thru_host_stack_vpp_cfg" ] ; then
 689             namespace_id="$server_namespace_id"
 690             namespace_secret="$server_namespace_secret"
 691         fi
 692         write_script_header $cmd2_file $tmp_gdb_cmdfile "$title2" "sleep 2"
 693         echo "export LD_LIBRARY_PATH=\"$lib64_dir:$VCL_LDPRELOAD_LIB_DIR:$LD_LIBRARY_PATH\"" >> $cmd2_file
 694         echo "${pre_cmd}${app_dir}${srvr_app}" >> $cmd2_file
 695         write_script_footer $cmd2_file $perf_server
 696         chmod +x $cmd2_file
 697     fi
 698
 699     if [ -z "$multi_host" ] || [ "$multi_host" = "client" ] ; then
 700         title3="CLIENT$title_dbg (Native-Preload Socket Test)"
 701         tmp_gdb_cmdfile=$tmp_gdb_cmdfile_client
 702         gdb_cmdfile=$VPPCOM_CLIENT_GDB_CMDFILE
 703         set_pre_cmd $emacs_client $gdb_client $ld_preload
 704         if [ -n "$full_thru_host_stack_vpp_cfg" ] ; then
 705             namespace_id="$client_namespace_id"
 706             namespace_secret="$client_namespace_secret"
 707         fi
 708         write_script_header $cmd3_file $tmp_gdb_cmdfile "$title3" "sleep 4"
 709         echo "export LD_LIBRARY_PATH=\"$lib64_dir:$VCL_LDPRELOAD_LIB_DIR:$LD_LIBRARY_PATH\"" >> $cmd3_file
 710         echo "srvr_addr=\"$sock_srvr_addr\"" >> $cmd3_file
 711         echo "${pre_cmd}${app_dir}${clnt_app}" >> $cmd3_file
 712         write_script_footer $cmd3_file $perf_client
 713         chmod +x $cmd3_file
 714     fi
 715 }
 716
 717 native_vcl() {
 718     verify_no_vpp
 719     banner="Running NATIVE-VCL socket test"
 720
 721     title1="VPP$title_dbg (Native-VCL Socket Test)"
 722     tmp_gdb_cmdfile=$tmp_gdb_cmdfile_vpp
 723     gdb_cmdfile=$VPP_GDB_CMDFILE
 724     set_pre_cmd $emacs_vpp $gdb_vpp
 725     write_script_header $cmd1_file $tmp_gdb_cmdfile "$title1"
 726     if [ -n "$multi_host" ] && [ $emacs_vpp -eq 0 ] ; then
 727         echo -n "sudo " >> $cmd1_file
 728     fi
 729     echo "${pre_cmd}$vpp_dir$vpp_app $vpp_args " >> $cmd1_file
 730     write_script_footer $cmd1_file $perf_vpp
 731     chmod +x $cmd1_file
 732
 733     if [ -z "$multi_host" ] || [ "$multi_host" = "server" ] ; then
 734         title2="SERVER$title_dbg (Native-VCL Socket Test)"
 735         tmp_gdb_cmdfile=$tmp_gdb_cmdfile_server
 736         gdb_cmdfile=$VPPCOM_SERVER_GDB_CMDFILE
 737         set_pre_cmd $emacs_server $gdb_server
 738         if [ "$multi_host" = "server" ] ; then
 739             delay="sleep 10"
 740         else
 741             delay="sleep 3"
 742         fi
 743         if [ -n "$full_thru_host_stack_vpp_cfg" ] ; then
 744             namespace_id="$server_namespace_id"
 745             namespace_secret="$server_namespace_secret"
 746         fi
 747         write_script_header $cmd2_file $tmp_gdb_cmdfile "$title2" "$delay"
 748         echo "export LD_LIBRARY_PATH=\"$lib64_dir:$LD_LIBRARY_PATH\"" >> $cmd2_file
 749         echo "${pre_cmd}${app_dir}${srvr_app}" >> $cmd2_file
 750         write_script_footer $cmd2_file $perf_server
 751         chmod +x $cmd2_file
 752     fi
 753
 754     if [ -z "$multi_host" ] || [ "$multi_host" = "client" ] ; then
 755         title3="CLIENT$title_dbg (Native-VCL Socket Test)"
 756         tmp_gdb_cmdfile=$tmp_gdb_cmdfile_client
 757         gdb_cmdfile=$VPPCOM_CLIENT_GDB_CMDFILE
 758         set_pre_cmd $emacs_client $gdb_client
 759         if [ "$multi_host" = "client" ] ; then
 760             delay="sleep 10"
 761         else
 762             delay="sleep 4"
 763         fi
 764         if [ -n "$full_thru_host_stack_vpp_cfg" ] ; then
 765             namespace_id="$client_namespace_id"
 766             namespace_secret="$client_namespace_secret"
 767         fi
 768         write_script_header $cmd3_file $tmp_gdb_cmdfile "$title3" "$delay"
 769         echo "export LD_LIBRARY_PATH=\"$lib64_dir:$LD_LIBRARY_PATH\"" >> $cmd3_file
 770         echo "srvr_addr=\"$sock_srvr_addr\"" >> $cmd3_file
 771         echo "${pre_cmd}${app_dir}${clnt_app}" >> $cmd3_file
 772         write_script_footer $cmd3_file $perf_client
 773         chmod +x $cmd3_file
 774     fi
 775 }
 776
 777 docker_kernel() {
 778     verify_no_docker_containers
 779     banner="Running DOCKER-KERNEL socket test"
 780
 781     if [ -z "$multi_host" ] || [ "$multi_host" = "server" ] ; then
 782         title1="SERVER$title_dbg (Docker-Native Socket Test)"
 783         tmp_gdb_cmdfile=$tmp_gdb_cmdfile_server
 784         gdb_cmdfile=$VPPCOM_SERVER_GDB_CMDFILE
 785         set_pre_cmd $emacs_server $gdb_server
 786         write_script_header $cmd1_file $tmp_gdb_cmdfile "$title1"
 787         echo "docker run -it --cpuset-cpus='4-7' --cpuset-cpus='4-7' -v $vpp_dir:$docker_vpp_dir -p $sock_srvr_port:$sock_srvr_port $docker_os ${docker_app_dir}${srvr_app}" >> $cmd1_file
 788         write_script_footer $cmd1_file $perf_server
 789         chmod +x $cmd1_file
 790     fi
 791
 792     if [ -z "$multi_host" ] || [ "$multi_host" = "client" ] ; then
 793         title2="CLIENT$title_dbg (Docker-Native Socket Test)"
 794         tmp_gdb_cmdfile=$tmp_gdb_cmdfile_client
 795         gdb_cmdfile=$VPPCOM_CLIENT_GDB_CMDFILE
 796         set_pre_cmd $emacs_client $gdb_client
 797         write_script_header $cmd2_file $tmp_gdb_cmdfile "$title2" "sleep 2"
 798         echo "$get_docker_server_ip4addr" >> $cmd2_file
 799         echo "docker run -it --cpuset-cpus='4-7' -v $vpp_dir:$docker_vpp_dir $docker_os ${docker_app_dir}${clnt_app}" >> $cmd2_file
 800         write_script_footer $cmd2_file $perf_client
 801         chmod +x $cmd2_file
 802     fi
 803 }
 804
 805 docker_preload() {
 806     verify_no_vpp
 807     verify_no_docker_containers
 808     banner="Running DOCKER-PRELOAD socket test"
 809     docker_ld_preload_dir="/vcl-ldpreload/"
 810     ld_preload_dir="$VCL_LDPRELOAD_LIB_DIR"
 811     ld_preload="$docker_ld_preload_dir$vcl_ldpreload_lib "
 812     docker_ld_preload_lib="$docker_ld_preload_dir$vcl_ldpreload_lib "
 813
 814     title1="VPP$title_dbg (Docker-Preload Socket Test)"
 815     tmp_gdb_cmdfile=$tmp_gdb_cmdfile_vpp
 816     gdb_cmdfile=$VPP_GDB_CMDFILE
 817     set_pre_cmd $emacs_vpp $gdb_vpp
 818     write_script_header $cmd1_file $tmp_gdb_cmdfile "$title1"
 819     if [ -n "$multi_host" ] ; then
 820         echo -n "sudo " >> $cmd1_file
 821     fi
 822     echo "${pre_cmd}$vpp_dir$vpp_app $vpp_args" >> $cmd1_file
 823     write_script_footer $cmd1_file $perf_vpp
 824     chmod +x $cmd1_file
 825
 826     if [ -z "$multi_host" ] || [ "$multi_host" = "server" ] ; then
 827         title2="SERVER$title_dbg (Docker-Preload Socket Test)"
 828         tmp_gdb_cmdfile=$tmp_gdb_cmdfile_server
 829         gdb_cmdfile=$VPPCOM_SERVER_GDB_CMDFILE
 830         set_pre_cmd $emacs_server $gdb_server $docker_ld_preload_lib
 831         if [ -n "$full_thru_host_stack_vpp_cfg" ] ; then
 832             namespace_id="$server_namespace_id"
 833             namespace_secret="$server_namespace_secret"
 834         fi
 835         write_script_header $cmd2_file $tmp_gdb_cmdfile "$title2" "sleep 2"
 836         echo "docker run -it -v $vpp_shm_dir:$vpp_shm_dir -v $vpp_dir:$docker_vpp_dir -v $lib64_dir:$docker_lib64_dir -v $ld_preload_dir:$docker_ld_preload_dir -v $vcl_config_dir:$docker_vcl_config_dir -p $sock_srvr_port:$sock_srvr_port -e VCL_DEBUG=$VCL_DEBUG -e VCL_CONFIG=${docker_vcl_config_dir}$vcl_config -e LD_LIBRARY_PATH=$docker_lib64_dir:$docker_ld_preload_dir ${docker_ld_preload}$docker_os ${docker_app_dir}${srvr_app}" >> $cmd2_file
 837         write_script_footer $cmd2_file $perf_server
 838         chmod +x $cmd2_file
 839     fi
 840
 841     if [ -z "$multi_host" ] || [ "$multi_host" = "client" ] ; then
 842         title3="CLIENT$title_dbg (Docker-Preload Socket Test)"
 843         tmp_gdb_cmdfile=$tmp_gdb_cmdfile_client
 844         gdb_cmdfile=$VPPCOM_CLIENT_GDB_CMDFILE
 845         set_pre_cmd $emacs_client $gdb_client $docker_ld_preload_lib
 846         if [ -n "$full_thru_host_stack_vpp_cfg" ] ; then
 847             namespace_id="$client_namespace_id"
 848             namespace_secret="$client_namespace_secret"
 849         fi
 850         write_script_header $cmd3_file $tmp_gdb_cmdfile "$title3" "sleep 4"
 851         echo "$get_docker_server_ip4addr" >> $cmd3_file
 852         echo "docker run -it --cpuset-cpus='4-7' -v $vpp_shm_dir:$vpp_shm_dir -v $vpp_dir:$docker_vpp_dir -v $lib64_dir:$docker_lib64_dir  -v $ld_preload_dir:$docker_ld_preload_dir -v $vcl_config_dir:$docker_vcl_config_dir -e VCL_DEBUG=$VCL_DEBUG -e VCL_CONFIG=${docker_vcl_config_dir}$vcl_config -e LD_LIBRARY_PATH=$docker_lib64_dir ${docker_ld_preload}$docker_os ${docker_app_dir}${clnt_app}" >> $cmd3_file
 853         write_script_footer $cmd3_file $perf_client
 854         chmod +x $cmd3_file
 855     fi
 856 }
 857
 858 docker_vcl() {
 859     verify_no_vpp
 860     verify_no_docker_containers
 861     banner="Running DOCKER-VCL socket test"
 862
 863     title1="VPP$title_dbg (Docker-VCL Socket Test)"
 864     tmp_gdb_cmdfile=$tmp_gdb_cmdfile_vpp
 865     gdb_cmdfile=$VPP_GDB_CMDFILE
 866     set_pre_cmd $emacs_vpp $gdb_vpp
 867     write_script_header $cmd1_file $tmp_gdb_cmdfile "$title1"
 868     if [ -n "$multi_host" ] ; then
 869         echo -n "sudo " >> $cmd1_file
 870     fi
 871     echo "${pre_cmd}$vpp_dir$vpp_app $vpp_args" >> $cmd1_file
 872     write_script_footer $cmd1_file $perf_vpp
 873     chmod +x $cmd1_file
 874
 875     if [ -z "$multi_host" ] || [ "$multi_host" = "server" ] ; then
 876         title2="SERVER$title_dbg (Docker-VCL Socket Test)"
 877         tmp_gdb_cmdfile=$tmp_gdb_cmdfile_server
 878         gdb_cmdfile=$VPPCOM_SERVER_GDB_CMDFILE
 879         set_pre_cmd $emacs_server $gdb_server
 880         if [ -n "$full_thru_host_stack_vpp_cfg" ] ; then
 881             namespace_id="$server_namespace_id"
 882             namespace_secret="$server_namespace_secret"
 883         fi
 884         write_script_header $cmd2_file $tmp_gdb_cmdfile "$title2" "sleep 2"
 885         echo "docker run -it --cpuset-cpus='4-7' -v $vpp_shm_dir:$vpp_shm_dir -v $vpp_dir:$docker_vpp_dir -v $lib64_dir:$docker_lib64_dir -v $vcl_config_dir:$docker_vcl_config_dir -p $sock_srvr_port:$sock_srvr_port -e VCL_CONFIG=${docker_vcl_config_dir}/$vcl_config -e LD_LIBRARY_PATH=$docker_lib64_dir $docker_os ${docker_app_dir}${srvr_app}" >> $cmd2_file
 886         write_script_footer $cmd2_file $perf_server
 887         chmod +x $cmd2_file
 888     fi
 889
 890     if [ -z "$multi_host" ] || [ "$multi_host" = "client" ] ; then
 891         title3="CLIENT$title_dbg (Docker-VCL Socket Test)"
 892         tmp_gdb_cmdfile=$tmp_gdb_cmdfile_client
 893         gdb_cmdfile=$VPPCOM_CLIENT_GDB_CMDFILE
 894         set_pre_cmd $emacs_client $gdb_client
 895         if [ -n "$full_thru_host_stack_vpp_cfg" ] ; then
 896             namespace_id="$client_namespace_id"
 897             namespace_secret="$client_namespace_secret"
 898         fi
 899         write_script_header $cmd3_file $tmp_gdb_cmdfile "$title3" "sleep 3"
 900         echo "$get_docker_server_ip4addr" >> $cmd3_file
 901         echo "docker run -it --cpuset-cpus='4-7' -v $vpp_shm_dir:$vpp_shm_dir -v $vpp_dir:$docker_vpp_dir -v $lib64_dir:$docker_lib64_dir -v $vcl_config_dir:$docker_vcl_config_dir -e VCL_CONFIG=${docker_vcl_config_dir}/$vcl_config -e LD_LIBRARY_PATH=$docker_lib64_dir $docker_os ${docker_app_dir}${clnt_app}" >> $cmd3_file
 902         write_script_footer $cmd3_file $perf_client
 903         chmod +x $cmd3_file
 904     fi
 905 }
 906
 907 if [[ $run_test ]] ; then
 908     eval $run_test
 909 else
 910     echo "ERROR: Please specify a test to run!" >&2
 911     usage;
 912 fi
 913
 914 if (( $(which xfce4-terminal | wc -l) > 0 )) ; then
 915     xterm_cmd="xfce4-terminal --geometry $xterm_geom"
 916     if [[ $use_tabs ]] ; then
 917         declare -a tab_cmd_files
 918         declare -a tab_titles
 919         declare -i i=0
 920
 921         if [ -x "$cmd1_file" ] ; then
 922             tab_cmd_files[$i]="$cmd1_file"
 923             tab_titles[$i]="$title1"
 924             (( i++ ))
 925         fi
 926         if [ -x "$cmd2_file" ] ; then
 927             tab_cmd_files[$i]="$cmd2_file"
 928             tab_titles[$i]="$title2"
 929             (( i++ ))
 930         fi
 931         if [ -x "$cmd3_file" ] ; then
 932             tab_cmd_files[$i]="$cmd3_file"
 933             tab_titles[$i]="$title3"
 934         fi
 935
 936         if [ -n "${tab_cmd_files[2]}" ] ; then
 937             $xterm_cmd  --title "${tab_titles[0]}" --command "${tab_cmd_files[0]}" --tab --title "${tab_titles[1]}" --command "${tab_cmd_files[1]}" --tab --title "${tab_titles[2]}" --command "${tab_cmd_files[2]}"
 938         elif [ -n "${tab_cmd_files[1]}" ] ; then
 939             $xterm_cmd --title "${tab_titles[0]}" --command "${tab_cmd_files[0]}" --tab --title "${tab_titles[1]}" --command "${tab_cmd_files[1]}"
 940
 941         else
 942             $xterm_cmd --title "${tab_titles[0]}" --command "${tab_cmd_files[0]}"
 943         fi
 944
 945     else
 946         if [ -x "$cmd1_file" ] ; then
 947             ($xterm_cmd --title "$title1" --command "$cmd1_file" &)
 948         fi
 949         if [ -x "$cmd2_file" ] ; then
 950             ($xterm_cmd --title "$title2" --command "$cmd2_file" &)
 951         fi
 952         if [ -x "$cmd3_file" ] ; then
 953             ($xterm_cmd --title "$title3" --command "$cmd3_file" &)
 954         fi
 955     fi
 956
 957 else
 958     if [[ $use_tabs ]] ; then
 959         echo "Sorry, plain ol' xterm doesn't support tabs."
 960     fi
 961     xterm_cmd="xterm -fs 10 -geometry $xterm_geom"
 962     if [ -x "$cmd1_file" ] ; then
 963         ($xterm_cmd -title "$title1" -e "$cmd1_file" &)
 964     fi
 965     if [ -x "$cmd2_file" ] ; then
 966         ($xterm_cmd -title "$title2" -e "$cmd2_file" &)
 967     fi
 968     if [ -x "$cmd3_file" ] ; then
 969         ($xterm_cmd -title "$title3" -e "$cmd3_file" &)
 970     fi
 971 fi
 972
 973 sleep 1