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 display information about transport resource allocation
33 .Op Fl C Ar PEERID | Fl -connect= Ns Ar PEERID
34 .Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
36 .Op Fl i Ar PEERID | Fl -id= Ns Ar PEERID
37 .Op Fl k Ar VALUE | Fl -value= Ns Ar VALUE
38 .Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
41 .Op Fl p Ar PREFERENCE | Fl -preference= Ns Ar PREFERENCE
43 .Op Fl t Ar TYPE | Fl -type= Ns Ar TYPE
49 can be used to display information about the
50 GNUnet's transport selection mechanism.
51 It shows information about the addresses and
52 the assigned input and output bandwidth.
54 .Bl -tag -width indent
56 List all addresses currently known to ats.
57 .It Fl C Ar PEERID | Fl -connect= Ns Ar PEERID
58 Ask ATS to suggest an address for PEERID to transport
59 to establish a connection.
60 Note that you can use the
61 .Xr gnunet-transport 1
62 commandline tool to force disconnects.
63 .It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
64 Use the configuration file FILENAME.
66 Print short help on options.
67 .It Fl i Ar PEERID | Fl -id= Ns Ar PEERID
68 Print information for a specific peer identity only.
69 .It Fl k Ar VALUE | Fl -value= Ns Ar VALUE
70 Value to set for when changing preference values.
71 .It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
72 Use LOGLEVEL for logging.
73 Valid values are DEBUG, INFO, WARNING and ERROR.
75 Monitor changes to the bandwidth assignments continuously.
77 Do not resolve IP addresses to hostnames.
78 .It Fl p Ar PREFERENCE | Fl -preference= Ns Ar PREFERENCE
79 Set preference values, -i, -k and -t required.
81 Print quotas for all network types
82 .It Fl t Ar TYPE | Fl -type= Ns Ar TYPE
83 Preference type to change: latency | bandwidth
85 Print addresses actively used only
87 Print verbose output (include ATS address properties)
89 Print GNUnet version number.
92 .Xr gnunet-transport 1
94 The full documentation for gnunet is maintained as a Texinfo manual.
97 and gnunet programs are properly installed at your site, the command
101 should give you access to the complete handbook,
103 .Dl info gnunet-c-tutorial
105 will give you access to a tutorial for developers.
107 Depending on your installation, this information is also available in
109 .Xr gnunet-c-tutorial 7 .
112 .Lk https://bugs.gnunet.org
113 or by sending electronic mail to
114 .Aq Mt bug-gnunet@gnu.org .