mirror of https://github.com/tstack/lnav synced 2024-11-03 23:15:38 +00:00

Go to file

Timothy Stack 826f9d18ec [build] add the source		2017-03-14 06:14:43 -07:00
docs	[vtab] add an lnav_view_stack table to get programmatic access to the view stack	2017-03-04 15:22:19 -08:00
example-scripts	[scripts] add an example script dir	2014-04-05 22:36:48 -07:00
m4	[listview] get a batch of rows from the source instead of a single one at a time	2017-03-14 06:05:46 -07:00
release	[vtab] add an lnav_view_stack table to get programmatic access to the view stack	2017-03-04 15:22:19 -08:00
src	[listview] get a batch of rows from the source instead of a single one at a time	2017-03-14 06:05:46 -07:00
test	[listview] get a batch of rows from the source instead of a single one at a time	2017-03-14 06:05:46 -07:00
.gitignore	add some compile-time artefacts to .gitignore	2016-11-19 14:35:43 +00:00
.travis.yml	[build] add the source	2017-03-14 06:14:43 -07:00
appveyor.yml	Add cygwin continuous integration through appveyor	2016-05-31 10:18:37 -03:00
AUTHORS	[misc] Update the AUTHORS and NEWS file.	2015-05-11 23:31:59 -07:00
autogen.sh	[autogen] More fixes.	2015-04-06 00:07:07 -07:00
CMakeLists.txt	[listview] get a batch of rows from the source instead of a single one at a time	2017-03-14 06:05:46 -07:00
configure.ac	[listview] get a batch of rows from the source instead of a single one at a time	2017-03-14 06:05:46 -07:00
INSTALL
LICENSE
lnav.1	[format] try to validate formats against a given file	2015-07-11 16:32:48 -07:00
lnav.cfg
Makefile.am
NEWS	[vtab] add an lnav_view_stack table to get programmatic access to the view stack	2017-03-04 15:22:19 -08:00
README	[nav] add "opid" support with a hotkey	2015-11-24 20:59:24 -08:00
README.md	Add LoC badge	2016-12-24 12:57:46 -08:00
TESTS_ENVIRONMENT.in	[cmd] replace wordexp with shlex	2015-12-25 12:03:44 -08:00

README.md

This is the source repository for lnav, visit http://lnav.org for a high level overview.

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

Lnav requires the following software packages:

libpcre - The Perl Compatible Regular Expression (PCRE) library.
sqlite - The SQLite database engine.
ncurses - The ncurses text UI library.
readline - The readline line editing library.
zlib - The zlib compression library.
bz2 - The bzip2 compression library.

Installation

Lnav follows the usual GNU style for configuring and installing software:

$ ./configure
$ make
$ sudo make install

Run ./autogen.sh before running any of the above commands when compiling from a cloned repository.

Cygwin users

It should compile fine in Cygwin.

Alternatively, you can get the generated binary from AppVeyor artifacts.

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.

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.