gnunet-nse.1: follow standards
[oweals/gnunet.git] / doc / man / gnunet-testing-run-service.1
1 .TH GNUNET-TESTING-RUN-SERVICE 1 "August 25, 2013" "GNUnet"
2 .SH NAME
3 gnunet\-testing\-run\-service \- Command line tool to start a service for testing.
4 .SH SYNOPSIS
5 .B gnunet\-testing\-run\-service
6 .RI [ options ]
7 .SH DESCRIPTION
8 \fBgnunet\-testing\-run\-service\fP is a command line tool to start a
9 service for testing. It starts a peer, running only the service
10 specified on the command line, outputs the path to the temporary
11 configuration file to stdout.
12 .PP
13 The peer will run until this program is killed, or stdin is
14 closed. When reading the character 'r' from stdin, the running service
15 is restarted with the same configuration.
16 .PP
17 This executable is intended to be used by gnunet-java, in order to
18 reliably start and stop services for test cases.
19 .SH OPTIONS
20 .IP "\-c FILENAME,  \-\-config=FILENAME"
21 Name of the template configuration file to use (optional).
22 .IP "\-h, \-\-help"
23 Print short help on options.
24 .IP "\-s SERVICE, \-\-service=SERVICE"
25 Name of the service to run.
26 .SH BUGS
27 Report bugs by using Mantis <https://bugs.gnunet.org/> or by sending
28 electronic mail to <gnunet\-developers@gnu.org>
29 .SH SEE ALSO
30 The full documentation for
31 .B gnunet
32 is maintained as a Texinfo manual.
33 If the
34 .B info
35 and
36 .B gnunet
37 programs are properly installed at your site, the command
38 .IP
39 .B info gnunet
40 .PP
41 should give you access to the complete handbook,
42 .IP
43 .B info gnunet-c-tutorial
44 .PP
45 will give you access to a tutorial for developers.
46 .PP
47 Depending on your installation, this information is also
48 available in
49 \fBgnunet\fP(7) and \fBgnunet-c-tutorial\fP(7).