GDBUS(1)          <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>         GDBUS(1)

<?><?><?> (NAME)
       gdbus - <?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?> D-Bus

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       gdbus introspect [--system | --session | --address address] --dest bus_name --object-path /path/to/object [--xml] [--recurse] [--only-properties]
       gdbus monitor [--system | --session | --address address] --dest bus_name [--object-path /path/to/object]
       gdbus call [--system | --session | --address address] --dest bus_name --object-path /path/to/object --method org.project.InterfaceName.MethodName [--timeout seconds | --interactive] [ARG<?>]
       gdbus emit [--system | --session | --address address] --object-path /path/to/object --signal org.project.InterfaceName.SignalName [--dest unique_bus_name] [ARG<?>]
       gdbus wait [--system | --session | --address address] --activate bus_name [--timeout seconds] bus_name
       gdbus help


<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> gdbus <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?> <?><?><?><?><?> D-Bus <?><?><?>.

<?><?><?><?><?><?><?> (COMMANDS)
       introspect
          <?><?><?><?><?><?><?> <?> <?><?><?><?><?><?>
          <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?>
          <?><?> <?><?><?> <?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?>
          <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
          <?><?><?><?> org.freedesktop.DBus.Introspectable <?><?>
          <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>. <?><?><?>
          <?><?> <?><?><?><?><?> --xml <?><?><?><?><?><?><?> <?><?><?><?>
          <?><?><?><?><?><?> XML <?><?><?><?><?><?><?><?><?><?><?><?><?><?>
          <?><?> <?><?><?><?><?><?><?><?><?> (introspection) <?><?><?>
          <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?> <?><?><?><?><?>
          <?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?>
          <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>. <?><?>
          <?><?><?><?><?> --recurse <?><?><?><?><?><?><?> <?><?><?><?>
          <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> (<?>
          <?><?><?><?><?><?><?> <?><?><?><?><?> <?> <?><?> <?><?><?><?>
          <?><?><?><?><?>) <?><?><?><?><?><?><?> <?><?><?> <?> <?><?><?><?><?>
          --only-properties <?><?><?><?><?><?><?><?> <?><?><?><?>
          <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
          <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?>.

       monitor
          <?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>
          <?><?><?><?><?><?> <?><?><?><?><?><?><?> bus_name <?><?>
          <?><?><?><?> <?><?><?><?><?><?>.

       call
          <?><?> <?><?><?> <?><?> <?><?><?> <?><?> <?><?><?>
          <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.
          <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?>
          <?><?><?><?> <?><?> <?><?><?><?> <?><?> GVariant
          <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
          <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
          <?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
          <?><?><?><?><?><?> <?><?><?><?><?>. <?><?><?><?><?><?>
          <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
          GVariant <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?>
          <?><?><?><?><?><?><?>.

       emit
          <?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>. <?><?>
          <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
          <?><?><?><?> <?><?> <?><?><?><?> <?><?> GVariant
          <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
          <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
          <?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
          <?><?><?><?><?><?> <?><?><?><?><?>.

       wait
          <?><?> <?><?><?><?><?> <?><?> bus_name <?><?><?><?>
          <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?>
          <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>. <?><?><?>
          --activate <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
          <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
          <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
          <?><?><?><?><?><?>. <?><?><?> <?><?><?> <?><?><?><?> <?><?><?>
          <?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?>
          <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
          <?><?><?><?><?><?>.

       help
          <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?>
          <?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> (BASH COMPLETION)
       <?><?><?><?><?> gdbus <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?> (bash
       completion) <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?> <?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> -- <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>:

          $ gdbus introspect --system \
                  --dest org.freedesktop.NetworkManager \
                  --object-path /org/freedesktop/NetworkManager/Devices/0
          node /org/freedesktop/NetworkManager/Devices/0 {
            interface org.freedesktop.DBus.Introspectable {
              methods:
                Introspect(out s data);
            };
            interface org.freedesktop.DBus.Properties {
              methods:
                Get(in  s interface,
                    in  s propname,
                    out v value);
                Set(in  s interface,
                    in  s propname,
                    in  v value);
                GetAll(in  s interface,
                       out a{sv} props);
            };
            interface org.freedesktop.NetworkManager.Device.Wired {
              signals:
                PropertiesChanged(a{sv} arg_0);
              properties:
                readonly b Carrier = false;
                readonly u Speed = 0;
                readonly s HwAddress = '00:1D:72:88:BE:97';
            };
            interface org.freedesktop.NetworkManager.Device {
              methods:
                Disconnect();
              signals:
                StateChanged(u arg_0,
                             u arg_1,
                             u arg_2);
              properties:
                readonly u DeviceType = 1;
                readonly b Managed = true;
                readwrite o Ip6Config = '/';
                readwrite o Dhcp4Config = '/';
                readwrite o Ip4Config = '/';
                readonly u State = 2;
                readwrite u Ip4Address = 0;
                readonly u Capabilities = 3;
                readonly s Driver = 'e1000e';
                readwrite s Interface = 'eth0';
                readonly s Udi = '/sys/devices/pci0000:00/0000:00:19.0/net/eth0';
            };
          };

       <?><?><?><?><?><?><?><?><?> --recurse <?> --only-properties
       <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?>:

          $ gdbus introspect --system --dest org.freedesktop.UPower --object-path / --recurse  --only-properties
          node / {
            node /org {
              node /org/freedesktop {
                node /org/freedesktop/UPower {
                  interface org.freedesktop.UPower {
                    properties:
                      readonly b IsDocked = true;
                      readonly b LidForceSleep = false;
                      readonly b LidIsPresent = false;
                      readonly b LidIsClosed = false;
                      readonly b OnLowBattery = false;
                      readonly b OnBattery = false;
                      readonly b CanHibernate = true;
                      readonly b CanSuspend = true;
                      readonly s DaemonVersion = '0.9.10';
                  };
                  node /org/freedesktop/UPower/Policy {
                  };
                  node /org/freedesktop/UPower/Wakeups {
                    interface org.freedesktop.UPower.Wakeups {
                      properties:
                        readonly b HasCapability = true;
                    };
                  };
                };
              };
            };
          };

       <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       introspect <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?> Notify <?><?><?><?><?><?><?> <?><?><?>:

          [<?>]
            interface org.freedesktop.Notifications {
              methods:
                GetServerInformation(out s return_name,
                                     out s return_vendor,
                                     out s return_version,
                                     out s return_spec_version);
                GetCapabilities(out as return_caps);
                CloseNotification(in  u id);
                Notify(in  s app_name,
                       in  u id,
                       in  s icon,
                       in  s summary,
                       in  s body,
                       in  as actions,
                       in  a{sv} hints,
                       in  i timeout,
                       out u return_id);
            };
          [<?>]

       <?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> call <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?>:

          $ gdbus call --session \
                       --dest org.freedesktop.Notifications \
                       --object-path /org/freedesktop/Notifications \
                       --method org.freedesktop.Notifications.Notify \
                       my_app_name \
                       42 \
                       gtk-dialog-info \
                       "The Summary" \
                       "Here's the body of the notification" \
                       [] \
                       {} \
                       5000
          (uint32 12,)

       <?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> (file handle):

          $ gdbus call --session \
                       --dest org.example.foo \
                       --object-path /org/example/foo \
                       --method SendFDs \
                       1 \
                       10 \
                       10<file.foo

       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?>:

          $ gdbus monitor --system --dest org.freedesktop.ConsoleKit
          Monitoring signals from all objects owned by org.freedesktop.ConsoleKit
          The name org.freedesktop.ConsoleKit is owned by :1.15
          /org/freedesktop/ConsoleKit/Session2: org.freedesktop.ConsoleKit.Session.ActiveChanged (false,)
          /org/freedesktop/ConsoleKit/Seat1: org.freedesktop.ConsoleKit.Seat.ActiveSessionChanged ('',)
          /org/freedesktop/ConsoleKit/Session2: org.freedesktop.ConsoleKit.Session.ActiveChanged (true,)
          /org/freedesktop/ConsoleKit/Seat1: org.freedesktop.ConsoleKit.Seat.ActiveSessionChanged ('/org/freedesktop/ConsoleKit/Session2',)

       <?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?>:

          $ gdbus monitor --system --dest org.freedesktop.NetworkManager --object-path /org/freedesktop/NetworkManager/AccessPoint/4141
          Monitoring signals on object /org/freedesktop/NetworkManager/AccessPoint/4141 owned by org.freedesktop.NetworkManager
          The name org.freedesktop.NetworkManager is owned by :1.5
          /org/freedesktop/NetworkManager/AccessPoint/4141: org.freedesktop.NetworkManager.AccessPoint.PropertiesChanged ({'Strength': <byte 0x5c>},)
          /org/freedesktop/NetworkManager/AccessPoint/4141: org.freedesktop.NetworkManager.AccessPoint.PropertiesChanged ({'Strength': <byte 0x64>},)
          /org/freedesktop/NetworkManager/AccessPoint/4141: org.freedesktop.NetworkManager.AccessPoint.PropertiesChanged ({'Strength': <byte 0x5e>},)
          /org/freedesktop/NetworkManager/AccessPoint/4141: org.freedesktop.NetworkManager.AccessPoint.PropertiesChanged ({'Strength': <byte 0x64>},)

       <?><?><?><?><?> <?><?> <?><?><?><?><?><?>:

          $ gdbus emit --session --object-path /foo --signal org.bar.Foo "['foo', 'bar', 'baz']"

       <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?>:

          $ gdbus emit --session --object-path /bar --signal org.bar.Bar someString --dest :1.42

       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?>:

          $ gdbus wait --session org.bar.SomeName

       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>:

          $ gdbus wait --session --activate org.bar.SomeName

       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>. <?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?> SomeName
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?>:

          $ gdbus wait --session --activate org.bar.PrerequisiteName org.bar.SomeName

       <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?> <?><?> <?><?>
       <?><?> <?><?><?><?><?>. <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> --timeout <?><?> <?><?><?><?><?> <?><?> 0
       <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?>:

          $ gdbus wait --session --timeout 30 org.bar.SomeName

<?><?><?><?><?> <?><?><?><?><?><?> (REPORTING BUGS)
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?>: <https://gitlab.gnome.org/GNOME/glib/issues/new>

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       dbus-send(1) <man:dbus-send(1)>

glib2                         <?><?> <?><?><?><?>                     GDBUS(1)