View source for Developers.Gnutella.Notes.Introduction

== Introduction to the Gnutella Network ==
{{box|This document is intended for readers with a fair knowledge of network programming but does not require any previous Gnutella experience}}
Yeay! At last!

[http://www.the-gdf.org/index.php?title=Terminology_and_Network_Management 1.2 Terminology and Network Management]

A Gnutella program running on a computer is called a ''servent'' - and this weird word comes from smashing together ''server'' and ''client''. The computer the program runs on is called a ''peer'', ''node'', or ''host''.

The names Gnutella defines are important, because we can use them to name parts of the Shareaza code. For instance, a remote computer running peer-to-peer software in the Shareaza code is represented with a ''CNeighbours'' object. This could have been named ''CServent'', ''CPeer'', ''CNode'', or ''CHost''. Gnucleus uses node. I'd like to use host to mean an IP address and port number. Servent is too weird. I think ''CPeer'' is the best name.

What Shareaza calls a ''packet'', the document names a ''message''.

[http://www.the-gdf.org/index.php?title=Characteristics 1.3 Characteristics]

{{box|Resources can be anything: mappings to other resources, cryptographic keys, files of any type, meta-information on keyable resources, etc. However, the semantics for locating and handling resources other than plain files are not specified in this document.}}
I'm glad they are going to keep this restricted to file sharing.

{{box|Resource data exchanges between nodes are negotiated using the standard HTTP. The Gnutella network is only used to locate the nodes sharing those resources.}}
This is a fancy way of saying: Gnutella programs with socket connections exchanging packets just talk about more computers they can connect to and what files they have and want. Actual file transfers are done totally outside the Gnutella network, using regular HTTP just like the Web.

[http://www.the-gdf.org/index.php?title=Extending_the_Protocol 1.4 Extending the Protocol]

{{box|Servents MAY extend the protocol or even change parts of it}}
Yes, but I wish they wouldn't. The Gnutella packets appear simple, but then have really, really complicated extensions. If you want to extend the protocol, use a packet scheme that was designed with extension in mind: [[Gnutella2]].

[[Category:External Links]]