2013-04-10 07:36:08 +02:00
|
|
|
[](https://travis-ci.org/tstack/lnav)
|
2016-06-04 21:52:32 +02:00
|
|
|
[](https://ci.appveyor.com/project/tstack/lnav)
|
2015-10-08 05:14:33 +02:00
|
|
|
[](https://www.bountysource.com/teams/lnav)
|
2016-12-24 21:57:46 +01:00
|
|
|
[](https://github.com/tstack/lnav).
|
2013-04-10 07:36:08 +02:00
|
|
|
|
2013-08-30 17:55:49 +02:00
|
|
|
_This is the source repository for **lnav**, visit [http://lnav.org](http://lnav.org) for a high level overview._
|
|
|
|
|
|
2013-04-10 07:36:08 +02:00
|
|
|
LNAV -- The Logfile Navigator
|
|
|
|
|
=============================
|
|
|
|
|
|
|
|
|
|
The log file navigator, lnav, is an enhanced log file viewer that
|
|
|
|
|
takes advantage of any semantic information that can be gleaned from
|
|
|
|
|
the files being viewed, such as timestamps and log levels. Using this
|
|
|
|
|
extra semantic information, lnav can do things like interleaving
|
|
|
|
|
messages from different files, generate histograms of messages over
|
|
|
|
|
time, and providing hotkeys for navigating through the file. It is
|
|
|
|
|
hoped that these features will allow the user to quickly and
|
|
|
|
|
efficiently zero in on problems.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Prerequisites
|
|
|
|
|
-------------
|
|
|
|
|
|
2017-03-16 01:01:58 +01:00
|
|
|
The following software packages are required to build lnav:
|
2013-04-10 07:36:08 +02:00
|
|
|
|
2017-03-16 01:01:58 +01:00
|
|
|
* gcc/clang - A C++14-compatible compiler.
|
2013-04-10 07:36:08 +02:00
|
|
|
* libpcre - The Perl Compatible Regular Expression (PCRE) library.
|
2017-03-16 01:01:58 +01:00
|
|
|
* sqlite - The SQLite database engine. Version 3.9.0 or higher is required.
|
2013-04-10 07:36:08 +02:00
|
|
|
* ncurses - The ncurses text UI library.
|
|
|
|
|
* readline - The readline line editing library.
|
|
|
|
|
* zlib - The zlib compression library.
|
|
|
|
|
* bz2 - The bzip2 compression library.
|
2017-03-16 01:01:58 +01:00
|
|
|
* libcurl - The cURL library for downloading files from URLs. Version 7.23.0 or higher is required.
|
2013-04-10 07:36:08 +02:00
|
|
|
|
|
|
|
|
|
|
|
|
|
Installation
|
|
|
|
|
------------
|
|
|
|
|
|
|
|
|
|
Lnav follows the usual GNU style for configuring and installing software:
|
|
|
|
|
|
|
|
|
|
$ ./configure
|
|
|
|
|
$ make
|
|
|
|
|
$ sudo make install
|
|
|
|
|
|
2015-04-05 11:53:51 +02:00
|
|
|
__Run ```./autogen.sh``` before running any of the above commands when
|
|
|
|
|
compiling from a cloned repository.__
|
2013-04-10 07:36:08 +02:00
|
|
|
|
2016-05-31 15:18:37 +02:00
|
|
|
|
|
|
|
|
Cygwin users
|
|
|
|
|
------------
|
|
|
|
|
|
|
|
|
|
It should compile fine in Cygwin.
|
|
|
|
|
|
2016-06-04 21:52:32 +02:00
|
|
|
Alternatively, you can get the generated binary from [AppVeyor](https://ci.appveyor.com/project/tstack/lnav) artifacts.
|
2016-05-31 15:18:37 +02:00
|
|
|
|
|
|
|
|
Remember that you still need the lnav dependencies under Cygwin, here is a quick way to do it:
|
|
|
|
|
|
|
|
|
|
`setup-x86_64.exe -q -P libpcre1 -P libpcrecpp0 -P libsqlite3_0 -P libstdc++6`
|
|
|
|
|
|
|
|
|
|
Currently, the x64 version seems to be working better than the x86 one.
|
|
|
|
|
|
|
|
|
|
|
2013-04-10 07:36:08 +02:00
|
|
|
Using
|
|
|
|
|
-----
|
|
|
|
|
|
|
|
|
|
The only file installed is the executable, "lnav". You can execute it
|
|
|
|
|
with no arguments to view the default set of files:
|
|
|
|
|
|
|
|
|
|
$ lnav
|
|
|
|
|
|
|
|
|
|
You can view all the syslog messages by running:
|
|
|
|
|
|
|
|
|
|
$ lnav /var/log/messages*
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Screenshot
|
|
|
|
|
----------
|
|
|
|
|
|
|
|
|
|
The following screenshot shows a syslog file. Log lines are displayed with
|
|
|
|
|
highlights. Errors are red and warnings are yellow.
|
|
|
|
|
|
|
|
|
|
[](http://tstack.github.io/lnav/lnav-syslog.png)
|
|
|
|
|
|
|
|
|
|
See Also
|
|
|
|
|
--------
|
|
|
|
|
|
|
|
|
|
The lnav website can be found at:
|
|
|
|
|
|
|
|
|
|
> [http://lnav.org](http://lnav.org)
|
