Return to xload.man CVS log

Up to [Research Unix] / researchv9 / X11 / src / X.V11R1 / clients / xload

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