From a991b61be4e426f3c1f5b2b98ce5e59d3b14a56b Mon Sep 17 00:00:00 2001
From: rebortg <github@ghlr.de>
Date: Tue, 9 Apr 2019 16:08:15 +0200
Subject: add show syslog and show syslog from image

---
 docs/system/syslog.rst | 63 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 63 insertions(+)

diff --git a/docs/system/syslog.rst b/docs/system/syslog.rst
index dbf7420a..8acbc237 100644
--- a/docs/system/syslog.rst
+++ b/docs/system/syslog.rst
@@ -112,3 +112,66 @@ logged in, no messages are being displayed.
 .. code-block:: sh
 
   set system syslog user <LOCAL_USERNAME> facility <FACILITY> level <LEVEL>
+
+Show logs
+^^^^^^^^^
+
+Display log files on the console
+
+.. code-block:: sh
+
+  vyos@vyos:~$ show log
+  Possible completions:
+    <Enter>       Execute the current command
+    all           Show contents of all master log files
+    authorization Show listing of authorization attempts
+    cluster       Show log for Cluster
+    conntrack-sync
+                  Show log for Conntrack-sync
+    dhcp          Show log for Dynamic Host Control Protocol (DHCP)
+    directory     Show listing of user-defined log files
+    dns           Show log for Domain Name Service (DNS)
+    file          Show contents of user-defined log file
+    firewall      Show log for Firewall
+    https         Show log for Https
+    image         Show logs from an image
+    lldp          Show log for Lldp
+    nat           Show log for Network Address Translation (NAT)
+    openvpn       Show log for Openvpn
+    snmp          Show log for Simple Network Monitoring Protocol (SNMP)
+    tail          Monitor last lines of messages file
+    vpn           Show log for Virtual Private Network (VPN)
+    vrrp          Show log for Virtual Router Redundancy Protocol (VRRP)
+    webproxy      Show log for Webproxy
+
+Show contents of a log file in an image
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Log messages from a specified image can be displayed on the console:
+
+.. code-block:: sh
+
+  $ show log image <image name>
+  $ show log image <image name> [all | authorization | directory | file <file name> | tail <lines>]
+
+Details of allowed parameters:
+
+.. list-table::
+   :widths: 25 75
+   :header-rows: 0
+
+   * - all
+     - Display contents of all master log files of the specified image
+   * - authorization
+     - Display all authorization attempts of the specified image
+   * - directory
+     - Display list of all user-defined log files of the specified image
+   * - file <file name>
+     - Display contents of a specified user-defined log file of the specified image
+   * - tail
+     - Display last lines of the system log of the specified image
+   * - <lines>
+     - Number of lines to be displayed, default 10
+
+
+When no options/parameters are used, the contents of the main syslog file are displayed.
-- 
cgit v1.2.3