Mismatch in documentation of dbus-send parameter --bus, --peer and --address
@rhabacker
Submitted by Ralf Habacker Assigned to D-Bus Maintainers
Description
dbus-send command line help prints
Usage: dbus-send [--help] [--system | --session | --bus=ADDRESS | --peer=ADDRESS] [--dest=NAME] [--type=TYPE] [--print-reply[=literal]] [--reply-timeout=MSEC] <destination object path>
<message name>
[contents ...]
while the man page prints out
dbus-send [--system | --session | --address=ADDRESS] [--dest=NAME] [--print-reply [=literal]] [--reply-timeout=MSEC] [--type=TYPE] OBJECT_PATH INTERFACE.MEMBER [CONTENTS...]
....
--address=ADDRESS Send to ADDRESS.
It differs in the parameter --bus, --address and --peer.
Looking at the implementation of dbus-send there are all mentioned parameters supported:
if ((strstr (arg, "--bus=") == arg) || (strstr (arg, "--peer=") == arg) || (strstr (arg, "--address=") == arg)) { if (arg[2] == 'b') /* bus / { is_bus = TRUE; } else if (arg[2] == 'p') / peer / { is_bus = FALSE; } else / address; keeping backwards compatibility */ { is_bus = FALSE; }
address = strchr (arg, '=') + 1;
if (address[0] == '\0')
{
fprintf (stderr, "\"--peer=\" and \"--bus=\" require an ADDRESS\n");
usage (1);
}
except that --address looks to be outdated and could not be used to connect to a bus. In the opposite dbus-monitor provides connecting to a bus using --address.
Version: 1.10