man: license headers
[oweals/gnunet.git] / doc / man / gnunet-peerinfo.1
1 .\" This file is part of GNUnet.
2 .\" Copyright (C) 2001-2019 GNUnet e.V.
3 .\"
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
9 .\" ``FDL-1.3''.
10 .\"
11 .\" A copy of the license is also available from the Free Software
12 .\" Foundation Web site at @url{http://www.gnu.org/licenses/fdl.html}.
13 .\"
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
17 .\" ``GPL3''.
18 .\"
19 .\" A copy of the license is also available from the Free Software
20 .\" Foundation Web site at @url{http://www.gnu.org/licenses/gpl.html}.
21 .\"
22 .\" SPDX-License-Identifier: GPL3.0-or-later OR FDL1.3-or-later
23 .\"
24 .Dd March 4, 2013
25 .Dt GNUNET-PEERINFO 1
26 .Os
27 .Sh NAME
28 .Nm gnunet-peerinfo
29 .Nd
30 display information about other peers
31 .Sh SYNOPSIS
32 .Nm
33 .Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME
34 .Op Fl g | \-get\-hello
35 .Op Fl h | \-help
36 .Op Fl i | \-info
37 .Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL
38 .Op Fl l Ar LOGFILE | Fl \-logfile= ns Ar LOGFILE
39 .Op Fl n | \-numeric
40 .Op Fl p Ar HELLO | Fl \-put\-hello= Ns Ar HELLO
41 .Op Fl q | \-quiet
42 .Op Fl s | \-self
43 .Op Fl v | \-version
44 .Sh DESCRIPTION
45 .Nm
46 displays the known addresses and trust of known peers.
47 .Bl -tag -width Ds
48 .It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME
49 Load config file, default FILENAME of the config is 
50 .Pa ~/.config/gnunet.conf .
51 .It Fl g | \-get\-hello
52 Output HELLO uri(s)
53 .It Fl h | \-help
54 Print the help page.
55 .It Fl i | \-info
56 List all known peers (and their addresses).
57 .It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL
58 Set the loglevel
59 .It Fl l Ar LOGFILE | Fl \-logfile= ns Ar LOGFILE
60 Log messages to LOGFILE
61 .It Fl n | \-numeric
62 Disable resolution of IPs to hostnames
63 .It Fl p Ar HELLO | Fl \-put\-hello= Ns Ar HELLO
64 Add given HELLO uri to the database
65 .It Fl q | \-quiet
66 Do not print anything but the peer identities
67 .It Fl s | \-self
68 Print only our own identity.
69 Together with
70 .Fl q ,
71 this is the exact line that other peers would have to put in to their friends file in order to consider this peer one of their friends in F2F mode.
72 .It Fl v | \-version
73 Print the version number
74 .El
75 .Sh SEE ALSO
76 .Xr gnunet.conf 5
77 .sp
78 The full documentation for gnunet is maintained as a Texinfo manual.
79 If the
80 .Xr info 1
81 and gnunet programs are properly installed at your site, the command
82 .Pp
83 .Dl info gnunet
84 .Pp
85 should give you access to the complete handbook,
86 .Pp
87 .Dl info gnunet-c-tutorial
88 .Pp
89 will give you access to a tutorial for developers.
90 .sp
91 Depending on your installation, this information is also available in
92 .Xr gnunet 7 and
93 .Xr gnunet-c-tutorial 7 .
94 .\".Sh HISTORY
95 .\".Sh AUTHORS
96 .Sh BUGS
97 Report bugs by using
98 .Lk https://bugs.gnunet.org
99 or by sending electronic mail to
100 .Aq Mt gnunet-developers@gnu.org .