summaryrefslogtreecommitdiffstats
path: root/remote-process/README.md
blob: 128dc3febef69f6c30134c1e604e6d19e20ff645 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
# remote-process

`remote-process` is an executable used to communicate with an instance of the
parameter-framework through a TCP socket.  It is only possible if the
parameter-framework's configuration allows it (`TuningAllowed="true"` in the
ParameterFrameworkConfiguration.xml) and if the port is also defined in the
configuration (by the `ServerPort` attribute):

For instance, if your parameter-framework configuration starts with:

    <ParameterFrameworkConfiguration SystemClassName="..." ServerPort="5000" TuningAllowed="true">

then, it listens on port 5000.

remote-process may also be used to communicate with test-platform
(see test/test-platform/README.md) thanks to test-platform being a minimal
parameter-framework client.

## Syntax

    remote-process <host> <port> <command>

You can get all available commands with the `help` command.

You may also run a batch of commands by passing them on remote-process'
standard input:

    remote-process <host> <port> < file

You should not use this feature in an interactive mode, because the
communication may timeout if you're typing your commands too slowly.