1SD-BUS-ERRORS(3) sd-bus-errors SD-BUS-ERRORS(3)
2
3
4
6 sd-bus-errors, SD_BUS_ERROR_FAILED, SD_BUS_ERROR_NO_MEMORY,
7 SD_BUS_ERROR_SERVICE_UNKNOWN, SD_BUS_ERROR_NAME_HAS_NO_OWNER,
8 SD_BUS_ERROR_NO_REPLY, SD_BUS_ERROR_IO_ERROR, SD_BUS_ERROR_BAD_ADDRESS,
9 SD_BUS_ERROR_NOT_SUPPORTED, SD_BUS_ERROR_LIMITS_EXCEEDED,
10 SD_BUS_ERROR_ACCESS_DENIED, SD_BUS_ERROR_AUTH_FAILED,
11 SD_BUS_ERROR_NO_SERVER, SD_BUS_ERROR_TIMEOUT, SD_BUS_ERROR_NO_NETWORK,
12 SD_BUS_ERROR_ADDRESS_IN_USE, SD_BUS_ERROR_DISCONNECTED,
13 SD_BUS_ERROR_INVALID_ARGS, SD_BUS_ERROR_FILE_NOT_FOUND,
14 SD_BUS_ERROR_FILE_EXISTS, SD_BUS_ERROR_UNKNOWN_METHOD,
15 SD_BUS_ERROR_UNKNOWN_OBJECT, SD_BUS_ERROR_UNKNOWN_INTERFACE,
16 SD_BUS_ERROR_UNKNOWN_PROPERTY, SD_BUS_ERROR_PROPERTY_READ_ONLY,
17 SD_BUS_ERROR_UNIX_PROCESS_ID_UNKNOWN, SD_BUS_ERROR_INVALID_SIGNATURE,
18 SD_BUS_ERROR_INCONSISTENT_MESSAGE, SD_BUS_ERROR_TIMED_OUT,
19 SD_BUS_ERROR_MATCH_RULE_NOT_FOUND, SD_BUS_ERROR_MATCH_RULE_INVALID,
20 SD_BUS_ERROR_INTERACTIVE_AUTHORIZATION_REQUIRED,
21 SD_BUS_ERROR_INVALID_FILE_CONTENT,
22 SD_BUS_ERROR_SELINUX_SECURITY_CONTEXT_UNKNOWN,
23 SD_BUS_ERROR_OBJECT_PATH_IN_USE - Standard D-Bus error names
24
26 #include <systemd/sd-bus.h>
27
28 #define SD_BUS_ERROR_FAILED "org.freedesktop.DBus.Error.Failed"
29 #define SD_BUS_ERROR_NO_MEMORY "org.freedesktop.DBus.Error.NoMemory"
30 #define SD_BUS_ERROR_SERVICE_UNKNOWN "org.freedesktop.DBus.Error.ServiceUnknown"
31 #define SD_BUS_ERROR_NAME_HAS_NO_OWNER "org.freedesktop.DBus.Error.NameHasNoOwner"
32 #define SD_BUS_ERROR_NO_REPLY "org.freedesktop.DBus.Error.NoReply"
33 #define SD_BUS_ERROR_IO_ERROR "org.freedesktop.DBus.Error.IOError"
34 #define SD_BUS_ERROR_BAD_ADDRESS "org.freedesktop.DBus.Error.BadAddress"
35 #define SD_BUS_ERROR_NOT_SUPPORTED "org.freedesktop.DBus.Error.NotSupported"
36 #define SD_BUS_ERROR_LIMITS_EXCEEDED "org.freedesktop.DBus.Error.LimitsExceeded"
37 #define SD_BUS_ERROR_ACCESS_DENIED "org.freedesktop.DBus.Error.AccessDenied"
38 #define SD_BUS_ERROR_AUTH_FAILED "org.freedesktop.DBus.Error.AuthFailed"
39 #define SD_BUS_ERROR_NO_SERVER "org.freedesktop.DBus.Error.NoServer"
40 #define SD_BUS_ERROR_TIMEOUT "org.freedesktop.DBus.Error.Timeout"
41 #define SD_BUS_ERROR_NO_NETWORK "org.freedesktop.DBus.Error.NoNetwork"
42 #define SD_BUS_ERROR_ADDRESS_IN_USE "org.freedesktop.DBus.Error.AddressInUse"
43 #define SD_BUS_ERROR_DISCONNECTED "org.freedesktop.DBus.Error.Disconnected"
44 #define SD_BUS_ERROR_INVALID_ARGS "org.freedesktop.DBus.Error.InvalidArgs"
45 #define SD_BUS_ERROR_FILE_NOT_FOUND "org.freedesktop.DBus.Error.FileNotFound"
46 #define SD_BUS_ERROR_FILE_EXISTS "org.freedesktop.DBus.Error.FileExists"
47 #define SD_BUS_ERROR_UNKNOWN_METHOD "org.freedesktop.DBus.Error.UnknownMethod"
48 #define SD_BUS_ERROR_UNKNOWN_OBJECT "org.freedesktop.DBus.Error.UnknownObject"
49 #define SD_BUS_ERROR_UNKNOWN_INTERFACE "org.freedesktop.DBus.Error.UnknownInterface"
50 #define SD_BUS_ERROR_UNKNOWN_PROPERTY "org.freedesktop.DBus.Error.UnknownProperty"
51 #define SD_BUS_ERROR_PROPERTY_READ_ONLY "org.freedesktop.DBus.Error.PropertyReadOnly"
52 #define SD_BUS_ERROR_UNIX_PROCESS_ID_UNKNOWN "org.freedesktop.DBus.Error.UnixProcessIdUnknown"
53 #define SD_BUS_ERROR_INVALID_SIGNATURE "org.freedesktop.DBus.Error.InvalidSignature"
54 #define SD_BUS_ERROR_INCONSISTENT_MESSAGE "org.freedesktop.DBus.Error.InconsistentMessage"
55 #define SD_BUS_ERROR_TIMED_OUT "org.freedesktop.DBus.Error.TimedOut"
56 #define SD_BUS_ERROR_MATCH_RULE_NOT_FOUND "org.freedesktop.DBus.Error.MatchRuleNotFound"
57 #define SD_BUS_ERROR_MATCH_RULE_INVALID "org.freedesktop.DBus.Error.MatchRuleInvalid"
58 #define SD_BUS_ERROR_INTERACTIVE_AUTHORIZATION_REQUIRED \
59 "org.freedesktop.DBus.Error.InteractiveAuthorizationRequired"
60 #define SD_BUS_ERROR_INVALID_FILE_CONTENT "org.freedesktop.DBus.Error.InvalidFileContent"
61 #define SD_BUS_ERROR_SELINUX_SECURITY_CONTEXT_UNKNOWN \
62 "org.freedesktop.DBus.Error.SELinuxSecurityContextUnknown"
63 #define SD_BUS_ERROR_OBJECT_PATH_IN_USE "org.freedesktop.DBus.Error.ObjectPathInUse"
64
65
67 In addition to the error names user programs define, D-Bus knows a
68 number of generic, standardized error names that are listed below.
69
70 In addition to this list, in sd-bus, the special error namespace
71 "System.Error." is used to map arbitrary Linux system errors (as
72 defined by errno(3)) to D-Bus errors and back. For example, the error
73 EUCLEAN is mapped to "System.Error.EUCLEAN" and back.
74
75 SD_BUS_ERROR_FAILED
76 A generic error indication. See the error message for further
77 details. This error name should be avoided, in favor of a more
78 expressive error name.
79
80 SD_BUS_ERROR_NO_MEMORY
81 A memory allocation failed, and the requested operation could not
82 be completed.
83
84 SD_BUS_ERROR_SERVICE_UNKNOWN
85 The contacted bus service is unknown and cannot be activated.
86
87 SD_BUS_ERROR_NAME_HAS_NO_OWNER
88 The specified bus service name currently has no owner.
89
90 SD_BUS_ERROR_NO_REPLY
91 A message did not receive a reply. This error is usually generated
92 after a timeout.
93
94 SD_BUS_ERROR_IO_ERROR
95 Generic input/output error, for example when accessing a socket or
96 other I/O context.
97
98 SD_BUS_ERROR_BAD_ADDRESS
99 The specified D-Bus bus address string is malformed.
100
101 SD_BUS_ERROR_NOT_SUPPORTED
102 The requested operation is not supported on the local system.
103
104 SD_BUS_ERROR_LIMITS_EXCEEDED
105 Some limited resource has been exhausted.
106
107 SD_BUS_ERROR_ACCESS_DENIED
108 Access to a resource has been denied due to security restrictions.
109
110 SD_BUS_ERROR_AUTH_FAILED
111 Authentication did not complete successfully.
112
113 SD_BUS_ERROR_NO_SERVER
114 Unable to connect to the specified server.
115
116 SD_BUS_ERROR_TIMEOUT
117 An operation timed out. Note that method calls which timeout
118 generate a SD_BUS_ERROR_NO_REPLY.
119
120 SD_BUS_ERROR_NO_NETWORK
121 No network available to execute requested network operation on.
122
123 SD_BUS_ERROR_ADDRESS_IN_USE
124 The specified network address is already being listened on.
125
126 SD_BUS_ERROR_DISCONNECTED
127 The connection has been terminated.
128
129 SD_BUS_ERROR_INVALID_ARGS
130 One or more invalid arguments have been passed.
131
132 SD_BUS_ERROR_FILE_NOT_FOUND
133 The requested file could not be found.
134
135 SD_BUS_ERROR_FILE_EXISTS
136 The requested file already exists.
137
138 SD_BUS_ERROR_UNKNOWN_METHOD
139 The requested method does not exist in the selected interface.
140
141 SD_BUS_ERROR_UNKNOWN_OBJECT
142 The requested object does not exist in the selected service.
143
144 SD_BUS_ERROR_UNKNOWN_INTERFACE
145 The requested interface does not exist on the selected object.
146
147 SD_BUS_ERROR_UNKNOWN_PROPERTY
148 The requested property does not exist in the selected interface.
149
150 SD_BUS_ERROR_PROPERTY_READ_ONLY
151 A write operation was requested on a read-only property.
152
153 SD_BUS_ERROR_UNIX_PROCESS_ID_UNKNOWN
154 The requested PID is not known.
155
156 SD_BUS_ERROR_INVALID_SIGNATURE
157 The specified message signature is not valid.
158
159 SD_BUS_ERROR_INCONSISTENT_MESSAGE
160 The passed message does not validate correctly.
161
162 SD_BUS_ERROR_MATCH_RULE_NOT_FOUND
163 The specified match rule does not exist.
164
165 SD_BUS_ERROR_MATCH_RULE_INVALID
166 The specified match rule is invalid.
167
168 SD_BUS_ERROR_INTERACTIVE_AUTHORIZATION_REQUIRED
169 Access to the requested operation is not permitted. However, it
170 might be available after interactive authentication. This is
171 usually returned by method calls supporting a framework for
172 additional interactive authorization, when interactive
173 authorization was not enabled with the
174 sd_bus_message_set_allow_interactive_authorization(3) for the
175 method call message.
176
178 Functions described here are available as a shared library, which can
179 be compiled against and linked to with the libsystemd pkg-config(1)
180 file.
181
182 The code described here uses getenv(3), which is declared to be not
183 multi-thread-safe. This means that the code calling the functions
184 described here must not call setenv(3) from a parallel thread. It is
185 recommended to only do calls to setenv() from an early phase of the
186 program when no other threads have been started.
187
189 systemd(1), libsystemd(3), sd-bus(3), sd_bus_error(3),
190 sd_bus_message_set_allow_interactive_authorization(3), errno(3),
191 strerror_r(3)
192
193
194
195systemd 254 SD-BUS-ERRORS(3)