systemd-bus-proxyd.xml revision 5de0ccffcc4a5a946102a14e0b0e681d964e3225
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann<?xml version='1.0'?> <!--*- Mode: nxml; nxml-child-indent: 2; indent-tabs-mode: nil -*-->
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann This file is part of systemd.
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann Copyright 2013 Zbigniew Jędrzejewski-Szmek
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann systemd is free software; you can redistribute it and/or modify it
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann under the terms of the GNU Lesser General Public License as published by
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann the Free Software Foundation; either version 2.1 of the License, or
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann (at your option) any later version.
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann systemd is distributed in the hope that it will be useful, but
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann WITHOUT ANY WARRANTY; without even the implied warranty of
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann Lesser General Public License for more details.
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann You should have received a copy of the GNU Lesser General Public License
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann along with systemd; If not, see <http://www.gnu.org/licenses/>.
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann<refentry id="systemd-bus-proxyd" conditional="ENABLE_KDBUS"
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <refentryinfo>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <authorgroup>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </authorgroup>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </refentryinfo>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <refentrytitle>systemd-bus-proxyd</refentrytitle>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <refpurpose>Connect STDIO or a socket to a given bus address</refpurpose>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann </refnamediv>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <refsynopsisdiv>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <cmdsynopsis>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <command>/usr/lib/systemd/systemd-bus-proxyd</command>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <arg choice="opt" rep="repeat">OPTIONS</arg>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <arg choice="opt"><replaceable>PLACEHOLDER</replaceable></arg>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </cmdsynopsis>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </refsynopsisdiv>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para><command>systemd-bus-proxyd</command> will proxy D-Bus
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann messages to and from a bus. The will be either the system bus or
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann the bus specified with <option>--address</option> when that option
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann is given. Messages will be proxied to/from standard input and
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann output, or the socket received through socket activation.</para>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>This program can be used to connect a program using classic
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann D-Bus to kdbus.</para>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>The following options are understood:</para>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <variablelist>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <term><option>--address=<replaceable>ADDRESS</replaceable><optional>:<replaceable>ADDRESS...</replaceable></optional></option></term>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <para>Connect to the bus specified by
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <replaceable>ADDRESS</replaceable>. Multiple colon-separated
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann addresses can be specified, in which case
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <command>systemd-bus-proxyd</command> will attempt to
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann connect to them in turn.</para>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <xi:include href="standard-options.xml" xpointer="help" />
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <xi:include href="standard-options.xml" xpointer="version" />
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </variablelist>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para><replaceable>PLACEHOLDER</replaceable>, if given, must be a string
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann of <literal>x</literal> and will be used to display information about
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann the process that <command>systemd-bus-proxyd</command> is forwarding
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann messages for.</para>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <citerefentry project='dbus'><refentrytitle>dbus-daemon</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <ulink url="http://freedesktop.org/wiki/Software/dbus">D-Bus</ulink>,
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <ulink url="https://code.google.com/p/d-bus/">kdbus</ulink>