grommunio / grommunio-sync

grommunio-sync-top.php

#!/usr/bin/env php
<?php
/*
 * SPDX-License-Identifier: AGPL-3.0-only
 * SPDX-FileCopyrightText: Copyright 2007-2016 Zarafa Deutschland GmbH
 * SPDX-FileCopyrightText: Copyright 2020-2022 grommunio GmbH
 *
 * Shows realtime information about connected devices and active connections
 * in a top-style format.
 */

require_once 'vendor/autoload.php';
if (!defined('GSYNC_CONFIG')) {
    define('GSYNC_CONFIG', 'config.php');
}

include_once GSYNC_CONFIG;

/*
 * MAIN
 */
    declare(ticks=1);
    define('BASE_PATH_CLI', dirname(__FILE__) . '/');
    set_include_path(get_include_path() . PATH_SEPARATOR . BASE_PATH_CLI);

    if (!defined('GSYNC_CONFIG')) {
        define('GSYNC_CONFIG', BASE_PATH_CLI . 'config.php');
    }

    include_once GSYNC_CONFIG;

    try {
        GSync::CheckConfig();
        if (!function_exists('pcntl_signal')) {
            throw new FatalException("Function pcntl_signal() is not available. Please install package 'php5-pcntl' (or similar) on your system.");
        }

        if ('cli' != php_sapi_name()) {
            throw new FatalException('This script can only be called from the CLI.');
        }

        $zpt = new GSyncTop();

        // check if help was requested from CLI
        if (in_array('-h', $argv) || in_array('--help', $argv)) {
            echo $zpt->UsageInstructions();

            exit(0);
        }

        if ($zpt->IsAvailable()) {
            pcntl_signal(SIGINT, [$zpt, 'SignalHandler']);
            $zpt->run();
            $zpt->scrClear();
            system('stty sane');
        } else {
            echo "grommunio-sync interprocess communication (IPC) is not available or TopCollector is disabled.\n";
        }
    } catch (GSyncException $zpe) {
        fwrite(STDERR, get_class($zpe) . ': ' . $zpe->getMessage() . "\n");

        exit(1);
    }

    echo "terminated\n";

/*
 * grommunio-sync-top
 */
class GSyncTop {
    // show options
    public const SHOW_DEFAULT = 0;
    public const SHOW_ACTIVE_ONLY = 1;
    public const SHOW_UNKNOWN_ONLY = 2;
    public const SHOW_TERM_DEFAULT_TIME = 5; // 5 secs

    private $topCollector;
    private $starttime;
    private $action;
    private $filter;
    private $status;
    private $statusexpire;
    private $wide;
    private $wasEnabled;
    private $terminate;
    private $scrSize;
    private $pingInterval;
    private $showPush;
    private $showTermSec;

    private $linesActive = [];
    private $linesOpen = [];
    private $linesUnknown = [];
    private $linesTerm = [];
    private $pushConn = 0;
    private $activeConn = [];
    private $activeHosts = [];
    private $activeUsers = [];
    private $activeDevices = [];

    /**
     * Constructor.
     */
    public function __construct() {
        $this->starttime = time();
        $this->currenttime = time();

The property currenttime does not exist. Although not strictly required by PHP, it is generally a best practice to declare properties explicitly.

        $this->action = '';
        $this->filter = false;
        $this->status = false;
        $this->statusexpire = 0;
        $this->helpexpire = 0;

The property helpexpire does not exist. Although not strictly required by PHP, it is generally a best practice to declare properties explicitly.

        $this->doingTail = false;

The property doingTail does not exist. Although not strictly required by PHP, it is generally a best practice to declare properties explicitly.

        $this->wide = false;
        $this->terminate = false;
        $this->showPush = true;
        $this->showOption = self::SHOW_DEFAULT;

The property showOption does not exist. Although not strictly required by PHP, it is generally a best practice to declare properties explicitly.

        $this->showTermSec = self::SHOW_TERM_DEFAULT_TIME;
        $this->scrSize = ['width' => 80, 'height' => 24];
        $this->pingInterval = (defined('PING_INTERVAL') && PING_INTERVAL > 0) ? PING_INTERVAL : 12;

        // get a TopCollector
        $this->topCollector = new TopCollector();
    }

    /**
     * Main loop of grommunio-sync-top
     * Runs until termination is requested.
     *
     * @return
     */
    public function run() {
        $this->initialize();

        do {
            $this->currenttime = time();

The property currenttime does not exist. Although not strictly required by PHP, it is generally a best practice to declare properties explicitly.

            // see if shared memory is active
            if (!$this->IsAvailable()) {
                $this->terminate = true;
            }

            // active processes should continue sending data
            $this->topCollector->CollectData();

            // get and process data from processes
            $this->topCollector->ClearLatest();
            $topdata = $this->topCollector->ReadLatest();
            $this->processData($topdata);

            // clear screen
            $this->scrClear();

            // check if screen size changed
            $s = $this->scrGetSize();
            if ($this->scrSize['width'] != $s['width']) {
                if ($s['width'] > 180) {
                    $this->wide = true;
                } else {
                    $this->wide = false;
                }
            }
            $this->scrSize = $s;

            // print overview
            $this->scrOverview();

            // wait for user input
            $this->readLineProcess();
        } while (true != $this->terminate);

It seems like you are loosely comparing two booleans. Considering using the strict comparison !== instead.

    }

    /**
     * Indicates if TopCollector is available collecting data.
     *
     * @return bool
     */
    public function IsAvailable() {
        if (defined('TOPCOLLECTOR_DISABLED') && true === constant('TOPCOLLECTOR_DISABLED')) {
            return false;
        }

        return $this->topCollector->IsActive();
    }

    /**
     * Signal handler function.
     *
     * @param int $signo signal number
     *
     * @return
     */
    public function SignalHandler($signo) {

The parameter $signo is not used and could be removed.

        // don't terminate if the signal was sent by terminating tail
        if (!$this->doingTail) {
            $this->topCollector->CollectData(true);
            $this->topCollector->ClearLatest(true);
            $this->terminate = true;
        }
    }

    /**
     * Returns usage instructions.
     *
     * @return string
     */
    public function UsageInstructions() {
        $help = "Usage:\n\tgrommunio-sync-top.php\n\n" .
                "  grommunio-sync-top is a live top-like overview of what grommunio-sync is doing. It does not have specific command line options.\n\n" .
                "  When grommunio-sync-top is running you can specify certain actions and options which can be executed (listed below).\n" .
                "  This help information can also be shown inside grommunio-sync-top by hitting 'help' or 'h'.\n\n";
        $scrhelp = $this->scrHelp();
        unset($scrhelp[0]);

        $help .= implode("\n", $scrhelp);
        $help .= "\n\n";

        return $help;
    }

    /**
     * Clears screen of the terminal.
     *
     * @param array $data
     *
     * @return
     */
    public function scrClear() {
        echo "\033[2J";
    }

    /**
     * Requests data from the running grommunio-sync processes.
     *
     * @return
     */
    private function initialize() {
        // request feedback from active processes
        $this->wasEnabled = $this->topCollector->CollectData();

        // remove obsolete data
        $this->topCollector->ClearLatest(true);

        // start with default colours
        $this->scrDefaultColors();
    }

    /**
     * Processes data written by the running processes.
     *
     * @param array $data
     *
     * @return
     */
    private function processData($data) {
        $this->linesActive = [];
        $this->linesOpen = [];
        $this->linesUnknown = [];
        $this->linesTerm = [];
        $this->pushConn = 0;
        $this->activeConn = [];
        $this->activeHosts = [];
        $this->activeUsers = [];
        $this->activeDevices = [];

        if (!is_array($data)) {

The condition is_array($data) is always true.

            return;
        }

        foreach ($data as $devid => $users) {
            foreach ($users as $user => $pids) {
                foreach ($pids as $pid => $line) {
                    if (!is_array($line)) {
                        continue;
                    }

                    $line['command'] = Utils::GetCommandFromCode($line['command']);

                    if (0 == $line['ended']) {
                        $this->activeDevices[$devid] = 1;
                        $this->activeUsers[$user] = 1;
                        $this->activeConn[$pid] = 1;
                        $this->activeHosts[$line['ip']] = 1;

                        $line['time'] = $this->currenttime - $line['start'];
                        if (true === $line['push']) {
                            ++$this->pushConn;
                        }

                        // ignore push connections
                        if (true === $line['push'] && !$this->showPush) {
                            continue;
                        }

                        if (false !== $this->filter) {
                            $f = $this->filter;
                            if (!($line['pid'] == $f || $line['ip'] == $f || strtolower($line['command']) == strtolower($f) || preg_match("/.*?{$f}.*?/i", $line['user'])

$f of type true is incompatible with the type string expected by parameter $string of strtolower().

                                || preg_match("/.*?{$f}.*?/i", $line['devagent']) || preg_match("/.*?{$f}.*?/i", $line['devid']) || preg_match("/.*?{$f}.*?/i", $line['addinfo']))) {
                                continue;
                            }
                        }

                        $lastUpdate = $this->currenttime - $line['update'];
                        if ($this->currenttime - $line['update'] < 2) {
                            $this->linesActive[$line['update'] . $line['pid']] = $line;
                        } elseif ((true === $line['push'] && $lastUpdate > ($this->pingInterval + 2)) || (true !== $line['push'] && $lastUpdate > 4)) {
                            $this->linesUnknown[$line['update'] . $line['pid']] = $line;
                        } else {
                            $this->linesOpen[$line['update'] . $line['pid']] = $line;
                        }
                    } else {
                        // do not show terminated + expired connections
                        if ($line['ended'] + $this->showTermSec < $this->currenttime) {
                            continue;
                        }

                        if (false !== $this->filter) {
                            $f = $this->filter;
                            if (!($line['pid'] == $f || $line['ip'] == $f || strtolower($line['command']) == strtolower($f) || preg_match("/.*?{$f}.*?/i", $line['user'])
                                || preg_match("/.*?{$f}.*?/i", $line['devagent']) || preg_match("/.*?{$f}.*?/i", $line['devid']) || preg_match("/.*?{$f}.*?/i", $line['addinfo']))) {
                                continue;
                            }
                        }

                        $line['time'] = $line['ended'] - $line['start'];
                        $this->linesTerm[$line['update'] . $line['pid']] = $line;
                    }
                }
            }
        }

        // sort by execution time
        krsort($this->linesActive);
        krsort($this->linesOpen);
        krsort($this->linesUnknown);
        krsort($this->linesTerm);
    }

    /**
     * Prints data to the terminal.
     *
     * @return
     */
    private function scrOverview() {
        $linesAvail = $this->scrSize['height'] - 8;
        $lc = 1;
        $this->scrPrintAt($lc, 0, "\033[1mgrommunio-sync-top live statistics\033[0m\t\t\t\t\t" . @strftime('%d/%m/%Y %T') . "\n");

Are you sure @strftime('%d/%m/%Y %T') of type false|string can be used in concatenation?

        ++$lc;

        $this->scrPrintAt($lc, 0, sprintf("Open connections: %d\t\t\t\tUsers:\t %d\tgrommunio-sync:   %s ", count($this->activeConn), count($this->activeUsers), $this->getVersion()));
        ++$lc;
        $this->scrPrintAt($lc, 0, sprintf("Push connections: %d\t\t\t\tDevices: %d\tPHP-MAPI: %s", $this->pushConn, count($this->activeDevices), phpversion('mapi')));
        ++$lc;
        $this->scrPrintAt($lc, 0, sprintf("                                                Hosts:\t %d", count($this->activeHosts)));
        ++$lc;
        ++$lc;

        $this->scrPrintAt($lc, 0, "\033[4m" . $this->getLine(['pid' => 'PID', 'ip' => 'IP', 'user' => 'USER', 'command' => 'COMMAND', 'time' => 'TIME', 'devagent' => 'AGENT', 'devid' => 'DEVID', 'addinfo' => 'Additional Information']) . str_repeat(' ', 20) . "\033[0m");
        ++$lc;

        // print help text if requested
        $hl = 0;
        if ($this->helpexpire > $this->currenttime) {
            $help = $this->scrHelp();
            $linesAvail -= count($help);
            $hl = $this->scrSize['height'] - count($help) - 1;
            foreach ($help as $h) {
                $this->scrPrintAt($hl, 0, $h);
                ++$hl;
            }
        }

        $toPrintActive = $linesAvail;
        $toPrintOpen = $linesAvail;
        $toPrintUnknown = $linesAvail;
        $toPrintTerm = $linesAvail;

        // default view: show all unknown, no terminated and half active+open
        if (count($this->linesActive) + count($this->linesOpen) + count($this->linesUnknown) > $linesAvail) {
            $toPrintUnknown = count($this->linesUnknown);
            $toPrintActive = count($this->linesActive);
            $toPrintOpen = $linesAvail - $toPrintUnknown - $toPrintActive;
            $toPrintTerm = 0;
        }

        if (self::SHOW_ACTIVE_ONLY == $this->showOption) {
            $toPrintActive = $linesAvail;
            $toPrintOpen = 0;
            $toPrintUnknown = 0;
            $toPrintTerm = 0;
        }

        if (self::SHOW_UNKNOWN_ONLY == $this->showOption) {
            $toPrintActive = 0;
            $toPrintOpen = 0;
            $toPrintUnknown = $linesAvail;
            $toPrintTerm = 0;
        }

        $linesprinted = 0;
        foreach ($this->linesActive as $time => $l) {
            if ($linesprinted >= $toPrintActive) {
                break;
            }

            $this->scrPrintAt($lc, 0, "\033[01m" . $this->getLine($l) . "\033[0m");
            ++$lc;
            ++$linesprinted;
        }

        $linesprinted = 0;
        foreach ($this->linesOpen as $time => $l) {
            if ($linesprinted >= $toPrintOpen) {
                break;
            }

            $this->scrPrintAt($lc, 0, $this->getLine($l));
            ++$lc;
            ++$linesprinted;
        }

        $linesprinted = 0;
        foreach ($this->linesUnknown as $time => $l) {
            if ($linesprinted >= $toPrintUnknown) {
                break;
            }

            $color = '0;31m';
            if (false == $l['push'] && $time - $l['start'] > 30) {
                $color = '1;31m';
            }
            $this->scrPrintAt($lc, 0, "\033[0" . $color . $this->getLine($l) . "\033[0m");
            ++$lc;
            ++$linesprinted;
        }

        if ($toPrintTerm > 0) {
            $toPrintTerm = $linesAvail - $lc + 6;
        }

        $linesprinted = 0;
        foreach ($this->linesTerm as $time => $l) {
            if ($linesprinted >= $toPrintTerm) {
                break;
            }

            $this->scrPrintAt($lc, 0, "\033[01;30m" . $this->getLine($l) . "\033[0m");
            ++$lc;
            ++$linesprinted;
        }

        // add the lines used when displaying the help text
        $lc += $hl;
        $this->scrPrintAt($lc, 0, "\033[K");
        ++$lc;
        $this->scrPrintAt($lc, 0, "Colorscheme: \033[01mActive  \033[0mOpen  \033[01;31mUnknown  \033[01;30mTerminated\033[0m");

        // remove old status
        if ($this->statusexpire < $this->currenttime) {
            $this->status = false;
        }

        // show request information and help command
        if ($this->starttime + 6 > $this->currenttime) {
            $this->status = sprintf('Requesting information (takes up to %dsecs)', $this->pingInterval) . str_repeat('.', ($this->currenttime - $this->starttime)) . "  type \033[01;31mh\033[00;31m or \033[01;31mhelp\033[00;31m for usage instructions";
            $this->statusexpire = $this->currenttime + 1;
        }

        $str = '';
        if (!$this->showPush) {
            $str .= "\033[00;32mPush: \033[01;32mNo\033[0m   ";
        }

        if (self::SHOW_ACTIVE_ONLY == $this->showOption) {
            $str .= "\033[01;32mActive only\033[0m   ";
        }

        if (self::SHOW_UNKNOWN_ONLY == $this->showOption) {
            $str .= "\033[01;32mUnknown only\033[0m   ";
        }

        if (self::SHOW_TERM_DEFAULT_TIME != $this->showTermSec) {
            $str .= "\033[01;32mTerminated: " . $this->showTermSec . "s\033[0m   ";
        }

        if (false !== $this->filter || (false !== $this->status && $this->statusexpire > $this->currenttime)) {
            // print filter in green
            if (false !== $this->filter) {
                $str .= "\033[00;32mFilter: \033[01;32m{$this->filter}\033[0m   ";
            }
            // print status in red
            if (false !== $this->status) {
                $str .= "\033[00;31m{$this->status}\033[0m";
            }
        }
        $this->scrPrintAt(5, 0, $str);

        $this->scrPrintAt(4, 0, "Action: \033[01m" . $this->action . "\033[0m");
    }

    /**
     * Waits for a keystroke and processes the requested command.
     *
     * @return
     */
    private function readLineProcess() {
        $ans = explode('^^', `bash -c "read -n 1 -t 1 ANS ; echo \\\$?^^\\\$ANS;"`);

        if ($ans[0] < 128) {
            if (isset($ans[1]) && '7f' == bin2hex(trim($ans[1]))) {
                $this->action = substr($this->action, 0, -1);
            }

            if (isset($ans[1]) && '' != $ans[1]) {
                $this->action .= trim(preg_replace('/[^A-Za-z0-9:]/', '', $ans[1]));
            }

            if ('30' == bin2hex($ans[0]) && '0a' == bin2hex($ans[1])) {
                $cmds = explode(':', $this->action);
                if ('quit' == $cmds[0] || 'q' == $cmds[0] || (isset($cmds[1]) && '' == $cmds[0] && 'q' == $cmds[1])) {
                    $this->topCollector->CollectData(true);
                    $this->topCollector->ClearLatest(true);

                    $this->terminate = true;
                } elseif ('clear' == $cmds[0]) {
                    $this->topCollector->ClearLatest(true);
                    $this->topCollector->CollectData(true);
                    $this->topCollector->ReInitIPC();
                } elseif ('filter' == $cmds[0] || 'f' == $cmds[0]) {
                    if (!isset($cmds[1]) || '' == $cmds[1]) {
                        $this->filter = false;
                        $this->status = 'No filter';
                        $this->statusexpire = $this->currenttime + 5;
                    } else {
                        $this->filter = $cmds[1];
                        $this->status = false;
                    }
                } elseif ('option' == $cmds[0] || 'o' == $cmds[0]) {
                    if (!isset($cmds[1]) || '' == $cmds[1]) {
                        $this->status = "Option value needs to be specified. See 'help' or 'h' for instructions";
                        $this->statusexpire = $this->currenttime + 5;
                    } elseif ('p' == $cmds[1] || 'push' == $cmds[1] || 'ping' == $cmds[1]) {
                        $this->showPush = !$this->showPush;
                    } elseif ('a' == $cmds[1] || 'active' == $cmds[1]) {
                        $this->showOption = self::SHOW_ACTIVE_ONLY;

The property showOption does not exist. Although not strictly required by PHP, it is generally a best practice to declare properties explicitly.

                    } elseif ('u' == $cmds[1] || 'unknown' == $cmds[1]) {
                        $this->showOption = self::SHOW_UNKNOWN_ONLY;
                    } elseif ('d' == $cmds[1] || 'default' == $cmds[1]) {
                        $this->showOption = self::SHOW_DEFAULT;
                        $this->showTermSec = self::SHOW_TERM_DEFAULT_TIME;
                        $this->showPush = true;
                    } elseif (is_numeric($cmds[1])) {
                        $this->showTermSec = $cmds[1];
                    } else {
                        $this->status = sprintf("Option '%s' unknown", $cmds[1]);
                        $this->statusexpire = $this->currenttime + 5;
                    }
                } elseif ('reset' == $cmds[0] || 'r' == $cmds[0]) {
                    $this->filter = false;
                    $this->wide = false;
                    $this->helpexpire = 0;

The property helpexpire does not exist. Although not strictly required by PHP, it is generally a best practice to declare properties explicitly.

                    $this->status = 'reset';
                    $this->statusexpire = $this->currenttime + 2;
                }
                // enable/disable wide view
                elseif ('wide' == $cmds[0] || 'w' == $cmds[0]) {
                    $this->wide = !$this->wide;
                    $this->status = ($this->wide) ? 'w i d e  view' : 'normal view';
                    $this->statusexpire = $this->currenttime + 2;
                } elseif ('help' == $cmds[0] || 'h' == $cmds[0]) {
                    $this->helpexpire = $this->currenttime + 20;
                }
                // grep the log file
                elseif (('log' == $cmds[0] || 'l' == $cmds[0]) && isset($cmds[1])) {
                    if (!file_exists(LOGFILE)) {
                        $this->status = 'Logfile can not be found: ' . LOGFILE;
                    } else {
                        system('bash -c "fgrep -a ' . escapeshellarg($cmds[1]) . ' ' . LOGFILE . ' | less +G" > `tty`');
                        $this->status = 'Returning from log, updating data';
                    }
                    $this->statusexpire = time() + 5; // it might be much "later" now
                }
                // tail the log file
                elseif (('tail' == $cmds[0] || 't' == $cmds[0])) {
                    if (!file_exists(LOGFILE)) {
                        $this->status = 'Logfile can not be found: ' . LOGFILE;
                    } else {
                        $this->doingTail = true;

The property doingTail does not exist. Although not strictly required by PHP, it is generally a best practice to declare properties explicitly.

                        $this->scrClear();
                        $this->scrPrintAt(1, 0, $this->scrAsBold("Press CTRL+C to return to grommunio-sync-top\n\n"));
                        $secondary = '';
                        if (isset($cmds[1])) {
                            $secondary = ' -n 200 | grep ' . escapeshellarg($cmds[1]);
                        }
                        system('bash -c "tail -f ' . LOGFILE . $secondary . '" > `tty`');
                        $this->doingTail = false;
                        $this->status = 'Returning from tail, updating data';
                    }
                    $this->statusexpire = time() + 5; // it might be much "later" now
                }
                // tail the error log file
                elseif (('error' == $cmds[0] || 'e' == $cmds[0])) {
                    if (!file_exists(LOGERRORFILE)) {
                        $this->status = 'Error logfile can not be found: ' . LOGERRORFILE;
                    } else {
                        $this->doingTail = true;
                        $this->scrClear();
                        $this->scrPrintAt(1, 0, $this->scrAsBold("Press CTRL+C to return to grommunio-sync-top\n\n"));
                        $secondary = '';
                        if (isset($cmds[1])) {
                            $secondary = ' -n 200 | grep ' . escapeshellarg($cmds[1]);
                        }
                        system('bash -c "tail -f ' . LOGERRORFILE . $secondary . '" > `tty`');
                        $this->doingTail = false;
                        $this->status = 'Returning from tail, updating data';
                    }
                    $this->statusexpire = time() + 5; // it might be much "later" now
                } elseif ('' != $cmds[0]) {
                    $this->status = sprintf("Command '%s' unknown", $cmds[0]);
                    $this->statusexpire = $this->currenttime + 8;
                }
                $this->action = '';
            }
        }
    }

    /**
     * Prints a 'help' text at the end of the page.
     *
     * @return array with help lines
     */
    private function scrHelp() {
        $h = [];
        $secs = $this->helpexpire - $this->currenttime;
        $h[] = 'Actions supported by grommunio-sync-top (help page still displayed for ' . $secs . 'secs)';
        $h[] = '  ' . $this->scrAsBold('Action') . "\t\t" . $this->scrAsBold('Comment');
        $h[] = '  ' . $this->scrAsBold('h') . ' or ' . $this->scrAsBold('help') . "\t\tDisplays this information.";
        $h[] = '  ' . $this->scrAsBold('q') . ', ' . $this->scrAsBold('quit') . ' or ' . $this->scrAsBold(':q') . "\t\tExits grommunio-sync-top.";
        $h[] = '  ' . $this->scrAsBold('w') . ' or ' . $this->scrAsBold('wide') . "\t\tTries not to truncate data. Automatically done if more than 180 columns available.";
        $h[] = '  ' . $this->scrAsBold('f:VAL') . ' or ' . $this->scrAsBold('filter:VAL') . "\tOnly display connections which contain VAL. This value is case-insensitive.";
        $h[] = '  ' . $this->scrAsBold('f:') . ' or ' . $this->scrAsBold('filter:') . "\t\tWithout a search word: resets the filter.";
        $h[] = '  ' . $this->scrAsBold('l:STR') . ' or ' . $this->scrAsBold('log:STR') . "\tIssues 'less +G' on the logfile, after grepping on the optional STR.";
        $h[] = '  ' . $this->scrAsBold('t:STR') . ' or ' . $this->scrAsBold('tail:STR') . "\tIssues 'tail -f' on the logfile, grepping for optional STR.";
        $h[] = '  ' . $this->scrAsBold('e:STR') . ' or ' . $this->scrAsBold('error:STR') . "\tIssues 'tail -f' on the error logfile, grepping for optional STR.";
        $h[] = '  ' . $this->scrAsBold('r') . ' or ' . $this->scrAsBold('reset') . "\t\tResets 'wide' or 'filter'.";
        $h[] = '  ' . $this->scrAsBold('o:') . ' or ' . $this->scrAsBold('option:') . "\t\tSets display options. Valid options specified below";
        $h[] = '  ' . $this->scrAsBold('  p') . ' or ' . $this->scrAsBold('push') . "\t\tLists/not lists active and open push connections.";
        $h[] = '  ' . $this->scrAsBold('  a') . ' or ' . $this->scrAsBold('action') . "\t\tLists only active connections.";
        $h[] = '  ' . $this->scrAsBold('  u') . ' or ' . $this->scrAsBold('unknown') . "\tLists only unknown connections.";
        $h[] = '  ' . $this->scrAsBold('  10') . ' or ' . $this->scrAsBold('20') . "\t\tLists terminated connections for 10 or 20 seconds. Any other number can be used.";
        $h[] = '  ' . $this->scrAsBold('  d') . ' or ' . $this->scrAsBold('default') . "\tUses default options";

        return $h;
    }

    /**
     * Encapsulates string with different color escape characters.
     *
     * @param string $text
     *
     * @return string same text as bold
     */
    private function scrAsBold($text) {
        return "\033[01m" . $text . "\033[0m";
    }

    /**
     * Prints one line of precessed data.
     *
     * @param array $l line information
     *
     * @return string
     */
    private function getLine($l) {
        if (true === $this->wide) {
            return sprintf('%s%s%s%s%s%s%s%s', $this->ptStr($l['pid'], 6), $this->ptStr($l['ip'], 16), $this->ptStr($l['user'], 24), $this->ptStr($l['command'], 16), $this->ptStr($this->sec2min($l['time']), 8), $this->ptStr($l['devagent'], 28), $this->ptStr($l['devid'], 33, true), $l['addinfo']);
        }

        return sprintf('%s%s%s%s%s%s%s%s', $this->ptStr($l['pid'], 6), $this->ptStr($l['ip'], 16), $this->ptStr($l['user'], 8), $this->ptStr($l['command'], 8), $this->ptStr($this->sec2min($l['time']), 6), $this->ptStr($l['devagent'], 20), $this->ptStr($l['devid'], 12, true), $l['addinfo']);
    }

    /**
     * Pads and trims string.
     *
     * @param string $str       to be trimmed/padded
     * @param int    $size      characters to be considered
     * @param bool   $cutmiddle (optional) indicates where to long information should
     *                          be trimmed of, false means at the end
     *
     * @return string
     */
    private function ptStr($str, $size, $cutmiddle = false) {
        if (strlen($str) < $size) {
            return str_pad($str, $size);
        }
        if (true == $cutmiddle) {

It seems like you are loosely comparing two booleans. Considering using the strict comparison === instead.

            $cut = ($size - 2) / 2;

            return $this->ptStr(substr($str, 0, $cut) . '..' . substr($str, (-1) * ($cut - 1)), $size);
        }

        return substr($str, 0, $size - 3) . '.. ';
    }

    /**
     * Tries to discover the size of the current terminal.
     *
     * @return array 'width' and 'height' as keys
     */
    private function scrGetSize() {
        $tty = strtolower(exec('stty -a | fgrep columns'));
        if (preg_match_all('/rows.([0-9]+);.columns.([0-9]+);/', $tty, $output)
            || preg_match_all('/([0-9]+).rows;.([0-9]+).columns;/', $tty, $output)) {
            return ['width' => $output[2][0], 'height' => $output[1][0]];
        }

        return ['width' => 80, 'height' => 24];
    }

    /**
     * Returns the version of the current grommunio-sync installation.
     *
     * @return string
     */
    private function getVersion() {
        return GROMMUNIOSYNC_VERSION;
    }

    /**
     * Converts seconds in MM:SS.
     *
     * @param int $s seconds
     *
     * @return string
     */
    private function sec2min($s) {
        if (!is_int($s)) {

The condition is_int($s) is always true.

            return $s;
        }

        return sprintf('%02.2d:%02.2d', floor($s / 60), $s % 60);
    }

    /**
     * Resets the default colors of the terminal.
     *
     * @return
     */
    private function scrDefaultColors() {
        echo "\033[0m";
    }

    /**
     * Prints a text at a specific screen/terminal coordinates.
     *
     * @param int    $row  row number
     * @param int    $col  column number
     * @param string $text to be printed
     *
     * @return
     */
    private function scrPrintAt($row, $col, $text = '') {
        echo "\033[" . $row . ';' . $col . 'H' . $text;
    }
}