.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sh \" Subsection heading
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  | will give a
.\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used to
.\" do unbreakable dashes and therefore won't be available.  \*(C` and \*(C'
.\" expand to `' in nroff, nothing in troff, for use with C<>.
.tr \(*W-|\(bv\*(Tr
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.if \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.\"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.hy 0
.if n .na
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "TOPLESS 1"
.TH TOPLESS 1 "2005-12-20" "topless" "General Commands Manual"
.SH "NAME"
topless \- display command output on the whole screen like "top"
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBtopless\fR [\fB\-cwVhv\fR] [\fB\-s\fR \fIseconds\fR] [\fB\-n\fR \fInumber\fR] [\fB\-a\fR \fIcommand\fR] \fI\s-1COMMAND\s0\fR
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBtopless\fR reads various command output, displays it on the whole screen
(like \fBless\fR), and periodically updates it like \fBtop\fR.
.PP
\&\fBtopless\fR can be used with almost every sort of command,
but is particularly useful when used with the command
to monitor the system, such as \fBps\fR, \fBnetstat\fR or \fBfstat\fR.
See \fB\s-1EXAMPLES\s0\fR below for details.
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-c\fR" 4
.IX Item "-c"
The lines difference from the previous screen update are colorized.
(default: false)
.IP "\fB\-s\fR \fIseconds\fR" 4
.IX Item "-s seconds"
Set the screen update periods to \fIseconds\fR seconds.
If the \fIsleep\fR\|(1) command accepts and honors a non-integer number of seconds,
\&\fIseconds\fR can be a non-integer number. (default: 1)
.IP "\fB\-n\fR \fInumber\fR" 4
.IX Item "-n number"
The lines are kept colorized for \fInumber\fR times screen update
when \-c is also enabled.
Once a line is colorized, that line becomes blue on next screen update,
and remains blue until the line returns to be original color. (default: 1)
.IP "\fB\-a\fR \fIcommand\fR" 4
.IX Item "-a command"
Topless enforce the specified command when \s-1COMMAND\s0 output gets difference 
from the previous output assumed for alert use, instead of \-c use for 
monochrome monitor or others. (default: false)
.IP "\fB\-w\fR" 4
.IX Item "-w"
Topless will use as many columns as necessary without regard for your window 
size. (default: true)
.IP "\fB\-V\fR" 4
.IX Item "-V"
Topless gets information header. (default: false)
.IP "\fB\-h\fR" 4
.IX Item "-h"
Print help message.
.IP "\fB\-v\fR" 4
.IX Item "-v"
Print version.
.SH "KEY COMMAND"
.IX Header "KEY COMMAND"
.IP "\fBq\fR" 4
.IX Item "q"
quit topless
.SH "EXAMPLES"
.IX Header "EXAMPLES"
Display the output of \f(CW\*(C`ps axuww\*(C'\fR like \fBtop\fR:
.PP
.Vb 1
\&    % topless ps axuww
.Ve
.PP
Same as the above, but the lines difference from the previous screen update
are colorized.
.PP
.Vb 1
\&    % topless -c ps axuww
.Ve
.PP
Set the screen update periods to 0.1 seconds
(suppose the \fIsleep\fR\|(1) command can honor non-integer number of seconds):
.PP
.Vb 1
\&    % topless -s 0.1 ps axuww
.Ve
.PP
Once a line is colorized, that line becomes blue on next screen update,
and remains blue after the next 10 times update:
.PP
.Vb 1
\&    % topless -c -n 10 netstat -a
.Ve
.PP
\&\fI\s-1COMMAND\s0\fR can be a more complex one, such as the one that contains pipe:
.PP
.Vb 1
\&    % topless 'fstat -f /var| sort -k8 -nr'
.Ve
.PP
.Vb 1
\&    % topless -c 'sockstat | egrep "([0-9]{1,3}[.]){3}[0-9]{1,3}"'
.Ve
.PP
Display the outout of \f(CW\*(C`ps axuww\*(C'\fR like \fBtop\fR with information header like
\&\fIwatch\fR\|(1) of Linux:
.PP
.Vb 1
\&    % topless -V ps axuww
.Ve
.PP
Alert when /var/log/messages gets change:
.PP
.Vb 1
\&    % topless -a "tput bl" tail /var/log/messages
.Ve
.PP
Alert when /var/log/messages gets change running as deamon mode:
.PP
.Vb 2
\&    # kldload speaker
\&    # daemon topless -a "echo AAA > /dev/speaker" tail /var/log/messages > /dev/null
.Ve
.SH "AUTHORS"
.IX Header "AUTHORS"
.IP "Daichi \s-1GOTO\s0  <daichi@FreeBSD.org>" 4
.IX Item "Daichi GOTO  <daichi@FreeBSD.org>"
.PD 0
.IP "\s-1KOMATSU\s0 Shinichiro <koma2@lovepeers.org> (documents)" 4
.IX Item "KOMATSU Shinichiro <koma2@lovepeers.org> (documents)"
.PD
.SH "PORTABILITY"
.IX Header "PORTABILITY"
\&\fBtopless\fR can work on various platforms, and has been reported to work
on the following platforms:
.PP
.Vb 2
\&    FreeBSD, NetBSD, OpenBSD, Linux, MacOS X, SuSE 9.1, 
\&    Solaris 10/8 (ksh is required)
.Ve
.PP
If you find \fBtopless\fR does not work on your platform,
feel free to send a patch to the author.
Your patch is *always* welcome. ;)
.SH "CAVEATS"
.IX Header "CAVEATS"
Special care must be taken when you search about \fBtopless\fR,
especially when you are at your office or with your family,
because the search results may not be what you expected.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fItop\fR\|(1) \fIless\fR\|(1)