DBUS-BROKER(1) DBUS-BROKER(1) (NAME) dbus-broker - D-Bus (SYNOPSIS) dbus-broker [ ] dbus-broker --version dbus-broker --help (DESCRIPTION) dbus-broker D-Bus [1] . . D-Bus . dbus-broker . . dbus-broker-launch(1) dbus-daemon(1) D-Bus . dbus-broker-launch(1) . dbus-broker ( dbus-broker-launch(1)) . (OPTIONS) . . -h, --help . --version . --audit (audit) ( audit : ). --controller=FD (file descriptor) ( (CONTROLLER) ). --log FD ( (LOGGING) : ). --machine-id=ID (machine-id) org.freedesktop.DBus ( /etc/machine-id ). --max-bytes=BYTES (: / 16 MiB). --max-fds=FDS (: ). --max-matches=MATCHES (match rules) (: / 16k). --max-objects=OBJECTS (peers) (: / 16k). (CONTROLLER) dbus-broker unix(7) . --controller . ( ) . (P2P) D-Bus . (API) . (idle) (fork) . . dbus-broker nss(5) . . . . (LOGGING) (FD) --log FD . : 1. FD unix(7) SOCK_STREAM . 2. FD unix(7) SOCK_DGRAM / . systemd-journal ( systemd ). / . . . . . . : 1. . 2. (policy) . 3. (resource quota) . (API) . . . . . node /org/bus1/DBus/Broker { interface org.bus1.DBus.Broker { # Create new activatable name @name, accounted on user @uid. The name # will be exposed by the controller as @path (which must fit the # template /org/bus1/DBus/Name/%). method AddName(o path, s name, u uid) -> () # Add a listener socket to this bus. The listener socket must be # ready in listening mode and specified as @socket. As soon as this # call returns, incoming client connection attempts will be served # on this socket. # The listener is exposed by the controller as @path (which must fit # the template /org/bus1/DBus/Listener/%). # The policy for all clients connecting through this socket is # provided as @policy. See org.bus1.DBus.Listener.SetPolicy() for # details. method AddListener(o path, h socket, v policy) -> () # This signal is raised according to client-requests of # org.freedesktop.DBus.UpdateActivationEnvironment(). signal SetActivationEnvironment(a{ss} environment) } } node /org/bus1/DBus/Listener/% { interface org.bus1.DBus.Listener { # Release this listener. It will immediately be removed by the broker # and no more connections will be served on it. All clients connected # through this listener are forcefully disconnected. method Release() -> () # Change the policy on this listener socket to @policy. The syntax of # the policy is still subject to change and not stable, yet. method SetPolicy(v policy) -> () } } node /org/bus1/DBus/Name/% { interface org.bus1.DBus.Name { # Release this activatable name. It will be removed with immediate # effect by the broker. Note that the name is still valid to be # acquired by clients, though no activation-features will be # supported on this name. method Release() -> () # Reset the activation state of this name. Any pending activation # requests are cancelled. The call requires a serial number to be # passed along. This must be the serial number received by the last # activation event on this name. Calls for other serial numbers are # silently ignored and considered stale. # A org.bus1.DBus.Name.Error string is also passed, giving a hint # about the reason the activation was reset. The list is defined below. method Reset(t serial, s error) -> () # Activation request failed: a concurrent deactivation request is already in progress error org.bus1.DBus.Name.Error.DestructiveTransaction # Activation request failed: unknown unit error org.bus1.DBus.Name.Error.UnknownUnit # Activation request failed: unit is masked error org.bus1.DBus.Name.Error.MaskedUnit # Activation request failed: unit is invalid error org.bus1.DBus.Name.Error.InvalidUnit # Unit activation job succeeded, but the unit failed afterwards error org.bus1.DBus.Name.Error.UnitFailure # The startup job was valid, but it failed during activation error org.bus1.DBus.Name.Error.StartupFailure # The startup job was valid, but it was skipped during activation error org.bus1.DBus.Name.Error.StartupSkipped # Activation request cancelled: bus name was released error org.bus1.DBus.Name.Error.NameReleased # This signal is sent whenever a client requests activation of this # name. Note that multiple activation requests are coalesced by the # broker. The controller can cancel outstanding requests via the # Reset() method. # The broker sends a serial number with the event. This number # represents the activation request and must be used when reacting # to the request with methods like Reset(). The serial number is # unique for each event, and is never reused. A serial number of 0 # is never sent and considered invalid. signal Activate(t serial) } } . (driver-interface) D-Bus . (asynchronous) . (blocking) . ( ) . node /org/bus1/DBus/Controller { interface org.bus1.DBus.Controller { # This function is called for each client-request of # org.freedesktop.DBus.ReloadConfig(). method ReloadConfig() -> () } } (REPORTING BUGS) : (SEE ALSO) dbus-broker-launch(1) dbus-daemon(1) (NOTES) [1] D-Bus: dbus-broker DBUS-BROKER(1)