=head1 NAME

topless - display command output on the whole screen like "top"

=head1 SYNOPSIS

B<topless> [B<-cwVhv>] [B<-s> I<seconds>] [B<-n> I<number>] [B<-a> I<command>] I<COMMAND>

=head1 DESCRIPTION

B<topless> reads various command output, displays it on the whole screen
(like B<less>), and periodically updates it like B<top>.

B<topless> can be used with almost every sort of command,
but is particularly useful when used with the command
to monitor the system, such as B<ps>, B<netstat> or B<fstat>.
See B<EXAMPLES> below for details.

=head1 OPTIONS

=over 4

=item B<-c>

The lines difference from the previous screen update are colorized.
(default: false)

=item B<-s> I<seconds>

Set the screen update periods to I<seconds> seconds.
If the sleep(1) command accepts and honors a non-integer number of seconds,
I<seconds> can be a non-integer number. (default: 1)

=item B<-n> I<number>

The lines are kept colorized for I<number> 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)

=item B<-a> I<command>

Topless enforce the specified command when COMMAND output gets difference 
from the previous output assumed for alert use, instead of -c use for 
monochrome monitor or others. (default: false)

=item B<-w>

Topless will use as many columns as necessary without regard for your window 
size. (default: true)

=item B<-V>

Topless gets information header. (default: false)

=item B<-h>

Print help message.

=item B<-v>

Print version.

=back

=head1 KEY COMMAND

=over 4

=item B<q>

quit topless

=back

=head1 EXAMPLES

Display the output of C<ps axuww> like B<top>:

    % topless ps axuww

Same as the above, but the lines difference from the previous screen update
are colorized.

    % topless -c ps axuww

Set the screen update periods to 0.1 seconds
(suppose the sleep(1) command can honor non-integer number of seconds):

    % topless -s 0.1 ps axuww

Once a line is colorized, that line becomes blue on next screen update,
and remains blue after the next 10 times update:

    % topless -c -n 10 netstat -a

I<COMMAND> can be a more complex one, such as the one that contains pipe:

    % topless 'fstat -f /var| sort -k8 -nr'

    % topless -c 'sockstat | egrep "([0-9]{1,3}[.]){3}[0-9]{1,3}"'

Display the outout of C<ps axuww> like B<top> with information header like
watch(1) of Linux:

    % topless -V ps axuww

Alert when /var/log/messages gets change:

    % topless -a "tput bl" tail /var/log/messages

Alert when /var/log/messages gets change running as deamon mode:

    # kldload speaker
    # daemon topless -a "echo AAA > /dev/speaker" tail /var/log/messages > /dev/null

=head1 AUTHORS

=over 4

=item Daichi GOTO  <daichi@FreeBSD.org>

=item KOMATSU Shinichiro <koma2@lovepeers.org> (documents)

=back

=head1 PORTABILITY

B<topless> can work on various platforms, and has been reported to work
on the following platforms:

    FreeBSD, NetBSD, OpenBSD, Linux, MacOS X, SuSE 9.1, 
    Solaris 10/8 (ksh is required)

If you find B<topless> does not work on your platform,
feel free to send a patch to the author.
Your patch is *always* welcome. ;)

=head1 CAVEATS

Special care must be taken when you search about B<topless>,
especially when you are at your office or with your family,
because the search results may not be what you expected.

=head1 SEE ALSO

top(1) less(1)