usr.bin/systat/mode.c

   1 /*
   2  * Copyright 1997 Massachusetts Institute of Technology
   3  *
   4  * Permission to use, copy, modify, and distribute this software and
   5  * its documentation for any purpose and without fee is hereby
   6  * granted, provided that both the above copyright notice and this
   7  * permission notice appear in all copies, that both the above
   8  * copyright notice and this permission notice appear in all
   9  * supporting documentation, and that the name of M.I.T. not be used
  10  * in advertising or publicity pertaining to distribution of the
  11  * software without specific, written prior permission.  M.I.T. makes
  12  * no representations about the suitability of this software for any
  13  * purpose.  It is provided "as is" without express or implied
  14  * warranty.
  15  *
  16  * THIS SOFTWARE IS PROVIDED BY M.I.T. ``AS IS''.  M.I.T. DISCLAIMS
  17  * ALL EXPRESS OR IMPLIED WARRANTIES WITH REGARD TO THIS SOFTWARE,
  18  * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
  19  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT
  20  * SHALL M.I.T. BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  21  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  22  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
  23  * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  24  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  25  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
  26  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  27  * SUCH DAMAGE.
  28  *
  29  * $FreeBSD: src/usr.bin/systat/mode.c,v 1.2 1999/08/28 01:06:03 peter Exp $
  30  * $DragonFly: src/usr.bin/systat/mode.c,v 1.3 2008/11/10 04:59:45 swildner Exp $
  31  */
  32
  33 /*
  34  * mode.c - mechanisms for dealing with SGI-style modal displays.
  35  *
  36  * There are four generally-understood useful modes for status displays
  37  * of the sort exemplified by the IRIX ``netstat -C'' and ``osview''
  38  * programs.  We try to follow their example, although the user interface
  39  * and terminology slightly differ.
  40  *
  41  * RATE - the default mode - displays the precise rate of change in
  42  * each statistic in units per second, regardless of the actual display
  43  * update interval.
  44  *
  45  * DELTA - displays the change in each statistic over the entire
  46  * display update interval (i.e., RATE * interval).
  47  *
  48  * SINCE - displays the total change in each statistic since the module
  49  * was last initialized or reset.
  50  *
  51  * ABSOLUTE - displays the current value of each statistic.
  52  *
  53  * In the SGI programs, these modes are selected by the single-character
  54  * commands D, W, N, and A.  In systat, they are the slightly-harder-to-type
  55  * ``mode delta'', etc.  The initial value for SINCE mode is initialized
  56  * when the module is first started and can be reset using the ``reset''
  57  * command (as opposed to the SGI way where changing modes implicitly
  58  * resets).  A ``mode'' command with no arguments displays the current
  59  * mode in the command line.
  60  */
  61
  62 #include <sys/types.h>
  63
  64 #include "systat.h"
  65 #include "extern.h"
  66 #include "mode.h"
  67
  68 enum mode currentmode = display_RATE;
  69
  70 static const char *const modes[] = { "rate", "delta", "since", "absolute" };
  71
  72 int
  73 cmdmode(const char *cmd, char *args)
  74 {
  75         if (prefix(cmd, "mode")) {
  76                 if (args[0] == '\0') {
  77                         move(CMDLINE, 0);
  78                         clrtoeol();
  79                         printw("%s", modes[currentmode]);
  80                 } else if (prefix(args, "rate")) {
  81                         currentmode = display_RATE;
  82                 } else if (prefix(args, "delta")) {
  83                         currentmode = display_DELTA;
  84                 } else if (prefix(args, "since")) {
  85                         currentmode = display_SINCE;
  86                 } else if (prefix(args, "absolute")) {
  87                         currentmode = display_ABS;
  88                 } else {
  89                         printw("unknown mode `%s'", args);
  90                 }
  91                 return 1;
  92         }
  93         if(prefix(cmd, "reset")) {
  94                 curcmd->c_reset();
  95                 return 1;
  96         }
  97         return 0;
  98 }