Difference between revisions of "GNUnet"

From ArchWiki
Jump to: navigation, search
(Configuration: Added systemctl command)
(style fixes, see Help:Style)
Line 8: Line 8:
 
[https://gnunet.org/ GNUnet] is a framework for secure peer-to-peer networking that does not use any centralized or otherwise trusted services. Currently, the service implemented on the framework serves to perform censorship-resistant file-sharing.
 
[https://gnunet.org/ GNUnet] is a framework for secure peer-to-peer networking that does not use any centralized or otherwise trusted services. Currently, the service implemented on the framework serves to perform censorship-resistant file-sharing.
  
See also [[Wikipedia:GNUnet|GNUnet]].
+
See also [[Wikipedia:GNUnet]].
  
 
== Installation ==
 
== Installation ==
  
GNUnet can be [[pacman|installed]] with package {{Pkg|gnunet}}, available in [[official repositories]]. If you also want to use the graphical interface, install {{Pkg|gnunet-gtk}}.
+
GNUnet can be [[installed]] with the {{Pkg|gnunet}} package. If you also want to use the graphical interface, install {{Pkg|gnunet-gtk}}.
  
 
== Configuration ==
 
== Configuration ==
  
Start the peer ''immediately'':
+
[[Start]] and possibly [[enable]] the {{ic|gnunet}} service.
  
{{bc|<nowiki># systemctl start gnunet</nowiki>}}
+
To start the peer immediately in a terminal:
  
Enable the peer to be started ''on bootup'':
+
# gnunet-arm -s
  
{{bc|<nowiki># systemctl enable gnunet</nowiki>}}
+
See also [https://gnunet.org/how-start-and-stop-gnunet-peer How to start and stop a GNUnet peer].
 
 
Start the peer ''immediately on a terminal'':
 
 
 
{{bc|<nowiki># gnunet-arm -s</nowiki>}}
 
 
 
See also: [https://gnunet.org/how-start-and-stop-gnunet-peer How to start and stop a GNUnet peer].
 
  
 
== Usage ==
 
== Usage ==
Line 34: Line 28:
 
=== Downloading ===
 
=== Downloading ===
  
To use gnunet-gtk to download a file, just search for the file in the 'Filesystem' tab. When you see the file you want, just download it as you would with any other P2P file-sharing program. Start it with
+
To use ''gnunet-gtk'' to download a file, just search for the file in the ''Filesystem'' tab. When you see the file you want, just download it as you would with any other P2P file-sharing program. Start it with:
  
{{bc|<nowiki># gnunet-fs-gtk</nowiki>}}
+
# gnunet-fs-gtk
  
 
=== Uploading ===
 
=== Uploading ===
  
Uploading files to the gnunet network is more complicated. GNUnet differentiates between 'indexing' a file and 'inserting' a file. The details can be read at the [https://gnunet.org framework's website]. The following steps explain how to share data with the network, and are a shortened form of the instructions found on [https://gnunet.org/file-sharing this page].
+
Uploading files to the gnunet network is more complicated. GNUnet differentiates between ''indexing'' a file and ''inserting'' a file. The details can be read at the [https://gnunet.org framework's website]. The following steps explain how to share data with the network, and are a shortened form of the instructions found on [https://gnunet.org/file-sharing this page].
  
The following steps may have to be done manually. A module, called gnunet-fuse, is being developed to make this process easier for a user. However, as of December 2008, there is little documentation for it and it is not even in [[AUR]] yet.
+
The following steps may have to be done manually. A module, called ''gnunet-fuse'', is being developed to make this process easier for a user. However, as of December 2008, there is little documentation for it and it is not even in [[AUR]] yet.
  
 
==== To index a file/directory ====
 
==== To index a file/directory ====
Line 49: Line 43:
  
 
It is not required to add keywords, but it is recommended. This is because GNUnet does not allow searching by filename, but by keywords. Libextractor, which is a dependency of gnunet, will extract keywords from the file, but you may wish to enter keywords of your own.
 
It is not required to add keywords, but it is recommended. This is because GNUnet does not allow searching by filename, but by keywords. Libextractor, which is a dependency of gnunet, will extract keywords from the file, but you may wish to enter keywords of your own.
The '-m' option is for meta-data. This is data (about the file) that other users of gnunet will see when your files show up during their searches. For further details, see the gnunet.org online documentation. The '-n' option is used to insert a file/directory into the gnunet MySQL/sqlite database, instead of just indexing it.
+
The {{ic|-m}} option is for meta-data. This is data (about the file) that other users of gnunet will see when your files show up during their searches. For further details, see the gnunet.org online documentation. The {{ic|-n}} option is used to insert a file/directory into the gnunet MySQL/sqlite database, instead of just indexing it.
  
 
==== To unindex a file/directory ====
 
==== To unindex a file/directory ====
Line 66: Line 60:
 
=== Killing GNUnet services ===
 
=== Killing GNUnet services ===
  
See [https://gnunet.org/content/how-start-and-stop-gnunet-peer].
+
See [https://gnunet.org/content/how-start-and-stop-gnunet-peer]{{Dead link|2016|02|14}}.

Revision as of 03:34, 14 February 2016

GNUnet is a framework for secure peer-to-peer networking that does not use any centralized or otherwise trusted services. Currently, the service implemented on the framework serves to perform censorship-resistant file-sharing.

See also Wikipedia:GNUnet.

Installation

GNUnet can be installed with the gnunet package. If you also want to use the graphical interface, install gnunet-gtk.

Configuration

Start and possibly enable the gnunet service.

To start the peer immediately in a terminal:

# gnunet-arm -s

See also How to start and stop a GNUnet peer.

Usage

Downloading

To use gnunet-gtk to download a file, just search for the file in the Filesystem tab. When you see the file you want, just download it as you would with any other P2P file-sharing program. Start it with:

# gnunet-fs-gtk

Uploading

Uploading files to the gnunet network is more complicated. GNUnet differentiates between indexing a file and inserting a file. The details can be read at the framework's website. The following steps explain how to share data with the network, and are a shortened form of the instructions found on this page.

The following steps may have to be done manually. A module, called gnunet-fuse, is being developed to make this process easier for a user. However, as of December 2008, there is little documentation for it and it is not even in AUR yet.

To index a file/directory

gnunet-insert [-n] [-k keword1] [-k keyword 2] [-m TYPE:VALUE] filename

It is not required to add keywords, but it is recommended. This is because GNUnet does not allow searching by filename, but by keywords. Libextractor, which is a dependency of gnunet, will extract keywords from the file, but you may wish to enter keywords of your own. The -m option is for meta-data. This is data (about the file) that other users of gnunet will see when your files show up during their searches. For further details, see the gnunet.org online documentation. The -n option is used to insert a file/directory into the gnunet MySQL/sqlite database, instead of just indexing it.

To unindex a file/directory

gnunet-unindex

Suppose you have forgotten which files you indexed, you can look up the pointers in the directory /var/lib/gnunet/data/shared, where GNUNET_HOME=/var/lib/gnunet (set by gnunet-setup -d).

Warning: Do not edit this directory yourself, use gnunet-insert and gnunet-unindex to make changes. This is because gnunet uses a database to store file information, and deleting (or modifying) the contents of the directory will not remove the entries in the gnunet database.

Modifying and removing indexed files

  • When you modify a file, the URI of the file changes. Therefore, GNUnet considers this to be a completely different file. Therefore, make sure that the original file is unindexed (using the gnunet-unindex command), modify the file, and then index the new file to make it accessible through the network.
  • If you want to move/remove a file from your system, then you should unindex it first.

Killing GNUnet services

See [1][dead link 2016-02-14].