1 .\" This file is part of GNUnet.
2 .\" Copyright (C) 2001-2019 GNUnet e.V.
4 .\" Permission is granted to copy, distribute and/or modify this document
5 .\" under the terms of the GNU Free Documentation License, Version 1.3 or
6 .\" any later version published by the Free Software Foundation; with no
7 .\" Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
8 .\" copy of the license is included in the file
11 .\" A copy of the license is also available from the Free Software
12 .\" Foundation Web site at http://www.gnu.org/licenses/fdl.html}.
14 .\" Alternately, this document is also available under the General
15 .\" Public License, version 3 or later, as published by the Free Software
16 .\" Foundation. A copy of the license is included in the file
19 .\" A copy of the license is also available from the Free Software
20 .\" Foundation Web site at http://www.gnu.org/licenses/gpl.html
22 .\" SPDX-License-Identifier: GPL3.0-or-later OR FDL1.3-or-later
29 .Nd control GNUnet services
32 .Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
37 .Op Fl i Ar SERVICE | Fl -init= Ns Ar SERVICE
39 .Op Fl k Ar SERVICE | Fl -kill= Ns Ar SERVICE
40 .Op Fl l Ar FILENAME | Fl -logfile= Ns Ar FILENAME
41 .Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
47 .Op Fl T DELAY | -timeout= Ns Ar TIMEOUT
51 can be used to start or stop GNUnet services,
52 including the ARM service itself.
53 The ARM service is a supervisor for GNUnet's service processes.
54 ARM starts services on-demand or as configured and restarts them
56 .Bl -tag -width indent
57 .It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
58 Use the configuration file
61 Delete configuration file and directory on exit.
63 Shutdown all GNUnet services (including ARM itself).
64 Running "gnunet-arm -e" is the usual way to shutdown a GNUnet peer.
66 Don't let gnunet-arm inherit stderr (standard error).
68 Print short help on options.
69 .It Fl i Ar SERVICE | Fl -init= Ns Ar SERVICE
72 if it is not already running.
73 More specifically, this makes the service behave as if it were in
74 the default services list.
76 List all running services.
77 .It Fl k Ar SERVICE | Fl -kill= Ns Ar SERVICE
81 While this will kill the service right now, the service may be
82 restarted immediately if other services depend on it (the service is
83 then started 'on-demand').
84 If the service used to be a 'default' service, its default-service
85 status will be revoked.
86 If the service was not a default service, it will just
87 be (temporarily) stopped, but could be re-started on-demand at any time.
88 .It Fl l Ar FILENAME | Fl -logfile= Ns Ar FILENAME
91 .It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
95 Valid values are DEBUG, INFO, WARNING and ERROR.
97 Monitor service activity of ARM.
98 In this mode, the command will not terminate until the user presses CTRL-C (thus sending SIGTERM or SIGINT).
100 Don't let gnunet-arm inherit standard output
102 Don't print status messages.
104 Stop and start all GNUnet default services.
106 Start all GNUnet default services on this system (and also ARM).
107 Naturally, if a service is demanded by a default service, it will
108 then also be started.
109 Running "gnunet-arm -s" is the usual way to start a GNUnet peer.
110 .It Fl T DELAY | -timeout= Ns Ar DELAY
111 Exit with error status if operation does not finish after
113 provided in number of microseconds.
115 Print GNUnet version number.
118 Start the gnunet-arm for the user:
122 Stop the gnunet-arm for the user:
126 .Xr gnunet-config 1 ,
129 The full documentation for gnunet is maintained as a Texinfo manual.
132 and gnunet programs are properly installed at your site, the command
136 should give you access to the complete handbook,
138 .Dl info gnunet-c-tutorial
140 will give you access to a tutorial for developers.
142 Depending on your installation, this information is also available in
144 .Xr gnunet-c-tutorial 7 .
149 .Lk https://bugs.gnunet.org
150 or by sending electronic mail to
151 .Aq Mt gnunet-developers@gnu.org .