Movatterモバイル変換

sd_bus_reply_method_error(3) — Linux manual page

SD_BUS_R...HOD_ERROR(3) sd_bus_reply_method_errorSD_BUS_R...HOD_ERROR(3)

NAME        top

       sd_bus_reply_method_error, sd_bus_reply_method_errorf,       sd_bus_reply_method_errorfv, sd_bus_reply_method_errno,       sd_bus_reply_method_errnof, sd_bus_reply_method_errnofv - Reply       with an error to a D-Bus method call

SYNOPSIS        top

#include <systemd/sd-bus.h>int sd_bus_reply_method_error(sd_bus_message *call,const sd_bus_error *e);int sd_bus_reply_method_errorf(sd_bus_message *call,const char *name,const char *format, ...);int sd_bus_reply_method_errorfv(sd_bus_message *call,const char *name,const char *format, va_listap);int sd_bus_reply_method_errno(sd_bus_message *call, interror,const sd_bus_error *p);int sd_bus_reply_method_errnof(sd_bus_message *call, interror,const char *format, ...);int sd_bus_reply_method_errnofv(sd_bus_message *call, interror,const char *format, va_listap);

DESCRIPTION        top

       Thesd_bus_reply_method_error()function sends an error reply to       thecall message. The error structuree specifies the error to       send, and is used as described insd_bus_message_new_method_error(3). If no reply is expected tocall, this function succeeds without sending a reply.       Thesd_bus_reply_method_errorf()is tosd_bus_reply_method_error()       whatsd_bus_message_new_method_errorf()is tosd_bus_message_new_method_error().       Thesd_bus_reply_method_errno()is tosd_bus_reply_method_error()       whatsd_bus_message_new_method_errno()is tosd_bus_message_new_method_error().       Thesd_bus_reply_method_errnof()is tosd_bus_reply_method_error()       whatsd_bus_message_new_method_errnof()is tosd_bus_message_new_method_error().

RETURN VALUE        top

       This function returns a non-negative integer if the error reply       was successfully sent or ifcall does not expect a reply. On       failure, it returns a negative errno-style error code.Errors       Returned errors may indicate the following problems:-EINVAL           The input parametercall isNULL.           Messagecall is not a method call message.           Messagecall is not attached to a bus.           The error parametere tosd_bus_reply_method_error()is not           set, seesd_bus_error_is_set(3).-EPERM           Messagecall has been sealed.-ENOTCONN           The bus to which messagecall is attached is not connected.-ENOMEM           Memory allocation failed.       In addition, any error returned bysd_bus_send(3) may be returned.

NOTES        top

       Functions described here are available as a shared library, which       can be compiled against and linked to with thelibsystemd pkg-config(1) file.       The code described here usesgetenv(3), which is declared to be       not multi-thread-safe. This means that the code calling the       functions described here must not callsetenv(3) from a parallel       thread. It is recommended to only do calls tosetenv()from an       early phase of the program when no other threads have been       started.

SEE ALSO        top

systemd(1),sd-bus(3),sd_bus_message_new_method_error(3)

COLOPHON        top

       This page is part of thesystemd (systemd system and service       manager) project.  Information about the project can be found at       ⟨http://www.freedesktop.org/wiki/Software/systemd⟩.  If you have a       bug report for this manual page, see       ⟨http://www.freedesktop.org/wiki/Software/systemd/#bugreports⟩.       This page was obtained from the project's upstream Git repository       ⟨https://github.com/systemd/systemd.git⟩ on 2025-08-11.  (At that       time, the date of the most recent commit that was found in the       repository was 2025-08-11.)  If you discover any rendering       problems in this HTML version of the page, or you believe there is       a better or more up-to-date source for the page, or you have       corrections or improvements to the information in this COLOPHON       (which isnot part of the original manual page), send a mail to       man-pages@man7.orgsystemd 258~rc2SD_BUS_R...HOD_ERROR(3)

Pages that refer to this page:sd-bus(3), sd_bus_add_object(3), systemd.directives(7), systemd.index(7)

HTML rendering created 2025-09-06 byMichael Kerrisk, author ofThe Linux Programming Interface. For details of in-depthLinux/UNIX system programming training courses that I teach, lookhere. Hosting byjambit GmbH.