aeb7cc751f5bfa05450d617b71e89d7b024c84bb
[oweals/gnunet.git] / doc / man / gnunet-datastore.1
1 .Dd April 13, 2017
2 .Dt GNUNET-DATASTORE 1
3 .Os
4 .Sh NAME
5 .Nm gnunet-datastore
6 .Nd
7 dump or insert (restore) GNUnet datastore databases
8 .Sh SYNOPSIS
9 .Nm
10 .Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME
11 .Op Fl d | \-dump
12 .Op Fl f Ar FILENAME | Fl \-file= Ns Ar FILENAME
13 .Op Fl h | \-help
14 .Op Fl i | \-insert
15 .Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL
16 .Op Fl l Ar FILENAME | Fl \-logfile= Ns Ar FILENAME
17 .Op Fl v | \-version
18 .Sh DESCRIPTION
19 .Nm
20 can be used to backup and restore or merge GNUnet datastores.
21 This is useful if a datastore is to be migrated between SQL databases, i.e. from sqlite to postgres or vice versa.
22 gnunet-datastore will dump the entire contents of the database or insert a dump file into the database.
23 .Bl -tag -width Ds
24 .It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME
25 Configuration file to use
26 .It Fl d | \-dump
27 Dump all records to a file
28 .It Fl f Ar FILENAME | Fl \-file= Ns Ar FILENAME
29 File to dump to or insert from.
30 Otherwise stdin/stdout are used.
31 .It Fl h | \-help
32 Print the help page.
33 .It Fl i | \-insert
34 Insert from dump file.
35 .It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL
36 Change the loglevel.
37 Possible values for LOGLEVEL are ERROR, WARNING, INFO and DEBUG.
38 .It Fl l Ar FILENAME | Fl \-logfile= Ns Ar FILENAME
39 Configure logging to write logs to FILENAME
40 .It Fl v | \-version
41 Print the version number
42 .El
43 .\".Sh EXAMPLES
44 .Sh SEE ALSO
45 .Xr gnunet-publish 1
46 .sp
47 The full documentation for gnunet is maintained as a Texinfo manual.
48 If the
49 .Xr info 1
50 and gnunet programs are properly installed at your site, the command
51 .Pp
52 .Dl info gnunet
53 .Pp
54 should give you access to the complete handbook,
55 .Pp
56 .Dl info gnunet-c-tutorial
57 .Pp
58 will give you access to a tutorial for developers.
59 .sp
60 Depending on your installation, this information is also available in
61 .Xr gnunet 7 and
62 .Xr gnunet-c-tutorial 7 .
63 .\".Sh HISTORY
64 .\".Sh AUTHORS
65 .Sh BUGS
66 Report bugs by using
67 .Lk https://bugs.gnunet.org
68 or by sending electronic mail to
69 .Aq Mt gnunet-developers@gnu.org .