test-hostname-util: add assert_se's to make coverity happy

[thirdparty/systemd.git] / man / sd_bus_request_name.xml

diff --git a/man/sd_bus_request_name.xml b/man/sd_bus_request_name.xml
index 9b0a93d8884d1550d8f9457c7db9bb60d1d1c9e9..f44cfdb1ac1b9c2683c38706b329922476380709 100644 (file)
--- a/man/sd_bus_request_name.xml
+++ b/man/sd_bus_request_name.xml
@@ -3,6 +3,8 @@
   "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
 
 <!--
+  SPDX-License-Identifier: LGPL-2.1+
+
   This file is part of systemd.
 
   Copyright 2013 Lennart Poettering
@@ -45,7 +47,7 @@
   <refnamediv>
     <refname>sd_bus_request_name</refname>
     <refname>sd_bus_release_name</refname>
-    <refpurpose>Request or release a well-known name on a bus</refpurpose>
+    <refpurpose>Request or release a well-known service name on a bus</refpurpose>
   </refnamediv>
 
   <refsynopsisdiv>
@@ -71,9 +73,9 @@
     <title>Description</title>
 
     <para><function>sd_bus_request_name()</function> requests a
-    well-known name on a bus. It takes a bus connection, a valid bus
-    name and a flags parameter. The flags parameter is a combination
-    of the following flags:</para>
+    well-known service name on a bus. It takes a bus connection, a
+    valid bus name and a flags parameter. The flags parameter is a
+    combination of the following flags:</para>
 
     <variablelist>
       <varlistentry>
@@ -166,8 +168,11 @@
       <varlistentry>
         <term><constant>-EINVAL</constant></term>
 
-        <listitem><para>A specified parameter is
-        invalid.</para></listitem>
+        <listitem><para>A specified parameter is invalid. This is also
+        generated when the requested name is a special service name
+        reserved by the D-Bus specification, or when the operation is
+        requested on a connection that does not refer to a
+        bus.</para></listitem>
       </varlistentry>
 
       <varlistentry>