diff options
Diffstat (limited to 'lnav.1')
| -rw-r--r-- | lnav.1 | 126 |
1 files changed, 126 insertions, 0 deletions
@@ -0,0 +1,126 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.43.3.
+.\" Some roff macros, for reference:
+.\" .nh disable hyphenation
+.\" .hy enable hyphenation
+.\" .ad l left justify
+.\" .ad b justify to both left and right margins
+.\" .nf disable filling
+.\" .fi enable filling
+.\" .br insert line break
+.\" .sp <n> insert n+1 empty lines
+.\" for manpage-specific macros, see man(7)
+.\" Define macros
+.de Vb \" Begin verbatim text
+.ft CW
+.nf
+.ne \\$1
+..
+.de Ve \" End verbatim text
+.ft R
+.fi
+..
+.TH LNAV "1" "August 2022"
+.SH NAME
+lnav \- ncurses-based log file viewer
+.SH SYNOPSIS
+.B lnav
+[\-hVsar] [logfile1 logfile2 ...]
+.SH DESCRIPTION
+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.
+.SH KEY BINDINGS
+.TP
+?
+View/leave the online help text.
+.TP
+q
+Quit the program.
+.SH OPTIONS
+.TP
+\fB\-h\fR
+Print help and exit
+.TP
+\fB\-H\fR
+Display the internal help text.
+.TP
+\fB\-n\fR
+Run without the curses UI. (headless mode)
+.TP
+\fB\-c\fR cmd
+Execute a command after the files have been loaded.
+.TP
+\fB\-f\fR path
+Execute the commands in the given file.
+.TP
+\fB\-I\fR path
+Add the given configuration directory to the search path.
+.TP
+\fB\-n\fR
+Do not open the default syslog file if no files are given.
+.TP
+\fB\-q\fR
+Quiet mode. Do not print the log messages after executing all of the commands.
+.TP
+\fB\-i\fR
+Install the given format files in the $HOME/.lnav/formats/installed directory
+and exit.
+.TP
+\fB\-u\fR
+Update formats installed from git repositories.
+.TP
+\fB\-C\fR
+Check the configuration and exit. The log format files will be loaded and
+checked. Any files given on the command-line will be loaded checked to make
+sure they match a log format.
+.TP
+\fB\-d\fR file
+Write debug messages to the given file.
+.TP
+\fB\-V\fR
+Print version information.
+.TP
+\fB\-r\fR
+Recursively load files from the given directories.
+.TP
+\fB\-R\fR
+Load older rotated log files as well.
+.TP
+\fB\-t\fR
+Prepend timestamps to the lines of data being read in
+on the standard input.
+.TP
+\fB\-w\fR file
+Write the contents of the standard input to this file.
+.SS "Optional arguments:"
+.TP
+logfile1
+The log files or directories to view. If a
+directory is given, all of the files in the
+directory will be loaded.
+.SH EXAMPLES
+To load and follow the syslog file:
+.PP
+.Vb 1
+\& lnav
+.Ve
+.PP
+To load all of the files in /var/log:
+.PP
+.Vb 1
+\& lnav /var/log
+.Ve
+.PP
+To watch the output of make with timestamps prepended:
+.PP
+.Vb 1
+\& make 2>&1 | lnav \-t
+.Ve
+.SH AUTHOR
+This manual page was written by Salvatore Bonaccorso <carnil@debian.org>
+for the Debian system (but may be used by others).
|