Return to xload.1 CVS log

Up to [CSRG BSD Unix] / 43BSD / contrib / X / man

Annotation of 43BSD/contrib/X/man/xload.1, revision 1.1

1.1     ! root        1: .TH XLOAD 1 "18 August 1985" "X Version 10"
        !             2: .SH NAME
        !             3: xload - X window system load average display
        !             4: .SH SYNOPSIS
        !             5: .B xload
        !             6: [ option ] ...
        !             7: .SH DESCRIPTION
        !             8: .I xload 
        !             9: continuously displays the system load average under the
        !            10: .I X
        !            11: window system.
        !            12: .I xload
        !            13: creates a window in which the load average is represented as a bar graph
        !            14: with n divisions. Each division represents one unit of load average.
        !            15: The name of the host is displayed in the upper left corner.
        !            16: .PP
        !            17: .I xload
        !            18: understands the following options:
        !            19: .PP
        !            20: .TP 8
        !            21: .B \-bd \fIcolor\fP
        !            22: Specify the border color.  On monochrome displays, should be ``white'', ``black'',
        !            23: or ``gray''; gray is the default.
        !            24: .PP
        !            25: .TP 8
        !            26: .B \-bg \fIcolor\fP
        !            27: Specify the background color.  On monochrome displays, should be ``white'' or
        !            28: ``black''; black is the default.
        !            29: .PP
        !            30: .TP 8
        !            31: .B \-bw \fIpixels\fP
        !            32: Specify the width in pixels of the border around the
        !            33: .I xload
        !            34: window. The default value is 3 pixels.
        !            35: .PP
        !            36: .TP 8
        !            37: .B \-fg \fIcolor\fP
        !            38: Specify the graph color.  On monochrome displays, should be ``white'' or ``black'';
        !            39: white is the default.
        !            40: .PP
        !            41: .TP 8
        !            42: .B \-fn \fIfontname\fP
        !            43: The hostname will be displayed in the specified font (if none
        !            44: is specified, this defaults to 6x10).
        !            45: .PP
        !            46: .TP 8
        !            47: .B \-hl \fIcolor\fP
        !            48: Specify the hostname and scale line color; the default is to make it the same
        !            49: as the graph color.
        !            50: .PP
        !            51: .TP 8
        !            52: .B \-rv
        !            53: Cause
        !            54: .I xload
        !            55: to produce all output in black-on-white instead of white-on-black.
        !            56: .PP
        !            57: .TP 8
        !            58: .B \-fw
        !            59: Cause
        !            60: .I xload
        !            61: to produce all output in white-on-black instead of black-on-white.
        !            62: .PP
        !            63: .TP 8
        !            64: .B \-scale \fIinteger\fP
        !            65: Specify the minimum number of divisions on the graph (default 1).
        !            66: .I Xload
        !            67: is free to use more divisions if the load gets too high to display,
        !            68: but it will never use fewer divisions than this.
        !            69: .PP
        !            70: .TP 8
        !            71: .B \-update \fIseconds\fP
        !            72: Specify the frequency in seconds with which
        !            73: .I xload
        !            74: updates its display (except if the
        !            75: .I xload
        !            76: window is obscured and then exposed, immediate redisplay occurs).  The default
        !            77: update frequency is 5 seconds.  Specification of a frequency
        !            78: less than 5 seconds is ignored and the default frequency is used instead.
        !            79: .PP
        !            80: .TP 8
        !            81: .B =\fIgeometry\fP
        !            82: The load graph window is created with the specified
        !            83: size and location
        !            84: determined
        !            85: by the supplied geometry specification.
        !            86: See \fIX(1)\fP for a full explanation.
        !            87: .PP
        !            88: .TP 8
        !            89: .B \[\fIhost\fP]:\[\fIdisplay\fP]
        !            90: Normally,
        !            91: .I xload
        !            92: gets the host and display number to use from the environment
        !            93: variable ``DISPLAY''.  Either or both can be specified with this option.
        !            94: .I host
        !            95: specifies which machine to create the
        !            96: .I xload
        !            97: window on, and
        !            98: .I display
        !            99: specifies the display number.
        !           100: For example,
        !           101: ``mit-grape-nehi:0'' creates an
        !           102: .I xload
        !           103: on display 0 on machine mit-grape-nehi. Either value can be defaulted
        !           104: by omission but ``:'' is necessary to specify one or both.
        !           105: .SH X DEFAULTS
        !           106: .PP
        !           107: .TP 8
        !           108: .B Foreground
        !           109: Set the graph color.
        !           110: .PP
        !           111: .TP 8
        !           112: .B Background
        !           113: Set the background color.
        !           114: .PP
        !           115: .TP 8
        !           116: .B BodyFont
        !           117: Set the hostname font.
        !           118: .PP
        !           119: .TP 8
        !           120: .B Border
        !           121: Set the internal border padding.
        !           122: .PP
        !           123: .TP 8
        !           124: .B BorderColor
        !           125: Set the border color.
        !           126: .PP
        !           127: .TP 8
        !           128: .B BorderWidth
        !           129: Set the border width of the window.
        !           130: .PP
        !           131: .TP 8
        !           132: .B Highlight
        !           133: Set the hostname and scale line color.
        !           134: .PP
        !           135: .TP 8
        !           136: .B ReverseVideo
        !           137: If ``on'', reverse the definition of foreground and background color.
        !           138: .PP
        !           139: .TP 8
        !           140: .B Scale
        !           141: Set the minimum scale.
        !           142: .PP
        !           143: .TP 8
        !           144: .B Update
        !           145: Set the update interval.
        !           146: .SH ENVIRONMENT
        !           147: DISPLAY - to get the default host and display number.
        !           148: .SH SEE ALSO
        !           149: X(10, xwm(1), X(8C), mem(4), select(2)
        !           150: .SH DIAGNOSTICS
        !           151: Unable to open display or create window. Unable to open /dev/kmem.
        !           152: Unable to query window for dimensions. Various X errors.
        !           153: .SH BUGS
        !           154: .I xload
        !           155: requires the ability to open and read /dev/kmem. On most systems, this requires
        !           156: the suid bit set with root ownership or the sgid bit set and membership in 
        !           157: the same group as /dev/kmem. 
        !           158: .SH AUTHORS
        !           159: K. Shane Hartman (MIT-LCS), Stuart A. Malone (MIT-LCS)
        !           160: .br
        !           161: Host name feature added by Jim Gettys (MIT-Athena).
        !           162: Scale feature added by Bob Scheifler (MIT-LCS).
        !           163: Automatic rescaling feature added by Stuart A. Malone (MIT-LCS).
        !           164: .br
        !           165: Copyright (c) 1985, Massachusetts Institute of Technology.
        !           166: .br
        !           167: See X(1) for a complete copyright notice.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.