diff options
Diffstat (limited to 'upstream/opensuse-tumbleweed/man3/sd-bus-errors.3')
| -rw-r--r-- | upstream/opensuse-tumbleweed/man3/sd-bus-errors.3 | 258 |
1 files changed, 258 insertions, 0 deletions
diff --git a/upstream/opensuse-tumbleweed/man3/sd-bus-errors.3 b/upstream/opensuse-tumbleweed/man3/sd-bus-errors.3 new file mode 100644 index 00000000..4c7da0b3 --- /dev/null +++ b/upstream/opensuse-tumbleweed/man3/sd-bus-errors.3 @@ -0,0 +1,258 @@ +'\" t +.TH "SD\-BUS\-ERRORS" "3" "" "systemd 254" "sd-bus-errors" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +sd-bus-errors, SD_BUS_ERROR_FAILED, SD_BUS_ERROR_NO_MEMORY, SD_BUS_ERROR_SERVICE_UNKNOWN, SD_BUS_ERROR_NAME_HAS_NO_OWNER, SD_BUS_ERROR_NO_REPLY, SD_BUS_ERROR_IO_ERROR, SD_BUS_ERROR_BAD_ADDRESS, SD_BUS_ERROR_NOT_SUPPORTED, SD_BUS_ERROR_LIMITS_EXCEEDED, SD_BUS_ERROR_ACCESS_DENIED, SD_BUS_ERROR_AUTH_FAILED, SD_BUS_ERROR_NO_SERVER, SD_BUS_ERROR_TIMEOUT, SD_BUS_ERROR_NO_NETWORK, SD_BUS_ERROR_ADDRESS_IN_USE, SD_BUS_ERROR_DISCONNECTED, SD_BUS_ERROR_INVALID_ARGS, SD_BUS_ERROR_FILE_NOT_FOUND, SD_BUS_ERROR_FILE_EXISTS, SD_BUS_ERROR_UNKNOWN_METHOD, SD_BUS_ERROR_UNKNOWN_OBJECT, SD_BUS_ERROR_UNKNOWN_INTERFACE, SD_BUS_ERROR_UNKNOWN_PROPERTY, SD_BUS_ERROR_PROPERTY_READ_ONLY, SD_BUS_ERROR_UNIX_PROCESS_ID_UNKNOWN, SD_BUS_ERROR_INVALID_SIGNATURE, SD_BUS_ERROR_INCONSISTENT_MESSAGE, SD_BUS_ERROR_TIMED_OUT, SD_BUS_ERROR_MATCH_RULE_NOT_FOUND, SD_BUS_ERROR_MATCH_RULE_INVALID, SD_BUS_ERROR_INTERACTIVE_AUTHORIZATION_REQUIRED, SD_BUS_ERROR_INVALID_FILE_CONTENT, SD_BUS_ERROR_SELINUX_SECURITY_CONTEXT_UNKNOWN, SD_BUS_ERROR_OBJECT_PATH_IN_USE \- Standard D\-Bus error names +.SH "SYNOPSIS" +.sp +.ft B +.nf +#include <systemd/sd\-bus\&.h> +.fi +.ft +.sp +.ft B +.nf +#define SD_BUS_ERROR_FAILED "org\&.freedesktop\&.DBus\&.Error\&.Failed" +#define SD_BUS_ERROR_NO_MEMORY "org\&.freedesktop\&.DBus\&.Error\&.NoMemory" +#define SD_BUS_ERROR_SERVICE_UNKNOWN "org\&.freedesktop\&.DBus\&.Error\&.ServiceUnknown" +#define SD_BUS_ERROR_NAME_HAS_NO_OWNER "org\&.freedesktop\&.DBus\&.Error\&.NameHasNoOwner" +#define SD_BUS_ERROR_NO_REPLY "org\&.freedesktop\&.DBus\&.Error\&.NoReply" +#define SD_BUS_ERROR_IO_ERROR "org\&.freedesktop\&.DBus\&.Error\&.IOError" +#define SD_BUS_ERROR_BAD_ADDRESS "org\&.freedesktop\&.DBus\&.Error\&.BadAddress" +#define SD_BUS_ERROR_NOT_SUPPORTED "org\&.freedesktop\&.DBus\&.Error\&.NotSupported" +#define SD_BUS_ERROR_LIMITS_EXCEEDED "org\&.freedesktop\&.DBus\&.Error\&.LimitsExceeded" +#define SD_BUS_ERROR_ACCESS_DENIED "org\&.freedesktop\&.DBus\&.Error\&.AccessDenied" +#define SD_BUS_ERROR_AUTH_FAILED "org\&.freedesktop\&.DBus\&.Error\&.AuthFailed" +#define SD_BUS_ERROR_NO_SERVER "org\&.freedesktop\&.DBus\&.Error\&.NoServer" +#define SD_BUS_ERROR_TIMEOUT "org\&.freedesktop\&.DBus\&.Error\&.Timeout" +#define SD_BUS_ERROR_NO_NETWORK "org\&.freedesktop\&.DBus\&.Error\&.NoNetwork" +#define SD_BUS_ERROR_ADDRESS_IN_USE "org\&.freedesktop\&.DBus\&.Error\&.AddressInUse" +#define SD_BUS_ERROR_DISCONNECTED "org\&.freedesktop\&.DBus\&.Error\&.Disconnected" +#define SD_BUS_ERROR_INVALID_ARGS "org\&.freedesktop\&.DBus\&.Error\&.InvalidArgs" +#define SD_BUS_ERROR_FILE_NOT_FOUND "org\&.freedesktop\&.DBus\&.Error\&.FileNotFound" +#define SD_BUS_ERROR_FILE_EXISTS "org\&.freedesktop\&.DBus\&.Error\&.FileExists" +#define SD_BUS_ERROR_UNKNOWN_METHOD "org\&.freedesktop\&.DBus\&.Error\&.UnknownMethod" +#define SD_BUS_ERROR_UNKNOWN_OBJECT "org\&.freedesktop\&.DBus\&.Error\&.UnknownObject" +#define SD_BUS_ERROR_UNKNOWN_INTERFACE "org\&.freedesktop\&.DBus\&.Error\&.UnknownInterface" +#define SD_BUS_ERROR_UNKNOWN_PROPERTY "org\&.freedesktop\&.DBus\&.Error\&.UnknownProperty" +#define SD_BUS_ERROR_PROPERTY_READ_ONLY "org\&.freedesktop\&.DBus\&.Error\&.PropertyReadOnly" +#define SD_BUS_ERROR_UNIX_PROCESS_ID_UNKNOWN "org\&.freedesktop\&.DBus\&.Error\&.UnixProcessIdUnknown" +#define SD_BUS_ERROR_INVALID_SIGNATURE "org\&.freedesktop\&.DBus\&.Error\&.InvalidSignature" +#define SD_BUS_ERROR_INCONSISTENT_MESSAGE "org\&.freedesktop\&.DBus\&.Error\&.InconsistentMessage" +#define SD_BUS_ERROR_TIMED_OUT "org\&.freedesktop\&.DBus\&.Error\&.TimedOut" +#define SD_BUS_ERROR_MATCH_RULE_NOT_FOUND "org\&.freedesktop\&.DBus\&.Error\&.MatchRuleNotFound" +#define SD_BUS_ERROR_MATCH_RULE_INVALID "org\&.freedesktop\&.DBus\&.Error\&.MatchRuleInvalid" +#define SD_BUS_ERROR_INTERACTIVE_AUTHORIZATION_REQUIRED \e + "org\&.freedesktop\&.DBus\&.Error\&.InteractiveAuthorizationRequired" +#define SD_BUS_ERROR_INVALID_FILE_CONTENT "org\&.freedesktop\&.DBus\&.Error\&.InvalidFileContent" +#define SD_BUS_ERROR_SELINUX_SECURITY_CONTEXT_UNKNOWN \e + "org\&.freedesktop\&.DBus\&.Error\&.SELinuxSecurityContextUnknown" +#define SD_BUS_ERROR_OBJECT_PATH_IN_USE "org\&.freedesktop\&.DBus\&.Error\&.ObjectPathInUse" + +.fi +.ft +.SH "DESCRIPTION" +.PP +In addition to the error names user programs define, D\-Bus knows a number of generic, standardized error names that are listed below\&. +.PP +In addition to this list, in sd\-bus, the special error namespace +"System\&.Error\&." +is used to map arbitrary Linux system errors (as defined by +\fBerrno\fR(3)) to D\-Bus errors and back\&. For example, the error +\fBEUCLEAN\fR +is mapped to +"System\&.Error\&.EUCLEAN" +and back\&. +.PP +\fBSD_BUS_ERROR_FAILED\fR +.RS 4 +A generic error indication\&. See the error message for further details\&. This error name should be avoided, in favor of a more expressive error name\&. +.RE +.PP +\fBSD_BUS_ERROR_NO_MEMORY\fR +.RS 4 +A memory allocation failed, and the requested operation could not be completed\&. +.RE +.PP +\fBSD_BUS_ERROR_SERVICE_UNKNOWN\fR +.RS 4 +The contacted bus service is unknown and cannot be activated\&. +.RE +.PP +\fBSD_BUS_ERROR_NAME_HAS_NO_OWNER\fR +.RS 4 +The specified bus service name currently has no owner\&. +.RE +.PP +\fBSD_BUS_ERROR_NO_REPLY\fR +.RS 4 +A message did not receive a reply\&. This error is usually generated after a timeout\&. +.RE +.PP +\fBSD_BUS_ERROR_IO_ERROR\fR +.RS 4 +Generic input/output error, for example when accessing a socket or other I/O context\&. +.RE +.PP +\fBSD_BUS_ERROR_BAD_ADDRESS\fR +.RS 4 +The specified D\-Bus bus address string is malformed\&. +.RE +.PP +\fBSD_BUS_ERROR_NOT_SUPPORTED\fR +.RS 4 +The requested operation is not supported on the local system\&. +.RE +.PP +\fBSD_BUS_ERROR_LIMITS_EXCEEDED\fR +.RS 4 +Some limited resource has been exhausted\&. +.RE +.PP +\fBSD_BUS_ERROR_ACCESS_DENIED\fR +.RS 4 +Access to a resource has been denied due to security restrictions\&. +.RE +.PP +\fBSD_BUS_ERROR_AUTH_FAILED\fR +.RS 4 +Authentication did not complete successfully\&. +.RE +.PP +\fBSD_BUS_ERROR_NO_SERVER\fR +.RS 4 +Unable to connect to the specified server\&. +.RE +.PP +\fBSD_BUS_ERROR_TIMEOUT\fR +.RS 4 +An operation timed out\&. Note that method calls which timeout generate a +\fBSD_BUS_ERROR_NO_REPLY\fR\&. +.RE +.PP +\fBSD_BUS_ERROR_NO_NETWORK\fR +.RS 4 +No network available to execute requested network operation on\&. +.RE +.PP +\fBSD_BUS_ERROR_ADDRESS_IN_USE\fR +.RS 4 +The specified network address is already being listened on\&. +.RE +.PP +\fBSD_BUS_ERROR_DISCONNECTED\fR +.RS 4 +The connection has been terminated\&. +.RE +.PP +\fBSD_BUS_ERROR_INVALID_ARGS\fR +.RS 4 +One or more invalid arguments have been passed\&. +.RE +.PP +\fBSD_BUS_ERROR_FILE_NOT_FOUND\fR +.RS 4 +The requested file could not be found\&. +.RE +.PP +\fBSD_BUS_ERROR_FILE_EXISTS\fR +.RS 4 +The requested file already exists\&. +.RE +.PP +\fBSD_BUS_ERROR_UNKNOWN_METHOD\fR +.RS 4 +The requested method does not exist in the selected interface\&. +.RE +.PP +\fBSD_BUS_ERROR_UNKNOWN_OBJECT\fR +.RS 4 +The requested object does not exist in the selected service\&. +.RE +.PP +\fBSD_BUS_ERROR_UNKNOWN_INTERFACE\fR +.RS 4 +The requested interface does not exist on the selected object\&. +.RE +.PP +\fBSD_BUS_ERROR_UNKNOWN_PROPERTY\fR +.RS 4 +The requested property does not exist in the selected interface\&. +.RE +.PP +\fBSD_BUS_ERROR_PROPERTY_READ_ONLY\fR +.RS 4 +A write operation was requested on a read\-only property\&. +.RE +.PP +\fBSD_BUS_ERROR_UNIX_PROCESS_ID_UNKNOWN\fR +.RS 4 +The requested PID is not known\&. +.RE +.PP +\fBSD_BUS_ERROR_INVALID_SIGNATURE\fR +.RS 4 +The specified message signature is not valid\&. +.RE +.PP +\fBSD_BUS_ERROR_INCONSISTENT_MESSAGE\fR +.RS 4 +The passed message does not validate correctly\&. +.RE +.PP +\fBSD_BUS_ERROR_MATCH_RULE_NOT_FOUND\fR +.RS 4 +The specified match rule does not exist\&. +.RE +.PP +\fBSD_BUS_ERROR_MATCH_RULE_INVALID\fR +.RS 4 +The specified match rule is invalid\&. +.RE +.PP +\fBSD_BUS_ERROR_INTERACTIVE_AUTHORIZATION_REQUIRED\fR +.RS 4 +Access to the requested operation is not permitted\&. However, it might be available after interactive authentication\&. This is usually returned by method calls supporting a framework for additional interactive authorization, when interactive authorization was not enabled with the +\fBsd_bus_message_set_allow_interactive_authorization\fR(3) +for the method call message\&. +.RE +.SH "NOTES" +.PP +Functions described here are available as a shared library, which can be compiled against and linked to with the +\fBlibsystemd\fR\ \&\fBpkg-config\fR(1) +file\&. +.PP +The code described here uses +\fBgetenv\fR(3), which is declared to be not multi\-thread\-safe\&. This means that the code calling the functions described here must not call +\fBsetenv\fR(3) +from a parallel thread\&. It is recommended to only do calls to +\fBsetenv()\fR +from an early phase of the program when no other threads have been started\&. +.SH "SEE ALSO" +.PP +\fBsystemd\fR(1), +\fBlibsystemd\fR(3), +\fBsd-bus\fR(3), +\fBsd_bus_error\fR(3), +\fBsd_bus_message_set_allow_interactive_authorization\fR(3), +\fBerrno\fR(3), +\fBstrerror_r\fR(3) |