gnunet/doc/man/gnunet-testing-run-service.1

.\" This file is part of GNUnet.
.\" Copyright (C) 2001-2019 GNUnet e.V.
.\"
.\" Permission is granted to copy, distribute and/or modify this document
.\" under the terms of the GNU Free Documentation License, Version 1.3 or
.\" any later version published by the Free Software Foundation; with no
.\" Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.  A
.\" copy of the license is included in the file
.\" FDL-1.3.
.\"
.\" A copy of the license is also available from the Free Software
.\" Foundation Web site at http://www.gnu.org/licenses/fdl.html}.
.\"
.\" Alternately, this document is also available under the General
.\" Public License, version 3 or later, as published by the Free Software
.\" Foundation.  A copy of the license is included in the file
.\" GPL3.
.\"
.\" A copy of the license is also available from the Free Software
.\" Foundation Web site at http://www.gnu.org/licenses/gpl.html
.\"
.\" SPDX-License-Identifier: GPL3.0-or-later OR FDL1.3-or-later
.\"
.Dd August 25, 2013
.Dt GNUNET-TESTING-RUN-SERVICE 1
.Os
.Sh NAME
.Nm gnunet-testing-run-service
.Nd command line tool to start a service for testing
.Sh SYNOPSIS
.Nm
.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
.Op Fl h | -help
.Op Fl s Ar SERVICE | Fl -service= Ns Ar SERVICE
.Sh DESCRIPTION
.Nm
is a command line tool to start a service for testing.
It starts a peer, running only the service specified on the command line, outputs the path to the temporary configuration file to stdout.
.Pp
The peer will run until this program is killed, or stdin is closed.
When reading the character 'r' from stdin, the running service is restarted with the same configuration.
.Pp
This executable is intended to be used by gnunet-java, in order to reliably start and stop services for test cases.
.Bl -tag -width indent
.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
Name of the template configuration file to use (optional).
.It Fl h | -help
Print short help on options.
.It Fl s Ar SERVICE | Fl -service= Ns Ar SERVICE
Name of the service to run.
.El
.Sh SEE ALSO
The full documentation for gnunet is maintained as a Texinfo manual.
If the
.Xr info 1
and gnunet programs are properly installed at your site, the command
.Pp
.Dl info gnunet
.Pp
should give you access to the complete handbook,
.Pp
.Dl info gnunet-c-tutorial
.Pp
will give you access to a tutorial for developers.
.sp
Depending on your installation, this information is also available in
.Xr gnunet 7 and
.Xr gnunet-c-tutorial 7 .
.\".Sh HISTORY
.\".Sh AUTHORS
.Sh BUGS
Report bugs by using
.Lk https://bugs.gnunet.org
or by sending electronic mail to
.Aq Mt gnunet-developers@gnu.org .