2 <!DOCTYPE refentry PUBLIC
"-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4 <!-- SPDX-License-Identifier: LGPL-2.1-or-later -->
6 <refentry id=
"sd-bus-errors"
7 xmlns:
xi=
"http://www.w3.org/2001/XInclude">
10 <title>sd-bus-errors
</title>
11 <productname>systemd
</productname>
15 <refentrytitle>sd-bus-errors
</refentrytitle>
16 <manvolnum>3</manvolnum>
20 <refname>sd-bus-errors
</refname>
21 <refname>SD_BUS_ERROR_FAILED
</refname>
22 <refname>SD_BUS_ERROR_NO_MEMORY
</refname>
23 <refname>SD_BUS_ERROR_SERVICE_UNKNOWN
</refname>
24 <refname>SD_BUS_ERROR_NAME_HAS_NO_OWNER
</refname>
25 <refname>SD_BUS_ERROR_NO_REPLY
</refname>
26 <refname>SD_BUS_ERROR_IO_ERROR
</refname>
27 <refname>SD_BUS_ERROR_BAD_ADDRESS
</refname>
28 <refname>SD_BUS_ERROR_NOT_SUPPORTED
</refname>
29 <refname>SD_BUS_ERROR_LIMITS_EXCEEDED
</refname>
30 <refname>SD_BUS_ERROR_ACCESS_DENIED
</refname>
31 <refname>SD_BUS_ERROR_AUTH_FAILED
</refname>
32 <refname>SD_BUS_ERROR_NO_SERVER
</refname>
33 <refname>SD_BUS_ERROR_TIMEOUT
</refname>
34 <refname>SD_BUS_ERROR_NO_NETWORK
</refname>
35 <refname>SD_BUS_ERROR_ADDRESS_IN_USE
</refname>
36 <refname>SD_BUS_ERROR_DISCONNECTED
</refname>
37 <refname>SD_BUS_ERROR_INVALID_ARGS
</refname>
38 <refname>SD_BUS_ERROR_FILE_NOT_FOUND
</refname>
39 <refname>SD_BUS_ERROR_FILE_EXISTS
</refname>
40 <refname>SD_BUS_ERROR_UNKNOWN_METHOD
</refname>
41 <refname>SD_BUS_ERROR_UNKNOWN_OBJECT
</refname>
42 <refname>SD_BUS_ERROR_UNKNOWN_INTERFACE
</refname>
43 <refname>SD_BUS_ERROR_UNKNOWN_PROPERTY
</refname>
44 <refname>SD_BUS_ERROR_PROPERTY_READ_ONLY
</refname>
45 <refname>SD_BUS_ERROR_UNIX_PROCESS_ID_UNKNOWN
</refname>
46 <refname>SD_BUS_ERROR_INVALID_SIGNATURE
</refname>
47 <refname>SD_BUS_ERROR_INCONSISTENT_MESSAGE
</refname>
48 <refname>SD_BUS_ERROR_TIMED_OUT
</refname>
49 <refname>SD_BUS_ERROR_MATCH_RULE_NOT_FOUND
</refname>
50 <refname>SD_BUS_ERROR_MATCH_RULE_INVALID
</refname>
51 <refname>SD_BUS_ERROR_INTERACTIVE_AUTHORIZATION_REQUIRED
</refname>
52 <refname>SD_BUS_ERROR_INVALID_FILE_CONTENT
</refname>
53 <refname>SD_BUS_ERROR_SELINUX_SECURITY_CONTEXT_UNKNOWN
</refname>
54 <refname>SD_BUS_ERROR_OBJECT_PATH_IN_USE
</refname>
56 <refpurpose>Standard D-Bus error names
</refpurpose>
61 <funcsynopsisinfo>#include
<systemd/sd-bus.h
></funcsynopsisinfo>
64 #define SD_BUS_ERROR_FAILED
"org.freedesktop.DBus.Error.Failed"
65 #define SD_BUS_ERROR_NO_MEMORY
"org.freedesktop.DBus.Error.NoMemory"
66 #define SD_BUS_ERROR_SERVICE_UNKNOWN
"org.freedesktop.DBus.Error.ServiceUnknown"
67 #define SD_BUS_ERROR_NAME_HAS_NO_OWNER
"org.freedesktop.DBus.Error.NameHasNoOwner"
68 #define SD_BUS_ERROR_NO_REPLY
"org.freedesktop.DBus.Error.NoReply"
69 #define SD_BUS_ERROR_IO_ERROR
"org.freedesktop.DBus.Error.IOError"
70 #define SD_BUS_ERROR_BAD_ADDRESS
"org.freedesktop.DBus.Error.BadAddress"
71 #define SD_BUS_ERROR_NOT_SUPPORTED
"org.freedesktop.DBus.Error.NotSupported"
72 #define SD_BUS_ERROR_LIMITS_EXCEEDED
"org.freedesktop.DBus.Error.LimitsExceeded"
73 #define SD_BUS_ERROR_ACCESS_DENIED
"org.freedesktop.DBus.Error.AccessDenied"
74 #define SD_BUS_ERROR_AUTH_FAILED
"org.freedesktop.DBus.Error.AuthFailed"
75 #define SD_BUS_ERROR_NO_SERVER
"org.freedesktop.DBus.Error.NoServer"
76 #define SD_BUS_ERROR_TIMEOUT
"org.freedesktop.DBus.Error.Timeout"
77 #define SD_BUS_ERROR_NO_NETWORK
"org.freedesktop.DBus.Error.NoNetwork"
78 #define SD_BUS_ERROR_ADDRESS_IN_USE
"org.freedesktop.DBus.Error.AddressInUse"
79 #define SD_BUS_ERROR_DISCONNECTED
"org.freedesktop.DBus.Error.Disconnected"
80 #define SD_BUS_ERROR_INVALID_ARGS
"org.freedesktop.DBus.Error.InvalidArgs"
81 #define SD_BUS_ERROR_FILE_NOT_FOUND
"org.freedesktop.DBus.Error.FileNotFound"
82 #define SD_BUS_ERROR_FILE_EXISTS
"org.freedesktop.DBus.Error.FileExists"
83 #define SD_BUS_ERROR_UNKNOWN_METHOD
"org.freedesktop.DBus.Error.UnknownMethod"
84 #define SD_BUS_ERROR_UNKNOWN_OBJECT
"org.freedesktop.DBus.Error.UnknownObject"
85 #define SD_BUS_ERROR_UNKNOWN_INTERFACE
"org.freedesktop.DBus.Error.UnknownInterface"
86 #define SD_BUS_ERROR_UNKNOWN_PROPERTY
"org.freedesktop.DBus.Error.UnknownProperty"
87 #define SD_BUS_ERROR_PROPERTY_READ_ONLY
"org.freedesktop.DBus.Error.PropertyReadOnly"
88 #define SD_BUS_ERROR_UNIX_PROCESS_ID_UNKNOWN
"org.freedesktop.DBus.Error.UnixProcessIdUnknown"
89 #define SD_BUS_ERROR_INVALID_SIGNATURE
"org.freedesktop.DBus.Error.InvalidSignature"
90 #define SD_BUS_ERROR_INCONSISTENT_MESSAGE
"org.freedesktop.DBus.Error.InconsistentMessage"
91 #define SD_BUS_ERROR_TIMED_OUT
"org.freedesktop.DBus.Error.TimedOut"
92 #define SD_BUS_ERROR_MATCH_RULE_NOT_FOUND
"org.freedesktop.DBus.Error.MatchRuleNotFound"
93 #define SD_BUS_ERROR_MATCH_RULE_INVALID
"org.freedesktop.DBus.Error.MatchRuleInvalid"
94 #define SD_BUS_ERROR_INTERACTIVE_AUTHORIZATION_REQUIRED \
95 "org.freedesktop.DBus.Error.InteractiveAuthorizationRequired"
96 #define SD_BUS_ERROR_INVALID_FILE_CONTENT
"org.freedesktop.DBus.Error.InvalidFileContent"
97 #define SD_BUS_ERROR_SELINUX_SECURITY_CONTEXT_UNKNOWN \
98 "org.freedesktop.DBus.Error.SELinuxSecurityContextUnknown"
99 #define SD_BUS_ERROR_OBJECT_PATH_IN_USE
"org.freedesktop.DBus.Error.ObjectPathInUse"
105 <title>Description
</title>
107 <para>In addition to the error names user programs define, D-Bus
108 knows a number of generic, standardized error names that are
111 <para>In addition to this list, in sd-bus, the special error
112 namespace
<literal>System.Error.
</literal> is used to map
113 arbitrary Linux system errors (as defined by
<citerefentry
114 project='man-pages'
><refentrytitle>errno
</refentrytitle><manvolnum>3</manvolnum></citerefentry>)
115 to D-Bus errors and back. For example, the error
116 <constant>EUCLEAN
</constant> is mapped to
117 <literal>System.Error.EUCLEAN
</literal> and back.
</para>
122 <term><constant>SD_BUS_ERROR_FAILED
</constant></term>
123 <listitem><para>A generic error indication. See the error
124 message for further details. This error name should be
125 avoided, in favor of a more expressive error
128 <xi:include href=
"version-info.xml" xpointer=
"v223"/></listitem>
132 <term><constant>SD_BUS_ERROR_NO_MEMORY
</constant></term>
133 <listitem><para>A memory allocation failed, and the requested
134 operation could not be completed.
</para>
136 <xi:include href=
"version-info.xml" xpointer=
"v223"/></listitem>
140 <term><constant>SD_BUS_ERROR_SERVICE_UNKNOWN
</constant></term>
141 <listitem><para>The contacted bus service is unknown and
142 cannot be activated.
</para>
144 <xi:include href=
"version-info.xml" xpointer=
"v223"/></listitem>
148 <term><constant>SD_BUS_ERROR_NAME_HAS_NO_OWNER
</constant></term>
149 <listitem><para>The specified bus service name currently has
152 <xi:include href=
"version-info.xml" xpointer=
"v223"/></listitem>
155 <term><constant>SD_BUS_ERROR_NO_REPLY
</constant></term>
156 <listitem><para>A message did not receive a reply. This error
157 is usually generated after a timeout.
</para>
159 <xi:include href=
"version-info.xml" xpointer=
"v223"/></listitem>
162 <term><constant>SD_BUS_ERROR_IO_ERROR
</constant></term>
163 <listitem><para>Generic input/output error, for example when
164 accessing a socket or other I/O context.
</para>
166 <xi:include href=
"version-info.xml" xpointer=
"v223"/></listitem>
169 <term><constant>SD_BUS_ERROR_BAD_ADDRESS
</constant></term>
170 <listitem><para>The specified D-Bus bus address string is
173 <xi:include href=
"version-info.xml" xpointer=
"v223"/></listitem>
176 <term><constant>SD_BUS_ERROR_NOT_SUPPORTED
</constant></term>
177 <listitem><para>The requested operation is not supported on
178 the local system.
</para>
180 <xi:include href=
"version-info.xml" xpointer=
"v223"/></listitem>
183 <term><constant>SD_BUS_ERROR_LIMITS_EXCEEDED
</constant></term>
184 <listitem><para>Some limited resource has been
187 <xi:include href=
"version-info.xml" xpointer=
"v223"/></listitem>
190 <term><constant>SD_BUS_ERROR_ACCESS_DENIED
</constant></term>
191 <listitem><para>Access to a resource has been denied due to security restrictions.
</para>
193 <xi:include href=
"version-info.xml" xpointer=
"v223"/></listitem>
196 <term><constant>SD_BUS_ERROR_AUTH_FAILED
</constant></term>
197 <listitem><para>Authentication did not complete successfully.
</para>
199 <xi:include href=
"version-info.xml" xpointer=
"v223"/></listitem>
202 <term><constant>SD_BUS_ERROR_NO_SERVER
</constant></term>
203 <listitem><para>Unable to connect to the specified server.
</para>
205 <xi:include href=
"version-info.xml" xpointer=
"v223"/></listitem>
208 <term><constant>SD_BUS_ERROR_TIMEOUT
</constant></term>
209 <listitem><para>An operation timed out. Note that method calls
210 which timeout generate a
211 <constant>SD_BUS_ERROR_NO_REPLY
</constant>.
</para>
213 <xi:include href=
"version-info.xml" xpointer=
"v223"/></listitem>
216 <term><constant>SD_BUS_ERROR_NO_NETWORK
</constant></term>
217 <listitem><para>No network available to execute requested network operation on.
</para>
219 <xi:include href=
"version-info.xml" xpointer=
"v223"/></listitem>
222 <term><constant>SD_BUS_ERROR_ADDRESS_IN_USE
</constant></term>
223 <listitem><para>The specified network address is already being listened on.
</para>
225 <xi:include href=
"version-info.xml" xpointer=
"v223"/></listitem>
228 <term><constant>SD_BUS_ERROR_DISCONNECTED
</constant></term>
229 <listitem><para>The connection has been terminated.
</para>
231 <xi:include href=
"version-info.xml" xpointer=
"v223"/></listitem>
234 <term><constant>SD_BUS_ERROR_INVALID_ARGS
</constant></term>
235 <listitem><para>One or more invalid arguments have been passed.
</para>
237 <xi:include href=
"version-info.xml" xpointer=
"v223"/></listitem>
240 <term><constant>SD_BUS_ERROR_FILE_NOT_FOUND
</constant></term>
241 <listitem><para>The requested file could not be found.
</para>
243 <xi:include href=
"version-info.xml" xpointer=
"v223"/></listitem>
246 <term><constant>SD_BUS_ERROR_FILE_EXISTS
</constant></term>
247 <listitem><para>The requested file already exists.
</para>
249 <xi:include href=
"version-info.xml" xpointer=
"v223"/></listitem>
252 <term><constant>SD_BUS_ERROR_UNKNOWN_METHOD
</constant></term>
253 <listitem><para>The requested method does not exist in the selected interface.
</para>
255 <xi:include href=
"version-info.xml" xpointer=
"v223"/></listitem>
258 <term><constant>SD_BUS_ERROR_UNKNOWN_OBJECT
</constant></term>
259 <listitem><para>The requested object does not exist in the selected service.
</para>
261 <xi:include href=
"version-info.xml" xpointer=
"v223"/></listitem>
264 <term><constant>SD_BUS_ERROR_UNKNOWN_INTERFACE
</constant></term>
265 <listitem><para>The requested interface does not exist on the selected object.
</para>
267 <xi:include href=
"version-info.xml" xpointer=
"v223"/></listitem>
270 <term><constant>SD_BUS_ERROR_UNKNOWN_PROPERTY
</constant></term>
271 <listitem><para>The requested property does not exist in the selected interface.
</para>
273 <xi:include href=
"version-info.xml" xpointer=
"v223"/></listitem>
276 <term><constant>SD_BUS_ERROR_PROPERTY_READ_ONLY
</constant></term>
277 <listitem><para>A write operation was requested on a read-only property.
</para>
279 <xi:include href=
"version-info.xml" xpointer=
"v223"/></listitem>
282 <term><constant>SD_BUS_ERROR_UNIX_PROCESS_ID_UNKNOWN
</constant></term>
283 <listitem><para>The requested PID is not known.
</para>
285 <xi:include href=
"version-info.xml" xpointer=
"v223"/></listitem>
288 <term><constant>SD_BUS_ERROR_INVALID_SIGNATURE
</constant></term>
289 <listitem><para>The specified message signature is not
292 <xi:include href=
"version-info.xml" xpointer=
"v223"/>
296 <term><constant>SD_BUS_ERROR_INCONSISTENT_MESSAGE
</constant></term>
297 <listitem><para>The passed message does not validate
300 <xi:include href=
"version-info.xml" xpointer=
"v223"/></listitem>
303 <term><constant>SD_BUS_ERROR_MATCH_RULE_NOT_FOUND
</constant></term>
304 <listitem><para>The specified match rule does not exist.
</para>
306 <xi:include href=
"version-info.xml" xpointer=
"v223"/></listitem>
309 <term><constant>SD_BUS_ERROR_MATCH_RULE_INVALID
</constant></term>
310 <listitem><para>The specified match rule is invalid.
</para>
312 <xi:include href=
"version-info.xml" xpointer=
"v223"/></listitem>
315 <term><constant>SD_BUS_ERROR_INTERACTIVE_AUTHORIZATION_REQUIRED
</constant></term>
316 <listitem><para>Access to the requested operation is not
317 permitted. However, it might be available after interactive
318 authentication. This is usually returned by method calls
319 supporting a framework for additional interactive
320 authorization, when interactive authorization was not enabled
322 <citerefentry><refentrytitle>sd_bus_message_set_allow_interactive_authorization
</refentrytitle><manvolnum>3</manvolnum></citerefentry>
323 for the method call message.
</para>
325 <xi:include href=
"version-info.xml" xpointer=
"v223"/></listitem>
330 <xi:include href=
"libsystemd-pkgconfig.xml" />
333 <title>See Also
</title>
335 <para><simplelist type=
"inline">
336 <member><citerefentry><refentrytitle>systemd
</refentrytitle><manvolnum>1</manvolnum></citerefentry></member>
337 <member><citerefentry><refentrytitle>libsystemd
</refentrytitle><manvolnum>3</manvolnum></citerefentry></member>
338 <member><citerefentry><refentrytitle>sd-bus
</refentrytitle><manvolnum>3</manvolnum></citerefentry></member>
339 <member><citerefentry><refentrytitle>sd_bus_error
</refentrytitle><manvolnum>3</manvolnum></citerefentry></member>
340 <member><citerefentry><refentrytitle>sd_bus_message_set_allow_interactive_authorization
</refentrytitle><manvolnum>3</manvolnum></citerefentry></member>
341 <member><citerefentry project='man-pages'
><refentrytitle>errno
</refentrytitle><manvolnum>3</manvolnum></citerefentry></member>
342 <member><citerefentry project='man-pages'
><refentrytitle>strerror_r
</refentrytitle><manvolnum>3</manvolnum></citerefentry></member>