[0m


XPERFMON(1)	    UNIX Programmer's Manual	      XPERFMON(1)



[1mNAME
     [0mxperfmon - X Window System-based performance monitor

[1mSYNOPSIS
     xperfmon [0m[-_t_o_o_l_k_i_t_o_p_t_i_o_n ...] [-_a_d_d_i_t_i_o_n_a_l_o_p_t_i_o_n ...]

[1mDESCRIPTION
     [0m_x_p_e_r_f_m_o_n continuously displays several system statistics as
     a set of parallel line graphs.  The name of the host is
     displayed in the upper left hand corner.  The information is
     scaled so that it fills up the entire window.  While _x_p_e_r_f_-
     _m_o_n is running, it is possible to perform certain tasks by
     pressing keys over the window:

     [1mQ/q: [0mQuit
     [1mR/r: [0mReset graph and timer
     [1ms: [0mDecrease update interval (slower) by a small amount
     [1mS: [0mDecrease update interval (slower) by a large amount
     [1mf: [0mIncrease update interval (faster) by a small amount
     [1mF: [0mIncrease update interval (faster) by a large amount
     [1m?: [0mHelp

[1mOPTIONS
     [0m_x_p_e_r_f_m_o_n accepts all of the standard X Toolkit command line
     options along with the following additional options:

     [1m-up | -update [0m_s_e_c_o_n_d_s
	     This options specifies the update interval for the
	     graph in seconds.	The default is 5.

     [1m-st | -stepsize [0m_p_i_x_e_l_s
	     This option specifies the stepsize of the graph.
	     The default is one pixel.

     [1m-user | -usercpu
     -sys | -systemcpu
     -idle | -idlecpu

     -free | -freemem
	     [0mThese options specify the list of statistics to be
	     displayed.  If none are listed, then all are
	     displayed.  If any are listed, only those listed are
	     displayed.  Possible statistics are [1muser, system,
	     idle, [0mand [1mfree. [0mThese refer to [1mUser CPU percentage,
	     System CPU percentage, Idle CPU percentage, [0mand [1mFree
	     memory.

     [0mThe following standard X Toolkit arguments are commonly used
     with _x_p_e_r_f_m_o_n:

     [1m-d | -display [0m_d_i_s_p_l_a_y
	     This option specifies the X server to contact.



Printed 12/3/93                                                 1






XPERFMON(1)	    UNIX Programmer's Manual	      XPERFMON(1)



     [1m-g | -geometry [0m_g_e_o_m_e_t_r_y
	     The xperfmon window is created with the specified
	     size and location determined by the supplied
	     geometry specification.  See _X(_1) for a full expla-
	     nation.

     [1m-rv | -reverse
	     [0mThis option indicates that reverse video should be
	     simulated by swapping the foreground and background
	     colors.

     [1m-bd | -bordercolor [0m_c_o_l_o_r
	     This option specifies the border color.  The default
	     is _b_l_a_c_k.

     [1m-bg | -background [0m_c_o_l_o_r
	     This option specifies the background color.  The
	     default is _w_h_i_t_e.

     [1m-bw | -borderwidth [0m_p_i_x_e_l_s
	     This option specifies the width in pixels of the
	     border around the window.	The default value is 2.

     [1m-fg | -foreground [0m_c_o_l_o_r
	     This option specifies the foreground color.  The
	     default color is _b_l_a_c_k.

     [1m-fn | -font [0m_f_o_n_t_n_a_m_e
	     This options specifies the font to be used in
	     displaying the hostname and labels.  The default is
	     _6_X_1_0.

     [1m-xrm [0m_r_e_s_o_u_r_c_e_s_t_r_i_n_g
	     This option specifies a resource string to be used.
	     This is especially useful for setting resources that
	     do not have separate command line options.

[1mX DEFAULTS
     [0m_x_p_e_r_f_m_o_n understands all of the core resource names and
     classes as well as:

     [1mwidth ([0mclass [1mWidth)
	     [0mSpecifies the width of the load average graph.

     [1mheight ([0mclass [1mHeight)
	     [0mSpecifies the height of the load average graph.

     [1mupdate ([0mclass [1mInterval)
	     [0mSpecifies the frequency in seconds at which the per-
	     formance statistics should be redisplayed.  [1mstepSize
	     ([0mclass [1mStepSize) [0mSpecifies the number of pixels that
	     should be drawn for each update of the performance



Printed 12/3/93                                                 2






XPERFMON(1)	    UNIX Programmer's Manual	      XPERFMON(1)



	     statistics.  [1mforeground ([0mclass [1mForeground) [0mSpecifies
	     the color for the foreground.  The default is _b_l_a_c_k
	     since the core default for background is _w_h_i_t_e.

     [1mfont ([0mclass [1mFont)
	     [0mSpecifies the font to be used for the label.  The
	     default is _f_i_x_e_d.

     [1mreverseVideo ([0mclass [1mReverseVideo)
	     [0mSpecifies that the foreground and background should
	     be reversed.

[1mENVIRONMENT VARIABLES
     [0mDISPLAY - specifies the default host and display number.

[1mSEE ALSO
     [0mX(1), uwm(1), xload(1), mem(4)

[1mBUGS
     [0m_x_p_e_r_f_m_o_n requires the ability to open and read the special
     system file /_d_e_v/_k_m_e_m. On most systems, this requires the
     _s_u_i_d (set user id) bit to be set with root ownership, or the
     _s_g_i_d (set group id) bit to be set and membership in the same
     group as /_d_e_v/_k_m_e_m.

     Reading /dev/kmem is inherently non-portable.  Therefore,
     the widget upon which this application is based must be
     ported to each new operating system.

     Border color has to be explicitly specified when reverse
     video is used.

[1mAUTHORS
     [0mThe X11 version of _x_p_e_r_f_m_o_n was written by Emanuel Jay Berk-
     enbilt, Project Athena on 1/21/1988.  There is no record of
     previous authors.	_x_p_e_r_f_m_o_n was modified by Thomas Bagli,
     PCS Computer Systeme GmbH, West Germany, to be a toolkit-
     based client.

















Printed 12/3/93                                                 3



[0m