gnunet-nse.1: follow standards
[oweals/gnunet.git] / doc / man / gnunet-namestore-fcfsd.1
1 .TH GNUNET-NAMESTORE-FCFSD 1 "September 5, 2013" "GNUnet"
2 .SH NAME
3 gnunet\-namestore-fcfsd \- HTTP server for GNU Name System First-Come-First-Served name registration
4 .SH SYNOPSIS
5 .B gnunet\-namestore-fcfsd
6 .RI [ options ]
7 .SH DESCRIPTION
8 Most users will not want to run an FCFS\-zone and thus will not need
9 this program.
10 .PP
11 \fBgnunet\-gns-fcfsd\fP runs a web server where users can register
12 names to be mapped to their GNS zone.  Names are made available on a
13 First Come First Served basis (hence fcfs).  Registered names do not
14 expire.  The HTTP server is run on the port that is specified in the
15 configuration file in section "[fcfsd]" under the name "HTTPPORT".
16 .PP
17 It is possible to manage gnunet\-gns\-fcfsd using
18 gnunet\-(service\-arm) by starting the daemon using "gnunet\-arm \-i
19 fcfsd" or by setting "IMMEDIATE_START=YES" in the "fcfds" section of your
20 configuration and the "-z ZONE" in as the "OPTION".
21 .PP
22 An FCFS\-zone is run at http://gnunet.org/fcfs/.  GNS users are
23 encouraged to register their zone with the gnunet.org FCFS authority.
24 .PP
25 If you want to run your own FCFS registrar, you need to first create a
26 pseudonym (using "gnunet\-identity \-C NAME"), and use it with the
27 "-z" option.  After that, you can start the FCFSD service (possibly using
28 gnunet\-arm).
29 .SH OPTIONS
30 .IP "\-c FILENAME,  \-\-config=FILENAME"
31 Use the configuration file FILENAME.
32 .IP "\-h, \-\-help"
33 Print short help on options.
34 .IP "\-L LOGLEVEL, \-\-loglevel=LOGLEVEL"
35 Use LOGLEVEL for logging.  Valid values are DEBUG, INFO, WARNING and
36 ERROR.
37 .IP "\-v, \-\-version"
38 Print GNUnet version number.
39 .IP "\-z EGO, \-\-zone=EGO"
40 Specifies for which EGO should FCFSD manage the zone.
41 .SH BUGS
42 Report bugs by using Mantis <https://bugs.gnunet.org/> or by sending
43 electronic mail to <bug\-gnunet@gnu.org>
44 .SH SEE ALSO
45 gnunet\-identity(1), gnunet\-gns(1), gnunet\-gns\-proxy(1)
46 .PP
47 The full documentation for
48 .B gnunet
49 is maintained as a Texinfo manual.
50 If the
51 .B info
52 and
53 .B gnunet
54 programs are properly installed at your site, the command
55 .IP
56 .B info gnunet
57 .PP
58 should give you access to the complete handbook,
59 .IP
60 .B info gnunet-c-tutorial
61 .PP
62 will give you access to a tutorial for developers.
63 .PP
64 Depending on your installation, this information is also
65 available in
66 \fBgnunet\fP(7) and \fBgnunet-c-tutorial\fP(7).