adding gnunet-gns, a new tool for zone manipulations
[oweals/gnunet.git] / doc / man / gnunet-transport.1
1 .TH gnunet\-transport "1" "26 Oct 2011" "GNUnet"
2 .SH NAME
3 gnunet\-transport \- measure and control the transport subsystem
4
5 .SH SYNOPSIS
6 .B gnunet\-transport
7 [\fIOPTIONS\fR]
8 .SH DESCRIPTION
9 .PP
10
11 gnunet\-transport is a tool to access various functions of GNUnet's transport subsystem from the command\-line.  Most of these are not expected to be useful for end-users.  gnunet\-transport can be used to evaluate the performance of the transports, force a peer to connect to another peer (if possible).  Other functions should be added in the near future.  
12
13 .TP
14 \fB\-b\fR, \fB\-\-benchmark\fR
15 measure how fast we are receiving data (from all connections).  On exit, the data rate will be reported.  Runs until aborted with CTRL-C.
16 .TP
17 \fB\-c \fIFILENAME\fR, \fB\-\-config=FILENAME\fR
18 configuration file to use
19 .TP
20 \fB\-C \fIPEER\fR, \fB\-\-connect=PEER\fR
21 peer to connect to (and to use for sending if used in conjunction with \-s)
22 .TP
23 \fB\-h\fR, \fB\-\-help\fR
24 print help page
25 .TP
26 \fB\-i\fR, \fB\-\-information\fR
27 print information about our current connections (once)
28 .TP
29 \fB\-m\fR, \fB\-\-monitor\fR
30 print information about our current connections (continuously)
31 .TP
32 \fB\-L \fILOGLEVEL\fR, \fB\-\-loglevel=LOGLEVEL\fR
33 Change the loglevel.  Possible values for LOGLEVEL are ERROR, WARNING, INFO and DEBUG.
34 .TP
35 \fB\-s\fR, \fB\-\-send\fR
36 transmit (dummy) traffic as quickly as possible to the peer specified with the \-C option.  The rate will still be limited by the quota(s) determined by the peers (ATS subsystem).  Will run until CTRL\-C is pressed or until the connection to the other peer is disrupted.
37 .TP
38 \fB\-t\fR, \fB\-\-test\fR
39 test transport configuration.  With this flag, the tool will check if each of the configured transport plugins has a working address.  Plugins that do not have a listen port configured will be ignored.  The test is performed with the help of an external server (by default running on gnunet.org) which tries to contact the local machine.  The test can only work if the local GNUnet peer is not yet running.
40 .TP
41 \fB\-v\fR, \fB\-\-version\fR
42 print the version number
43 .TP
44 \fB\-V\fR, \fB\-\-verbose\fR
45 be verbose
46
47 .SH NOTES
48
49
50 .SH "REPORTING BUGS"
51 Report bugs by using mantis <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org>
52 .SH "SEE ALSO"
53 \fBgnunet\-arm\fP(1)