1SD-BUS-ERRORS(3)                 sd-bus-errors                SD-BUS-ERRORS(3)
2
3
4

NAME

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

SYNOPSIS

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

DESCRIPTION

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

NOTES

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

SEE ALSO

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)
Impressum