sd_bus_list_names(3) — Linux manual page


SD_BUS_LIST_NAMES(3)          sd_bus_list_names         SD_BUS_LIST_NAMES(3)

NAME         top

       sd_bus_list_names - Retrieve information about registered names on a

SYNOPSIS         top

       #include <systemd/sd-bus.h>

       int sd_bus_list_names(sd_bus *bus, char ***acquired,
                             char ***activatable);

DESCRIPTION         top

       sd_bus_list_names() retrieves information about the registered names
       on a bus. If acquired is not NULL, this function calls
       org.freedesktop.DBus.ListNames[1] to retrieve the list of
       currently-owned names on the bus. If acquired is not NULL, the
       function calls org.freedesktop.DBus.ListActivableNames[2] to retrieve
       the list of all names on the bus that can be activated. Note that
       ownership of the arrays returned by sd_bus_list_names() in acquired
       and activatable is transferred to the caller and hence, the caller is
       responsible for freeing these arrays and their contents.

RETURN VALUE         top

       On success, sd_bus_list_names() returns a non-negative integer. On
       failure, it returns a negative errno-style error code.

       Returned errors may indicate the following problems:

           bus or both acquired and activatable were NULL.

           The bus cannot be resolved.

           The bus was created in a different process.

           Memory allocation failed.

           The bus is not connected.

NOTES         top

       These APIs are implemented as a shared library, which can be compiled
       and linked to with the libsystemd pkg-config(1) file.

SEE ALSO         top

       systemd(1), sd-bus(3)

NOTES         top

        1. org.freedesktop.DBus.ListNames

        2. org.freedesktop.DBus.ListActivableNames

COLOPHON         top

       This page is part of the systemd (systemd system and service manager)
       project.  Information about the project can be found at 
       ⟨⟩.  If you have a bug
       report for this manual page, see
       ⟨⟩.  This
       page was obtained from the project's upstream Git repository
       ⟨⟩ on 2020-06-09.  (At that
       time, the date of the most recent commit that was found in the repos‐
       itory was 2020-06-09.)  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 is not part
       of the original manual page), send a mail to

systemd 245                                             SD_BUS_LIST_NAMES(3)

Pages that refer to this page: sd-bus(3)30-systemd-environment-d-generator(7)systemd.directives(7)systemd.index(7)