You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
lnav/docs/source/hotkeys.rst

248 lines
6.4 KiB
ReStructuredText

.. include:: kbd.rst
.. _hotkeys:
Hotkey Reference
================
This reference covers the keys used to control **lnav**. Consult the `built-in
help <https://github.com/tstack/lnav/blob/master/src/help.txt>`_ in **lnav** for
a more detailed explanation of each key.
Spatial Navigation
------------------
.. list-table::
:header-rows: 1
:widths: 6 6 6 20
* - Keypress
-
-
- Command
* - |ks| Space |ke|
- |ks| PgDn |ke|
-
- Down a page
* - |ks| b |ke|
- |ks| Backspace |ke|
- |ks| PgUp |ke|
- Up a page
* - |ks| j |ke|
- |ks| Return |ke|
- |ks| ↓ |ke|
- Down a line
* - |ks| k |ke|
- |ks| ↑ |ke|
-
- Up a line
* - |ks| h |ke|
- |ks| ← |ke|
-
- Left half a page. In the log view, pressing left while at the start of
the message text will reveal the source file name for each line.
Pressing again will reveal the full path.
* - |ks| Shift |ke| + |ks| h |ke|
- |ks| Shift |ke| + |ks| ← |ke|
-
- Left ten columns
* - |ks| l |ke|
- |ks| → |ke|
-
- Right half a page
* - |ks| Shift |ke| + |ks| l |ke|
- |ks| Shift |ke| + |ks| → |ke|
-
- Right ten columns
* - |ks| Home |ke|
- |ks| g |ke|
-
- Top of the view
* - |ks| End |ke|
- |ks| G |ke|
-
- Bottom of the view
* - |ks| e |ke|
- |ks| Shift |ke| + |ks| e |ke|
-
- Next/previous error
* - |ks| w |ke|
- |ks| Shift |ke| + |ks| w |ke|
-
- Next/previous warning
* - |ks| n |ke|
- |ks| Shift |ke| + |ks| n |ke|
-
- Next/previous search hit
* - |ks| > |ke|
- |ks| < |ke|
-
- Next/previous search hit (horizontal)
* - |ks| f |ke|
- |ks| Shift |ke| + |ks| f |ke|
-
- Next/previous file
* - |ks| u |ke|
- |ks| Shift |ke| + |ks| u |ke|
-
- Next/previous bookmark
* - |ks| o |ke|
- |ks| Shift |ke| + |ks| o |ke|
-
- Forward/backward through log messages with a matching "opid" field
* - |ks| y |ke|
- |ks| Shift |ke| + |ks| y |ke|
-
- Next/prevous SQL result
* - |ks| s |ke|
- |ks| Shift |ke| + |ks| s |ke|
-
- Next/prevous slow down in the log message rate
* - |ks| { |ke|
- |ks| } |ke|
-
- Previous/next location in history
Chronological Navigation
------------------------
.. list-table::
:header-rows: 1
:widths: 5 5 20
* - Keypress
-
- Command
* - |ks| d |ke|
- |ks| Shift |ke| + |ks| d |ke|
- Forward/backward 24 hours
* - |ks| 1 |ke| - |ks| 6 |ke|
- |ks| Shift |ke| + |ks| 1 |ke| - |ks| 6 |ke|
- Next/previous n'th ten minute of the hour
* - |ks| 7 |ke|
- |ks| 8 |ke|
- Previous/next minute
* - |ks| 0 |ke|
- |ks| Shift |ke| + |ks| 0 |ke|
- Next/previous day
* - |ks| r |ke|
- |ks| Shift |ke| + |ks| r |ke|
- Forward/backward by the relative time that was last used with the goto command.
Bookmarks
---------
.. list-table::
:header-rows: 1
:widths: 5 20
* - Keypress
- Command
* - |ks| m |ke|
- Mark/unmark the top line
* - |ks| Shift |ke| + |ks| m |ke|
- Mark/unmark the range of lines from the last marked to the top
* - |ks| Shift |ke| + |ks| j |ke|
- Mark/unmark the next line after the previously marked
* - |ks| Shift |ke| + |ks| k |ke|
- Mark/unmark the previous line
* - |ks| c |ke|
- Copy marked lines to the clipboard
* - |ks| Shift |ke| + |ks| c |ke|
- Clear marked lines
Display
-------
.. list-table::
:header-rows: 1
:widths: 5 20
* - Keypress
- Command
* - |ks| ? |ke|
- View/leave builtin help
* - |ks| q |ke|
- Return to the previous view/quit
* - |ks| Shift |ke| + |ks| q |ke|
- Return to the previous view/quit while matching the top times of the two views
* - |ks| a |ke|
- Restore the view that was previously popped with 'q/Q'
* - |ks| Shift |ke| + |ks| a |ke|
- Restore the view that was previously popped with 'q/Q' and match the top times of the views
* - |ks| Shift |ke| + |ks| p |ke|
- Switch to/from the pretty-printed view of the displayed log or text files
* - |ks| Shift |ke| + |ks| t |ke|
- Display elapsed time between lines
* - |ks| t |ke|
- Switch to/from the text file view
* - |ks| i |ke|
- Switch to/from the histogram view
* - |ks| Shift |ke| + |ks| i |ke|
- Switch to/from the histogram view
* - |ks| v |ke|
- Switch to/from the SQL result view
* - |ks| Shift |ke| + |ks| v |ke|
- Switch to/from the SQL result view and move to the corresponding in the
log_line column
* - |ks| p |ke|
- Toggle the display of the log parser results
* - |ks| Tab |ke|
- In the log/text views, focus on the configuration panel for editing
filters and examining the list of loaded files. In the SQL result view,
cycle through columns to display as bar graphs
* - |ks| Ctrl |ke| + |ks| l |ke|
- Switch to lo-fi mode. The displayed log lines will be dumped to the
terminal without any decorations so they can be copied easily.
* - |ks| Ctrl |ke| + |ks| w |ke|
- Toggle word-wrap.
* - |ks| Ctrl |ke| + |ks| p |ke|
- Show/hide the data preview panel that may be opened when entering
commands or SQL queries.
* - |ks| Ctrl |ke| + |ks| f |ke|
- Toggle the enabled/disabled state of all filters in the current view.
* - |ks| x |ke|
- Toggle the hiding of log message fields. The hidden fields will be
replaced with three bullets and highlighted in yellow.
* - |ks| = |ke|
- Pause/unpause loading of new file data.
Session
-------
.. list-table::
:header-rows: 1
:widths: 5 20
* - Keypress
- Command
* - |ks| Ctrl |ke| + |ks| R |ke|
- Reset current session.
Query
-----
.. list-table::
:header-rows: 1
:widths: 5 20
* - Keypress
- Command
* - |ks| / |ke|
- Search for lines matching a regular expression
* - |ks| ; |ke|
- Execute an SQL query
* - |ks| : |ke|
- Execute an internal command, see :ref:`commands` for more information
* - |ks| \| |ke|
- Execute an lnav script located in a format directory.
* - |ks| Ctrl |ke| + |ks| ] |ke|
- Abort the prompt
Customizing
-----------
You can customize the behavior of hotkeys by defining your own keymaps.
Consult the :ref:`Keymaps<keymaps>` configuration section for more information.