From d2d10f5c645b4f8fb01cbe3100b7938293e703ac Mon Sep 17 00:00:00 2001
From: Alexey Lebedeff <alebedev@mirantis.com>
Date: Fri, 11 Mar 2016 11:32:43 +0300
Subject: [PATCH] Add warning to `systemd-notify` manpage

About it not working properly for non-root users. So the next poor soul
won't have to debug why it's not working.

Alleviates #2739
---
 man/systemd-notify.xml | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/man/systemd-notify.xml b/man/systemd-notify.xml
index a5f4077166ffe..07ef9468411a1 100644
--- a/man/systemd-notify.xml
+++ b/man/systemd-notify.xml
@@ -76,6 +76,11 @@
     from this command unless <varname>NotifyAccess=all</varname> is
     set for the service unit this command is called from.</para>
 
+    <para>Due to current limitations of the Linux kernel and the systemd, this
+    command requires <constant>CAP_SYS_ADMIN</constant> privileges to work
+    reliably. I.e. it's useful only in shell scripts running as a root
+    user.</para>
+
   </refsect1>
 
   <refsect1>