Diffstat (limited to 'doc/man/gnunet-transport.1')
1 files changed, 75 insertions, 67 deletions
diff --git a/doc/man/gnunet-transport.1 b/doc/man/gnunet-transport.1
index eef762174..f5ed47ad1 100644
@@ -1,84 +1,92 @@
-.TH GNUNET\-TRANSPORT "1" "October 17, 2015" "GNUnet"
-gnunet\-transport \- measure and control the transport subsystem
-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
-measure how fast we are receiving data (from all connections). On
-exit, the data rate will be reported. Runs until aborted with CTRL-C.
-force disconnection from a peer (used in conjunction with \-p).
-Note that you can use the gnunet\-ats command\-line tool to suggest connects.
-\fB\-c \fIFILENAME\fR, \fB\-\-config=FILENAME\fR
+.Dd October 17, 2015
+.Dt GNUNET-TRANSPORT 1
+measure and control the transport subsystem
+.Op Fl b | \-benchmark
+.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME
+.Op Fl D | \-disconnect
+.Op Fl e | \-events
+.Op Fl h | \-help
+.Op Fl i | \-information
+.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL
+.Op Fl l Ar LOGFILE | Fl \-logfile= Ns Ar LOGFILE
+.Op Fl m | \-monitor
+.Op Fl p Ar PEER | Fl \-peer= Ns Ar PEER
+.Op Fl P | \-plugins
+.Op Fl s | \-send
+.Op Fl v | \-version
+.Op Fl V | \-verbose
+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.
+.Bl -tag -width Ds
+.It Fl b | \-benchmark
+measure how fast we are receiving data (from all connections).
+On exit, the data rate will be reported.
+Runs until aborted with CTRL-C.
+.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME
configuration file to use
+.It Fl D | \-disconnect
+force disconnection from a peer (used in conjunction with \-p).
+Note that you can use the gnunet-ats command-line tool to suggest connects.
+.It Fl e | \-events
provide information about all connect and disconnect events (continuously)
+.It Fl h | \-help
print help page
+.It Fl i | \-information
print information about our current connections (once)
-\fB\-L \fILOGLEVEL\fR, \fB\-\-loglevel=LOGLEVEL\fR
+.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL
Change the loglevel. Possible values for LOGLEVEL are ERROR, WARNING, INFO and DEBUG.
-\fB\-l \fILOGFILE\fR, \fB\-\-logfile=LOGFILE\fR
+.It Fl l Ar LOGFILE | Fl \-logfile= Ns Ar LOGFILE
configure logging to write logs to LOGFILE
+.It Fl m | \-monitor
print information about our current connections (continuously)
-\fB\-p \fIPEER\fR, \fB\-\-peer=PEER\fR
+.It Fl p Ar PEER | Fl \-peer= Ns Ar PEER
the peer identity to connect to or monitor
+.It Fl P | \-plugins
monitor session state of transport plugins
+.It Fl s | \-send
transmit (dummy) traffic as quickly as possible to the peer specified
with the \-p 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.
+.It Fl v | \-version
print the version number
+.It Fl V | \-verbose
-.SH "REPORTING BUGS"
-Report bugs by using mantis <https://bugs.gnunet.org/> or by sending electronic mail to <gnunet\-firstname.lastname@example.org>
-.SH "SEE ALSO"
-The full documentation for
-is maintained as a Texinfo manual. If the
-programs are properly installed at your site, the command
-.B info gnunet
+.Sh SEE ALSO
+.Xr gnunet-arm 1 ,
+.Xr gnunet-ats 1
+The full documentation for gnunet is maintained as a Texinfo manual.
+.Xr info 1
+and gnunet programs are properly installed at your site, the command
+.Dl info gnunet
should give you access to the complete handbook,
-.B info gnunet-c-tutorial
+.Dl info gnunet-c-tutorial
will give you access to a tutorial for developers.
-Depending on your installation, this information is also
-\fBgnunet\fP(7) and \fBgnunet-c-tutorial\fP(7).
+Depending on your installation, this information is also available in
+.Xr gnunet 7 and
+.Xr gnunet-c-tutorial 7 .
+Report bugs by using
+or by sending electronic mail to
+.Aq Mt email@example.com .