xref: /lnav/
NameDateSize

..16-Mar-201612 KiB

.gitignore07-Apr-20151.4 KiB

.travis.yml10-Aug-2015851

AUTHORS12-May-2015306

autogen.sh07-Apr-2015560

CMakeLists.txt02-Oct-201498

configure.ac28-Sep-20156.8 KiB

docs/03-Apr-20144 KiB

example-scripts/07-Apr-20144 KiB

INSTALL03-Apr-20149 KiB

LICENSE03-Apr-20141.3 KiB

lnav.107-Aug-20152.8 KiB

lnav.cfg03-Apr-201419.6 KiB

m4/10-Dec-20154 KiB

Makefile.am03-Apr-2014156

NEWS10-Dec-201513.3 KiB

README30-Nov-20151.5 KiB

README.md12-Oct-20152.1 KiB

release/28-Sep-20154 KiB

src/11-Dec-20154 KiB

test/10-Dec-20154 KiB

TESTS_ENVIRONMENT.in10-Dec-20153 KiB

README

1
2LNAV
3----
4
5The log file navigator, lnav, is an enhanced log file viewer that
6takes advantage of any semantic information that can be gleaned from
7the files being viewed, such as timestamps and log levels.  Using this
8extra semantic information, lnav can do things like interleaving
9messages from different files, generate histograms of messages over
10time, and providing hotkeys for navigating through the file.  It is
11hoped that these features will allow the user to quickly and
12efficiently zero in on problems.
13
14
15PREREQUISITES
16-------------
17
18Lnav requires the following software packages:
19
20  libpcre   - The Perl Compatible Regular Expression (PCRE) library.
21  sqlite    - The SQLite database engine.
22  ncurses   - The ncurses text UI library.
23  readline  - The readline line editing library.
24  zlib      - The zlib compression library.
25  bz2       - The bzip2 compression library.
26  re2c      - The re2c scanner generator.
27  libcurl   - The cURL library for downloading files from URLs.  Version
28              7.23.0 or higher is required.
29
30
31INSTALLATION
32------------
33
34Lnav follows the usual GNU style for configuring and installing software:
35
36  $ ./configure
37  $ make
38  $ sudo make install
39
40
41USING
42-----
43
44The only file installed is the executable, "lnav".  You can execute it
45with no arguments to view the default set of files:
46
47  $ lnav
48
49You can view all the syslog messages by running:
50
51  $ lnav /var/log/messages*
52
53
54SUPPORT
55-------
56
57The lnav mailing list can be reached at:
58
59  lnav@googlegroups.com
60
61
62SEE ALSO
63--------
64
65The lnav website:
66
67  http://lnav.org
68

README.md

1[![Build Status](https://travis-ci.org/tstack/lnav.png)](https://travis-ci.org/tstack/lnav)
2[![Bounties](https://img.shields.io/bountysource/team/lnav/activity.svg)](https://www.bountysource.com/teams/lnav)
3
4_This is the source repository for **lnav**, visit [http://lnav.org](http://lnav.org) for a high level overview._
5
6LNAV -- The Logfile Navigator
7=============================
8
9The log file navigator, lnav, is an enhanced log file viewer that
10takes advantage of any semantic information that can be gleaned from
11the files being viewed, such as timestamps and log levels.  Using this
12extra semantic information, lnav can do things like interleaving
13messages from different files, generate histograms of messages over
14time, and providing hotkeys for navigating through the file.  It is
15hoped that these features will allow the user to quickly and
16efficiently zero in on problems.
17
18
19Prerequisites
20-------------
21
22Lnav requires the following software packages:
23
24  * libpcre   - The Perl Compatible Regular Expression (PCRE) library.
25  * sqlite    - The SQLite database engine.
26  * ncurses   - The ncurses text UI library.
27  * readline  - The readline line editing library.
28  * zlib      - The zlib compression library.
29  * bz2       - The bzip2 compression library.
30
31
32Installation
33------------
34
35Lnav follows the usual GNU style for configuring and installing software:
36
37    $ ./configure
38    $ make
39    $ sudo make install
40
41__Run ```./autogen.sh``` before running any of the above commands when
42compiling from a cloned repository.__
43
44Using
45-----
46
47The only file installed is the executable, "lnav".  You can execute it
48with no arguments to view the default set of files:
49
50    $ lnav
51
52You can view all the syslog messages by running:
53
54    $ lnav /var/log/messages*
55
56
57Screenshot
58----------
59
60The following screenshot shows a syslog file. Log lines are displayed with
61highlights. Errors are red and warnings are yellow.
62
63[![Screenshot](http://tstack.github.io/lnav/lnav-syslog-thumb.png)](http://tstack.github.io/lnav/lnav-syslog.png)
64
65See Also
66--------
67
68The lnav website can be found at:
69
70> [http://lnav.org](http://lnav.org)
71