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