.nh
.TH bluechi-proxy 1
.SH NAME
bluechi-proxy \- Proxy requesting services on other agents

.SH SYNOPSIS
\fBbluechi-proxy\fP [\fIoptions\fP] \fIcommand\fP

.SH DESCRIPTION
Eclipse BlueChi™ is a service orchestrator tool intended for multi-node devices
(e.g.: edge devices) clusters with a predefined number of nodes and
with a focus on highly regulated environment such as those requiring
functional safety (for example in cars).

.PP
A \fBbluechi-proxy\fR uses the public API of \fBbluechi-agent\fR provided on the
local D-Bus to request services required by a local unit to be started
or stopped on a remote node managed by another \fBbluechi-agent\fR\&.

.PP
\fBbluechi-proxy [OPTIONS]\fP

.SH OPTIONS
.SS \fB--help\fP, \fB-h\fP
Print usage statement and exit.

.SS \fB--version\fP,  \fB-v\fP
Print current bluechi-proxy version

.SH Commands
.SS \fBbluechi-proxy\fP create [\fInode_service\fP]
Starts the \fBbluechi-proxy\fR to call the \fBCreateProxy\fR method on the local
\fBbluechi-agent\fR to request a remote service to be started on the given
node. \fBbluechi-proxy\fR is exiting when starting the service has either
succeeded or failed.

.SS \fBbluechi-proxy\fP remove [\fInode_service\fP]
Starts the \fBbluechi-proxy\fR to call the \fBRemoveProxy\fR method on the local
\fBbluechi-agent\fR to request a remote service to be started on the given
node. \fBbluechi-proxy\fR is exiting when starting the service has either
succeeded or failed.

.SH Exit Codes
On successfully starting the remote service, 0 is returned. Otherwise, 1 is returned.

.SH SEE ALSO
\fBsystemd.unit(5)
\[la]https://www.freedesktop.org/software/systemd/man/systemd.unit.html\[ra]\fP