
Notes on nsc v0.80
==================

Monitoring a Nagios on a remote host
------------------------------------
Please see the nsc man-page (nsc.doc / 'man nsc') for information about this.


Nagios v2 support
-----------------
nsc automatically detects the format of the Nagios status.log file
and handles Nagios v1.1, v1.2 and v2.0b3 format status.log's.


Sorting by node
---------------
The 'n' key turns toggles sorting by nodename on/off. While on, sorting
will be done by nodename, status and service. If off, sorting is done by
status, nodename and service. 

Any of the above may be reversed with 'r' :-)


Notes on nsc v0.70
==================

Improved background colouring
-----------------------------
I've tested nsc on various platforms to investigate proper setups for nsc
in colours and with the background colour properly rendered. nsc in
monochrome in general just works fine (when $TERM is about right), whereas
nsc in proper colours often requires a tweaked TERM-setting.

 - Linux Mandrake 9.1-10.2:
    - putty (+ screen): TERM=xterm-color works as advertised
 - Solaris 9:
    - CDE xterm window                                   ?colour?
    - putty via ssh + screen: TERM=xterm-color works as advertised
 - FreeBSD 4.7:
    - putty + ssh in screen: TERM=vt340-color works as advertised

At least two different putty versions were used in testing.

"works" as advertised" means that nsc will produce colour and that
it looks right, specifically regarding producing an even-coloured
background.

The above list is much shorter than what nsc actually will work with. So if
you find new platform/terminal combos that just works, including colours,
please send me info (<nsc@gothix.dk>) to be added to the "nsc certified
terminals" list above.


Configurable colours
--------------------
To use, run the new version of nsc.pl to get defaults written to the
configuration file.

After quitting nsc, edit ~/.nsc.conf to set the colours.

The '!normal' colour/attribute refers to the 'normal' colour/attribute and
is just a shorthand to avoid specifying 'white on magenta' seven times.


Auto-roller
-----------
This is controlled by two parameters in .nsc.conf:

'roll_wait' is the number of seconds to wait since last keypress
until rolling starts.

'roll' is the time in seconds between shown pages - if this is
set to -1, then rolling will be disabled.


Map external commands to keys in nsc
------------------------------------
This is done with 'usercmd_X' in your ~/.nsc.conf - see .nsc.conf 
for an example (top).

To edit passwd with the 'W' key from within nsc, add this to .nsc.conf:

   usercmd_W=vi /etc/passwd


# vim:tw=75:
# $Id: NOTES.txt 2846 2005-05-15 19:23:37Z shj $

#.
