ryantimwilson / rpms / systemd

Forked from rpms/systemd a month ago
Clone
923a60
From a4f12d4849daed23651ab3c23b5ff830aa32b2a0 Mon Sep 17 00:00:00 2001
923a60
From: Michal Sekletar <msekleta@redhat.com>
923a60
Date: Wed, 3 Feb 2016 10:38:29 +0100
923a60
Subject: [PATCH] man: clarify what happens when journalctl is called with
923a60
 devpath
923a60
923a60
Cherry-picked from: 3cea8e06e45fc1757de8f74da29fb5fb181db4eb
923a60
Related: #947636
923a60
---
923a60
 man/journalctl.xml | 10 ++++++++--
923a60
 1 file changed, 8 insertions(+), 2 deletions(-)
923a60
923a60
diff --git a/man/journalctl.xml b/man/journalctl.xml
923a60
index 2764f66ed4..0981fba729 100644
923a60
--- a/man/journalctl.xml
923a60
+++ b/man/journalctl.xml
923a60
@@ -91,8 +91,14 @@
923a60
       paths may be specified. If a file path refers to an executable
923a60
       file, this is equivalent to an <literal>_EXE=</literal> match
923a60
       for the canonicalized binary path. Similarly, if a path refers
923a60
-      to a device node, this is equivalent to a
923a60
-      <literal>_KERNEL_DEVICE=</literal> match for the device.</para>
923a60
+      to a device node then match is added for the kernel name of the
923a60
+      device (<literal>_KERNEL_DEVICE=</literal>). Also, matches for the
923a60
+      kernel names of all the parent devices are added automatically.
923a60
+      Device node paths are not stable across reboots, therefore match
923a60
+      for the current boot id (<literal>_BOOT_ID=</literal>) is
923a60
+      always added as well. Note that only the log entries for
923a60
+      the existing device nodes maybe queried by providing path to
923a60
+      the device node.</para>
923a60
 
923a60
       <para>Additional constraints may be added using options
923a60
       <option>--boot</option>, <option>--unit=</option>, etc, to