https://shareaza.sourceforge.net/w/api.php?action=feedcontributions&feedformat=atom&user=Ale5000 2026-05-02T04:19:36Z User contributions MediaWiki 1.40.1 https://shareaza.sourceforge.net/w/index.php?title=GWC_specs&diff=11518 2016-01-10T04:41:44Z

<p>Ale5000: Added Cachechu last release date</p> <hr /> <div>''For general information on GWCs, have a look at the [[GWC]] Wiki page.''<br /> {{do not translate}}<br /> This page is thought to give an overview over the GWC specifications as they are implemented into Shareaza.<br /> <br /> A GWC is a simple script that can be put on any webserver that supports one of the following scripting languages: <br /> <br /> * '''PHP''' ''(Tip: PHP GWCs are usually the easiest to run and setup on a server.)''<br /> ** [http://code.google.com/p/cachechu/ Cachechu G2WC]<br /> ** [http://sourceforge.net/projects/skulls/ Skulls! Multi-Network WebCache]<br /> ** [http://sourceforge.net/projects/beaconcache/ Beacon Cache]<br /> ** Bazooka G2WC<br /> ** [http://gwcii.sourceforge.net/ PHPGnuCacheII]<br /> ** The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache] ''(PHP version is no longer supported)'' <br /> * C <br /> ** [http://github.com/gtk-gnutella/gwc GhostWhiteCrab] (For dedicated server environments and people who know how to compile C source code!) <br /> * JSP (Java Servlet) <br /> ** [http://www1.mager.org/GWebCache/ Jums Web Cache] (Excellent for heavy loads) <br /> * ASP <br /> ** [http://www.edazzle.net/downloads/gerry.zip Gerry GWC] <br /> ** [https://www.planet-source-code.com/vb/scripts/ShowCode.asp?txtCodeId=7846&amp;lngWId=4 Lynn (v.s. 0.5)] <br /> ** [https://www.planet-source-code.com/vb/scripts/ShowCode.asp?txtCodeId=7731&amp;lngWId=4 Lynn (v.s. 0.4)] <br /> ** [http://www.poundwebhosting.com/cgi-bin/lynnx.asp LynnX] <br /> * Perl <br /> ** [http://www.jonatkins.com/perlgcache/ Jon Atkins' perlgcache] <br /> ** The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache] <br /> <br /> == Breakdown Of The Gnutella Web Caches: == <br /> {{RecoveredPage|I recently put this into a table. The contents need to be verified -- [[User:Cyko 01|Cyko 01]]}}<br /> <br /> {| width= auto; style=&quot;font-size: 85%; text-align: center;text-valign: middle;&quot; class=&quot;wikitable&quot;<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Cache:<br /> ! rowspan=1 |Gnutella:<br /> ! rowspan=1 |Gnutella2:<br /> ! rowspan=1 |Spec 1:<br /> ! rowspan=1 |Spec 2:<br /> ! rowspan=1 |Flat-File:<br /> ! rowspan=1 |SQL:<br /> ! rowspan=1 |Installer:<br /> ! rowspan=1 |Other Networks:<br /> ! rowspan=1 |Different network instances:<br /> ! rowspan=1 |Latest release date:<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Beacon Cache (Core 2)<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> |style=&quot;background: #CCFFCC;&quot;| Yes (As of 0.2.0 Alpha)<br /> | {{yes}}<br /> | {{yes}}<br /> | 2009-09-14<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Beacon Cache (Core 1)<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Skulls<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | 2015-04-10<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|JumsWebCache<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|GnuWebCache (Perl)<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|GnuWebCache (PHP) <br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|GhostWhiteCrab(GWC) <br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> |style=&quot;background: #FFFFCC;&quot;| N/A<br /> |style=&quot;background: #FFFFCC;&quot;| N/A<br /> |style=&quot;background: #FFFFCC;&quot;| N/A<br /> | {{yes}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|PHPGnuCacheII <br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Bazooka <br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Cachechu<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | 2016-01-09<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Perlgcache<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Gerry GWC (v2)<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Gerry GWC (v1)<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Lynn<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|LynnX<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |}<br /> <br /> == Shareaza Specific Details == <br /> <br /> {{RecoveredPage|Warninig: here I have pasted better formatted recovery, but not verified. Row recovery has been mooved below as I don't know if anybody has made any changes in it. If not then row recovery can be deleted. Paste starts from &gt;&gt;Shareaza Specific Details&lt;&lt;, here, and ends at second &gt;&gt;Shareaza Specific Details&lt;&lt; I hope it is visible. --[[User:Ocexyz|Ocexyz]] 23:27, 27 July 2009 (UTC)}}<br /> <br /> '''Get String Breakdown:''' <br /> * Update a leaf <br /> ** &quot;?update=1&amp;ip=(ip):(port)&amp;x_leaves=(leaf count) <br /> * Ping Variable <br /> ** Appends &amp;ping=1 to identify the cache name in debug messages (for gnutella and gnutella2 in 2.4.0.0, but only for gnutella2 now in 2.4.0.X for spec1 cache compatibility). <br /> ** This feature new to Shareaza. <br /> * Network Variable <br /> ** Appends &amp;net=gnutella2 on Gnutella2 queries. <br /> ** Does NOT append a network variable on Gnutella(1) queries. <br /> * Client Name / Version Format (2.4.0.0 and earlier): <br /> ** &amp;client=(Shareaza 4 letter code (RAZA / RAZB) ) <br /> ** &amp;version=(Shareaza's version) <br /> * Client Name / Version Format (2.4.0.X): <br /> ** If Gnutella <br /> *** &amp;client=(Shareaza 4 letter code (RAZA / RAZB) ) <br /> *** &amp;version=(Shareaza's version) <br /> ** If Gnutella2 <br /> *** &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )+(Shareaza's version) <br /> <br /> '''GWC Response Matching:''' <br /> * i| <br /> ** Informational output alone will not be taken as GWC 'success.' <br /> * i|access|period|(time in sec.) <br /> ** Time in seconds before Shareaza is allowed to make a request to the cache. <br /> * i|update|period|(time in sec.) <br /> ** Time in seconds before Shareaza is allowed to update to the cache. <br /> * i|force|remove and i|update|warning|bad url <br /> ** Remove the GWC from the internal list. <br /> * Some Response Matches (added in 2.3.1.X) <br /> ** i|NO-URL-NO-HOSTS <br /> *** Outputs warning of the cache being totally empty to the system log. <br /> ** i|NO-URL <br /> *** Outputs warning of the cache having no alternative URLs to the system log. <br /> ** i|NO-HOSTS <br /> *** Outputs warning of the cache having no hosts to the system log. <br /> ** i|warning| <br /> *** Outputs warning of the cache to the system log. <br /> ** ERROR Something Failed <br /> *** Outputs warning of the cache to the system log(Buggy Bazooka GWCs workaround). <br /> ** i|warning|You came back too early (2.3.1.X) <br /> ** i|warning|client|early (2.3.1.X) <br /> ** WARNING: You came back too early (2.3.1.X) <br /> ** ERROR: Client returned too early (2.3.1.X) <br /> *** Flood detection for the update side. <br /> *** Outputs GWebCache(update) Too many connection attempts to the system log. <br /> ** too early (2.3.1.X) <br /> ** early (2.4.0.X) <br /> *** Flood detection for the request side. <br /> *** Outputs GWebCache URL: Too many connection attempts to the system log. <br /> ** i|update|OK <br /> *** Outputs &quot;GWebCache(v2) Update Passed: &quot; to the system log. <br /> ** OK <br /> *** Outputs &quot;GWebCache(v1) Update Passed: &quot; to the system log. <br /> <br /> == Gnutella Web Cache Specifications ==<br /> ==== Specification 1: ====<br /> * '''Networks Served''' <br /> ** Gnutella <br /> * '''Format''' <br /> ** Update went fine: <br /> *** Ex: OK <br /> ** Update Warning (Small prob., not that bad): <br /> *** Ex: OKWARNING: Error Message <br /> <br /> * Severe Warning (No 'OK' message sent) <br /> ** Ex: WARNING: Error Message<br /> <br /> * URL Output: <br /> ** Ex: [http://somefreakinrandomcache.com/cache/gcache.php http://somefreakinrandomcache.com/cache/gcache.php] <br /> *** OR - WITH A PORT NUMBER (If not 80) <br /> **** Ex: [http://somefreakinrandomcache.com:8080/cache/gcache.php http://somefreakinrandomcache.com:8080/cache/gcache.php] <br /> * Host Output: <br /> ** Ex: 66.132.55.12:6346 <br /> * Pong (ping variable response) - was explained below under the topic: variables. <br /> * '''Example Cache Output (Beacon Cache) For urlfile Command''' <br /> ** Example &quot;urlfile Output&quot; URL: Ex: [http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;urlfile=1 http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;urlfile=1] <br /> *** Example URL Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting urls with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | PONG Beacon Cache 0.1.5D Beta[http://gwc.frodoslair.net/skulls/skulls.php http://gwc.frodoslair.net/skulls/skulls.php][http://bbs.robertwoolley.co.uk/GWebCache/gcache.php http://bbs.robertwoolley.co.uk/GWebCache/gcache.php][http://g2.tjtech.org/g2/ http://g2.tjtech.org/g2/][http://g2.tjtech.org/g2/index.php http://g2.tjtech.org/g2/index.php][http://gwc.monnsta.net/ http://gwc.monnsta.net/][http://holograph.uni.cc/other/skulls.php http://holograph.uni.cc/other/skulls.php][http://gwc.nickstallman.net/ http://gwc.nickstallman.net/][http://gwc.eod.cc/skulls.php http://gwc.eod.cc/skulls.php][http://gwc.frodoslair.net/skulls/skulls http://gwc.frodoslair.net/skulls/skulls][http://gwc.werwin.net/skulls.php http://gwc.werwin.net/skulls.php] <br /> <br /> |}<br /> * '''Example Cache Output (Beacon Cache) For hostfile Command''' <br /> ** Example &quot;hostfile Output&quot; URL: Ex: [http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;hostfile=1 http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;hostfile=1] <br /> *** Example Host Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting the hosts with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | PONG Beacon Cache 0.1.5D Beta71.8.84.153:391599.248.214.157:2752969.60.241.55:16369193.253.239.246:3021868.156.175.121:634871.179.7.241:1834474.196.22.241:634812.210.197.194:10531222.150.143.77:1000058.85.231.135:634624.141.199.164:2020572.175.201.195:634869.81.129.228:488097.81.221.63:1321970.15.130.224:7759216.211.188.106:5190375.167.168.156:4866012.214.14.3:3591676.177.244.106:2418098.165.218.139:3963068.112.182.125:368568.117.204.57:2348265.12.154.25:4076069.180.47.169:571175.138.40.173:2498798.201.19.0:3366270.187.2.144:634868.186.209.107:1442969.159.7.61:634876.208.176.196:48199<br /> <br /> |}<br /> * '''For combining a hostfile and urlfile request:''' <br /> ** Warning: This is non-standard. <br /> ** '''Example Cache Output (Beacon Cache) For bfile Command''' <br /> *** Example &quot;bfile Output&quot; URL: Ex: [http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;bfile=1 http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;bfile=1] <br /> **** Example Host and URL Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting the hosts and urls with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | PONG Beacon Cache 0.1.5D Beta71.8.84.153:391599.248.214.157:2752969.60.241.55:16369193.253.239.246:3021868.156.175.121:634871.179.7.241:1834474.196.22.241:634812.210.197.194:10531222.150.143.77:1000058.85.231.135:634624.141.199.164:2020572.175.201.195:634869.81.129.228:488097.81.221.63:1321970.15.130.224:7759216.211.188.106:5190375.167.168.156:4866012.214.14.3:3591676.177.244.106:2418098.165.218.139:3963068.112.182.125:368568.117.204.57:2348265.12.154.25:4076069.180.47.169:571175.138.40.173:2498798.201.19.0:3366270.187.2.144:634868.186.209.107:1442969.159.7.61:634876.208.176.196:48199[http://gwc.frodoslair.net/skulls/skulls.php http://gwc.frodoslair.net/skulls/skulls.php][http://bbs.robertwoolley.co.uk/GWebCache/gcache.php http://bbs.robertwoolley.co.uk/GWebCache/gcache.php][http://g2.tjtech.org/g2/ http://g2.tjtech.org/g2/][http://g2.tjtech.org/g2/index.php http://g2.tjtech.org/g2/index.php][http://gwc.monnsta.net/ http://gwc.monnsta.net/][http://holograph.uni.cc/other/skulls.php http://holograph.uni.cc/other/skulls.php][http://gwc.nickstallman.net/ http://gwc.nickstallman.net/][http://gwc.eod.cc/skulls.php http://gwc.eod.cc/skulls.php][http://gwc.frodoslair.net/skulls/skulls http://gwc.frodoslair.net/skulls/skulls][http://gwc.werwin.net/skulls.php http://gwc.werwin.net/skulls.php] <br /> <br /> |}<br /> '''Variables''' <br /> * '''Mandatory''' <br /> ** ping: <br /> *** Response should have this always: PONG<br /> *** After, put the cache's name. ex: PONG fakecache 0.01<br /> ** client: <br /> *** Four letter code of the client. ex: RAZA <br /> ** version: <br /> *** Version number of the client. <br /> ** urlfile: <br /> *** Used by the client to request alternate cache urls. <br /> ** hostfile: <br /> *** Used by the client to request IPs with port numbers attached. <br /> ** url: <br /> *** Client update giving an alternate cache URL. <br /> *** Formatted with a http:// prefix to each cache. <br /> ** ip: <br /> *** Client update giving one's IP to submit. <br /> ** url1: <br /> *** OLD OUTDATED Client update giving an alternate cache URL. <br /> *** Formatted with a http:// prefix to each cache. <br /> ** ip1: <br /> *** OLD OUTDATED Client update giving one's IP to submit. <br /> * '''Optional''' <br /> ** bfile: <br /> *** For clients to request both URLs and IPs from the cache at the same time. <br /> ** statfile: <br /> *** Statistics of the cache request: <br /> **** First line: Total requests of the cache number. <br /> **** Second line: Requests of the cache an hour number. <br /> **** Third line: Updates of the cache an hour number.<br /> <br /> ==== Specification 2: ====<br /> '''Networks Served''' <br /> * Gnutella, Gnutella2, etc. <br /> '''Format''' <br /> * '''Information Output''' <br /> ** Starts with: I| <br /> *** '''Categories''' <br /> **** '''Pong''' (ping variable response) - Described below under the topic: variables. <br /> **** '''Update Status Response''' <br /> ***** Format: I|update <br /> ***** '''Responses''' <br /> ****** I|update|OK <br /> ******* - Everything went fine. <br /> ****** I|update|OK|WARNING <br /> ******* Small warning. <br /> ****** I|update|WARNING <br /> ******* Severe warning <br /> **** '''Plain Warnings''' <br /> ***** Format: I|WARNING <br /> ****** Append any warning messages after it - Ex: I|WARNING|You came back too early <br /> **** '''Extra Info''' - Described below under the topic: variables. <br /> * '''Host Output''' <br /> ** Starts with: H| <br /> ** Add the IP with its port: <br /> *** Ex: H|0.0.0.0:6346 <br /> ** Add the time, thereafter, of the host's (In seconds*) time in cache: <br /> *** Ex: H|0.0.0.0:6346|45 <br /> ** If cluster exists with cluster=somerandomwords <br /> *** Add the clustered words after the host's age: <br /> **** Ex: H|0.0.0.0:6346|45|somerandomwords <br /> * '''URL Output''' <br /> ** Starts with: U| <br /> ** Add the URL with http:// before it, plus the port (if it's not 80). <br /> *** Ex: U|[http://somerandomcache.com/ http://somerandomcache.com/] <br /> ** Add the time, thereafter, of the URL's time (In seconds*) in cache: <br /> *** Ex: U|[http://somerandomcache.com/%7C45 http://somerandomcache.com/|45] <br /> * '''Example Cache Output (Beacon Cache) For get Command''' <br /> ** Example URL: [http://grantgalitz.com/Beacon/gwc.php?get=1&amp;client=RAZA&amp;version=2.3.1.3&amp;net=gnutella2&amp;ping=1 http://grantgalitz.com/Beacon/gwc.php?get=1&amp;client=RAZA&amp;version=2.3.1.3&amp;net=gnutella2&amp;ping=1] <br /> *** Example &quot;Get&quot; Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting the hosts and urls with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | I|pong|Beacon Cache 0.1.5D Beta|gnutella-gnutella2H|65.9.200.243:4968|248261H|68.228.129.75:44599|242678H|98.240.196.122:8206|240719H|76.104.12.133:14921|218273H|69.136.1.12:3924|211610H|81.154.208.71:8595|174402H|97.96.105.51:2076|153610H|74.192.153.212:39340|144203H|72.190.106.57:12584|132984H|78.93.71.132:12334|125668H|82.43.248.184:27560|97974H|196.205.224.97:6357|86763H|74.129.219.30:33172|82005H|76.104.12.133:19185|57182H|69.59.83.131:18442|38628U|[http://www.k33bz.com/g2/bazooka.php%7C248639 http://www.k33bz.com/g2/bazooka.php|248639]U|[http://gwebcache.ns1.net/%7C248592 http://gwebcache.ns1.net/|248592]U|[http://gwc2.wodi.org/skulls.php%7C248384 http://gwc2.wodi.org/skulls.php|248384]U|[http://gwc.guufshop.com/skulls/skulls.php%7C248322 http://gwc.guufshop.com/skulls/skulls.php|248322]U|[http://groovy.syxy.com/up/skulls.php%7C248300 http://groovy.syxy.com/up/skulls.php|248300]U|[http://g2.tjtech.org/g2/index.php%7C247770 http://g2.tjtech.org/g2/index.php|247770]U|[http://midian.jayl.de/g2/bazooka.php%7C240719 http://midian.jayl.de/g2/bazooka.php|240719]U|[http://www.dom2porno.info/skulls/skulls.php%7C207473 http://www.dom2porno.info/skulls/skulls.php|207473]U|[http://gwc.frodoslair.net/skulls/skulls%7C125668 http://gwc.frodoslair.net/skulls/skulls|125668]U|[http://holograph.uni.cc/other/skulls.php%7C9642 http://holograph.uni.cc/other/skulls.php|9642] <br /> <br /> |}<br /> '''Variables''' <br /> * '''Mandatory''' <br /> ** ping: <br /> *** Main Part: I|pong| <br /> *** Then add the cache name and version: I|pong|fakecache 0.01 <br /> *** Then lastly add the network support: <br /> **** I|pong|fakecache 0.01|gnutella <br /> ***** - Gnutella only <br /> **** I|pong|fakecache 0.01|gnutella2 <br /> ***** - Gnutella2 only <br /> **** I|pong|fakecache 0.01|gnutella-gnutella2 <br /> ***** - Gnutella and Gnutella2 served <br /> ** get: <br /> *** Used by clients to requests alternate cache URLs along with IPs and their port numbers. <br /> ** update: <br /> *** url: <br /> **** Client update giving an alternate cache URL. <br /> **** Formatted with a http:// prefix to each cache. <br /> *** ip: <br /> **** Client update giving one's IP to submit. <br /> ** net: <br /> *** Which network to serve the client. <br /> **** Gnutella <br /> ***** Ex: net=gnutella <br /> **** Gnutella2 <br /> ***** Ex: net=gnutella2 <br /> **** '''Should always be lowercase''' <br /> ***** GWCs should automatically convert network name given to lowercase to prevent Net ID mismatches <br /> <br /> solely on case alone. <br /> <br /> <br /> * <br /> ** client: <br /> *** Four letter code of the client. ex: RAZA <br /> ** version: <br /> *** Version number of the client. <br /> * '''Optional''' <br /> ** cluster: <br /> *** To add extra info to an IP update. <br /> **** Output by cache: H|0.0.0.0|AGE OF HOST (Seconds)|clustering some bull**** <br /> ** statfile: <br /> *** Exactly like the specification 1 statfile '''(Same routine and output style)'''. <br /> *** Statistics of the cache request: <br /> **** First line: Total requests of the cache number. <br /> **** Second line: Requests of the cache an hour number. <br /> **** Third line: Updates of the cache an hour number. <br /> <br /> ==== Specification 2.1 ====<br /> '''This is an extension of specification 2, not a separate specification!''' <br /> Pong extension <br /> * Append the networks supported joined by a hyphen '-'. <br /> * Used for client-side validation of networks supported and for network support reporting to other web caches. <br /> * Format: <br /> ** I|pong|cache name|network names joined by '-' <br /> ** Format Examples: <br /> *** I|pong|fakecache 0.01|gnutella <br /> **** - Gnutella only <br /> *** I|pong|fakecache 0.01|gnutella2 <br /> **** - Gnutella2 only <br /> *** I|pong|fakecache 0.01|gnutella-gnutella2 <br /> **** - Gnutella and Gnutella2 served <br /> Host Output <br /> * Just like specification 2, but with more fields supported for host output. <br /> ** H|ip:port|age in cache|clustering|leaves|4 letter vendor code|reported uptime of host|max. leaves possible <br /> *** The host, age, and clustering fields are all still the same as in specification 2. <br /> *** The leaf count of the hub reported is in the 5th field. <br /> *** The vendor code with version number is in the 6th field. <br /> Request Control Variables: <br /> * getleaves <br /> ** Used to obtain leaf counts of hubs given <br /> ** 4th field ultilized for current leaf count. <br /> ** 7th field ultilized for maximum leaf slots possible. <br /> ** Use this as 'getleaves=1' or 'getleaves' to enable. <br /> * getclusters <br /> ** Enables/Disables clustering. <br /> ** Use this as 'getclusters=1'. <br /> ** Using 'getclusters' or 'getclusters=0' disables cluster output. <br /> * getvendors <br /> ** Used to obtain the vendor code w/ version number of the hubs given. <br /> ** Found in the 5th field. <br /> ** Use this as 'getvendors=1' or 'getvendors' to enable. <br /> * getuptime <br /> ** Used to obtain the vendor code w/ version number of the hubs given. <br /> ** Value is static, do not change the value given when time passes. <br /> ** Found in the 6th field. <br /> ** Use this as 'getuptime=1' or 'getuptime' to enable. <br /> * spec <br /> ** To force the specification parameter <br /> ** Currently is only supported by Beacon Cache II <br /> * pv <br /> ** Similar to the 'spec' parameter, except that it does not force, instead it simply negotiates the specification. <br /> Special Data Requests <br /> * info <br /> ** Outputs extra details of your cache. <br /> *** Start with the informational response: I| <br /> **** Ex: I|open-source|1 <br /> * support <br /> ** Outputs USEFUL details of your cache. <br /> *** Start with the informational response: I| <br /> **** Ex: I|support|gnutella2 <br /> * getnetworks <br /> ** Outputs the enabled networks in two formats. <br /> *** Start with the informational response: I| <br /> **** For the 'I|nets|' line <br /> ***** The third field contains the supported networks joined by '-'. <br /> **** For the 'I|networks|' line <br /> ***** Interpret the fields from 3 and beyond as individual network names to challenge against. <br /> *** Examples <br /> **** <br /> ***** I|nets|gnutella-gnutella2 <br /> ***** I|networks|gnutella|gnutella2 <br /> Update Extension Variables: <br /> * x_leaves <br /> ** Number of leaves running on a given hub or ultrapeer. <br /> ** '''Value must not be greater than an integer value of 2047.''' <br /> ** '''Note: It is important to know that PHP automaticaly replace dots with underscores, so to keep compatibility with old/new version of clients all caches should support both variants, example: x.leaves x_leaves''' <br /> * x_max <br /> ** Maximum number of leaves possible on a given hub or ultrapeer. <br /> ** '''Value must not be greater than an integer value of 2047.''' <br /> * uptime <br /> ** Value submitted must be an integer value of the number of seconds of uptime. <br /> ** '''Value must not be greater than an integer value of 1 year (31536000) and less than 1 hour (60).''' <br /> <br /> === Pinging Caches With Your Cache ===<br /> '''Please follow this standard:''' <br /> * '''Client: TEST''' <br /> * '''Version: Your Cache's Name''' <br /> ** The old value for &quot;version&quot; was 1 <br /> '''Some variables to attach to the ping (compatibility):''' <br /> * '''multi''' <br /> ** Used by some gwcs in their pings to other gwcs. <br /> ** &lt;nowiki&gt;It tells the pinged cache to ignore the &quot;net&quot; parameter (so it should never say network not supported) and outputting the pong using this format, if possible, &quot;I|pong|[cache name] [cache version]|[supported networks list]&quot; - example: I|pong|Skulls 0.2.9|gnutella-gnutella2 &lt;/nowiki&gt;<br /> ** Used by Skulls GWC only, supported by Skulls and Beacon Cache II. <br /> * '''cache''' <br /> ** This is added to every request made by some gwcs, it is for statistical purposes only. <br /> ** It simply tells the remote cache that the client is a GWC. <br /> '''Help''' <br /> * For PHP <br /> ** Use the fsockopen() function to open a connection to a cache. <br /> *** Make sure you &quot;write&quot; to the fsockopen carry value to open the GWC's target file. <br /> **** [http://us.php.net/manual/en/function.fsockopen.php http://us.php.net/manual/en/function.fsockopen.php] <br /> <br /> === Variable Combination Standards ===<br /> '''Net variable decides specification!''' <br /> * There are many ways to determine spec., but going with net is the safe way. <br /> * Skulls GWC does not use the network parameter to determine specification level. <br /> * Beacon Cache (I and II) uses the network parameter to determine the specification level. <br /> '''Your cache needs to be able to process certain combinations of variables.''' <br /> * Update variable <br /> ** Update should not fail if absent if spec. 2. <br /> *** A Specification 2 parameter. <br /> Spec 1 parameters used in Spec 2: <br /> * Should still accept hostfile and urlfile responses for spec. 2. <br /> ** Beacon Cache (I and II) accepts these parameters on spec 2. <br /> The 'spec' paameter can be used to force a specification: <br /> * Only known to exist in Beacon Cache II, it can force the request to be handled as a specification 1 or 2 request. <br /> * Spec 1 = 'spec=1' <br /> * Spec 2 = 'spec=2' <br /> * If 'spec' is not equal to any current spec, then default to the predetermined spec. <br /> '''Multiple variable requests''' <br /> * If for instance a ping and request exist, you should always handle them properly. <br /> ** Same goes with other combos like an update and ping, statfile + ping and info. <br /> * Handle multiple variables as BEST as possible! <br /> ** Some scanners and GWCs like to fit all their requests into one URL send. <br /> <br /> === Further Information: ===<br /> * [http://www.gnucleus.com/gwebcache/ Original GWC] [http://www.gnucleus.com/gwebcache/ site] <br /> ** [http://gnucleus.sourceforge.net/gwebcache/specs.html GWC Spec. 1] <br /> ** [http://gnucleus.sourceforge.net/gwebcache/newgwc.html GWC Spec. 2] <br /> <br /> === Gnutella Web Cache ===<br /> Gnutella requires Gnutella Web Caches (GWC) to get IPs to establish a connection to the network. These are critical to ensuring the health of the network. If you have a dedicated server and can spare some extra bandwidth then please consider running a GWC. People that don't have a dedicated server or are on normal broadband consumer lines should not run a cache from home.<br /> <br /> A GWC is a simple script that can be put on any webserver that supports one of the following scripting languages:<br /> *JSP (Java Servlet)<br /> **[http://web.archive.org/web/20061108091447/http://www.mager.org/GWebCache/ Java Servlet GWebCache Application (Archive.org)]<br /> *C<br /> **[http://github.com/gtk-gnutella/gwc GhostWhiteCrab]<br /> *Perl <br /> **[http://www.jonatkins.com/perlgcache/ Jon Atkins' perlgcache] <br /> **The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache]<br /> *PHP <br /> **[http://gwcii.sourceforge.net/ PHPGnuCacheII] - MySQL<br /> **[http://www.bazookanetworks.com Bazooka G2WC] (recommended) - flat files<br /> **[http://sourceforge.net/projects/skulls/ Skulls! Multi-Network WebCache] - flat files<br /> ====Further Information:====<br /> *[http://www.gnucleus.com/gwebcache/|Original GWC site]<br /> <br /> <br /> {{RecoveredPage|--&gt;Saved in timestamp 20090421202728Retrieved from &quot;[https://www.pantheraproject.net/wiki/index.php?title=GWC This page was last modified on April 18, 2009, at 23:25. &lt;/center&gt;<br /> <br /> &lt;center&gt;Copyright © 2002-2009 Shareaza Development Team. &lt;/center&gt;&lt;center&gt;[[Image:poweredby_mediawiki_88x31.png]] --[[User:Ocexyz|Ocexyz]] 16:20, 27 July 2009 (UTC)}}<br /> <br /> {{RecoveredPage|Warninig: here ends pasted better formatted recovery. Row recovery has been mooved below as I don't know if anybody has made any changes in it. If not then row recovery can be deleted I suppose. Paste starts from == Shareaza Specific Details == and ends at second == Shareaza Specific Details ==, here. I hope it is visible. --[[User:Ocexyz|Ocexyz]] 16:20, 27 July 2009 (UTC) }}<br /> <br /> ==Shareaza Specific Details==<br /> <br /> {{RecoveredPage|Warninig: here ends pasted better formatted recovery. Row recovery has been mooved below as I don't know if anybody has made any changes in it. If not then row recovery can be deleted I suppose. Paste starts from &gt;&gt;Shareaza Specific Details&lt;&lt; and ends at second &gt;&gt; Shareaza Specific Details&lt;&lt;, here. I hope it is visible. --[[User:Ocexyz|Ocexyz]] 23:27, 27 July 2009 (UTC) }}<br /> <br /> * Get String Breakdown:<br /> o Update a leaf<br /> + &quot;?update=1&amp;ip=(ip):(port)&amp;x_leaves=(leaf count) <br /> o Ping Variable<br /> + Appends &amp;ping=1 to identify the cache name in debug messages (for gnutella and gnutella2 in 2.4.0.0, but only for gnutella2 now in 2.4.0.X for spec1 cache compatibility).<br /> + This feature new to Shareaza. <br /> o Network Variable<br /> + Appends &amp;net=gnutella2 on Gnutella2 queries.<br /> + Does NOT append a network variable on Gnutella(1) queries. <br /> o Client Name / Version Format (2.4.0.0 and earlier):<br /> + &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )<br /> + &amp;version=(Shareaza's version) <br /> o Client Name / Version Format (2.4.0.X):<br /> + If Gnutella<br /> # &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )<br /> # &amp;version=(Shareaza's version) <br /> + If Gnutella2<br /> # &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )+(Shareaza's version) <br /> <br /> <br /> <br /> * GWC Response Matching:<br /> o i|<br /> + Informational output alone will not be taken as GWC 'success.' <br /> o i|access|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to make a request to the cache. <br /> o i|update|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to update to the cache. <br /> o i|force|remove and i|update|warning|bad url<br /> + Remove the GWC from the internal list. <br /> o Some Response Matches (added in 2.3.1.X)<br /> + i|NO-URL-NO-HOSTS<br /> # Outputs warning of the cache being totally empty to the system log. <br /> + i|NO-URL<br /> # Outputs warning of the cache having no alternative URLs to the system log. <br /> + i|NO-HOSTS<br /> # Outputs warning of the cache having no hosts to the system log. <br /> + i|warning|<br /> # Outputs warning of the cache to the system log. <br /> + ERROR Something Failed<br /> # Outputs warning of the cache to the system log(Buggy Bazooka GWCs workaround). <br /> + i|warning|You came back too early (2.3.1.X)<br /> + i|warning|client|early (2.3.1.X)<br /> + WARNING: You came back too early (2.3.1.X)<br /> + ERROR: Client returned too early (2.3.1.X)<br /> # Flood detection for the update side.<br /> # Outputs GWebCache(update) Too many connection attempts to the system log. <br /> + too early (2.3.1.X)<br /> + early (2.4.0.X)<br /> # Flood detection for the request side.<br /> # Outputs GWebCache URL: Too many connection attempts to the system log. <br /> + i|update|OK<br /> # Outputs &quot;GWebCache(v2) Update Passed: &quot; to the system log. <br /> + OK<br /> # Outputs &quot;GWebCache(v1) Update Passed: &quot; to the system log. <br /> <br /> <br /> <br /> * GWC Response Matching:<br /> o i|<br /> + Informational output alone will not be taken as GWC 'success.' <br /> o i|access|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to make a request to the cache. <br /> o i|update|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to update to the cache. <br /> o i|force|remove and i|update|warning|bad url<br /> + Remove the GWC from the internal list. <br /> o Some Response Matches (added in 2.3.1.X)<br /> + i|NO-URL-NO-HOSTS<br /> # Outputs warning of the cache being totally empty to the system log. <br /> + i|NO-URL<br /> # Outputs warning of the cache having no alternative URLs to the system log. <br /> + i|NO-HOSTS<br /> # Outputs warning of the cache having no hosts to the system log. <br /> + i|warning|<br /> # Outputs warning of the cache to the system log. <br /> + ERROR Something Failed<br /> # Outputs warning of the cache to the system log(Buggy Bazooka GWCs workaround). <br /> + i|warning|You came back too early (2.3.1.X)<br /> + i|warning|client|early (2.3.1.X)<br /> + WARNING: You came back too early (2.3.1.X)<br /> + ERROR: Client returned too early (2.3.1.X)<br /> # Flood detection for the update side.<br /> # Outputs GWebCache(update) Too many connection attempts to the system log. <br /> + too early (2.3.1.X)<br /> + early (2.4.0.X)<br /> # Flood detection for the request side.<br /> # Outputs GWebCache URL: Too many connection attempts to the system log. <br /> + i|update|OK<br /> # Outputs &quot;GWebCache(v2) Update Passed: &quot; to the system log. <br /> + OK<br /> # Outputs &quot;GWebCache(v1) Update Passed: &quot; to the system log. <br /> <br /> <br /> <br /> ==Gnutella Web Cache Specifications==<br /> &lt;end of partial recovery by OCE&gt;<br /> <br /> <br /> <br /> <br /> &lt;end of recovered content&gt;<br /> <br /> &lt;row recovery, start&gt; <br /> Specification 1:<br /> <br /> * Networks Served<br /> o Gnutella <br /> * Format<br /> o Update went fine:<br /> + Ex: OK <br /> o Update Warning (Small prob., not that bad):<br /> + Ex: <br /> <br /> OK<br /> WARNING: Error Message<br /> <br /> * Severe Warning (No 'OK' message sent)<br /> o Ex: <br /> <br /> WARNING: Error Message<br /> <br /> * URL Output:<br /> o Ex: http://somefreakinrandomcache.com/cache/gcache.php<br /> + OR - WITH A PORT NUMBER (If not 80)<br /> # Ex: http://somefreakinrandomcache.com:8080/cache/gcache.php <br /> * Host Output:<br /> o Ex: 66.132.55.12:6346 <br /> * Pong (ping variable response) - was explained below under the topic: variables.<br /> * Example Cache Output (Beacon Cache) For urlfile Command<br /> o Example &quot;urlfile Output&quot; URL: Ex: http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;urlfile=1<br /> + Example URL Output: <br /> <br /> <br /> Getting urls with a pong combined<br /> <br /> PONG Beacon Cache 0.1.5D Beta<br /> http://gwc.frodoslair.net/skulls/skulls.php<br /> http://bbs.robertwoolley.co.uk/GWebCache/gcache.php<br /> http://g2.tjtech.org/g2/<br /> http://g2.tjtech.org/g2/index.php<br /> http://gwc.monnsta.net/<br /> http://holograph.uni.cc/other/skulls.php<br /> http://gwc.nickstallman.net/<br /> http://gwc.eod.cc/skulls.php<br /> http://gwc.frodoslair.net/skulls/skulls<br /> http://gwc.werwin.net/skulls.php<br /> <br /> <br /> * Example Cache Output (Beacon Cache) For hostfile Command<br /> o Example &quot;hostfile Output&quot; URL: Ex: http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;hostfile=1<br /> + Example Host Output: <br /> <br /> <br /> Getting the hosts with a pong combined<br /> <br /> PONG Beacon Cache 0.1.5D Beta<br /> 71.8.84.153:3915<br /> 99.248.214.157:27529<br /> 69.60.241.55:16369<br /> 193.253.239.246:30218<br /> 68.156.175.121:6348<br /> 71.179.7.241:18344<br /> 74.196.22.241:6348<br /> 12.210.197.194:10531<br /> 222.150.143.77:10000<br /> 58.85.231.135:6346<br /> 24.141.199.164:20205<br /> 72.175.201.195:6348<br /> 69.81.129.228:4880<br /> 97.81.221.63:13219<br /> 70.15.130.224:7759<br /> 216.211.188.106:51903<br /> 75.167.168.156:48660<br /> 12.214.14.3:35916<br /> 76.177.244.106:24180<br /> 98.165.218.139:39630<br /> 68.112.182.125:3685<br /> 68.117.204.57:23482<br /> 65.12.154.25:40760<br /> 69.180.47.169:5711<br /> 75.138.40.173:24987<br /> 98.201.19.0:33662<br /> 70.187.2.144:6348<br /> 68.186.209.107:14429<br /> 69.159.7.61:6348<br /> 76.208.176.196:48199<br /> <br /> <br /> * For combining a hostfile and urlfile request:<br /> o Warning: This is non-standard.<br /> o Example Cache Output (Beacon Cache) For bfile Command<br /> + Example &quot;bfile Output&quot; URL: Ex: http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;bfile=1<br /> # Example Host and URL Output: <br /> <br /> <br /> Getting the hosts and urls with a pong combined<br /> <br /> PONG Beacon Cache 0.1.5D Beta<br /> 71.8.84.153:3915<br /> 99.248.214.157:27529<br /> 69.60.241.55:16369<br /> 193.253.239.246:30218<br /> 68.156.175.121:6348<br /> 71.179.7.241:18344<br /> 74.196.22.241:6348<br /> 12.210.197.194:10531<br /> 222.150.143.77:10000<br /> 58.85.231.135:6346<br /> 24.141.199.164:20205<br /> 72.175.201.195:6348<br /> 69.81.129.228:4880<br /> 97.81.221.63:13219<br /> 70.15.130.224:7759<br /> 216.211.188.106:51903<br /> 75.167.168.156:48660<br /> 12.214.14.3:35916<br /> 76.177.244.106:24180<br /> 98.165.218.139:39630<br /> 68.112.182.125:3685<br /> 68.117.204.57:23482<br /> 65.12.154.25:40760<br /> 69.180.47.169:5711<br /> 75.138.40.173:24987<br /> 98.201.19.0:33662<br /> 70.187.2.144:6348<br /> 68.186.209.107:14429<br /> 69.159.7.61:6348<br /> 76.208.176.196:48199<br /> http://gwc.frodoslair.net/skulls/skulls.php<br /> http://bbs.robertwoolley.co.uk/GWebCache/gcache.php<br /> http://g2.tjtech.org/g2/<br /> http://g2.tjtech.org/g2/index.php<br /> http://gwc.monnsta.net/<br /> http://holograph.uni.cc/other/skulls.php<br /> http://gwc.nickstallman.net/<br /> http://gwc.eod.cc/skulls.php<br /> http://gwc.frodoslair.net/skulls/skulls<br /> http://gwc.werwin.net/skulls.php<br /> <br /> <br /> * Variables<br /> o Mandatory<br /> + ping:<br /> # Response should have this always: PONG<br /> # After, put the cache's name. ex: PONG fakecache 0.01<br /> + client:<br /> # Four letter code of the client. ex: RAZA <br /> + version:<br /> # Version number of the client. <br /> + urlfile:<br /> # Used by the client to request alternate cache urls. <br /> + hostfile:<br /> # Used by the client to request IPs with port numbers attached. <br /> + url:<br /> # Client update giving an alternate cache URL.<br /> # Formatted with a http:// prefix to each cache. <br /> + ip:<br /> # Client update giving one's IP to submit. <br /> + url1:<br /> # OLD OUTDATED Client update giving an alternate cache URL.<br /> # Formatted with a http:// prefix to each cache. <br /> + ip1:<br /> # OLD OUTDATED Client update giving one's IP to submit. <br /> o Optional<br /> + bfile:<br /> # For clients to request both URLs and IPs from the cache at the same time. <br /> + statfile:<br /> # Statistics of the cache request:<br /> * First line: Total requests of the cache number.<br /> * Second line: Requests of the cache an hour number.<br /> * Third line: Updates of the cache an hour number. <br /> <br /> Specification 2:<br /> <br /> * Networks Served<br /> o Gnutella, Gnutella2, etc. <br /> * Format<br /> o Information Output<br /> + Starts with: I|<br /> # Categories<br /> * Pong (ping variable response) - Described below under the topic: variables.<br /> * Update Status Response<br /> o Format: I|update<br /> o Responses<br /> + I|update|OK<br /> # - Everything went fine. <br /> + I|update|OK|WARNING<br /> # Small warning. <br /> + I|update|WARNING<br /> # Severe warning <br /> * Plain Warnings<br /> o Format: I|WARNING<br /> + Append any warning messages after it - Ex: I|WARNING|You came back too early <br /> * Extra Info - Described below under the topic: variables. <br /> o Host Output<br /> + Starts with: H|<br /> + Add the IP with its port:<br /> # Ex: H|0.0.0.0:6346 <br /> + Add the time, thereafter, of the host's (In seconds*) time in cache:<br /> # Ex: H|0.0.0.0:6346|45 <br /> + If cluster exists with cluster=somerandomwords<br /> # Add the clustered words after the host's age:<br /> * Ex: H|0.0.0.0:6346|45|somerandomwords <br /> o URL Output<br /> + Starts with: U|<br /> + Add the URL with http:// before it, plus the port (if it's not 80).<br /> # Ex: U|http://somerandomcache.com/ <br /> + Add the time, thereafter, of the URL's time (In seconds*) in cache:<br /> # Ex: U|http://somerandomcache.com/|45 <br /> o Example Cache Output (Beacon Cache) For get Command<br /> + Example URL: http://grantgalitz.com/Beacon/gwc.php?get=1&amp;client=RAZA&amp;version=2.3.1.3&amp;net=gnutella2&amp;ping=1<br /> # Example &quot;Get&quot; Output: <br /> <br /> <br /> Getting the hosts and urls with a pong combined<br /> <br /> I|pong|Beacon Cache 0.1.5D Beta|gnutella-gnutella2<br /> H|65.9.200.243:4968|248261<br /> H|68.228.129.75:44599|242678<br /> H|98.240.196.122:8206|240719<br /> H|76.104.12.133:14921|218273<br /> H|69.136.1.12:3924|211610<br /> H|81.154.208.71:8595|174402<br /> H|97.96.105.51:2076|153610<br /> H|74.192.153.212:39340|144203<br /> H|72.190.106.57:12584|132984<br /> H|78.93.71.132:12334|125668<br /> H|82.43.248.184:27560|97974<br /> H|196.205.224.97:6357|86763<br /> H|74.129.219.30:33172|82005<br /> H|76.104.12.133:19185|57182<br /> H|69.59.83.131:18442|38628<br /> U|http://www.k33bz.com/g2/bazooka.php|248639<br /> U|http://gwebcache.ns1.net/|248592<br /> U|http://gwc2.wodi.org/skulls.php|248384<br /> U|http://gwc.guufshop.com/skulls/skulls.php|248322<br /> U|http://groovy.syxy.com/up/skulls.php|248300<br /> U|http://g2.tjtech.org/g2/index.php|247770<br /> U|http://midian.jayl.de/g2/bazooka.php|240719<br /> U|http://www.dom2porno.info/skulls/skulls.php|207473<br /> U|http://gwc.frodoslair.net/skulls/skulls|125668<br /> U|http://holograph.uni.cc/other/skulls.php|9642<br /> <br /> <br /> * Variables<br /> o Mandatory<br /> + ping:<br /> # Main Part: I|pong|<br /> # Then add the cache name and version: I|pong|fakecache 0.01<br /> # Then lastly add the network support:<br /> * I|pong|fakecache 0.01|gnutella<br /> o - Gnutella only <br /> * I|pong|fakecache 0.01|gnutella2<br /> o - Gnutella2 only <br /> * I|pong|fakecache 0.01|gnutella-gnutella2<br /> o - Gnutella and Gnutella2 served <br /> + get:<br /> # Used by clients to requests alternate cache URLs along with IPs and their port numbers. <br /> + update:<br /> # url:<br /> * Client update giving an alternate cache URL.<br /> * Formatted with a http:// prefix to each cache. <br /> # ip:<br /> * Client update giving one's IP to submit. <br /> + net:<br /> # Which network to serve the client.<br /> * Gnutella<br /> o Ex: net=gnutella <br /> * Gnutella2<br /> o Ex: net=gnutella2 <br /> * Should always be lowercase<br /> o GWCs should automatically convert network name given to lowercase to prevent Net ID mismatches <br /> <br /> solely on case alone.<br /> <br /> *<br /> o<br /> + client:<br /> # Four letter code of the client. ex: RAZA <br /> + version:<br /> # Version number of the client. <br /> o Optional<br /> + cluster:<br /> # To add extra info to an IP update.<br /> * Output by cache: H|0.0.0.0|AGE OF HOST (Seconds)|clustering some bull**** <br /> + statfile:<br /> # Exactly like the specification 1 statfile (Same routine and output style).<br /> # Statistics of the cache request:<br /> * First line: Total requests of the cache number.<br /> * Second line: Requests of the cache an hour number.<br /> * Third line: Updates of the cache an hour number. <br /> <br /> Specification 2.1<br /> <br /> * This is an extension of specification 2, not a separate specification!<br /> * Pong extension<br /> o Append the networks supported joined by a hyphen '-'.<br /> o Used for client-side validation of networks supported and for network support reporting to other web caches.<br /> o Format:<br /> + I|pong|cache name|network names joined by '-'<br /> + Format Examples:<br /> # I|pong|fakecache 0.01|gnutella<br /> * - Gnutella only <br /> # I|pong|fakecache 0.01|gnutella2<br /> * - Gnutella2 only <br /> # I|pong|fakecache 0.01|gnutella-gnutella2<br /> * - Gnutella and Gnutella2 served <br /> * Host Output<br /> o Just like specification 2, but with more fields supported for host output.<br /> + H|ip:port|age in cache|clustering|leaves|4 letter vendor code|reported uptime of host|max. leaves possible<br /> # The host, age, and clustering fields are all still the same as in specification 2.<br /> # The leaf count of the hub reported is in the 5th field.<br /> # The vendor code with version number is in the 6th field. <br /> * Request Control Variables:<br /> o getleaves<br /> + Used to obtain leaf counts of hubs given<br /> + 4th field ultilized for current leaf count.<br /> + 7th field ultilized for maximum leaf slots possible.<br /> + Use this as 'getleaves=1' or 'getleaves' to enable. <br /> o getclusters<br /> + Enables/Disables clustering.<br /> + Use this as 'getclusters=1'.<br /> + Using 'getclusters' or 'getclusters=0' disables cluster output. <br /> o getvendors<br /> + Used to obtain the vendor code w/ version number of the hubs given.<br /> + Found in the 5th field.<br /> + Use this as 'getvendors=1' or 'getvendors' to enable. <br /> o getuptime<br /> + Used to obtain the vendor code w/ version number of the hubs given.<br /> + Value is static, do not change the value given when time passes.<br /> + Found in the 6th field.<br /> + Use this as 'getuptime=1' or 'getuptime' to enable. <br /> o spec<br /> + To force the specification parameter<br /> + Currently is only supported by Beacon Cache II <br /> o pv<br /> + Similar to the 'spec' parameter, except that it does not force, instead it simply negotiates the specification. <br /> * Special Data Requests<br /> o info<br /> + Outputs extra details of your cache.<br /> # Start with the informational response: I|<br /> * Ex: I|open-source|1 <br /> o support<br /> + Outputs USEFUL details of your cache.<br /> # Start with the informational response: I|<br /> * Ex: I|support|gnutella2 <br /> o getnetworks<br /> + Outputs the enabled networks in two formats.<br /> # Start with the informational response: I|<br /> * For the 'I|nets|' line<br /> o The third field contains the supported networks joined by '-'. <br /> * For the 'I|networks|' line<br /> o Interpret the fields from 3 and beyond as individual network names to challenge against. <br /> # Examples<br /> *<br /> o I|nets|gnutella-gnutella2<br /> o I|networks|gnutella|gnutella2 <br /> * Update Extension Variables:<br /> o x_leaves<br /> + Number of leaves running on a given hub or ultrapeer.<br /> + Value must not be greater than an integer value of 2047.<br /> + Note: It is important to know that PHP automaticaly replace dots with underscores, so to keep compatibility with old/new version of clients all caches should support both variants, example: x.leaves x_leaves<br /> o x_max<br /> + Maximum number of leaves possible on a given hub or ultrapeer.<br /> + Value must not be greater than an integer value of 2047. <br /> o uptime<br /> + Value submitted must be an integer value of the number of seconds of uptime.<br /> + Value must not be greater than an integer value of 1 year (31536000) and less than 1 hour (60). <br /> <br /> Pinging Caches With Your Cache<br /> <br /> * Please follow this standard:<br /> o Client: TEST<br /> o Version: Your Cache's Name<br /> + The old value for &quot;version&quot; was 1 <br /> * Some variables to attach to the ping (compatibility):<br /> o multi<br /> + Used by some gwcs in their pings to other gwcs.<br /> + It tells the pinged cache to ignore the &quot;net&quot; parameter (so it should never say network not supported) and outputting the pong using this format, if possible, &quot;I|pong|[cache name] [cache version]|[supported networks list]|[url adding is enabled]&quot; - example: I|pong|Skulls 0.2.8a|gnutella-gnutella2|1<br /> + Used by Skulls GWC only, supported by Skulls and Beacon Cache II. <br /> o cache<br /> + This is added to every request made by some gwcs, it is for statistical purposes only.<br /> + It simply tells the remote cache that the client is a GWC. <br /> * Help<br /> o For PHP<br /> + Use the fsockopen() function to open a connection to a cache.<br /> # Make sure you &quot;write&quot; to the fsockopen carry value to open the GWC's target file.<br /> * http://us.php.net/manual/en/function.fsockopen.php <br /> <br /> Variable Combination Standards<br /> <br /> * Net variable decides specification!<br /> o There are many ways to determine spec., but going with net is the safe way.<br /> o Skulls GWC does not use the network parameter to determine specification level.<br /> o Beacon Cache (I and II) uses the network parameter to determine the specification level. <br /> * Your cache needs to be able to process certain combinations of variables.<br /> o Update variable<br /> + Update should not fail if absent if spec. 2.<br /> # A Specification 2 parameter. <br /> * Spec 1 parameters used in Spec 2:<br /> o Should still accept hostfile and urlfile responses for spec. 2.<br /> + Beacon Cache (I and II) accepts these parameters on spec 2. <br /> * The 'spec' paameter can be used to force a specification:<br /> o Only known to exist in Beacon Cache II, it can force the request to be handled as a specification 1 or 2 request.<br /> o Spec 1 = 'spec=1'<br /> o Spec 2 = 'spec=2'<br /> o If 'spec' is not equal to any current spec, then default to the predetermined spec. <br /> * Multiple variable requests<br /> o If for instance a ping and request exist, you should always handle them properly.<br /> + Same goes with other combos like an update and ping, statfile + ping and info. <br /> o Handle multiple variables as BEST as possible!<br /> + Some scanners and GWCs like to fit all their requests into one URL send. <br /> <br /> &lt;row recovery, end&gt; <br /> <br /> Further Information:<br /> <br /> * [http://www.gnucleus.com/gwebcache/ Original GWC site]<br /> ** [http://gnucleus.sourceforge.net/gwebcache/specs.html GWC Spec. 1]<br /> ** [http://gnucleus.sourceforge.net/gwebcache/newgwc.html GWC Spec. 2] <br /> <br /> <br /> <br /> <br /> <br /> &lt;content recovered from last aviable backup&gt; <br /> <br /> ===Gnutella Web Cache===<br /> Gnutella requires Gnutella Web Caches (GWC) to get IPs to establish a connection to the network. These are critical to ensuring the health of the network. If you have a dedicated server and can spare some extra bandwidth then please consider running a GWC. People that don't have a dedicated server or are on normal broadband consumer lines should not run a cache from home.<br /> <br /> A GWC is a simple script that can be put on any webserver that supports one of the following scripting languages:<br /> *JSP (Java Servlet)<br /> **[http://web.archive.org/web/20061108091447/http://www.mager.org/GWebCache/ Java Servlet GWebCache Application (Archive.org)]<br /> *C<br /> **[http://github.com/gtk-gnutella/gwc GhostWhiteCrab]<br /> *Perl <br /> **[http://www.jonatkins.com/perlgcache/ Jon Atkins' perlgcache] <br /> **The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache]<br /> *PHP <br /> **[http://gwcii.sourceforge.net/ PHPGnuCacheII] - MySQL<br /> **[http://www.bazookanetworks.com Bazooka G2WC] (recommended) - flat files<br /> **[http://sourceforge.net/projects/skulls/ Skulls! Multi-Network WebCache] - flat files<br /> === Further Information: ===<br /> * [http://www.gnucleus.com/gwebcache/ Original GWC site]<br /> <br /> [[Category:External Links]]</div>

Ale5000 https://shareaza.sourceforge.net/w/index.php?title=GWC_specs&diff=11517 2016-01-10T04:28:56Z

<p>Ale5000: Reordered GWC links based on activity and outdating</p> <hr /> <div>''For general information on GWCs, have a look at the [[GWC]] Wiki page.''<br /> {{do not translate}}<br /> This page is thought to give an overview over the GWC specifications as they are implemented into Shareaza.<br /> <br /> A GWC is a simple script that can be put on any webserver that supports one of the following scripting languages: <br /> <br /> * '''PHP''' ''(Tip: PHP GWCs are usually the easiest to run and setup on a server.)''<br /> ** [http://code.google.com/p/cachechu/ Cachechu G2WC]<br /> ** [http://sourceforge.net/projects/skulls/ Skulls! Multi-Network WebCache]<br /> ** [http://sourceforge.net/projects/beaconcache/ Beacon Cache]<br /> ** Bazooka G2WC<br /> ** [http://gwcii.sourceforge.net/ PHPGnuCacheII]<br /> ** The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache] ''(PHP version is no longer supported)'' <br /> * C <br /> ** [http://github.com/gtk-gnutella/gwc GhostWhiteCrab] (For dedicated server environments and people who know how to compile C source code!) <br /> * JSP (Java Servlet) <br /> ** [http://www1.mager.org/GWebCache/ Jums Web Cache] (Excellent for heavy loads) <br /> * ASP <br /> ** [http://www.edazzle.net/downloads/gerry.zip Gerry GWC] <br /> ** [https://www.planet-source-code.com/vb/scripts/ShowCode.asp?txtCodeId=7846&amp;lngWId=4 Lynn (v.s. 0.5)] <br /> ** [https://www.planet-source-code.com/vb/scripts/ShowCode.asp?txtCodeId=7731&amp;lngWId=4 Lynn (v.s. 0.4)] <br /> ** [http://www.poundwebhosting.com/cgi-bin/lynnx.asp LynnX] <br /> * Perl <br /> ** [http://www.jonatkins.com/perlgcache/ Jon Atkins' perlgcache] <br /> ** The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache] <br /> <br /> == Breakdown Of The Gnutella Web Caches: == <br /> {{RecoveredPage|I recently put this into a table. The contents need to be verified -- [[User:Cyko 01|Cyko 01]]}}<br /> <br /> {| width= auto; style=&quot;font-size: 85%; text-align: center;text-valign: middle;&quot; class=&quot;wikitable&quot;<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Cache:<br /> ! rowspan=1 |Gnutella:<br /> ! rowspan=1 |Gnutella2:<br /> ! rowspan=1 |Spec 1:<br /> ! rowspan=1 |Spec 2:<br /> ! rowspan=1 |Flat-File:<br /> ! rowspan=1 |SQL:<br /> ! rowspan=1 |Installer:<br /> ! rowspan=1 |Other Networks:<br /> ! rowspan=1 |Different network instances:<br /> ! rowspan=1 |Latest release date:<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Beacon Cache (Core 2)<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> |style=&quot;background: #CCFFCC;&quot;| Yes (As of 0.2.0 Alpha)<br /> | {{yes}}<br /> | {{yes}}<br /> | 2009-09-14<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Beacon Cache (Core 1)<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Skulls<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | 2015-04-10<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|JumsWebCache<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|GnuWebCache (Perl)<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|GnuWebCache (PHP) <br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|GhostWhiteCrab(GWC) <br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> |style=&quot;background: #FFFFCC;&quot;| N/A<br /> |style=&quot;background: #FFFFCC;&quot;| N/A<br /> |style=&quot;background: #FFFFCC;&quot;| N/A<br /> | {{yes}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|PHPGnuCacheII <br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Bazooka <br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Cachechu<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Perlgcache<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Gerry GWC (v2)<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Gerry GWC (v1)<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Lynn<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|LynnX<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |}<br /> <br /> == Shareaza Specific Details == <br /> <br /> {{RecoveredPage|Warninig: here I have pasted better formatted recovery, but not verified. Row recovery has been mooved below as I don't know if anybody has made any changes in it. If not then row recovery can be deleted. Paste starts from &gt;&gt;Shareaza Specific Details&lt;&lt;, here, and ends at second &gt;&gt;Shareaza Specific Details&lt;&lt; I hope it is visible. --[[User:Ocexyz|Ocexyz]] 23:27, 27 July 2009 (UTC)}}<br /> <br /> '''Get String Breakdown:''' <br /> * Update a leaf <br /> ** &quot;?update=1&amp;ip=(ip):(port)&amp;x_leaves=(leaf count) <br /> * Ping Variable <br /> ** Appends &amp;ping=1 to identify the cache name in debug messages (for gnutella and gnutella2 in 2.4.0.0, but only for gnutella2 now in 2.4.0.X for spec1 cache compatibility). <br /> ** This feature new to Shareaza. <br /> * Network Variable <br /> ** Appends &amp;net=gnutella2 on Gnutella2 queries. <br /> ** Does NOT append a network variable on Gnutella(1) queries. <br /> * Client Name / Version Format (2.4.0.0 and earlier): <br /> ** &amp;client=(Shareaza 4 letter code (RAZA / RAZB) ) <br /> ** &amp;version=(Shareaza's version) <br /> * Client Name / Version Format (2.4.0.X): <br /> ** If Gnutella <br /> *** &amp;client=(Shareaza 4 letter code (RAZA / RAZB) ) <br /> *** &amp;version=(Shareaza's version) <br /> ** If Gnutella2 <br /> *** &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )+(Shareaza's version) <br /> <br /> '''GWC Response Matching:''' <br /> * i| <br /> ** Informational output alone will not be taken as GWC 'success.' <br /> * i|access|period|(time in sec.) <br /> ** Time in seconds before Shareaza is allowed to make a request to the cache. <br /> * i|update|period|(time in sec.) <br /> ** Time in seconds before Shareaza is allowed to update to the cache. <br /> * i|force|remove and i|update|warning|bad url <br /> ** Remove the GWC from the internal list. <br /> * Some Response Matches (added in 2.3.1.X) <br /> ** i|NO-URL-NO-HOSTS <br /> *** Outputs warning of the cache being totally empty to the system log. <br /> ** i|NO-URL <br /> *** Outputs warning of the cache having no alternative URLs to the system log. <br /> ** i|NO-HOSTS <br /> *** Outputs warning of the cache having no hosts to the system log. <br /> ** i|warning| <br /> *** Outputs warning of the cache to the system log. <br /> ** ERROR Something Failed <br /> *** Outputs warning of the cache to the system log(Buggy Bazooka GWCs workaround). <br /> ** i|warning|You came back too early (2.3.1.X) <br /> ** i|warning|client|early (2.3.1.X) <br /> ** WARNING: You came back too early (2.3.1.X) <br /> ** ERROR: Client returned too early (2.3.1.X) <br /> *** Flood detection for the update side. <br /> *** Outputs GWebCache(update) Too many connection attempts to the system log. <br /> ** too early (2.3.1.X) <br /> ** early (2.4.0.X) <br /> *** Flood detection for the request side. <br /> *** Outputs GWebCache URL: Too many connection attempts to the system log. <br /> ** i|update|OK <br /> *** Outputs &quot;GWebCache(v2) Update Passed: &quot; to the system log. <br /> ** OK <br /> *** Outputs &quot;GWebCache(v1) Update Passed: &quot; to the system log. <br /> <br /> == Gnutella Web Cache Specifications ==<br /> ==== Specification 1: ====<br /> * '''Networks Served''' <br /> ** Gnutella <br /> * '''Format''' <br /> ** Update went fine: <br /> *** Ex: OK <br /> ** Update Warning (Small prob., not that bad): <br /> *** Ex: OKWARNING: Error Message <br /> <br /> * Severe Warning (No 'OK' message sent) <br /> ** Ex: WARNING: Error Message<br /> <br /> * URL Output: <br /> ** Ex: [http://somefreakinrandomcache.com/cache/gcache.php http://somefreakinrandomcache.com/cache/gcache.php] <br /> *** OR - WITH A PORT NUMBER (If not 80) <br /> **** Ex: [http://somefreakinrandomcache.com:8080/cache/gcache.php http://somefreakinrandomcache.com:8080/cache/gcache.php] <br /> * Host Output: <br /> ** Ex: 66.132.55.12:6346 <br /> * Pong (ping variable response) - was explained below under the topic: variables. <br /> * '''Example Cache Output (Beacon Cache) For urlfile Command''' <br /> ** Example &quot;urlfile Output&quot; URL: Ex: [http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;urlfile=1 http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;urlfile=1] <br /> *** Example URL Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting urls with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | PONG Beacon Cache 0.1.5D Beta[http://gwc.frodoslair.net/skulls/skulls.php http://gwc.frodoslair.net/skulls/skulls.php][http://bbs.robertwoolley.co.uk/GWebCache/gcache.php http://bbs.robertwoolley.co.uk/GWebCache/gcache.php][http://g2.tjtech.org/g2/ http://g2.tjtech.org/g2/][http://g2.tjtech.org/g2/index.php http://g2.tjtech.org/g2/index.php][http://gwc.monnsta.net/ http://gwc.monnsta.net/][http://holograph.uni.cc/other/skulls.php http://holograph.uni.cc/other/skulls.php][http://gwc.nickstallman.net/ http://gwc.nickstallman.net/][http://gwc.eod.cc/skulls.php http://gwc.eod.cc/skulls.php][http://gwc.frodoslair.net/skulls/skulls http://gwc.frodoslair.net/skulls/skulls][http://gwc.werwin.net/skulls.php http://gwc.werwin.net/skulls.php] <br /> <br /> |}<br /> * '''Example Cache Output (Beacon Cache) For hostfile Command''' <br /> ** Example &quot;hostfile Output&quot; URL: Ex: [http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;hostfile=1 http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;hostfile=1] <br /> *** Example Host Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting the hosts with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | PONG Beacon Cache 0.1.5D Beta71.8.84.153:391599.248.214.157:2752969.60.241.55:16369193.253.239.246:3021868.156.175.121:634871.179.7.241:1834474.196.22.241:634812.210.197.194:10531222.150.143.77:1000058.85.231.135:634624.141.199.164:2020572.175.201.195:634869.81.129.228:488097.81.221.63:1321970.15.130.224:7759216.211.188.106:5190375.167.168.156:4866012.214.14.3:3591676.177.244.106:2418098.165.218.139:3963068.112.182.125:368568.117.204.57:2348265.12.154.25:4076069.180.47.169:571175.138.40.173:2498798.201.19.0:3366270.187.2.144:634868.186.209.107:1442969.159.7.61:634876.208.176.196:48199<br /> <br /> |}<br /> * '''For combining a hostfile and urlfile request:''' <br /> ** Warning: This is non-standard. <br /> ** '''Example Cache Output (Beacon Cache) For bfile Command''' <br /> *** Example &quot;bfile Output&quot; URL: Ex: [http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;bfile=1 http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;bfile=1] <br /> **** Example Host and URL Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting the hosts and urls with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | PONG Beacon Cache 0.1.5D Beta71.8.84.153:391599.248.214.157:2752969.60.241.55:16369193.253.239.246:3021868.156.175.121:634871.179.7.241:1834474.196.22.241:634812.210.197.194:10531222.150.143.77:1000058.85.231.135:634624.141.199.164:2020572.175.201.195:634869.81.129.228:488097.81.221.63:1321970.15.130.224:7759216.211.188.106:5190375.167.168.156:4866012.214.14.3:3591676.177.244.106:2418098.165.218.139:3963068.112.182.125:368568.117.204.57:2348265.12.154.25:4076069.180.47.169:571175.138.40.173:2498798.201.19.0:3366270.187.2.144:634868.186.209.107:1442969.159.7.61:634876.208.176.196:48199[http://gwc.frodoslair.net/skulls/skulls.php http://gwc.frodoslair.net/skulls/skulls.php][http://bbs.robertwoolley.co.uk/GWebCache/gcache.php http://bbs.robertwoolley.co.uk/GWebCache/gcache.php][http://g2.tjtech.org/g2/ http://g2.tjtech.org/g2/][http://g2.tjtech.org/g2/index.php http://g2.tjtech.org/g2/index.php][http://gwc.monnsta.net/ http://gwc.monnsta.net/][http://holograph.uni.cc/other/skulls.php http://holograph.uni.cc/other/skulls.php][http://gwc.nickstallman.net/ http://gwc.nickstallman.net/][http://gwc.eod.cc/skulls.php http://gwc.eod.cc/skulls.php][http://gwc.frodoslair.net/skulls/skulls http://gwc.frodoslair.net/skulls/skulls][http://gwc.werwin.net/skulls.php http://gwc.werwin.net/skulls.php] <br /> <br /> |}<br /> '''Variables''' <br /> * '''Mandatory''' <br /> ** ping: <br /> *** Response should have this always: PONG<br /> *** After, put the cache's name. ex: PONG fakecache 0.01<br /> ** client: <br /> *** Four letter code of the client. ex: RAZA <br /> ** version: <br /> *** Version number of the client. <br /> ** urlfile: <br /> *** Used by the client to request alternate cache urls. <br /> ** hostfile: <br /> *** Used by the client to request IPs with port numbers attached. <br /> ** url: <br /> *** Client update giving an alternate cache URL. <br /> *** Formatted with a http:// prefix to each cache. <br /> ** ip: <br /> *** Client update giving one's IP to submit. <br /> ** url1: <br /> *** OLD OUTDATED Client update giving an alternate cache URL. <br /> *** Formatted with a http:// prefix to each cache. <br /> ** ip1: <br /> *** OLD OUTDATED Client update giving one's IP to submit. <br /> * '''Optional''' <br /> ** bfile: <br /> *** For clients to request both URLs and IPs from the cache at the same time. <br /> ** statfile: <br /> *** Statistics of the cache request: <br /> **** First line: Total requests of the cache number. <br /> **** Second line: Requests of the cache an hour number. <br /> **** Third line: Updates of the cache an hour number.<br /> <br /> ==== Specification 2: ====<br /> '''Networks Served''' <br /> * Gnutella, Gnutella2, etc. <br /> '''Format''' <br /> * '''Information Output''' <br /> ** Starts with: I| <br /> *** '''Categories''' <br /> **** '''Pong''' (ping variable response) - Described below under the topic: variables. <br /> **** '''Update Status Response''' <br /> ***** Format: I|update <br /> ***** '''Responses''' <br /> ****** I|update|OK <br /> ******* - Everything went fine. <br /> ****** I|update|OK|WARNING <br /> ******* Small warning. <br /> ****** I|update|WARNING <br /> ******* Severe warning <br /> **** '''Plain Warnings''' <br /> ***** Format: I|WARNING <br /> ****** Append any warning messages after it - Ex: I|WARNING|You came back too early <br /> **** '''Extra Info''' - Described below under the topic: variables. <br /> * '''Host Output''' <br /> ** Starts with: H| <br /> ** Add the IP with its port: <br /> *** Ex: H|0.0.0.0:6346 <br /> ** Add the time, thereafter, of the host's (In seconds*) time in cache: <br /> *** Ex: H|0.0.0.0:6346|45 <br /> ** If cluster exists with cluster=somerandomwords <br /> *** Add the clustered words after the host's age: <br /> **** Ex: H|0.0.0.0:6346|45|somerandomwords <br /> * '''URL Output''' <br /> ** Starts with: U| <br /> ** Add the URL with http:// before it, plus the port (if it's not 80). <br /> *** Ex: U|[http://somerandomcache.com/ http://somerandomcache.com/] <br /> ** Add the time, thereafter, of the URL's time (In seconds*) in cache: <br /> *** Ex: U|[http://somerandomcache.com/%7C45 http://somerandomcache.com/|45] <br /> * '''Example Cache Output (Beacon Cache) For get Command''' <br /> ** Example URL: [http://grantgalitz.com/Beacon/gwc.php?get=1&amp;client=RAZA&amp;version=2.3.1.3&amp;net=gnutella2&amp;ping=1 http://grantgalitz.com/Beacon/gwc.php?get=1&amp;client=RAZA&amp;version=2.3.1.3&amp;net=gnutella2&amp;ping=1] <br /> *** Example &quot;Get&quot; Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting the hosts and urls with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | I|pong|Beacon Cache 0.1.5D Beta|gnutella-gnutella2H|65.9.200.243:4968|248261H|68.228.129.75:44599|242678H|98.240.196.122:8206|240719H|76.104.12.133:14921|218273H|69.136.1.12:3924|211610H|81.154.208.71:8595|174402H|97.96.105.51:2076|153610H|74.192.153.212:39340|144203H|72.190.106.57:12584|132984H|78.93.71.132:12334|125668H|82.43.248.184:27560|97974H|196.205.224.97:6357|86763H|74.129.219.30:33172|82005H|76.104.12.133:19185|57182H|69.59.83.131:18442|38628U|[http://www.k33bz.com/g2/bazooka.php%7C248639 http://www.k33bz.com/g2/bazooka.php|248639]U|[http://gwebcache.ns1.net/%7C248592 http://gwebcache.ns1.net/|248592]U|[http://gwc2.wodi.org/skulls.php%7C248384 http://gwc2.wodi.org/skulls.php|248384]U|[http://gwc.guufshop.com/skulls/skulls.php%7C248322 http://gwc.guufshop.com/skulls/skulls.php|248322]U|[http://groovy.syxy.com/up/skulls.php%7C248300 http://groovy.syxy.com/up/skulls.php|248300]U|[http://g2.tjtech.org/g2/index.php%7C247770 http://g2.tjtech.org/g2/index.php|247770]U|[http://midian.jayl.de/g2/bazooka.php%7C240719 http://midian.jayl.de/g2/bazooka.php|240719]U|[http://www.dom2porno.info/skulls/skulls.php%7C207473 http://www.dom2porno.info/skulls/skulls.php|207473]U|[http://gwc.frodoslair.net/skulls/skulls%7C125668 http://gwc.frodoslair.net/skulls/skulls|125668]U|[http://holograph.uni.cc/other/skulls.php%7C9642 http://holograph.uni.cc/other/skulls.php|9642] <br /> <br /> |}<br /> '''Variables''' <br /> * '''Mandatory''' <br /> ** ping: <br /> *** Main Part: I|pong| <br /> *** Then add the cache name and version: I|pong|fakecache 0.01 <br /> *** Then lastly add the network support: <br /> **** I|pong|fakecache 0.01|gnutella <br /> ***** - Gnutella only <br /> **** I|pong|fakecache 0.01|gnutella2 <br /> ***** - Gnutella2 only <br /> **** I|pong|fakecache 0.01|gnutella-gnutella2 <br /> ***** - Gnutella and Gnutella2 served <br /> ** get: <br /> *** Used by clients to requests alternate cache URLs along with IPs and their port numbers. <br /> ** update: <br /> *** url: <br /> **** Client update giving an alternate cache URL. <br /> **** Formatted with a http:// prefix to each cache. <br /> *** ip: <br /> **** Client update giving one's IP to submit. <br /> ** net: <br /> *** Which network to serve the client. <br /> **** Gnutella <br /> ***** Ex: net=gnutella <br /> **** Gnutella2 <br /> ***** Ex: net=gnutella2 <br /> **** '''Should always be lowercase''' <br /> ***** GWCs should automatically convert network name given to lowercase to prevent Net ID mismatches <br /> <br /> solely on case alone. <br /> <br /> <br /> * <br /> ** client: <br /> *** Four letter code of the client. ex: RAZA <br /> ** version: <br /> *** Version number of the client. <br /> * '''Optional''' <br /> ** cluster: <br /> *** To add extra info to an IP update. <br /> **** Output by cache: H|0.0.0.0|AGE OF HOST (Seconds)|clustering some bull**** <br /> ** statfile: <br /> *** Exactly like the specification 1 statfile '''(Same routine and output style)'''. <br /> *** Statistics of the cache request: <br /> **** First line: Total requests of the cache number. <br /> **** Second line: Requests of the cache an hour number. <br /> **** Third line: Updates of the cache an hour number. <br /> <br /> ==== Specification 2.1 ====<br /> '''This is an extension of specification 2, not a separate specification!''' <br /> Pong extension <br /> * Append the networks supported joined by a hyphen '-'. <br /> * Used for client-side validation of networks supported and for network support reporting to other web caches. <br /> * Format: <br /> ** I|pong|cache name|network names joined by '-' <br /> ** Format Examples: <br /> *** I|pong|fakecache 0.01|gnutella <br /> **** - Gnutella only <br /> *** I|pong|fakecache 0.01|gnutella2 <br /> **** - Gnutella2 only <br /> *** I|pong|fakecache 0.01|gnutella-gnutella2 <br /> **** - Gnutella and Gnutella2 served <br /> Host Output <br /> * Just like specification 2, but with more fields supported for host output. <br /> ** H|ip:port|age in cache|clustering|leaves|4 letter vendor code|reported uptime of host|max. leaves possible <br /> *** The host, age, and clustering fields are all still the same as in specification 2. <br /> *** The leaf count of the hub reported is in the 5th field. <br /> *** The vendor code with version number is in the 6th field. <br /> Request Control Variables: <br /> * getleaves <br /> ** Used to obtain leaf counts of hubs given <br /> ** 4th field ultilized for current leaf count. <br /> ** 7th field ultilized for maximum leaf slots possible. <br /> ** Use this as 'getleaves=1' or 'getleaves' to enable. <br /> * getclusters <br /> ** Enables/Disables clustering. <br /> ** Use this as 'getclusters=1'. <br /> ** Using 'getclusters' or 'getclusters=0' disables cluster output. <br /> * getvendors <br /> ** Used to obtain the vendor code w/ version number of the hubs given. <br /> ** Found in the 5th field. <br /> ** Use this as 'getvendors=1' or 'getvendors' to enable. <br /> * getuptime <br /> ** Used to obtain the vendor code w/ version number of the hubs given. <br /> ** Value is static, do not change the value given when time passes. <br /> ** Found in the 6th field. <br /> ** Use this as 'getuptime=1' or 'getuptime' to enable. <br /> * spec <br /> ** To force the specification parameter <br /> ** Currently is only supported by Beacon Cache II <br /> * pv <br /> ** Similar to the 'spec' parameter, except that it does not force, instead it simply negotiates the specification. <br /> Special Data Requests <br /> * info <br /> ** Outputs extra details of your cache. <br /> *** Start with the informational response: I| <br /> **** Ex: I|open-source|1 <br /> * support <br /> ** Outputs USEFUL details of your cache. <br /> *** Start with the informational response: I| <br /> **** Ex: I|support|gnutella2 <br /> * getnetworks <br /> ** Outputs the enabled networks in two formats. <br /> *** Start with the informational response: I| <br /> **** For the 'I|nets|' line <br /> ***** The third field contains the supported networks joined by '-'. <br /> **** For the 'I|networks|' line <br /> ***** Interpret the fields from 3 and beyond as individual network names to challenge against. <br /> *** Examples <br /> **** <br /> ***** I|nets|gnutella-gnutella2 <br /> ***** I|networks|gnutella|gnutella2 <br /> Update Extension Variables: <br /> * x_leaves <br /> ** Number of leaves running on a given hub or ultrapeer. <br /> ** '''Value must not be greater than an integer value of 2047.''' <br /> ** '''Note: It is important to know that PHP automaticaly replace dots with underscores, so to keep compatibility with old/new version of clients all caches should support both variants, example: x.leaves x_leaves''' <br /> * x_max <br /> ** Maximum number of leaves possible on a given hub or ultrapeer. <br /> ** '''Value must not be greater than an integer value of 2047.''' <br /> * uptime <br /> ** Value submitted must be an integer value of the number of seconds of uptime. <br /> ** '''Value must not be greater than an integer value of 1 year (31536000) and less than 1 hour (60).''' <br /> <br /> === Pinging Caches With Your Cache ===<br /> '''Please follow this standard:''' <br /> * '''Client: TEST''' <br /> * '''Version: Your Cache's Name''' <br /> ** The old value for &quot;version&quot; was 1 <br /> '''Some variables to attach to the ping (compatibility):''' <br /> * '''multi''' <br /> ** Used by some gwcs in their pings to other gwcs. <br /> ** &lt;nowiki&gt;It tells the pinged cache to ignore the &quot;net&quot; parameter (so it should never say network not supported) and outputting the pong using this format, if possible, &quot;I|pong|[cache name] [cache version]|[supported networks list]&quot; - example: I|pong|Skulls 0.2.9|gnutella-gnutella2 &lt;/nowiki&gt;<br /> ** Used by Skulls GWC only, supported by Skulls and Beacon Cache II. <br /> * '''cache''' <br /> ** This is added to every request made by some gwcs, it is for statistical purposes only. <br /> ** It simply tells the remote cache that the client is a GWC. <br /> '''Help''' <br /> * For PHP <br /> ** Use the fsockopen() function to open a connection to a cache. <br /> *** Make sure you &quot;write&quot; to the fsockopen carry value to open the GWC's target file. <br /> **** [http://us.php.net/manual/en/function.fsockopen.php http://us.php.net/manual/en/function.fsockopen.php] <br /> <br /> === Variable Combination Standards ===<br /> '''Net variable decides specification!''' <br /> * There are many ways to determine spec., but going with net is the safe way. <br /> * Skulls GWC does not use the network parameter to determine specification level. <br /> * Beacon Cache (I and II) uses the network parameter to determine the specification level. <br /> '''Your cache needs to be able to process certain combinations of variables.''' <br /> * Update variable <br /> ** Update should not fail if absent if spec. 2. <br /> *** A Specification 2 parameter. <br /> Spec 1 parameters used in Spec 2: <br /> * Should still accept hostfile and urlfile responses for spec. 2. <br /> ** Beacon Cache (I and II) accepts these parameters on spec 2. <br /> The 'spec' paameter can be used to force a specification: <br /> * Only known to exist in Beacon Cache II, it can force the request to be handled as a specification 1 or 2 request. <br /> * Spec 1 = 'spec=1' <br /> * Spec 2 = 'spec=2' <br /> * If 'spec' is not equal to any current spec, then default to the predetermined spec. <br /> '''Multiple variable requests''' <br /> * If for instance a ping and request exist, you should always handle them properly. <br /> ** Same goes with other combos like an update and ping, statfile + ping and info. <br /> * Handle multiple variables as BEST as possible! <br /> ** Some scanners and GWCs like to fit all their requests into one URL send. <br /> <br /> === Further Information: ===<br /> * [http://www.gnucleus.com/gwebcache/ Original GWC] [http://www.gnucleus.com/gwebcache/ site] <br /> ** [http://gnucleus.sourceforge.net/gwebcache/specs.html GWC Spec. 1] <br /> ** [http://gnucleus.sourceforge.net/gwebcache/newgwc.html GWC Spec. 2] <br /> <br /> === Gnutella Web Cache ===<br /> Gnutella requires Gnutella Web Caches (GWC) to get IPs to establish a connection to the network. These are critical to ensuring the health of the network. If you have a dedicated server and can spare some extra bandwidth then please consider running a GWC. People that don't have a dedicated server or are on normal broadband consumer lines should not run a cache from home.<br /> <br /> A GWC is a simple script that can be put on any webserver that supports one of the following scripting languages:<br /> *JSP (Java Servlet)<br /> **[http://web.archive.org/web/20061108091447/http://www.mager.org/GWebCache/ Java Servlet GWebCache Application (Archive.org)]<br /> *C<br /> **[http://github.com/gtk-gnutella/gwc GhostWhiteCrab]<br /> *Perl <br /> **[http://www.jonatkins.com/perlgcache/ Jon Atkins' perlgcache] <br /> **The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache]<br /> *PHP <br /> **[http://gwcii.sourceforge.net/ PHPGnuCacheII] - MySQL<br /> **[http://www.bazookanetworks.com Bazooka G2WC] (recommended) - flat files<br /> **[http://sourceforge.net/projects/skulls/ Skulls! Multi-Network WebCache] - flat files<br /> ====Further Information:====<br /> *[http://www.gnucleus.com/gwebcache/|Original GWC site]<br /> <br /> <br /> {{RecoveredPage|--&gt;Saved in timestamp 20090421202728Retrieved from &quot;[https://www.pantheraproject.net/wiki/index.php?title=GWC This page was last modified on April 18, 2009, at 23:25. &lt;/center&gt;<br /> <br /> &lt;center&gt;Copyright © 2002-2009 Shareaza Development Team. &lt;/center&gt;&lt;center&gt;[[Image:poweredby_mediawiki_88x31.png]] --[[User:Ocexyz|Ocexyz]] 16:20, 27 July 2009 (UTC)}}<br /> <br /> {{RecoveredPage|Warninig: here ends pasted better formatted recovery. Row recovery has been mooved below as I don't know if anybody has made any changes in it. If not then row recovery can be deleted I suppose. Paste starts from == Shareaza Specific Details == and ends at second == Shareaza Specific Details ==, here. I hope it is visible. --[[User:Ocexyz|Ocexyz]] 16:20, 27 July 2009 (UTC) }}<br /> <br /> ==Shareaza Specific Details==<br /> <br /> {{RecoveredPage|Warninig: here ends pasted better formatted recovery. Row recovery has been mooved below as I don't know if anybody has made any changes in it. If not then row recovery can be deleted I suppose. Paste starts from &gt;&gt;Shareaza Specific Details&lt;&lt; and ends at second &gt;&gt; Shareaza Specific Details&lt;&lt;, here. I hope it is visible. --[[User:Ocexyz|Ocexyz]] 23:27, 27 July 2009 (UTC) }}<br /> <br /> * Get String Breakdown:<br /> o Update a leaf<br /> + &quot;?update=1&amp;ip=(ip):(port)&amp;x_leaves=(leaf count) <br /> o Ping Variable<br /> + Appends &amp;ping=1 to identify the cache name in debug messages (for gnutella and gnutella2 in 2.4.0.0, but only for gnutella2 now in 2.4.0.X for spec1 cache compatibility).<br /> + This feature new to Shareaza. <br /> o Network Variable<br /> + Appends &amp;net=gnutella2 on Gnutella2 queries.<br /> + Does NOT append a network variable on Gnutella(1) queries. <br /> o Client Name / Version Format (2.4.0.0 and earlier):<br /> + &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )<br /> + &amp;version=(Shareaza's version) <br /> o Client Name / Version Format (2.4.0.X):<br /> + If Gnutella<br /> # &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )<br /> # &amp;version=(Shareaza's version) <br /> + If Gnutella2<br /> # &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )+(Shareaza's version) <br /> <br /> <br /> <br /> * GWC Response Matching:<br /> o i|<br /> + Informational output alone will not be taken as GWC 'success.' <br /> o i|access|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to make a request to the cache. <br /> o i|update|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to update to the cache. <br /> o i|force|remove and i|update|warning|bad url<br /> + Remove the GWC from the internal list. <br /> o Some Response Matches (added in 2.3.1.X)<br /> + i|NO-URL-NO-HOSTS<br /> # Outputs warning of the cache being totally empty to the system log. <br /> + i|NO-URL<br /> # Outputs warning of the cache having no alternative URLs to the system log. <br /> + i|NO-HOSTS<br /> # Outputs warning of the cache having no hosts to the system log. <br /> + i|warning|<br /> # Outputs warning of the cache to the system log. <br /> + ERROR Something Failed<br /> # Outputs warning of the cache to the system log(Buggy Bazooka GWCs workaround). <br /> + i|warning|You came back too early (2.3.1.X)<br /> + i|warning|client|early (2.3.1.X)<br /> + WARNING: You came back too early (2.3.1.X)<br /> + ERROR: Client returned too early (2.3.1.X)<br /> # Flood detection for the update side.<br /> # Outputs GWebCache(update) Too many connection attempts to the system log. <br /> + too early (2.3.1.X)<br /> + early (2.4.0.X)<br /> # Flood detection for the request side.<br /> # Outputs GWebCache URL: Too many connection attempts to the system log. <br /> + i|update|OK<br /> # Outputs &quot;GWebCache(v2) Update Passed: &quot; to the system log. <br /> + OK<br /> # Outputs &quot;GWebCache(v1) Update Passed: &quot; to the system log. <br /> <br /> <br /> <br /> * GWC Response Matching:<br /> o i|<br /> + Informational output alone will not be taken as GWC 'success.' <br /> o i|access|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to make a request to the cache. <br /> o i|update|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to update to the cache. <br /> o i|force|remove and i|update|warning|bad url<br /> + Remove the GWC from the internal list. <br /> o Some Response Matches (added in 2.3.1.X)<br /> + i|NO-URL-NO-HOSTS<br /> # Outputs warning of the cache being totally empty to the system log. <br /> + i|NO-URL<br /> # Outputs warning of the cache having no alternative URLs to the system log. <br /> + i|NO-HOSTS<br /> # Outputs warning of the cache having no hosts to the system log. <br /> + i|warning|<br /> # Outputs warning of the cache to the system log. <br /> + ERROR Something Failed<br /> # Outputs warning of the cache to the system log(Buggy Bazooka GWCs workaround). <br /> + i|warning|You came back too early (2.3.1.X)<br /> + i|warning|client|early (2.3.1.X)<br /> + WARNING: You came back too early (2.3.1.X)<br /> + ERROR: Client returned too early (2.3.1.X)<br /> # Flood detection for the update side.<br /> # Outputs GWebCache(update) Too many connection attempts to the system log. <br /> + too early (2.3.1.X)<br /> + early (2.4.0.X)<br /> # Flood detection for the request side.<br /> # Outputs GWebCache URL: Too many connection attempts to the system log. <br /> + i|update|OK<br /> # Outputs &quot;GWebCache(v2) Update Passed: &quot; to the system log. <br /> + OK<br /> # Outputs &quot;GWebCache(v1) Update Passed: &quot; to the system log. <br /> <br /> <br /> <br /> ==Gnutella Web Cache Specifications==<br /> &lt;end of partial recovery by OCE&gt;<br /> <br /> <br /> <br /> <br /> &lt;end of recovered content&gt;<br /> <br /> &lt;row recovery, start&gt; <br /> Specification 1:<br /> <br /> * Networks Served<br /> o Gnutella <br /> * Format<br /> o Update went fine:<br /> + Ex: OK <br /> o Update Warning (Small prob., not that bad):<br /> + Ex: <br /> <br /> OK<br /> WARNING: Error Message<br /> <br /> * Severe Warning (No 'OK' message sent)<br /> o Ex: <br /> <br /> WARNING: Error Message<br /> <br /> * URL Output:<br /> o Ex: http://somefreakinrandomcache.com/cache/gcache.php<br /> + OR - WITH A PORT NUMBER (If not 80)<br /> # Ex: http://somefreakinrandomcache.com:8080/cache/gcache.php <br /> * Host Output:<br /> o Ex: 66.132.55.12:6346 <br /> * Pong (ping variable response) - was explained below under the topic: variables.<br /> * Example Cache Output (Beacon Cache) For urlfile Command<br /> o Example &quot;urlfile Output&quot; URL: Ex: http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;urlfile=1<br /> + Example URL Output: <br /> <br /> <br /> Getting urls with a pong combined<br /> <br /> PONG Beacon Cache 0.1.5D Beta<br /> http://gwc.frodoslair.net/skulls/skulls.php<br /> http://bbs.robertwoolley.co.uk/GWebCache/gcache.php<br /> http://g2.tjtech.org/g2/<br /> http://g2.tjtech.org/g2/index.php<br /> http://gwc.monnsta.net/<br /> http://holograph.uni.cc/other/skulls.php<br /> http://gwc.nickstallman.net/<br /> http://gwc.eod.cc/skulls.php<br /> http://gwc.frodoslair.net/skulls/skulls<br /> http://gwc.werwin.net/skulls.php<br /> <br /> <br /> * Example Cache Output (Beacon Cache) For hostfile Command<br /> o Example &quot;hostfile Output&quot; URL: Ex: http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;hostfile=1<br /> + Example Host Output: <br /> <br /> <br /> Getting the hosts with a pong combined<br /> <br /> PONG Beacon Cache 0.1.5D Beta<br /> 71.8.84.153:3915<br /> 99.248.214.157:27529<br /> 69.60.241.55:16369<br /> 193.253.239.246:30218<br /> 68.156.175.121:6348<br /> 71.179.7.241:18344<br /> 74.196.22.241:6348<br /> 12.210.197.194:10531<br /> 222.150.143.77:10000<br /> 58.85.231.135:6346<br /> 24.141.199.164:20205<br /> 72.175.201.195:6348<br /> 69.81.129.228:4880<br /> 97.81.221.63:13219<br /> 70.15.130.224:7759<br /> 216.211.188.106:51903<br /> 75.167.168.156:48660<br /> 12.214.14.3:35916<br /> 76.177.244.106:24180<br /> 98.165.218.139:39630<br /> 68.112.182.125:3685<br /> 68.117.204.57:23482<br /> 65.12.154.25:40760<br /> 69.180.47.169:5711<br /> 75.138.40.173:24987<br /> 98.201.19.0:33662<br /> 70.187.2.144:6348<br /> 68.186.209.107:14429<br /> 69.159.7.61:6348<br /> 76.208.176.196:48199<br /> <br /> <br /> * For combining a hostfile and urlfile request:<br /> o Warning: This is non-standard.<br /> o Example Cache Output (Beacon Cache) For bfile Command<br /> + Example &quot;bfile Output&quot; URL: Ex: http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;bfile=1<br /> # Example Host and URL Output: <br /> <br /> <br /> Getting the hosts and urls with a pong combined<br /> <br /> PONG Beacon Cache 0.1.5D Beta<br /> 71.8.84.153:3915<br /> 99.248.214.157:27529<br /> 69.60.241.55:16369<br /> 193.253.239.246:30218<br /> 68.156.175.121:6348<br /> 71.179.7.241:18344<br /> 74.196.22.241:6348<br /> 12.210.197.194:10531<br /> 222.150.143.77:10000<br /> 58.85.231.135:6346<br /> 24.141.199.164:20205<br /> 72.175.201.195:6348<br /> 69.81.129.228:4880<br /> 97.81.221.63:13219<br /> 70.15.130.224:7759<br /> 216.211.188.106:51903<br /> 75.167.168.156:48660<br /> 12.214.14.3:35916<br /> 76.177.244.106:24180<br /> 98.165.218.139:39630<br /> 68.112.182.125:3685<br /> 68.117.204.57:23482<br /> 65.12.154.25:40760<br /> 69.180.47.169:5711<br /> 75.138.40.173:24987<br /> 98.201.19.0:33662<br /> 70.187.2.144:6348<br /> 68.186.209.107:14429<br /> 69.159.7.61:6348<br /> 76.208.176.196:48199<br /> http://gwc.frodoslair.net/skulls/skulls.php<br /> http://bbs.robertwoolley.co.uk/GWebCache/gcache.php<br /> http://g2.tjtech.org/g2/<br /> http://g2.tjtech.org/g2/index.php<br /> http://gwc.monnsta.net/<br /> http://holograph.uni.cc/other/skulls.php<br /> http://gwc.nickstallman.net/<br /> http://gwc.eod.cc/skulls.php<br /> http://gwc.frodoslair.net/skulls/skulls<br /> http://gwc.werwin.net/skulls.php<br /> <br /> <br /> * Variables<br /> o Mandatory<br /> + ping:<br /> # Response should have this always: PONG<br /> # After, put the cache's name. ex: PONG fakecache 0.01<br /> + client:<br /> # Four letter code of the client. ex: RAZA <br /> + version:<br /> # Version number of the client. <br /> + urlfile:<br /> # Used by the client to request alternate cache urls. <br /> + hostfile:<br /> # Used by the client to request IPs with port numbers attached. <br /> + url:<br /> # Client update giving an alternate cache URL.<br /> # Formatted with a http:// prefix to each cache. <br /> + ip:<br /> # Client update giving one's IP to submit. <br /> + url1:<br /> # OLD OUTDATED Client update giving an alternate cache URL.<br /> # Formatted with a http:// prefix to each cache. <br /> + ip1:<br /> # OLD OUTDATED Client update giving one's IP to submit. <br /> o Optional<br /> + bfile:<br /> # For clients to request both URLs and IPs from the cache at the same time. <br /> + statfile:<br /> # Statistics of the cache request:<br /> * First line: Total requests of the cache number.<br /> * Second line: Requests of the cache an hour number.<br /> * Third line: Updates of the cache an hour number. <br /> <br /> Specification 2:<br /> <br /> * Networks Served<br /> o Gnutella, Gnutella2, etc. <br /> * Format<br /> o Information Output<br /> + Starts with: I|<br /> # Categories<br /> * Pong (ping variable response) - Described below under the topic: variables.<br /> * Update Status Response<br /> o Format: I|update<br /> o Responses<br /> + I|update|OK<br /> # - Everything went fine. <br /> + I|update|OK|WARNING<br /> # Small warning. <br /> + I|update|WARNING<br /> # Severe warning <br /> * Plain Warnings<br /> o Format: I|WARNING<br /> + Append any warning messages after it - Ex: I|WARNING|You came back too early <br /> * Extra Info - Described below under the topic: variables. <br /> o Host Output<br /> + Starts with: H|<br /> + Add the IP with its port:<br /> # Ex: H|0.0.0.0:6346 <br /> + Add the time, thereafter, of the host's (In seconds*) time in cache:<br /> # Ex: H|0.0.0.0:6346|45 <br /> + If cluster exists with cluster=somerandomwords<br /> # Add the clustered words after the host's age:<br /> * Ex: H|0.0.0.0:6346|45|somerandomwords <br /> o URL Output<br /> + Starts with: U|<br /> + Add the URL with http:// before it, plus the port (if it's not 80).<br /> # Ex: U|http://somerandomcache.com/ <br /> + Add the time, thereafter, of the URL's time (In seconds*) in cache:<br /> # Ex: U|http://somerandomcache.com/|45 <br /> o Example Cache Output (Beacon Cache) For get Command<br /> + Example URL: http://grantgalitz.com/Beacon/gwc.php?get=1&amp;client=RAZA&amp;version=2.3.1.3&amp;net=gnutella2&amp;ping=1<br /> # Example &quot;Get&quot; Output: <br /> <br /> <br /> Getting the hosts and urls with a pong combined<br /> <br /> I|pong|Beacon Cache 0.1.5D Beta|gnutella-gnutella2<br /> H|65.9.200.243:4968|248261<br /> H|68.228.129.75:44599|242678<br /> H|98.240.196.122:8206|240719<br /> H|76.104.12.133:14921|218273<br /> H|69.136.1.12:3924|211610<br /> H|81.154.208.71:8595|174402<br /> H|97.96.105.51:2076|153610<br /> H|74.192.153.212:39340|144203<br /> H|72.190.106.57:12584|132984<br /> H|78.93.71.132:12334|125668<br /> H|82.43.248.184:27560|97974<br /> H|196.205.224.97:6357|86763<br /> H|74.129.219.30:33172|82005<br /> H|76.104.12.133:19185|57182<br /> H|69.59.83.131:18442|38628<br /> U|http://www.k33bz.com/g2/bazooka.php|248639<br /> U|http://gwebcache.ns1.net/|248592<br /> U|http://gwc2.wodi.org/skulls.php|248384<br /> U|http://gwc.guufshop.com/skulls/skulls.php|248322<br /> U|http://groovy.syxy.com/up/skulls.php|248300<br /> U|http://g2.tjtech.org/g2/index.php|247770<br /> U|http://midian.jayl.de/g2/bazooka.php|240719<br /> U|http://www.dom2porno.info/skulls/skulls.php|207473<br /> U|http://gwc.frodoslair.net/skulls/skulls|125668<br /> U|http://holograph.uni.cc/other/skulls.php|9642<br /> <br /> <br /> * Variables<br /> o Mandatory<br /> + ping:<br /> # Main Part: I|pong|<br /> # Then add the cache name and version: I|pong|fakecache 0.01<br /> # Then lastly add the network support:<br /> * I|pong|fakecache 0.01|gnutella<br /> o - Gnutella only <br /> * I|pong|fakecache 0.01|gnutella2<br /> o - Gnutella2 only <br /> * I|pong|fakecache 0.01|gnutella-gnutella2<br /> o - Gnutella and Gnutella2 served <br /> + get:<br /> # Used by clients to requests alternate cache URLs along with IPs and their port numbers. <br /> + update:<br /> # url:<br /> * Client update giving an alternate cache URL.<br /> * Formatted with a http:// prefix to each cache. <br /> # ip:<br /> * Client update giving one's IP to submit. <br /> + net:<br /> # Which network to serve the client.<br /> * Gnutella<br /> o Ex: net=gnutella <br /> * Gnutella2<br /> o Ex: net=gnutella2 <br /> * Should always be lowercase<br /> o GWCs should automatically convert network name given to lowercase to prevent Net ID mismatches <br /> <br /> solely on case alone.<br /> <br /> *<br /> o<br /> + client:<br /> # Four letter code of the client. ex: RAZA <br /> + version:<br /> # Version number of the client. <br /> o Optional<br /> + cluster:<br /> # To add extra info to an IP update.<br /> * Output by cache: H|0.0.0.0|AGE OF HOST (Seconds)|clustering some bull**** <br /> + statfile:<br /> # Exactly like the specification 1 statfile (Same routine and output style).<br /> # Statistics of the cache request:<br /> * First line: Total requests of the cache number.<br /> * Second line: Requests of the cache an hour number.<br /> * Third line: Updates of the cache an hour number. <br /> <br /> Specification 2.1<br /> <br /> * This is an extension of specification 2, not a separate specification!<br /> * Pong extension<br /> o Append the networks supported joined by a hyphen '-'.<br /> o Used for client-side validation of networks supported and for network support reporting to other web caches.<br /> o Format:<br /> + I|pong|cache name|network names joined by '-'<br /> + Format Examples:<br /> # I|pong|fakecache 0.01|gnutella<br /> * - Gnutella only <br /> # I|pong|fakecache 0.01|gnutella2<br /> * - Gnutella2 only <br /> # I|pong|fakecache 0.01|gnutella-gnutella2<br /> * - Gnutella and Gnutella2 served <br /> * Host Output<br /> o Just like specification 2, but with more fields supported for host output.<br /> + H|ip:port|age in cache|clustering|leaves|4 letter vendor code|reported uptime of host|max. leaves possible<br /> # The host, age, and clustering fields are all still the same as in specification 2.<br /> # The leaf count of the hub reported is in the 5th field.<br /> # The vendor code with version number is in the 6th field. <br /> * Request Control Variables:<br /> o getleaves<br /> + Used to obtain leaf counts of hubs given<br /> + 4th field ultilized for current leaf count.<br /> + 7th field ultilized for maximum leaf slots possible.<br /> + Use this as 'getleaves=1' or 'getleaves' to enable. <br /> o getclusters<br /> + Enables/Disables clustering.<br /> + Use this as 'getclusters=1'.<br /> + Using 'getclusters' or 'getclusters=0' disables cluster output. <br /> o getvendors<br /> + Used to obtain the vendor code w/ version number of the hubs given.<br /> + Found in the 5th field.<br /> + Use this as 'getvendors=1' or 'getvendors' to enable. <br /> o getuptime<br /> + Used to obtain the vendor code w/ version number of the hubs given.<br /> + Value is static, do not change the value given when time passes.<br /> + Found in the 6th field.<br /> + Use this as 'getuptime=1' or 'getuptime' to enable. <br /> o spec<br /> + To force the specification parameter<br /> + Currently is only supported by Beacon Cache II <br /> o pv<br /> + Similar to the 'spec' parameter, except that it does not force, instead it simply negotiates the specification. <br /> * Special Data Requests<br /> o info<br /> + Outputs extra details of your cache.<br /> # Start with the informational response: I|<br /> * Ex: I|open-source|1 <br /> o support<br /> + Outputs USEFUL details of your cache.<br /> # Start with the informational response: I|<br /> * Ex: I|support|gnutella2 <br /> o getnetworks<br /> + Outputs the enabled networks in two formats.<br /> # Start with the informational response: I|<br /> * For the 'I|nets|' line<br /> o The third field contains the supported networks joined by '-'. <br /> * For the 'I|networks|' line<br /> o Interpret the fields from 3 and beyond as individual network names to challenge against. <br /> # Examples<br /> *<br /> o I|nets|gnutella-gnutella2<br /> o I|networks|gnutella|gnutella2 <br /> * Update Extension Variables:<br /> o x_leaves<br /> + Number of leaves running on a given hub or ultrapeer.<br /> + Value must not be greater than an integer value of 2047.<br /> + Note: It is important to know that PHP automaticaly replace dots with underscores, so to keep compatibility with old/new version of clients all caches should support both variants, example: x.leaves x_leaves<br /> o x_max<br /> + Maximum number of leaves possible on a given hub or ultrapeer.<br /> + Value must not be greater than an integer value of 2047. <br /> o uptime<br /> + Value submitted must be an integer value of the number of seconds of uptime.<br /> + Value must not be greater than an integer value of 1 year (31536000) and less than 1 hour (60). <br /> <br /> Pinging Caches With Your Cache<br /> <br /> * Please follow this standard:<br /> o Client: TEST<br /> o Version: Your Cache's Name<br /> + The old value for &quot;version&quot; was 1 <br /> * Some variables to attach to the ping (compatibility):<br /> o multi<br /> + Used by some gwcs in their pings to other gwcs.<br /> + It tells the pinged cache to ignore the &quot;net&quot; parameter (so it should never say network not supported) and outputting the pong using this format, if possible, &quot;I|pong|[cache name] [cache version]|[supported networks list]|[url adding is enabled]&quot; - example: I|pong|Skulls 0.2.8a|gnutella-gnutella2|1<br /> + Used by Skulls GWC only, supported by Skulls and Beacon Cache II. <br /> o cache<br /> + This is added to every request made by some gwcs, it is for statistical purposes only.<br /> + It simply tells the remote cache that the client is a GWC. <br /> * Help<br /> o For PHP<br /> + Use the fsockopen() function to open a connection to a cache.<br /> # Make sure you &quot;write&quot; to the fsockopen carry value to open the GWC's target file.<br /> * http://us.php.net/manual/en/function.fsockopen.php <br /> <br /> Variable Combination Standards<br /> <br /> * Net variable decides specification!<br /> o There are many ways to determine spec., but going with net is the safe way.<br /> o Skulls GWC does not use the network parameter to determine specification level.<br /> o Beacon Cache (I and II) uses the network parameter to determine the specification level. <br /> * Your cache needs to be able to process certain combinations of variables.<br /> o Update variable<br /> + Update should not fail if absent if spec. 2.<br /> # A Specification 2 parameter. <br /> * Spec 1 parameters used in Spec 2:<br /> o Should still accept hostfile and urlfile responses for spec. 2.<br /> + Beacon Cache (I and II) accepts these parameters on spec 2. <br /> * The 'spec' paameter can be used to force a specification:<br /> o Only known to exist in Beacon Cache II, it can force the request to be handled as a specification 1 or 2 request.<br /> o Spec 1 = 'spec=1'<br /> o Spec 2 = 'spec=2'<br /> o If 'spec' is not equal to any current spec, then default to the predetermined spec. <br /> * Multiple variable requests<br /> o If for instance a ping and request exist, you should always handle them properly.<br /> + Same goes with other combos like an update and ping, statfile + ping and info. <br /> o Handle multiple variables as BEST as possible!<br /> + Some scanners and GWCs like to fit all their requests into one URL send. <br /> <br /> &lt;row recovery, end&gt; <br /> <br /> Further Information:<br /> <br /> * [http://www.gnucleus.com/gwebcache/ Original GWC site]<br /> ** [http://gnucleus.sourceforge.net/gwebcache/specs.html GWC Spec. 1]<br /> ** [http://gnucleus.sourceforge.net/gwebcache/newgwc.html GWC Spec. 2] <br /> <br /> <br /> <br /> <br /> <br /> &lt;content recovered from last aviable backup&gt; <br /> <br /> ===Gnutella Web Cache===<br /> Gnutella requires Gnutella Web Caches (GWC) to get IPs to establish a connection to the network. These are critical to ensuring the health of the network. If you have a dedicated server and can spare some extra bandwidth then please consider running a GWC. People that don't have a dedicated server or are on normal broadband consumer lines should not run a cache from home.<br /> <br /> A GWC is a simple script that can be put on any webserver that supports one of the following scripting languages:<br /> *JSP (Java Servlet)<br /> **[http://web.archive.org/web/20061108091447/http://www.mager.org/GWebCache/ Java Servlet GWebCache Application (Archive.org)]<br /> *C<br /> **[http://github.com/gtk-gnutella/gwc GhostWhiteCrab]<br /> *Perl <br /> **[http://www.jonatkins.com/perlgcache/ Jon Atkins' perlgcache] <br /> **The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache]<br /> *PHP <br /> **[http://gwcii.sourceforge.net/ PHPGnuCacheII] - MySQL<br /> **[http://www.bazookanetworks.com Bazooka G2WC] (recommended) - flat files<br /> **[http://sourceforge.net/projects/skulls/ Skulls! Multi-Network WebCache] - flat files<br /> === Further Information: ===<br /> * [http://www.gnucleus.com/gwebcache/ Original GWC site]<br /> <br /> [[Category:External Links]]</div>

Ale5000 https://shareaza.sourceforge.net/w/index.php?title=Developers.TestingEnvironment.Server.GWC&diff=11516 2015-11-25T13:23:02Z

<p>Ale5000: Remove link to died site / Added link to GWC list</p> <hr /> <div>If you want to run a Gnutella / Gnutella2 GWebCache, you can find a list [[GWC_specs|here]].<br /> <br /> <br /> <br /> You need to modify some settings from config.php file<br /> <br /> ==Bazooka config.php settings (Originally by Atomo64) (It will be modified)==<br /> <br /> <br /> $BAZ_ROOT = &quot;\g2data\&quot;;<br /> <br /> <br /> E: This is the path to the directory where the cache data is going to be stored.<br /> <br /> T: Most of the web servers run over a unix or linux plataform, so the path can be like this: ./data/(note that this is not a full path, so if you change the main script of directory it is not going to work). But over a Windows plataform the path can be like this: data\, note that Windows paths uses a back slash instead of a normal slash, what makes that using &quot;&quot; as a string format the back slash has to be double, but if it is replaced with '', a normal back slash can work.<br /> <br /> <br /> $BAZ_PASS = &quot;&quot;;<br /> <br /> <br /> E: This is not used.<br /> <br /> T: You can remove it if you want, it is not going to affect anything.<br /> <br /> <br /> $BAZ_DISABLED = 0;<br /> <br /> <br /> E: It is going to complitely disable the cache.<br /> <br /> <br /> $BAZ_DEBUG = 0;<br /> <br /> <br /> E: Changes the PHP settings to show all level error messages.<br /> <br /> T: It is used for developers for find bugs<br /> <br /> <br /> $BAZ_LOG = 0;<br /> <br /> <br /> E: It is not used since the stats package was never released.<br /> <br /> T: Keep it because bazooka is going to check if it is set to true or false.<br /> <br /> <br /> $BAZ_KS_ON = 0;<br /> <br /> <br /> E: This feature makes that when a there's a cache submission, the cache url is checked for validation and it connects to it to know if it works or not and if it is a web cache.<br /> <br /> T: This may cause a double check of the URL, so, it is not recommended to enable it.<br /> <br /> <br /> $BAZ_URL_ON = 1;<br /> <br /> <br /> E: When enabled(and PHP allows it), it is going to connect to the cache that is submited to check for validation. When it is disabled, bazooka is going to block any cache submission.<br /> <br /> T: It is very important to enable it, so you can keep a clean cache.<br /> <br /> <br /> $BAZ_LEAF_COUNT = 1;<br /> <br /> <br /> E: When a host is submited, it must have atleast 50 leafs so it is added to the cache.<br /> <br /> T: This doesn't really have functionallity, because if you limit the hosts to have 50 leafs, reduces the chances that a client that is searching a hub to connect to can find a hub where it can get a place.<br /> <br /> <br /> $BAZ_FSOCKTO = 30;<br /> <br /> <br /> E: It is wrongly used in the code, so it doesn't affect the timeout.<br /> <br /> T: You have to keep the var, but any value can be used.<br /> <br /> <br /> $BAZ_LOGROOT = &quot;&quot;;<br /> <br /> <br /> E: Unknown usage.<br /> <br /> T: You have to keep it because it is mentioned by the script.<br /> <br /> <br /> $BAZ_CACHE_RC = 14;<br /> <br /> <br /> E: When a cache is submited and it already exists, if it is older than $BAZ_CACHE_RC days, bazooka is going to validate the cache again, so if it still exists the time is going to be updated, if not, it is going to be removed.<br /> <br /> T: You can keep it with a 14 days value, because less time can make a waste of bandwidth and more time can make the cache data become old.</div>

Ale5000 https://shareaza.sourceforge.net/w/index.php?title=GWC_specs&diff=11515 2015-11-11T11:12:16Z

<p>Ale5000: Fixed GhostWhiteCrab link</p> <hr /> <div>''For general information on GWCs, have a look at the [[GWC]] Wiki page.''<br /> {{do not translate}}<br /> This page is thought to give an overview over the GWC specifications as they are implemented into Shareaza.<br /> <br /> A GWC is a simple script that can be put on any webserver that supports one of the following scripting languages: <br /> <br /> * JSP (Java Servlet) <br /> ** [http://www1.mager.org/GWebCache/ Jums Web Cache] (Excellent for heavy loads) <br /> * C <br /> ** [http://github.com/gtk-gnutella/gwc GhostWhiteCrab] (For dedicated server environments and people who know how to compile C source code!) <br /> * ASP <br /> ** [http://www.edazzle.net/downloads/gerry.zip Gerry GWC] <br /> ** [https://www.planet-source-code.com/vb/scripts/ShowCode.asp?txtCodeId=7846&amp;lngWId=4 Lynn (v.s. 0.5)] <br /> ** [https://www.planet-source-code.com/vb/scripts/ShowCode.asp?txtCodeId=7731&amp;lngWId=4 Lynn (v.s. 0.4)] <br /> ** [http://www.poundwebhosting.com/cgi-bin/lynnx.asp LynnX] <br /> * Perl <br /> ** [http://www.jonatkins.com/perlgcache/ Jon Atkins' perlgcache] <br /> ** The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache] <br /> * '''PHP''' ''(Tip: PHP GWCs are usually the easiest to run and setup on a server.)''<br /> ** [http://gwcii.sourceforge.net/ PHPGnuCacheII] <br /> ** Bazooka G2WC<br /> ** [http://sourceforge.net/projects/skulls/ Skulls! Multi-Network WebCache] <br /> ** [http://sourceforge.net/projects/beaconcache/ Beacon Cache] <br /> ** [http://code.google.com/p/cachechu/ Cachechu G2WC] <br /> ** The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache] ''(PHP version is no longer supported)'' <br /> <br /> == Breakdown Of The Gnutella Web Caches: == <br /> {{RecoveredPage|I recently put this into a table. The contents need to be verified -- [[User:Cyko 01|Cyko 01]]}}<br /> <br /> {| width= auto; style=&quot;font-size: 85%; text-align: center;text-valign: middle;&quot; class=&quot;wikitable&quot;<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Cache:<br /> ! rowspan=1 |Gnutella:<br /> ! rowspan=1 |Gnutella2:<br /> ! rowspan=1 |Spec 1:<br /> ! rowspan=1 |Spec 2:<br /> ! rowspan=1 |Flat-File:<br /> ! rowspan=1 |SQL:<br /> ! rowspan=1 |Installer:<br /> ! rowspan=1 |Other Networks:<br /> ! rowspan=1 |Different network instances:<br /> ! rowspan=1 |Latest release date:<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Beacon Cache (Core 2)<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> |style=&quot;background: #CCFFCC;&quot;| Yes (As of 0.2.0 Alpha)<br /> | {{yes}}<br /> | {{yes}}<br /> | 2009-09-14<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Beacon Cache (Core 1)<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Skulls<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | 2015-04-10<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|JumsWebCache<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|GnuWebCache (Perl)<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|GnuWebCache (PHP) <br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|GhostWhiteCrab(GWC) <br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> |style=&quot;background: #FFFFCC;&quot;| N/A<br /> |style=&quot;background: #FFFFCC;&quot;| N/A<br /> |style=&quot;background: #FFFFCC;&quot;| N/A<br /> | {{yes}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|PHPGnuCacheII <br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Bazooka <br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Cachechu<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Perlgcache<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Gerry GWC (v2)<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Gerry GWC (v1)<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Lynn<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|LynnX<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |}<br /> <br /> == Shareaza Specific Details == <br /> <br /> {{RecoveredPage|Warninig: here I have pasted better formatted recovery, but not verified. Row recovery has been mooved below as I don't know if anybody has made any changes in it. If not then row recovery can be deleted. Paste starts from &gt;&gt;Shareaza Specific Details&lt;&lt;, here, and ends at second &gt;&gt;Shareaza Specific Details&lt;&lt; I hope it is visible. --[[User:Ocexyz|Ocexyz]] 23:27, 27 July 2009 (UTC)}}<br /> <br /> '''Get String Breakdown:''' <br /> * Update a leaf <br /> ** &quot;?update=1&amp;ip=(ip):(port)&amp;x_leaves=(leaf count) <br /> * Ping Variable <br /> ** Appends &amp;ping=1 to identify the cache name in debug messages (for gnutella and gnutella2 in 2.4.0.0, but only for gnutella2 now in 2.4.0.X for spec1 cache compatibility). <br /> ** This feature new to Shareaza. <br /> * Network Variable <br /> ** Appends &amp;net=gnutella2 on Gnutella2 queries. <br /> ** Does NOT append a network variable on Gnutella(1) queries. <br /> * Client Name / Version Format (2.4.0.0 and earlier): <br /> ** &amp;client=(Shareaza 4 letter code (RAZA / RAZB) ) <br /> ** &amp;version=(Shareaza's version) <br /> * Client Name / Version Format (2.4.0.X): <br /> ** If Gnutella <br /> *** &amp;client=(Shareaza 4 letter code (RAZA / RAZB) ) <br /> *** &amp;version=(Shareaza's version) <br /> ** If Gnutella2 <br /> *** &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )+(Shareaza's version) <br /> <br /> '''GWC Response Matching:''' <br /> * i| <br /> ** Informational output alone will not be taken as GWC 'success.' <br /> * i|access|period|(time in sec.) <br /> ** Time in seconds before Shareaza is allowed to make a request to the cache. <br /> * i|update|period|(time in sec.) <br /> ** Time in seconds before Shareaza is allowed to update to the cache. <br /> * i|force|remove and i|update|warning|bad url <br /> ** Remove the GWC from the internal list. <br /> * Some Response Matches (added in 2.3.1.X) <br /> ** i|NO-URL-NO-HOSTS <br /> *** Outputs warning of the cache being totally empty to the system log. <br /> ** i|NO-URL <br /> *** Outputs warning of the cache having no alternative URLs to the system log. <br /> ** i|NO-HOSTS <br /> *** Outputs warning of the cache having no hosts to the system log. <br /> ** i|warning| <br /> *** Outputs warning of the cache to the system log. <br /> ** ERROR Something Failed <br /> *** Outputs warning of the cache to the system log(Buggy Bazooka GWCs workaround). <br /> ** i|warning|You came back too early (2.3.1.X) <br /> ** i|warning|client|early (2.3.1.X) <br /> ** WARNING: You came back too early (2.3.1.X) <br /> ** ERROR: Client returned too early (2.3.1.X) <br /> *** Flood detection for the update side. <br /> *** Outputs GWebCache(update) Too many connection attempts to the system log. <br /> ** too early (2.3.1.X) <br /> ** early (2.4.0.X) <br /> *** Flood detection for the request side. <br /> *** Outputs GWebCache URL: Too many connection attempts to the system log. <br /> ** i|update|OK <br /> *** Outputs &quot;GWebCache(v2) Update Passed: &quot; to the system log. <br /> ** OK <br /> *** Outputs &quot;GWebCache(v1) Update Passed: &quot; to the system log. <br /> <br /> == Gnutella Web Cache Specifications ==<br /> ==== Specification 1: ====<br /> * '''Networks Served''' <br /> ** Gnutella <br /> * '''Format''' <br /> ** Update went fine: <br /> *** Ex: OK <br /> ** Update Warning (Small prob., not that bad): <br /> *** Ex: OKWARNING: Error Message <br /> <br /> * Severe Warning (No 'OK' message sent) <br /> ** Ex: WARNING: Error Message<br /> <br /> * URL Output: <br /> ** Ex: [http://somefreakinrandomcache.com/cache/gcache.php http://somefreakinrandomcache.com/cache/gcache.php] <br /> *** OR - WITH A PORT NUMBER (If not 80) <br /> **** Ex: [http://somefreakinrandomcache.com:8080/cache/gcache.php http://somefreakinrandomcache.com:8080/cache/gcache.php] <br /> * Host Output: <br /> ** Ex: 66.132.55.12:6346 <br /> * Pong (ping variable response) - was explained below under the topic: variables. <br /> * '''Example Cache Output (Beacon Cache) For urlfile Command''' <br /> ** Example &quot;urlfile Output&quot; URL: Ex: [http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;urlfile=1 http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;urlfile=1] <br /> *** Example URL Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting urls with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | PONG Beacon Cache 0.1.5D Beta[http://gwc.frodoslair.net/skulls/skulls.php http://gwc.frodoslair.net/skulls/skulls.php][http://bbs.robertwoolley.co.uk/GWebCache/gcache.php http://bbs.robertwoolley.co.uk/GWebCache/gcache.php][http://g2.tjtech.org/g2/ http://g2.tjtech.org/g2/][http://g2.tjtech.org/g2/index.php http://g2.tjtech.org/g2/index.php][http://gwc.monnsta.net/ http://gwc.monnsta.net/][http://holograph.uni.cc/other/skulls.php http://holograph.uni.cc/other/skulls.php][http://gwc.nickstallman.net/ http://gwc.nickstallman.net/][http://gwc.eod.cc/skulls.php http://gwc.eod.cc/skulls.php][http://gwc.frodoslair.net/skulls/skulls http://gwc.frodoslair.net/skulls/skulls][http://gwc.werwin.net/skulls.php http://gwc.werwin.net/skulls.php] <br /> <br /> |}<br /> * '''Example Cache Output (Beacon Cache) For hostfile Command''' <br /> ** Example &quot;hostfile Output&quot; URL: Ex: [http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;hostfile=1 http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;hostfile=1] <br /> *** Example Host Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting the hosts with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | PONG Beacon Cache 0.1.5D Beta71.8.84.153:391599.248.214.157:2752969.60.241.55:16369193.253.239.246:3021868.156.175.121:634871.179.7.241:1834474.196.22.241:634812.210.197.194:10531222.150.143.77:1000058.85.231.135:634624.141.199.164:2020572.175.201.195:634869.81.129.228:488097.81.221.63:1321970.15.130.224:7759216.211.188.106:5190375.167.168.156:4866012.214.14.3:3591676.177.244.106:2418098.165.218.139:3963068.112.182.125:368568.117.204.57:2348265.12.154.25:4076069.180.47.169:571175.138.40.173:2498798.201.19.0:3366270.187.2.144:634868.186.209.107:1442969.159.7.61:634876.208.176.196:48199<br /> <br /> |}<br /> * '''For combining a hostfile and urlfile request:''' <br /> ** Warning: This is non-standard. <br /> ** '''Example Cache Output (Beacon Cache) For bfile Command''' <br /> *** Example &quot;bfile Output&quot; URL: Ex: [http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;bfile=1 http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;bfile=1] <br /> **** Example Host and URL Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting the hosts and urls with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | PONG Beacon Cache 0.1.5D Beta71.8.84.153:391599.248.214.157:2752969.60.241.55:16369193.253.239.246:3021868.156.175.121:634871.179.7.241:1834474.196.22.241:634812.210.197.194:10531222.150.143.77:1000058.85.231.135:634624.141.199.164:2020572.175.201.195:634869.81.129.228:488097.81.221.63:1321970.15.130.224:7759216.211.188.106:5190375.167.168.156:4866012.214.14.3:3591676.177.244.106:2418098.165.218.139:3963068.112.182.125:368568.117.204.57:2348265.12.154.25:4076069.180.47.169:571175.138.40.173:2498798.201.19.0:3366270.187.2.144:634868.186.209.107:1442969.159.7.61:634876.208.176.196:48199[http://gwc.frodoslair.net/skulls/skulls.php http://gwc.frodoslair.net/skulls/skulls.php][http://bbs.robertwoolley.co.uk/GWebCache/gcache.php http://bbs.robertwoolley.co.uk/GWebCache/gcache.php][http://g2.tjtech.org/g2/ http://g2.tjtech.org/g2/][http://g2.tjtech.org/g2/index.php http://g2.tjtech.org/g2/index.php][http://gwc.monnsta.net/ http://gwc.monnsta.net/][http://holograph.uni.cc/other/skulls.php http://holograph.uni.cc/other/skulls.php][http://gwc.nickstallman.net/ http://gwc.nickstallman.net/][http://gwc.eod.cc/skulls.php http://gwc.eod.cc/skulls.php][http://gwc.frodoslair.net/skulls/skulls http://gwc.frodoslair.net/skulls/skulls][http://gwc.werwin.net/skulls.php http://gwc.werwin.net/skulls.php] <br /> <br /> |}<br /> '''Variables''' <br /> * '''Mandatory''' <br /> ** ping: <br /> *** Response should have this always: PONG<br /> *** After, put the cache's name. ex: PONG fakecache 0.01<br /> ** client: <br /> *** Four letter code of the client. ex: RAZA <br /> ** version: <br /> *** Version number of the client. <br /> ** urlfile: <br /> *** Used by the client to request alternate cache urls. <br /> ** hostfile: <br /> *** Used by the client to request IPs with port numbers attached. <br /> ** url: <br /> *** Client update giving an alternate cache URL. <br /> *** Formatted with a http:// prefix to each cache. <br /> ** ip: <br /> *** Client update giving one's IP to submit. <br /> ** url1: <br /> *** OLD OUTDATED Client update giving an alternate cache URL. <br /> *** Formatted with a http:// prefix to each cache. <br /> ** ip1: <br /> *** OLD OUTDATED Client update giving one's IP to submit. <br /> * '''Optional''' <br /> ** bfile: <br /> *** For clients to request both URLs and IPs from the cache at the same time. <br /> ** statfile: <br /> *** Statistics of the cache request: <br /> **** First line: Total requests of the cache number. <br /> **** Second line: Requests of the cache an hour number. <br /> **** Third line: Updates of the cache an hour number.<br /> <br /> ==== Specification 2: ====<br /> '''Networks Served''' <br /> * Gnutella, Gnutella2, etc. <br /> '''Format''' <br /> * '''Information Output''' <br /> ** Starts with: I| <br /> *** '''Categories''' <br /> **** '''Pong''' (ping variable response) - Described below under the topic: variables. <br /> **** '''Update Status Response''' <br /> ***** Format: I|update <br /> ***** '''Responses''' <br /> ****** I|update|OK <br /> ******* - Everything went fine. <br /> ****** I|update|OK|WARNING <br /> ******* Small warning. <br /> ****** I|update|WARNING <br /> ******* Severe warning <br /> **** '''Plain Warnings''' <br /> ***** Format: I|WARNING <br /> ****** Append any warning messages after it - Ex: I|WARNING|You came back too early <br /> **** '''Extra Info''' - Described below under the topic: variables. <br /> * '''Host Output''' <br /> ** Starts with: H| <br /> ** Add the IP with its port: <br /> *** Ex: H|0.0.0.0:6346 <br /> ** Add the time, thereafter, of the host's (In seconds*) time in cache: <br /> *** Ex: H|0.0.0.0:6346|45 <br /> ** If cluster exists with cluster=somerandomwords <br /> *** Add the clustered words after the host's age: <br /> **** Ex: H|0.0.0.0:6346|45|somerandomwords <br /> * '''URL Output''' <br /> ** Starts with: U| <br /> ** Add the URL with http:// before it, plus the port (if it's not 80). <br /> *** Ex: U|[http://somerandomcache.com/ http://somerandomcache.com/] <br /> ** Add the time, thereafter, of the URL's time (In seconds*) in cache: <br /> *** Ex: U|[http://somerandomcache.com/%7C45 http://somerandomcache.com/|45] <br /> * '''Example Cache Output (Beacon Cache) For get Command''' <br /> ** Example URL: [http://grantgalitz.com/Beacon/gwc.php?get=1&amp;client=RAZA&amp;version=2.3.1.3&amp;net=gnutella2&amp;ping=1 http://grantgalitz.com/Beacon/gwc.php?get=1&amp;client=RAZA&amp;version=2.3.1.3&amp;net=gnutella2&amp;ping=1] <br /> *** Example &quot;Get&quot; Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting the hosts and urls with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | I|pong|Beacon Cache 0.1.5D Beta|gnutella-gnutella2H|65.9.200.243:4968|248261H|68.228.129.75:44599|242678H|98.240.196.122:8206|240719H|76.104.12.133:14921|218273H|69.136.1.12:3924|211610H|81.154.208.71:8595|174402H|97.96.105.51:2076|153610H|74.192.153.212:39340|144203H|72.190.106.57:12584|132984H|78.93.71.132:12334|125668H|82.43.248.184:27560|97974H|196.205.224.97:6357|86763H|74.129.219.30:33172|82005H|76.104.12.133:19185|57182H|69.59.83.131:18442|38628U|[http://www.k33bz.com/g2/bazooka.php%7C248639 http://www.k33bz.com/g2/bazooka.php|248639]U|[http://gwebcache.ns1.net/%7C248592 http://gwebcache.ns1.net/|248592]U|[http://gwc2.wodi.org/skulls.php%7C248384 http://gwc2.wodi.org/skulls.php|248384]U|[http://gwc.guufshop.com/skulls/skulls.php%7C248322 http://gwc.guufshop.com/skulls/skulls.php|248322]U|[http://groovy.syxy.com/up/skulls.php%7C248300 http://groovy.syxy.com/up/skulls.php|248300]U|[http://g2.tjtech.org/g2/index.php%7C247770 http://g2.tjtech.org/g2/index.php|247770]U|[http://midian.jayl.de/g2/bazooka.php%7C240719 http://midian.jayl.de/g2/bazooka.php|240719]U|[http://www.dom2porno.info/skulls/skulls.php%7C207473 http://www.dom2porno.info/skulls/skulls.php|207473]U|[http://gwc.frodoslair.net/skulls/skulls%7C125668 http://gwc.frodoslair.net/skulls/skulls|125668]U|[http://holograph.uni.cc/other/skulls.php%7C9642 http://holograph.uni.cc/other/skulls.php|9642] <br /> <br /> |}<br /> '''Variables''' <br /> * '''Mandatory''' <br /> ** ping: <br /> *** Main Part: I|pong| <br /> *** Then add the cache name and version: I|pong|fakecache 0.01 <br /> *** Then lastly add the network support: <br /> **** I|pong|fakecache 0.01|gnutella <br /> ***** - Gnutella only <br /> **** I|pong|fakecache 0.01|gnutella2 <br /> ***** - Gnutella2 only <br /> **** I|pong|fakecache 0.01|gnutella-gnutella2 <br /> ***** - Gnutella and Gnutella2 served <br /> ** get: <br /> *** Used by clients to requests alternate cache URLs along with IPs and their port numbers. <br /> ** update: <br /> *** url: <br /> **** Client update giving an alternate cache URL. <br /> **** Formatted with a http:// prefix to each cache. <br /> *** ip: <br /> **** Client update giving one's IP to submit. <br /> ** net: <br /> *** Which network to serve the client. <br /> **** Gnutella <br /> ***** Ex: net=gnutella <br /> **** Gnutella2 <br /> ***** Ex: net=gnutella2 <br /> **** '''Should always be lowercase''' <br /> ***** GWCs should automatically convert network name given to lowercase to prevent Net ID mismatches <br /> <br /> solely on case alone. <br /> <br /> <br /> * <br /> ** client: <br /> *** Four letter code of the client. ex: RAZA <br /> ** version: <br /> *** Version number of the client. <br /> * '''Optional''' <br /> ** cluster: <br /> *** To add extra info to an IP update. <br /> **** Output by cache: H|0.0.0.0|AGE OF HOST (Seconds)|clustering some bull**** <br /> ** statfile: <br /> *** Exactly like the specification 1 statfile '''(Same routine and output style)'''. <br /> *** Statistics of the cache request: <br /> **** First line: Total requests of the cache number. <br /> **** Second line: Requests of the cache an hour number. <br /> **** Third line: Updates of the cache an hour number. <br /> <br /> ==== Specification 2.1 ====<br /> '''This is an extension of specification 2, not a separate specification!''' <br /> Pong extension <br /> * Append the networks supported joined by a hyphen '-'. <br /> * Used for client-side validation of networks supported and for network support reporting to other web caches. <br /> * Format: <br /> ** I|pong|cache name|network names joined by '-' <br /> ** Format Examples: <br /> *** I|pong|fakecache 0.01|gnutella <br /> **** - Gnutella only <br /> *** I|pong|fakecache 0.01|gnutella2 <br /> **** - Gnutella2 only <br /> *** I|pong|fakecache 0.01|gnutella-gnutella2 <br /> **** - Gnutella and Gnutella2 served <br /> Host Output <br /> * Just like specification 2, but with more fields supported for host output. <br /> ** H|ip:port|age in cache|clustering|leaves|4 letter vendor code|reported uptime of host|max. leaves possible <br /> *** The host, age, and clustering fields are all still the same as in specification 2. <br /> *** The leaf count of the hub reported is in the 5th field. <br /> *** The vendor code with version number is in the 6th field. <br /> Request Control Variables: <br /> * getleaves <br /> ** Used to obtain leaf counts of hubs given <br /> ** 4th field ultilized for current leaf count. <br /> ** 7th field ultilized for maximum leaf slots possible. <br /> ** Use this as 'getleaves=1' or 'getleaves' to enable. <br /> * getclusters <br /> ** Enables/Disables clustering. <br /> ** Use this as 'getclusters=1'. <br /> ** Using 'getclusters' or 'getclusters=0' disables cluster output. <br /> * getvendors <br /> ** Used to obtain the vendor code w/ version number of the hubs given. <br /> ** Found in the 5th field. <br /> ** Use this as 'getvendors=1' or 'getvendors' to enable. <br /> * getuptime <br /> ** Used to obtain the vendor code w/ version number of the hubs given. <br /> ** Value is static, do not change the value given when time passes. <br /> ** Found in the 6th field. <br /> ** Use this as 'getuptime=1' or 'getuptime' to enable. <br /> * spec <br /> ** To force the specification parameter <br /> ** Currently is only supported by Beacon Cache II <br /> * pv <br /> ** Similar to the 'spec' parameter, except that it does not force, instead it simply negotiates the specification. <br /> Special Data Requests <br /> * info <br /> ** Outputs extra details of your cache. <br /> *** Start with the informational response: I| <br /> **** Ex: I|open-source|1 <br /> * support <br /> ** Outputs USEFUL details of your cache. <br /> *** Start with the informational response: I| <br /> **** Ex: I|support|gnutella2 <br /> * getnetworks <br /> ** Outputs the enabled networks in two formats. <br /> *** Start with the informational response: I| <br /> **** For the 'I|nets|' line <br /> ***** The third field contains the supported networks joined by '-'. <br /> **** For the 'I|networks|' line <br /> ***** Interpret the fields from 3 and beyond as individual network names to challenge against. <br /> *** Examples <br /> **** <br /> ***** I|nets|gnutella-gnutella2 <br /> ***** I|networks|gnutella|gnutella2 <br /> Update Extension Variables: <br /> * x_leaves <br /> ** Number of leaves running on a given hub or ultrapeer. <br /> ** '''Value must not be greater than an integer value of 2047.''' <br /> ** '''Note: It is important to know that PHP automaticaly replace dots with underscores, so to keep compatibility with old/new version of clients all caches should support both variants, example: x.leaves x_leaves''' <br /> * x_max <br /> ** Maximum number of leaves possible on a given hub or ultrapeer. <br /> ** '''Value must not be greater than an integer value of 2047.''' <br /> * uptime <br /> ** Value submitted must be an integer value of the number of seconds of uptime. <br /> ** '''Value must not be greater than an integer value of 1 year (31536000) and less than 1 hour (60).''' <br /> <br /> === Pinging Caches With Your Cache ===<br /> '''Please follow this standard:''' <br /> * '''Client: TEST''' <br /> * '''Version: Your Cache's Name''' <br /> ** The old value for &quot;version&quot; was 1 <br /> '''Some variables to attach to the ping (compatibility):''' <br /> * '''multi''' <br /> ** Used by some gwcs in their pings to other gwcs. <br /> ** &lt;nowiki&gt;It tells the pinged cache to ignore the &quot;net&quot; parameter (so it should never say network not supported) and outputting the pong using this format, if possible, &quot;I|pong|[cache name] [cache version]|[supported networks list]&quot; - example: I|pong|Skulls 0.2.9|gnutella-gnutella2 &lt;/nowiki&gt;<br /> ** Used by Skulls GWC only, supported by Skulls and Beacon Cache II. <br /> * '''cache''' <br /> ** This is added to every request made by some gwcs, it is for statistical purposes only. <br /> ** It simply tells the remote cache that the client is a GWC. <br /> '''Help''' <br /> * For PHP <br /> ** Use the fsockopen() function to open a connection to a cache. <br /> *** Make sure you &quot;write&quot; to the fsockopen carry value to open the GWC's target file. <br /> **** [http://us.php.net/manual/en/function.fsockopen.php http://us.php.net/manual/en/function.fsockopen.php] <br /> <br /> === Variable Combination Standards ===<br /> '''Net variable decides specification!''' <br /> * There are many ways to determine spec., but going with net is the safe way. <br /> * Skulls GWC does not use the network parameter to determine specification level. <br /> * Beacon Cache (I and II) uses the network parameter to determine the specification level. <br /> '''Your cache needs to be able to process certain combinations of variables.''' <br /> * Update variable <br /> ** Update should not fail if absent if spec. 2. <br /> *** A Specification 2 parameter. <br /> Spec 1 parameters used in Spec 2: <br /> * Should still accept hostfile and urlfile responses for spec. 2. <br /> ** Beacon Cache (I and II) accepts these parameters on spec 2. <br /> The 'spec' paameter can be used to force a specification: <br /> * Only known to exist in Beacon Cache II, it can force the request to be handled as a specification 1 or 2 request. <br /> * Spec 1 = 'spec=1' <br /> * Spec 2 = 'spec=2' <br /> * If 'spec' is not equal to any current spec, then default to the predetermined spec. <br /> '''Multiple variable requests''' <br /> * If for instance a ping and request exist, you should always handle them properly. <br /> ** Same goes with other combos like an update and ping, statfile + ping and info. <br /> * Handle multiple variables as BEST as possible! <br /> ** Some scanners and GWCs like to fit all their requests into one URL send. <br /> <br /> === Further Information: ===<br /> * [http://www.gnucleus.com/gwebcache/ Original GWC] [http://www.gnucleus.com/gwebcache/ site] <br /> ** [http://gnucleus.sourceforge.net/gwebcache/specs.html GWC Spec. 1] <br /> ** [http://gnucleus.sourceforge.net/gwebcache/newgwc.html GWC Spec. 2] <br /> <br /> === Gnutella Web Cache ===<br /> Gnutella requires Gnutella Web Caches (GWC) to get IPs to establish a connection to the network. These are critical to ensuring the health of the network. If you have a dedicated server and can spare some extra bandwidth then please consider running a GWC. People that don't have a dedicated server or are on normal broadband consumer lines should not run a cache from home.<br /> <br /> A GWC is a simple script that can be put on any webserver that supports one of the following scripting languages:<br /> *JSP (Java Servlet)<br /> **[http://web.archive.org/web/20061108091447/http://www.mager.org/GWebCache/ Java Servlet GWebCache Application (Archive.org)]<br /> *C<br /> **[http://github.com/gtk-gnutella/gwc GhostWhiteCrab]<br /> *Perl <br /> **[http://www.jonatkins.com/perlgcache/ Jon Atkins' perlgcache] <br /> **The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache]<br /> *PHP <br /> **[http://gwcii.sourceforge.net/ PHPGnuCacheII] - MySQL<br /> **[http://www.bazookanetworks.com Bazooka G2WC] (recommended) - flat files<br /> **[http://sourceforge.net/projects/skulls/ Skulls! Multi-Network WebCache] - flat files<br /> ====Further Information:====<br /> *[http://www.gnucleus.com/gwebcache/|Original GWC site]<br /> <br /> <br /> {{RecoveredPage|--&gt;Saved in timestamp 20090421202728Retrieved from &quot;[https://www.pantheraproject.net/wiki/index.php?title=GWC This page was last modified on April 18, 2009, at 23:25. &lt;/center&gt;<br /> <br /> &lt;center&gt;Copyright © 2002-2009 Shareaza Development Team. &lt;/center&gt;&lt;center&gt;[[Image:poweredby_mediawiki_88x31.png]] --[[User:Ocexyz|Ocexyz]] 16:20, 27 July 2009 (UTC)}}<br /> <br /> {{RecoveredPage|Warninig: here ends pasted better formatted recovery. Row recovery has been mooved below as I don't know if anybody has made any changes in it. If not then row recovery can be deleted I suppose. Paste starts from == Shareaza Specific Details == and ends at second == Shareaza Specific Details ==, here. I hope it is visible. --[[User:Ocexyz|Ocexyz]] 16:20, 27 July 2009 (UTC) }}<br /> <br /> ==Shareaza Specific Details==<br /> <br /> {{RecoveredPage|Warninig: here ends pasted better formatted recovery. Row recovery has been mooved below as I don't know if anybody has made any changes in it. If not then row recovery can be deleted I suppose. Paste starts from &gt;&gt;Shareaza Specific Details&lt;&lt; and ends at second &gt;&gt; Shareaza Specific Details&lt;&lt;, here. I hope it is visible. --[[User:Ocexyz|Ocexyz]] 23:27, 27 July 2009 (UTC) }}<br /> <br /> * Get String Breakdown:<br /> o Update a leaf<br /> + &quot;?update=1&amp;ip=(ip):(port)&amp;x_leaves=(leaf count) <br /> o Ping Variable<br /> + Appends &amp;ping=1 to identify the cache name in debug messages (for gnutella and gnutella2 in 2.4.0.0, but only for gnutella2 now in 2.4.0.X for spec1 cache compatibility).<br /> + This feature new to Shareaza. <br /> o Network Variable<br /> + Appends &amp;net=gnutella2 on Gnutella2 queries.<br /> + Does NOT append a network variable on Gnutella(1) queries. <br /> o Client Name / Version Format (2.4.0.0 and earlier):<br /> + &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )<br /> + &amp;version=(Shareaza's version) <br /> o Client Name / Version Format (2.4.0.X):<br /> + If Gnutella<br /> # &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )<br /> # &amp;version=(Shareaza's version) <br /> + If Gnutella2<br /> # &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )+(Shareaza's version) <br /> <br /> <br /> <br /> * GWC Response Matching:<br /> o i|<br /> + Informational output alone will not be taken as GWC 'success.' <br /> o i|access|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to make a request to the cache. <br /> o i|update|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to update to the cache. <br /> o i|force|remove and i|update|warning|bad url<br /> + Remove the GWC from the internal list. <br /> o Some Response Matches (added in 2.3.1.X)<br /> + i|NO-URL-NO-HOSTS<br /> # Outputs warning of the cache being totally empty to the system log. <br /> + i|NO-URL<br /> # Outputs warning of the cache having no alternative URLs to the system log. <br /> + i|NO-HOSTS<br /> # Outputs warning of the cache having no hosts to the system log. <br /> + i|warning|<br /> # Outputs warning of the cache to the system log. <br /> + ERROR Something Failed<br /> # Outputs warning of the cache to the system log(Buggy Bazooka GWCs workaround). <br /> + i|warning|You came back too early (2.3.1.X)<br /> + i|warning|client|early (2.3.1.X)<br /> + WARNING: You came back too early (2.3.1.X)<br /> + ERROR: Client returned too early (2.3.1.X)<br /> # Flood detection for the update side.<br /> # Outputs GWebCache(update) Too many connection attempts to the system log. <br /> + too early (2.3.1.X)<br /> + early (2.4.0.X)<br /> # Flood detection for the request side.<br /> # Outputs GWebCache URL: Too many connection attempts to the system log. <br /> + i|update|OK<br /> # Outputs &quot;GWebCache(v2) Update Passed: &quot; to the system log. <br /> + OK<br /> # Outputs &quot;GWebCache(v1) Update Passed: &quot; to the system log. <br /> <br /> <br /> <br /> * GWC Response Matching:<br /> o i|<br /> + Informational output alone will not be taken as GWC 'success.' <br /> o i|access|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to make a request to the cache. <br /> o i|update|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to update to the cache. <br /> o i|force|remove and i|update|warning|bad url<br /> + Remove the GWC from the internal list. <br /> o Some Response Matches (added in 2.3.1.X)<br /> + i|NO-URL-NO-HOSTS<br /> # Outputs warning of the cache being totally empty to the system log. <br /> + i|NO-URL<br /> # Outputs warning of the cache having no alternative URLs to the system log. <br /> + i|NO-HOSTS<br /> # Outputs warning of the cache having no hosts to the system log. <br /> + i|warning|<br /> # Outputs warning of the cache to the system log. <br /> + ERROR Something Failed<br /> # Outputs warning of the cache to the system log(Buggy Bazooka GWCs workaround). <br /> + i|warning|You came back too early (2.3.1.X)<br /> + i|warning|client|early (2.3.1.X)<br /> + WARNING: You came back too early (2.3.1.X)<br /> + ERROR: Client returned too early (2.3.1.X)<br /> # Flood detection for the update side.<br /> # Outputs GWebCache(update) Too many connection attempts to the system log. <br /> + too early (2.3.1.X)<br /> + early (2.4.0.X)<br /> # Flood detection for the request side.<br /> # Outputs GWebCache URL: Too many connection attempts to the system log. <br /> + i|update|OK<br /> # Outputs &quot;GWebCache(v2) Update Passed: &quot; to the system log. <br /> + OK<br /> # Outputs &quot;GWebCache(v1) Update Passed: &quot; to the system log. <br /> <br /> <br /> <br /> ==Gnutella Web Cache Specifications==<br /> &lt;end of partial recovery by OCE&gt;<br /> <br /> <br /> <br /> <br /> &lt;end of recovered content&gt;<br /> <br /> &lt;row recovery, start&gt; <br /> Specification 1:<br /> <br /> * Networks Served<br /> o Gnutella <br /> * Format<br /> o Update went fine:<br /> + Ex: OK <br /> o Update Warning (Small prob., not that bad):<br /> + Ex: <br /> <br /> OK<br /> WARNING: Error Message<br /> <br /> * Severe Warning (No 'OK' message sent)<br /> o Ex: <br /> <br /> WARNING: Error Message<br /> <br /> * URL Output:<br /> o Ex: http://somefreakinrandomcache.com/cache/gcache.php<br /> + OR - WITH A PORT NUMBER (If not 80)<br /> # Ex: http://somefreakinrandomcache.com:8080/cache/gcache.php <br /> * Host Output:<br /> o Ex: 66.132.55.12:6346 <br /> * Pong (ping variable response) - was explained below under the topic: variables.<br /> * Example Cache Output (Beacon Cache) For urlfile Command<br /> o Example &quot;urlfile Output&quot; URL: Ex: http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;urlfile=1<br /> + Example URL Output: <br /> <br /> <br /> Getting urls with a pong combined<br /> <br /> PONG Beacon Cache 0.1.5D Beta<br /> http://gwc.frodoslair.net/skulls/skulls.php<br /> http://bbs.robertwoolley.co.uk/GWebCache/gcache.php<br /> http://g2.tjtech.org/g2/<br /> http://g2.tjtech.org/g2/index.php<br /> http://gwc.monnsta.net/<br /> http://holograph.uni.cc/other/skulls.php<br /> http://gwc.nickstallman.net/<br /> http://gwc.eod.cc/skulls.php<br /> http://gwc.frodoslair.net/skulls/skulls<br /> http://gwc.werwin.net/skulls.php<br /> <br /> <br /> * Example Cache Output (Beacon Cache) For hostfile Command<br /> o Example &quot;hostfile Output&quot; URL: Ex: http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;hostfile=1<br /> + Example Host Output: <br /> <br /> <br /> Getting the hosts with a pong combined<br /> <br /> PONG Beacon Cache 0.1.5D Beta<br /> 71.8.84.153:3915<br /> 99.248.214.157:27529<br /> 69.60.241.55:16369<br /> 193.253.239.246:30218<br /> 68.156.175.121:6348<br /> 71.179.7.241:18344<br /> 74.196.22.241:6348<br /> 12.210.197.194:10531<br /> 222.150.143.77:10000<br /> 58.85.231.135:6346<br /> 24.141.199.164:20205<br /> 72.175.201.195:6348<br /> 69.81.129.228:4880<br /> 97.81.221.63:13219<br /> 70.15.130.224:7759<br /> 216.211.188.106:51903<br /> 75.167.168.156:48660<br /> 12.214.14.3:35916<br /> 76.177.244.106:24180<br /> 98.165.218.139:39630<br /> 68.112.182.125:3685<br /> 68.117.204.57:23482<br /> 65.12.154.25:40760<br /> 69.180.47.169:5711<br /> 75.138.40.173:24987<br /> 98.201.19.0:33662<br /> 70.187.2.144:6348<br /> 68.186.209.107:14429<br /> 69.159.7.61:6348<br /> 76.208.176.196:48199<br /> <br /> <br /> * For combining a hostfile and urlfile request:<br /> o Warning: This is non-standard.<br /> o Example Cache Output (Beacon Cache) For bfile Command<br /> + Example &quot;bfile Output&quot; URL: Ex: http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;bfile=1<br /> # Example Host and URL Output: <br /> <br /> <br /> Getting the hosts and urls with a pong combined<br /> <br /> PONG Beacon Cache 0.1.5D Beta<br /> 71.8.84.153:3915<br /> 99.248.214.157:27529<br /> 69.60.241.55:16369<br /> 193.253.239.246:30218<br /> 68.156.175.121:6348<br /> 71.179.7.241:18344<br /> 74.196.22.241:6348<br /> 12.210.197.194:10531<br /> 222.150.143.77:10000<br /> 58.85.231.135:6346<br /> 24.141.199.164:20205<br /> 72.175.201.195:6348<br /> 69.81.129.228:4880<br /> 97.81.221.63:13219<br /> 70.15.130.224:7759<br /> 216.211.188.106:51903<br /> 75.167.168.156:48660<br /> 12.214.14.3:35916<br /> 76.177.244.106:24180<br /> 98.165.218.139:39630<br /> 68.112.182.125:3685<br /> 68.117.204.57:23482<br /> 65.12.154.25:40760<br /> 69.180.47.169:5711<br /> 75.138.40.173:24987<br /> 98.201.19.0:33662<br /> 70.187.2.144:6348<br /> 68.186.209.107:14429<br /> 69.159.7.61:6348<br /> 76.208.176.196:48199<br /> http://gwc.frodoslair.net/skulls/skulls.php<br /> http://bbs.robertwoolley.co.uk/GWebCache/gcache.php<br /> http://g2.tjtech.org/g2/<br /> http://g2.tjtech.org/g2/index.php<br /> http://gwc.monnsta.net/<br /> http://holograph.uni.cc/other/skulls.php<br /> http://gwc.nickstallman.net/<br /> http://gwc.eod.cc/skulls.php<br /> http://gwc.frodoslair.net/skulls/skulls<br /> http://gwc.werwin.net/skulls.php<br /> <br /> <br /> * Variables<br /> o Mandatory<br /> + ping:<br /> # Response should have this always: PONG<br /> # After, put the cache's name. ex: PONG fakecache 0.01<br /> + client:<br /> # Four letter code of the client. ex: RAZA <br /> + version:<br /> # Version number of the client. <br /> + urlfile:<br /> # Used by the client to request alternate cache urls. <br /> + hostfile:<br /> # Used by the client to request IPs with port numbers attached. <br /> + url:<br /> # Client update giving an alternate cache URL.<br /> # Formatted with a http:// prefix to each cache. <br /> + ip:<br /> # Client update giving one's IP to submit. <br /> + url1:<br /> # OLD OUTDATED Client update giving an alternate cache URL.<br /> # Formatted with a http:// prefix to each cache. <br /> + ip1:<br /> # OLD OUTDATED Client update giving one's IP to submit. <br /> o Optional<br /> + bfile:<br /> # For clients to request both URLs and IPs from the cache at the same time. <br /> + statfile:<br /> # Statistics of the cache request:<br /> * First line: Total requests of the cache number.<br /> * Second line: Requests of the cache an hour number.<br /> * Third line: Updates of the cache an hour number. <br /> <br /> Specification 2:<br /> <br /> * Networks Served<br /> o Gnutella, Gnutella2, etc. <br /> * Format<br /> o Information Output<br /> + Starts with: I|<br /> # Categories<br /> * Pong (ping variable response) - Described below under the topic: variables.<br /> * Update Status Response<br /> o Format: I|update<br /> o Responses<br /> + I|update|OK<br /> # - Everything went fine. <br /> + I|update|OK|WARNING<br /> # Small warning. <br /> + I|update|WARNING<br /> # Severe warning <br /> * Plain Warnings<br /> o Format: I|WARNING<br /> + Append any warning messages after it - Ex: I|WARNING|You came back too early <br /> * Extra Info - Described below under the topic: variables. <br /> o Host Output<br /> + Starts with: H|<br /> + Add the IP with its port:<br /> # Ex: H|0.0.0.0:6346 <br /> + Add the time, thereafter, of the host's (In seconds*) time in cache:<br /> # Ex: H|0.0.0.0:6346|45 <br /> + If cluster exists with cluster=somerandomwords<br /> # Add the clustered words after the host's age:<br /> * Ex: H|0.0.0.0:6346|45|somerandomwords <br /> o URL Output<br /> + Starts with: U|<br /> + Add the URL with http:// before it, plus the port (if it's not 80).<br /> # Ex: U|http://somerandomcache.com/ <br /> + Add the time, thereafter, of the URL's time (In seconds*) in cache:<br /> # Ex: U|http://somerandomcache.com/|45 <br /> o Example Cache Output (Beacon Cache) For get Command<br /> + Example URL: http://grantgalitz.com/Beacon/gwc.php?get=1&amp;client=RAZA&amp;version=2.3.1.3&amp;net=gnutella2&amp;ping=1<br /> # Example &quot;Get&quot; Output: <br /> <br /> <br /> Getting the hosts and urls with a pong combined<br /> <br /> I|pong|Beacon Cache 0.1.5D Beta|gnutella-gnutella2<br /> H|65.9.200.243:4968|248261<br /> H|68.228.129.75:44599|242678<br /> H|98.240.196.122:8206|240719<br /> H|76.104.12.133:14921|218273<br /> H|69.136.1.12:3924|211610<br /> H|81.154.208.71:8595|174402<br /> H|97.96.105.51:2076|153610<br /> H|74.192.153.212:39340|144203<br /> H|72.190.106.57:12584|132984<br /> H|78.93.71.132:12334|125668<br /> H|82.43.248.184:27560|97974<br /> H|196.205.224.97:6357|86763<br /> H|74.129.219.30:33172|82005<br /> H|76.104.12.133:19185|57182<br /> H|69.59.83.131:18442|38628<br /> U|http://www.k33bz.com/g2/bazooka.php|248639<br /> U|http://gwebcache.ns1.net/|248592<br /> U|http://gwc2.wodi.org/skulls.php|248384<br /> U|http://gwc.guufshop.com/skulls/skulls.php|248322<br /> U|http://groovy.syxy.com/up/skulls.php|248300<br /> U|http://g2.tjtech.org/g2/index.php|247770<br /> U|http://midian.jayl.de/g2/bazooka.php|240719<br /> U|http://www.dom2porno.info/skulls/skulls.php|207473<br /> U|http://gwc.frodoslair.net/skulls/skulls|125668<br /> U|http://holograph.uni.cc/other/skulls.php|9642<br /> <br /> <br /> * Variables<br /> o Mandatory<br /> + ping:<br /> # Main Part: I|pong|<br /> # Then add the cache name and version: I|pong|fakecache 0.01<br /> # Then lastly add the network support:<br /> * I|pong|fakecache 0.01|gnutella<br /> o - Gnutella only <br /> * I|pong|fakecache 0.01|gnutella2<br /> o - Gnutella2 only <br /> * I|pong|fakecache 0.01|gnutella-gnutella2<br /> o - Gnutella and Gnutella2 served <br /> + get:<br /> # Used by clients to requests alternate cache URLs along with IPs and their port numbers. <br /> + update:<br /> # url:<br /> * Client update giving an alternate cache URL.<br /> * Formatted with a http:// prefix to each cache. <br /> # ip:<br /> * Client update giving one's IP to submit. <br /> + net:<br /> # Which network to serve the client.<br /> * Gnutella<br /> o Ex: net=gnutella <br /> * Gnutella2<br /> o Ex: net=gnutella2 <br /> * Should always be lowercase<br /> o GWCs should automatically convert network name given to lowercase to prevent Net ID mismatches <br /> <br /> solely on case alone.<br /> <br /> *<br /> o<br /> + client:<br /> # Four letter code of the client. ex: RAZA <br /> + version:<br /> # Version number of the client. <br /> o Optional<br /> + cluster:<br /> # To add extra info to an IP update.<br /> * Output by cache: H|0.0.0.0|AGE OF HOST (Seconds)|clustering some bull**** <br /> + statfile:<br /> # Exactly like the specification 1 statfile (Same routine and output style).<br /> # Statistics of the cache request:<br /> * First line: Total requests of the cache number.<br /> * Second line: Requests of the cache an hour number.<br /> * Third line: Updates of the cache an hour number. <br /> <br /> Specification 2.1<br /> <br /> * This is an extension of specification 2, not a separate specification!<br /> * Pong extension<br /> o Append the networks supported joined by a hyphen '-'.<br /> o Used for client-side validation of networks supported and for network support reporting to other web caches.<br /> o Format:<br /> + I|pong|cache name|network names joined by '-'<br /> + Format Examples:<br /> # I|pong|fakecache 0.01|gnutella<br /> * - Gnutella only <br /> # I|pong|fakecache 0.01|gnutella2<br /> * - Gnutella2 only <br /> # I|pong|fakecache 0.01|gnutella-gnutella2<br /> * - Gnutella and Gnutella2 served <br /> * Host Output<br /> o Just like specification 2, but with more fields supported for host output.<br /> + H|ip:port|age in cache|clustering|leaves|4 letter vendor code|reported uptime of host|max. leaves possible<br /> # The host, age, and clustering fields are all still the same as in specification 2.<br /> # The leaf count of the hub reported is in the 5th field.<br /> # The vendor code with version number is in the 6th field. <br /> * Request Control Variables:<br /> o getleaves<br /> + Used to obtain leaf counts of hubs given<br /> + 4th field ultilized for current leaf count.<br /> + 7th field ultilized for maximum leaf slots possible.<br /> + Use this as 'getleaves=1' or 'getleaves' to enable. <br /> o getclusters<br /> + Enables/Disables clustering.<br /> + Use this as 'getclusters=1'.<br /> + Using 'getclusters' or 'getclusters=0' disables cluster output. <br /> o getvendors<br /> + Used to obtain the vendor code w/ version number of the hubs given.<br /> + Found in the 5th field.<br /> + Use this as 'getvendors=1' or 'getvendors' to enable. <br /> o getuptime<br /> + Used to obtain the vendor code w/ version number of the hubs given.<br /> + Value is static, do not change the value given when time passes.<br /> + Found in the 6th field.<br /> + Use this as 'getuptime=1' or 'getuptime' to enable. <br /> o spec<br /> + To force the specification parameter<br /> + Currently is only supported by Beacon Cache II <br /> o pv<br /> + Similar to the 'spec' parameter, except that it does not force, instead it simply negotiates the specification. <br /> * Special Data Requests<br /> o info<br /> + Outputs extra details of your cache.<br /> # Start with the informational response: I|<br /> * Ex: I|open-source|1 <br /> o support<br /> + Outputs USEFUL details of your cache.<br /> # Start with the informational response: I|<br /> * Ex: I|support|gnutella2 <br /> o getnetworks<br /> + Outputs the enabled networks in two formats.<br /> # Start with the informational response: I|<br /> * For the 'I|nets|' line<br /> o The third field contains the supported networks joined by '-'. <br /> * For the 'I|networks|' line<br /> o Interpret the fields from 3 and beyond as individual network names to challenge against. <br /> # Examples<br /> *<br /> o I|nets|gnutella-gnutella2<br /> o I|networks|gnutella|gnutella2 <br /> * Update Extension Variables:<br /> o x_leaves<br /> + Number of leaves running on a given hub or ultrapeer.<br /> + Value must not be greater than an integer value of 2047.<br /> + Note: It is important to know that PHP automaticaly replace dots with underscores, so to keep compatibility with old/new version of clients all caches should support both variants, example: x.leaves x_leaves<br /> o x_max<br /> + Maximum number of leaves possible on a given hub or ultrapeer.<br /> + Value must not be greater than an integer value of 2047. <br /> o uptime<br /> + Value submitted must be an integer value of the number of seconds of uptime.<br /> + Value must not be greater than an integer value of 1 year (31536000) and less than 1 hour (60). <br /> <br /> Pinging Caches With Your Cache<br /> <br /> * Please follow this standard:<br /> o Client: TEST<br /> o Version: Your Cache's Name<br /> + The old value for &quot;version&quot; was 1 <br /> * Some variables to attach to the ping (compatibility):<br /> o multi<br /> + Used by some gwcs in their pings to other gwcs.<br /> + It tells the pinged cache to ignore the &quot;net&quot; parameter (so it should never say network not supported) and outputting the pong using this format, if possible, &quot;I|pong|[cache name] [cache version]|[supported networks list]|[url adding is enabled]&quot; - example: I|pong|Skulls 0.2.8a|gnutella-gnutella2|1<br /> + Used by Skulls GWC only, supported by Skulls and Beacon Cache II. <br /> o cache<br /> + This is added to every request made by some gwcs, it is for statistical purposes only.<br /> + It simply tells the remote cache that the client is a GWC. <br /> * Help<br /> o For PHP<br /> + Use the fsockopen() function to open a connection to a cache.<br /> # Make sure you &quot;write&quot; to the fsockopen carry value to open the GWC's target file.<br /> * http://us.php.net/manual/en/function.fsockopen.php <br /> <br /> Variable Combination Standards<br /> <br /> * Net variable decides specification!<br /> o There are many ways to determine spec., but going with net is the safe way.<br /> o Skulls GWC does not use the network parameter to determine specification level.<br /> o Beacon Cache (I and II) uses the network parameter to determine the specification level. <br /> * Your cache needs to be able to process certain combinations of variables.<br /> o Update variable<br /> + Update should not fail if absent if spec. 2.<br /> # A Specification 2 parameter. <br /> * Spec 1 parameters used in Spec 2:<br /> o Should still accept hostfile and urlfile responses for spec. 2.<br /> + Beacon Cache (I and II) accepts these parameters on spec 2. <br /> * The 'spec' paameter can be used to force a specification:<br /> o Only known to exist in Beacon Cache II, it can force the request to be handled as a specification 1 or 2 request.<br /> o Spec 1 = 'spec=1'<br /> o Spec 2 = 'spec=2'<br /> o If 'spec' is not equal to any current spec, then default to the predetermined spec. <br /> * Multiple variable requests<br /> o If for instance a ping and request exist, you should always handle them properly.<br /> + Same goes with other combos like an update and ping, statfile + ping and info. <br /> o Handle multiple variables as BEST as possible!<br /> + Some scanners and GWCs like to fit all their requests into one URL send. <br /> <br /> &lt;row recovery, end&gt; <br /> <br /> Further Information:<br /> <br /> * [http://www.gnucleus.com/gwebcache/ Original GWC site]<br /> ** [http://gnucleus.sourceforge.net/gwebcache/specs.html GWC Spec. 1]<br /> ** [http://gnucleus.sourceforge.net/gwebcache/newgwc.html GWC Spec. 2] <br /> <br /> <br /> <br /> <br /> <br /> &lt;content recovered from last aviable backup&gt; <br /> <br /> ===Gnutella Web Cache===<br /> Gnutella requires Gnutella Web Caches (GWC) to get IPs to establish a connection to the network. These are critical to ensuring the health of the network. If you have a dedicated server and can spare some extra bandwidth then please consider running a GWC. People that don't have a dedicated server or are on normal broadband consumer lines should not run a cache from home.<br /> <br /> A GWC is a simple script that can be put on any webserver that supports one of the following scripting languages:<br /> *JSP (Java Servlet)<br /> **[http://web.archive.org/web/20061108091447/http://www.mager.org/GWebCache/ Java Servlet GWebCache Application (Archive.org)]<br /> *C<br /> **[http://github.com/gtk-gnutella/gwc GhostWhiteCrab]<br /> *Perl <br /> **[http://www.jonatkins.com/perlgcache/ Jon Atkins' perlgcache] <br /> **The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache]<br /> *PHP <br /> **[http://gwcii.sourceforge.net/ PHPGnuCacheII] - MySQL<br /> **[http://www.bazookanetworks.com Bazooka G2WC] (recommended) - flat files<br /> **[http://sourceforge.net/projects/skulls/ Skulls! Multi-Network WebCache] - flat files<br /> === Further Information: ===<br /> * [http://www.gnucleus.com/gwebcache/ Original GWC site]<br /> <br /> [[Category:External Links]]</div>

Ale5000 https://shareaza.sourceforge.net/w/index.php?title=GWC_specs&diff=11514 2015-10-18T19:05:03Z

<p>Ale5000: Added the date of latest release</p> <hr /> <div>''For general information on GWCs, have a look at the [[GWC]] Wiki page.''<br /> {{do not translate}}<br /> This page is thought to give an overview over the GWC specifications as they are implemented into Shareaza.<br /> <br /> A GWC is a simple script that can be put on any webserver that supports one of the following scripting languages: <br /> <br /> * JSP (Java Servlet) <br /> ** [http://www1.mager.org/GWebCache/ Jums Web Cache] (Excellent for heavy loads) <br /> * C <br /> ** [http://sourceforge.net/projects/frostwire/files/GhostWhiteCrab/ GhostWhiteCrab] (For dedicated server environments and people who know how to compile C source code!) <br /> * ASP <br /> ** [http://www.edazzle.net/downloads/gerry.zip Gerry GWC] <br /> ** [https://www.planet-source-code.com/vb/scripts/ShowCode.asp?txtCodeId=7846&amp;lngWId=4 Lynn (v.s. 0.5)] <br /> ** [https://www.planet-source-code.com/vb/scripts/ShowCode.asp?txtCodeId=7731&amp;lngWId=4 Lynn (v.s. 0.4)] <br /> ** [http://www.poundwebhosting.com/cgi-bin/lynnx.asp LynnX] <br /> * Perl <br /> ** [http://www.jonatkins.com/perlgcache/ Jon Atkins' perlgcache] <br /> ** The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache] <br /> * '''PHP''' ''(Tip: PHP GWCs are usually the easiest to run and setup on a server.)''<br /> ** [http://gwcii.sourceforge.net/ PHPGnuCacheII] <br /> ** Bazooka G2WC<br /> ** [http://sourceforge.net/projects/skulls/ Skulls! Multi-Network WebCache] <br /> ** [http://sourceforge.net/projects/beaconcache/ Beacon Cache] <br /> ** [http://code.google.com/p/cachechu/ Cachechu G2WC] <br /> ** The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache] ''(PHP version is no longer supported)'' <br /> <br /> == Breakdown Of The Gnutella Web Caches: == <br /> {{RecoveredPage|I recently put this into a table. The contents need to be verified -- [[User:Cyko 01|Cyko 01]]}}<br /> <br /> {| width= auto; style=&quot;font-size: 85%; text-align: center;text-valign: middle;&quot; class=&quot;wikitable&quot;<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Cache:<br /> ! rowspan=1 |Gnutella:<br /> ! rowspan=1 |Gnutella2:<br /> ! rowspan=1 |Spec 1:<br /> ! rowspan=1 |Spec 2:<br /> ! rowspan=1 |Flat-File:<br /> ! rowspan=1 |SQL:<br /> ! rowspan=1 |Installer:<br /> ! rowspan=1 |Other Networks:<br /> ! rowspan=1 |Different network instances:<br /> ! rowspan=1 |Latest release date:<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Beacon Cache (Core 2)<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> |style=&quot;background: #CCFFCC;&quot;| Yes (As of 0.2.0 Alpha)<br /> | {{yes}}<br /> | {{yes}}<br /> | 2009-09-14<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Beacon Cache (Core 1)<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Skulls<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | 2015-04-10<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|JumsWebCache<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|GnuWebCache (Perl)<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|GnuWebCache (PHP) <br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|GhostWhiteCrab(GWC) <br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> |style=&quot;background: #FFFFCC;&quot;| N/A<br /> |style=&quot;background: #FFFFCC;&quot;| N/A<br /> |style=&quot;background: #FFFFCC;&quot;| N/A<br /> | {{yes}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|PHPGnuCacheII <br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Bazooka <br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Cachechu<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Perlgcache<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Gerry GWC (v2)<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Gerry GWC (v1)<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Lynn<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|LynnX<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |}<br /> <br /> == Shareaza Specific Details == <br /> <br /> {{RecoveredPage|Warninig: here I have pasted better formatted recovery, but not verified. Row recovery has been mooved below as I don't know if anybody has made any changes in it. If not then row recovery can be deleted. Paste starts from &gt;&gt;Shareaza Specific Details&lt;&lt;, here, and ends at second &gt;&gt;Shareaza Specific Details&lt;&lt; I hope it is visible. --[[User:Ocexyz|Ocexyz]] 23:27, 27 July 2009 (UTC)}}<br /> <br /> '''Get String Breakdown:''' <br /> * Update a leaf <br /> ** &quot;?update=1&amp;ip=(ip):(port)&amp;x_leaves=(leaf count) <br /> * Ping Variable <br /> ** Appends &amp;ping=1 to identify the cache name in debug messages (for gnutella and gnutella2 in 2.4.0.0, but only for gnutella2 now in 2.4.0.X for spec1 cache compatibility). <br /> ** This feature new to Shareaza. <br /> * Network Variable <br /> ** Appends &amp;net=gnutella2 on Gnutella2 queries. <br /> ** Does NOT append a network variable on Gnutella(1) queries. <br /> * Client Name / Version Format (2.4.0.0 and earlier): <br /> ** &amp;client=(Shareaza 4 letter code (RAZA / RAZB) ) <br /> ** &amp;version=(Shareaza's version) <br /> * Client Name / Version Format (2.4.0.X): <br /> ** If Gnutella <br /> *** &amp;client=(Shareaza 4 letter code (RAZA / RAZB) ) <br /> *** &amp;version=(Shareaza's version) <br /> ** If Gnutella2 <br /> *** &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )+(Shareaza's version) <br /> <br /> '''GWC Response Matching:''' <br /> * i| <br /> ** Informational output alone will not be taken as GWC 'success.' <br /> * i|access|period|(time in sec.) <br /> ** Time in seconds before Shareaza is allowed to make a request to the cache. <br /> * i|update|period|(time in sec.) <br /> ** Time in seconds before Shareaza is allowed to update to the cache. <br /> * i|force|remove and i|update|warning|bad url <br /> ** Remove the GWC from the internal list. <br /> * Some Response Matches (added in 2.3.1.X) <br /> ** i|NO-URL-NO-HOSTS <br /> *** Outputs warning of the cache being totally empty to the system log. <br /> ** i|NO-URL <br /> *** Outputs warning of the cache having no alternative URLs to the system log. <br /> ** i|NO-HOSTS <br /> *** Outputs warning of the cache having no hosts to the system log. <br /> ** i|warning| <br /> *** Outputs warning of the cache to the system log. <br /> ** ERROR Something Failed <br /> *** Outputs warning of the cache to the system log(Buggy Bazooka GWCs workaround). <br /> ** i|warning|You came back too early (2.3.1.X) <br /> ** i|warning|client|early (2.3.1.X) <br /> ** WARNING: You came back too early (2.3.1.X) <br /> ** ERROR: Client returned too early (2.3.1.X) <br /> *** Flood detection for the update side. <br /> *** Outputs GWebCache(update) Too many connection attempts to the system log. <br /> ** too early (2.3.1.X) <br /> ** early (2.4.0.X) <br /> *** Flood detection for the request side. <br /> *** Outputs GWebCache URL: Too many connection attempts to the system log. <br /> ** i|update|OK <br /> *** Outputs &quot;GWebCache(v2) Update Passed: &quot; to the system log. <br /> ** OK <br /> *** Outputs &quot;GWebCache(v1) Update Passed: &quot; to the system log. <br /> <br /> == Gnutella Web Cache Specifications ==<br /> ==== Specification 1: ====<br /> * '''Networks Served''' <br /> ** Gnutella <br /> * '''Format''' <br /> ** Update went fine: <br /> *** Ex: OK <br /> ** Update Warning (Small prob., not that bad): <br /> *** Ex: OKWARNING: Error Message <br /> <br /> * Severe Warning (No 'OK' message sent) <br /> ** Ex: WARNING: Error Message<br /> <br /> * URL Output: <br /> ** Ex: [http://somefreakinrandomcache.com/cache/gcache.php http://somefreakinrandomcache.com/cache/gcache.php] <br /> *** OR - WITH A PORT NUMBER (If not 80) <br /> **** Ex: [http://somefreakinrandomcache.com:8080/cache/gcache.php http://somefreakinrandomcache.com:8080/cache/gcache.php] <br /> * Host Output: <br /> ** Ex: 66.132.55.12:6346 <br /> * Pong (ping variable response) - was explained below under the topic: variables. <br /> * '''Example Cache Output (Beacon Cache) For urlfile Command''' <br /> ** Example &quot;urlfile Output&quot; URL: Ex: [http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;urlfile=1 http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;urlfile=1] <br /> *** Example URL Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting urls with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | PONG Beacon Cache 0.1.5D Beta[http://gwc.frodoslair.net/skulls/skulls.php http://gwc.frodoslair.net/skulls/skulls.php][http://bbs.robertwoolley.co.uk/GWebCache/gcache.php http://bbs.robertwoolley.co.uk/GWebCache/gcache.php][http://g2.tjtech.org/g2/ http://g2.tjtech.org/g2/][http://g2.tjtech.org/g2/index.php http://g2.tjtech.org/g2/index.php][http://gwc.monnsta.net/ http://gwc.monnsta.net/][http://holograph.uni.cc/other/skulls.php http://holograph.uni.cc/other/skulls.php][http://gwc.nickstallman.net/ http://gwc.nickstallman.net/][http://gwc.eod.cc/skulls.php http://gwc.eod.cc/skulls.php][http://gwc.frodoslair.net/skulls/skulls http://gwc.frodoslair.net/skulls/skulls][http://gwc.werwin.net/skulls.php http://gwc.werwin.net/skulls.php] <br /> <br /> |}<br /> * '''Example Cache Output (Beacon Cache) For hostfile Command''' <br /> ** Example &quot;hostfile Output&quot; URL: Ex: [http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;hostfile=1 http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;hostfile=1] <br /> *** Example Host Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting the hosts with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | PONG Beacon Cache 0.1.5D Beta71.8.84.153:391599.248.214.157:2752969.60.241.55:16369193.253.239.246:3021868.156.175.121:634871.179.7.241:1834474.196.22.241:634812.210.197.194:10531222.150.143.77:1000058.85.231.135:634624.141.199.164:2020572.175.201.195:634869.81.129.228:488097.81.221.63:1321970.15.130.224:7759216.211.188.106:5190375.167.168.156:4866012.214.14.3:3591676.177.244.106:2418098.165.218.139:3963068.112.182.125:368568.117.204.57:2348265.12.154.25:4076069.180.47.169:571175.138.40.173:2498798.201.19.0:3366270.187.2.144:634868.186.209.107:1442969.159.7.61:634876.208.176.196:48199<br /> <br /> |}<br /> * '''For combining a hostfile and urlfile request:''' <br /> ** Warning: This is non-standard. <br /> ** '''Example Cache Output (Beacon Cache) For bfile Command''' <br /> *** Example &quot;bfile Output&quot; URL: Ex: [http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;bfile=1 http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;bfile=1] <br /> **** Example Host and URL Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting the hosts and urls with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | PONG Beacon Cache 0.1.5D Beta71.8.84.153:391599.248.214.157:2752969.60.241.55:16369193.253.239.246:3021868.156.175.121:634871.179.7.241:1834474.196.22.241:634812.210.197.194:10531222.150.143.77:1000058.85.231.135:634624.141.199.164:2020572.175.201.195:634869.81.129.228:488097.81.221.63:1321970.15.130.224:7759216.211.188.106:5190375.167.168.156:4866012.214.14.3:3591676.177.244.106:2418098.165.218.139:3963068.112.182.125:368568.117.204.57:2348265.12.154.25:4076069.180.47.169:571175.138.40.173:2498798.201.19.0:3366270.187.2.144:634868.186.209.107:1442969.159.7.61:634876.208.176.196:48199[http://gwc.frodoslair.net/skulls/skulls.php http://gwc.frodoslair.net/skulls/skulls.php][http://bbs.robertwoolley.co.uk/GWebCache/gcache.php http://bbs.robertwoolley.co.uk/GWebCache/gcache.php][http://g2.tjtech.org/g2/ http://g2.tjtech.org/g2/][http://g2.tjtech.org/g2/index.php http://g2.tjtech.org/g2/index.php][http://gwc.monnsta.net/ http://gwc.monnsta.net/][http://holograph.uni.cc/other/skulls.php http://holograph.uni.cc/other/skulls.php][http://gwc.nickstallman.net/ http://gwc.nickstallman.net/][http://gwc.eod.cc/skulls.php http://gwc.eod.cc/skulls.php][http://gwc.frodoslair.net/skulls/skulls http://gwc.frodoslair.net/skulls/skulls][http://gwc.werwin.net/skulls.php http://gwc.werwin.net/skulls.php] <br /> <br /> |}<br /> '''Variables''' <br /> * '''Mandatory''' <br /> ** ping: <br /> *** Response should have this always: PONG<br /> *** After, put the cache's name. ex: PONG fakecache 0.01<br /> ** client: <br /> *** Four letter code of the client. ex: RAZA <br /> ** version: <br /> *** Version number of the client. <br /> ** urlfile: <br /> *** Used by the client to request alternate cache urls. <br /> ** hostfile: <br /> *** Used by the client to request IPs with port numbers attached. <br /> ** url: <br /> *** Client update giving an alternate cache URL. <br /> *** Formatted with a http:// prefix to each cache. <br /> ** ip: <br /> *** Client update giving one's IP to submit. <br /> ** url1: <br /> *** OLD OUTDATED Client update giving an alternate cache URL. <br /> *** Formatted with a http:// prefix to each cache. <br /> ** ip1: <br /> *** OLD OUTDATED Client update giving one's IP to submit. <br /> * '''Optional''' <br /> ** bfile: <br /> *** For clients to request both URLs and IPs from the cache at the same time. <br /> ** statfile: <br /> *** Statistics of the cache request: <br /> **** First line: Total requests of the cache number. <br /> **** Second line: Requests of the cache an hour number. <br /> **** Third line: Updates of the cache an hour number.<br /> <br /> ==== Specification 2: ====<br /> '''Networks Served''' <br /> * Gnutella, Gnutella2, etc. <br /> '''Format''' <br /> * '''Information Output''' <br /> ** Starts with: I| <br /> *** '''Categories''' <br /> **** '''Pong''' (ping variable response) - Described below under the topic: variables. <br /> **** '''Update Status Response''' <br /> ***** Format: I|update <br /> ***** '''Responses''' <br /> ****** I|update|OK <br /> ******* - Everything went fine. <br /> ****** I|update|OK|WARNING <br /> ******* Small warning. <br /> ****** I|update|WARNING <br /> ******* Severe warning <br /> **** '''Plain Warnings''' <br /> ***** Format: I|WARNING <br /> ****** Append any warning messages after it - Ex: I|WARNING|You came back too early <br /> **** '''Extra Info''' - Described below under the topic: variables. <br /> * '''Host Output''' <br /> ** Starts with: H| <br /> ** Add the IP with its port: <br /> *** Ex: H|0.0.0.0:6346 <br /> ** Add the time, thereafter, of the host's (In seconds*) time in cache: <br /> *** Ex: H|0.0.0.0:6346|45 <br /> ** If cluster exists with cluster=somerandomwords <br /> *** Add the clustered words after the host's age: <br /> **** Ex: H|0.0.0.0:6346|45|somerandomwords <br /> * '''URL Output''' <br /> ** Starts with: U| <br /> ** Add the URL with http:// before it, plus the port (if it's not 80). <br /> *** Ex: U|[http://somerandomcache.com/ http://somerandomcache.com/] <br /> ** Add the time, thereafter, of the URL's time (In seconds*) in cache: <br /> *** Ex: U|[http://somerandomcache.com/%7C45 http://somerandomcache.com/|45] <br /> * '''Example Cache Output (Beacon Cache) For get Command''' <br /> ** Example URL: [http://grantgalitz.com/Beacon/gwc.php?get=1&amp;client=RAZA&amp;version=2.3.1.3&amp;net=gnutella2&amp;ping=1 http://grantgalitz.com/Beacon/gwc.php?get=1&amp;client=RAZA&amp;version=2.3.1.3&amp;net=gnutella2&amp;ping=1] <br /> *** Example &quot;Get&quot; Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting the hosts and urls with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | I|pong|Beacon Cache 0.1.5D Beta|gnutella-gnutella2H|65.9.200.243:4968|248261H|68.228.129.75:44599|242678H|98.240.196.122:8206|240719H|76.104.12.133:14921|218273H|69.136.1.12:3924|211610H|81.154.208.71:8595|174402H|97.96.105.51:2076|153610H|74.192.153.212:39340|144203H|72.190.106.57:12584|132984H|78.93.71.132:12334|125668H|82.43.248.184:27560|97974H|196.205.224.97:6357|86763H|74.129.219.30:33172|82005H|76.104.12.133:19185|57182H|69.59.83.131:18442|38628U|[http://www.k33bz.com/g2/bazooka.php%7C248639 http://www.k33bz.com/g2/bazooka.php|248639]U|[http://gwebcache.ns1.net/%7C248592 http://gwebcache.ns1.net/|248592]U|[http://gwc2.wodi.org/skulls.php%7C248384 http://gwc2.wodi.org/skulls.php|248384]U|[http://gwc.guufshop.com/skulls/skulls.php%7C248322 http://gwc.guufshop.com/skulls/skulls.php|248322]U|[http://groovy.syxy.com/up/skulls.php%7C248300 http://groovy.syxy.com/up/skulls.php|248300]U|[http://g2.tjtech.org/g2/index.php%7C247770 http://g2.tjtech.org/g2/index.php|247770]U|[http://midian.jayl.de/g2/bazooka.php%7C240719 http://midian.jayl.de/g2/bazooka.php|240719]U|[http://www.dom2porno.info/skulls/skulls.php%7C207473 http://www.dom2porno.info/skulls/skulls.php|207473]U|[http://gwc.frodoslair.net/skulls/skulls%7C125668 http://gwc.frodoslair.net/skulls/skulls|125668]U|[http://holograph.uni.cc/other/skulls.php%7C9642 http://holograph.uni.cc/other/skulls.php|9642] <br /> <br /> |}<br /> '''Variables''' <br /> * '''Mandatory''' <br /> ** ping: <br /> *** Main Part: I|pong| <br /> *** Then add the cache name and version: I|pong|fakecache 0.01 <br /> *** Then lastly add the network support: <br /> **** I|pong|fakecache 0.01|gnutella <br /> ***** - Gnutella only <br /> **** I|pong|fakecache 0.01|gnutella2 <br /> ***** - Gnutella2 only <br /> **** I|pong|fakecache 0.01|gnutella-gnutella2 <br /> ***** - Gnutella and Gnutella2 served <br /> ** get: <br /> *** Used by clients to requests alternate cache URLs along with IPs and their port numbers. <br /> ** update: <br /> *** url: <br /> **** Client update giving an alternate cache URL. <br /> **** Formatted with a http:// prefix to each cache. <br /> *** ip: <br /> **** Client update giving one's IP to submit. <br /> ** net: <br /> *** Which network to serve the client. <br /> **** Gnutella <br /> ***** Ex: net=gnutella <br /> **** Gnutella2 <br /> ***** Ex: net=gnutella2 <br /> **** '''Should always be lowercase''' <br /> ***** GWCs should automatically convert network name given to lowercase to prevent Net ID mismatches <br /> <br /> solely on case alone. <br /> <br /> <br /> * <br /> ** client: <br /> *** Four letter code of the client. ex: RAZA <br /> ** version: <br /> *** Version number of the client. <br /> * '''Optional''' <br /> ** cluster: <br /> *** To add extra info to an IP update. <br /> **** Output by cache: H|0.0.0.0|AGE OF HOST (Seconds)|clustering some bull**** <br /> ** statfile: <br /> *** Exactly like the specification 1 statfile '''(Same routine and output style)'''. <br /> *** Statistics of the cache request: <br /> **** First line: Total requests of the cache number. <br /> **** Second line: Requests of the cache an hour number. <br /> **** Third line: Updates of the cache an hour number. <br /> <br /> ==== Specification 2.1 ====<br /> '''This is an extension of specification 2, not a separate specification!''' <br /> Pong extension <br /> * Append the networks supported joined by a hyphen '-'. <br /> * Used for client-side validation of networks supported and for network support reporting to other web caches. <br /> * Format: <br /> ** I|pong|cache name|network names joined by '-' <br /> ** Format Examples: <br /> *** I|pong|fakecache 0.01|gnutella <br /> **** - Gnutella only <br /> *** I|pong|fakecache 0.01|gnutella2 <br /> **** - Gnutella2 only <br /> *** I|pong|fakecache 0.01|gnutella-gnutella2 <br /> **** - Gnutella and Gnutella2 served <br /> Host Output <br /> * Just like specification 2, but with more fields supported for host output. <br /> ** H|ip:port|age in cache|clustering|leaves|4 letter vendor code|reported uptime of host|max. leaves possible <br /> *** The host, age, and clustering fields are all still the same as in specification 2. <br /> *** The leaf count of the hub reported is in the 5th field. <br /> *** The vendor code with version number is in the 6th field. <br /> Request Control Variables: <br /> * getleaves <br /> ** Used to obtain leaf counts of hubs given <br /> ** 4th field ultilized for current leaf count. <br /> ** 7th field ultilized for maximum leaf slots possible. <br /> ** Use this as 'getleaves=1' or 'getleaves' to enable. <br /> * getclusters <br /> ** Enables/Disables clustering. <br /> ** Use this as 'getclusters=1'. <br /> ** Using 'getclusters' or 'getclusters=0' disables cluster output. <br /> * getvendors <br /> ** Used to obtain the vendor code w/ version number of the hubs given. <br /> ** Found in the 5th field. <br /> ** Use this as 'getvendors=1' or 'getvendors' to enable. <br /> * getuptime <br /> ** Used to obtain the vendor code w/ version number of the hubs given. <br /> ** Value is static, do not change the value given when time passes. <br /> ** Found in the 6th field. <br /> ** Use this as 'getuptime=1' or 'getuptime' to enable. <br /> * spec <br /> ** To force the specification parameter <br /> ** Currently is only supported by Beacon Cache II <br /> * pv <br /> ** Similar to the 'spec' parameter, except that it does not force, instead it simply negotiates the specification. <br /> Special Data Requests <br /> * info <br /> ** Outputs extra details of your cache. <br /> *** Start with the informational response: I| <br /> **** Ex: I|open-source|1 <br /> * support <br /> ** Outputs USEFUL details of your cache. <br /> *** Start with the informational response: I| <br /> **** Ex: I|support|gnutella2 <br /> * getnetworks <br /> ** Outputs the enabled networks in two formats. <br /> *** Start with the informational response: I| <br /> **** For the 'I|nets|' line <br /> ***** The third field contains the supported networks joined by '-'. <br /> **** For the 'I|networks|' line <br /> ***** Interpret the fields from 3 and beyond as individual network names to challenge against. <br /> *** Examples <br /> **** <br /> ***** I|nets|gnutella-gnutella2 <br /> ***** I|networks|gnutella|gnutella2 <br /> Update Extension Variables: <br /> * x_leaves <br /> ** Number of leaves running on a given hub or ultrapeer. <br /> ** '''Value must not be greater than an integer value of 2047.''' <br /> ** '''Note: It is important to know that PHP automaticaly replace dots with underscores, so to keep compatibility with old/new version of clients all caches should support both variants, example: x.leaves x_leaves''' <br /> * x_max <br /> ** Maximum number of leaves possible on a given hub or ultrapeer. <br /> ** '''Value must not be greater than an integer value of 2047.''' <br /> * uptime <br /> ** Value submitted must be an integer value of the number of seconds of uptime. <br /> ** '''Value must not be greater than an integer value of 1 year (31536000) and less than 1 hour (60).''' <br /> <br /> === Pinging Caches With Your Cache ===<br /> '''Please follow this standard:''' <br /> * '''Client: TEST''' <br /> * '''Version: Your Cache's Name''' <br /> ** The old value for &quot;version&quot; was 1 <br /> '''Some variables to attach to the ping (compatibility):''' <br /> * '''multi''' <br /> ** Used by some gwcs in their pings to other gwcs. <br /> ** &lt;nowiki&gt;It tells the pinged cache to ignore the &quot;net&quot; parameter (so it should never say network not supported) and outputting the pong using this format, if possible, &quot;I|pong|[cache name] [cache version]|[supported networks list]&quot; - example: I|pong|Skulls 0.2.9|gnutella-gnutella2 &lt;/nowiki&gt;<br /> ** Used by Skulls GWC only, supported by Skulls and Beacon Cache II. <br /> * '''cache''' <br /> ** This is added to every request made by some gwcs, it is for statistical purposes only. <br /> ** It simply tells the remote cache that the client is a GWC. <br /> '''Help''' <br /> * For PHP <br /> ** Use the fsockopen() function to open a connection to a cache. <br /> *** Make sure you &quot;write&quot; to the fsockopen carry value to open the GWC's target file. <br /> **** [http://us.php.net/manual/en/function.fsockopen.php http://us.php.net/manual/en/function.fsockopen.php] <br /> <br /> === Variable Combination Standards ===<br /> '''Net variable decides specification!''' <br /> * There are many ways to determine spec., but going with net is the safe way. <br /> * Skulls GWC does not use the network parameter to determine specification level. <br /> * Beacon Cache (I and II) uses the network parameter to determine the specification level. <br /> '''Your cache needs to be able to process certain combinations of variables.''' <br /> * Update variable <br /> ** Update should not fail if absent if spec. 2. <br /> *** A Specification 2 parameter. <br /> Spec 1 parameters used in Spec 2: <br /> * Should still accept hostfile and urlfile responses for spec. 2. <br /> ** Beacon Cache (I and II) accepts these parameters on spec 2. <br /> The 'spec' paameter can be used to force a specification: <br /> * Only known to exist in Beacon Cache II, it can force the request to be handled as a specification 1 or 2 request. <br /> * Spec 1 = 'spec=1' <br /> * Spec 2 = 'spec=2' <br /> * If 'spec' is not equal to any current spec, then default to the predetermined spec. <br /> '''Multiple variable requests''' <br /> * If for instance a ping and request exist, you should always handle them properly. <br /> ** Same goes with other combos like an update and ping, statfile + ping and info. <br /> * Handle multiple variables as BEST as possible! <br /> ** Some scanners and GWCs like to fit all their requests into one URL send. <br /> <br /> === Further Information: ===<br /> * [http://www.gnucleus.com/gwebcache/ Original GWC] [http://www.gnucleus.com/gwebcache/ site] <br /> ** [http://gnucleus.sourceforge.net/gwebcache/specs.html GWC Spec. 1] <br /> ** [http://gnucleus.sourceforge.net/gwebcache/newgwc.html GWC Spec. 2] <br /> <br /> === Gnutella Web Cache ===<br /> Gnutella requires Gnutella Web Caches (GWC) to get IPs to establish a connection to the network. These are critical to ensuring the health of the network. If you have a dedicated server and can spare some extra bandwidth then please consider running a GWC. People that don't have a dedicated server or are on normal broadband consumer lines should not run a cache from home.<br /> <br /> A GWC is a simple script that can be put on any webserver that supports one of the following scripting languages:<br /> *JSP (Java Servlet)<br /> **[http://web.archive.org/web/20061108091447/http://www.mager.org/GWebCache/ Java Servlet GWebCache Application (Archive.org)]<br /> *C<br /> **[http://ghostwhitecrab.com/crab/ GhostWhiteCrab]<br /> *Perl <br /> **[http://www.jonatkins.com/perlgcache/ Jon Atkins' perlgcache] <br /> **The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache]<br /> *PHP <br /> **[http://gwcii.sourceforge.net/ PHPGnuCacheII] - MySQL<br /> **[http://www.bazookanetworks.com Bazooka G2WC] (recommended) - flat files<br /> **[http://sourceforge.net/projects/skulls/ Skulls! Multi-Network WebCache] - flat files<br /> ====Further Information:====<br /> *[http://www.gnucleus.com/gwebcache/|Original GWC site]<br /> <br /> <br /> {{RecoveredPage|--&gt;Saved in timestamp 20090421202728Retrieved from &quot;[https://www.pantheraproject.net/wiki/index.php?title=GWC This page was last modified on April 18, 2009, at 23:25. &lt;/center&gt;<br /> <br /> &lt;center&gt;Copyright © 2002-2009 Shareaza Development Team. &lt;/center&gt;&lt;center&gt;[[Image:poweredby_mediawiki_88x31.png]] --[[User:Ocexyz|Ocexyz]] 16:20, 27 July 2009 (UTC)}}<br /> <br /> {{RecoveredPage|Warninig: here ends pasted better formatted recovery. Row recovery has been mooved below as I don't know if anybody has made any changes in it. If not then row recovery can be deleted I suppose. Paste starts from == Shareaza Specific Details == and ends at second == Shareaza Specific Details ==, here. I hope it is visible. --[[User:Ocexyz|Ocexyz]] 16:20, 27 July 2009 (UTC) }}<br /> <br /> ==Shareaza Specific Details==<br /> <br /> {{RecoveredPage|Warninig: here ends pasted better formatted recovery. Row recovery has been mooved below as I don't know if anybody has made any changes in it. If not then row recovery can be deleted I suppose. Paste starts from &gt;&gt;Shareaza Specific Details&lt;&lt; and ends at second &gt;&gt; Shareaza Specific Details&lt;&lt;, here. I hope it is visible. --[[User:Ocexyz|Ocexyz]] 23:27, 27 July 2009 (UTC) }}<br /> <br /> * Get String Breakdown:<br /> o Update a leaf<br /> + &quot;?update=1&amp;ip=(ip):(port)&amp;x_leaves=(leaf count) <br /> o Ping Variable<br /> + Appends &amp;ping=1 to identify the cache name in debug messages (for gnutella and gnutella2 in 2.4.0.0, but only for gnutella2 now in 2.4.0.X for spec1 cache compatibility).<br /> + This feature new to Shareaza. <br /> o Network Variable<br /> + Appends &amp;net=gnutella2 on Gnutella2 queries.<br /> + Does NOT append a network variable on Gnutella(1) queries. <br /> o Client Name / Version Format (2.4.0.0 and earlier):<br /> + &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )<br /> + &amp;version=(Shareaza's version) <br /> o Client Name / Version Format (2.4.0.X):<br /> + If Gnutella<br /> # &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )<br /> # &amp;version=(Shareaza's version) <br /> + If Gnutella2<br /> # &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )+(Shareaza's version) <br /> <br /> <br /> <br /> * GWC Response Matching:<br /> o i|<br /> + Informational output alone will not be taken as GWC 'success.' <br /> o i|access|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to make a request to the cache. <br /> o i|update|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to update to the cache. <br /> o i|force|remove and i|update|warning|bad url<br /> + Remove the GWC from the internal list. <br /> o Some Response Matches (added in 2.3.1.X)<br /> + i|NO-URL-NO-HOSTS<br /> # Outputs warning of the cache being totally empty to the system log. <br /> + i|NO-URL<br /> # Outputs warning of the cache having no alternative URLs to the system log. <br /> + i|NO-HOSTS<br /> # Outputs warning of the cache having no hosts to the system log. <br /> + i|warning|<br /> # Outputs warning of the cache to the system log. <br /> + ERROR Something Failed<br /> # Outputs warning of the cache to the system log(Buggy Bazooka GWCs workaround). <br /> + i|warning|You came back too early (2.3.1.X)<br /> + i|warning|client|early (2.3.1.X)<br /> + WARNING: You came back too early (2.3.1.X)<br /> + ERROR: Client returned too early (2.3.1.X)<br /> # Flood detection for the update side.<br /> # Outputs GWebCache(update) Too many connection attempts to the system log. <br /> + too early (2.3.1.X)<br /> + early (2.4.0.X)<br /> # Flood detection for the request side.<br /> # Outputs GWebCache URL: Too many connection attempts to the system log. <br /> + i|update|OK<br /> # Outputs &quot;GWebCache(v2) Update Passed: &quot; to the system log. <br /> + OK<br /> # Outputs &quot;GWebCache(v1) Update Passed: &quot; to the system log. <br /> <br /> <br /> <br /> * GWC Response Matching:<br /> o i|<br /> + Informational output alone will not be taken as GWC 'success.' <br /> o i|access|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to make a request to the cache. <br /> o i|update|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to update to the cache. <br /> o i|force|remove and i|update|warning|bad url<br /> + Remove the GWC from the internal list. <br /> o Some Response Matches (added in 2.3.1.X)<br /> + i|NO-URL-NO-HOSTS<br /> # Outputs warning of the cache being totally empty to the system log. <br /> + i|NO-URL<br /> # Outputs warning of the cache having no alternative URLs to the system log. <br /> + i|NO-HOSTS<br /> # Outputs warning of the cache having no hosts to the system log. <br /> + i|warning|<br /> # Outputs warning of the cache to the system log. <br /> + ERROR Something Failed<br /> # Outputs warning of the cache to the system log(Buggy Bazooka GWCs workaround). <br /> + i|warning|You came back too early (2.3.1.X)<br /> + i|warning|client|early (2.3.1.X)<br /> + WARNING: You came back too early (2.3.1.X)<br /> + ERROR: Client returned too early (2.3.1.X)<br /> # Flood detection for the update side.<br /> # Outputs GWebCache(update) Too many connection attempts to the system log. <br /> + too early (2.3.1.X)<br /> + early (2.4.0.X)<br /> # Flood detection for the request side.<br /> # Outputs GWebCache URL: Too many connection attempts to the system log. <br /> + i|update|OK<br /> # Outputs &quot;GWebCache(v2) Update Passed: &quot; to the system log. <br /> + OK<br /> # Outputs &quot;GWebCache(v1) Update Passed: &quot; to the system log. <br /> <br /> <br /> <br /> ==Gnutella Web Cache Specifications==<br /> &lt;end of partial recovery by OCE&gt;<br /> <br /> <br /> <br /> <br /> &lt;end of recovered content&gt;<br /> <br /> &lt;row recovery, start&gt; <br /> Specification 1:<br /> <br /> * Networks Served<br /> o Gnutella <br /> * Format<br /> o Update went fine:<br /> + Ex: OK <br /> o Update Warning (Small prob., not that bad):<br /> + Ex: <br /> <br /> OK<br /> WARNING: Error Message<br /> <br /> * Severe Warning (No 'OK' message sent)<br /> o Ex: <br /> <br /> WARNING: Error Message<br /> <br /> * URL Output:<br /> o Ex: http://somefreakinrandomcache.com/cache/gcache.php<br /> + OR - WITH A PORT NUMBER (If not 80)<br /> # Ex: http://somefreakinrandomcache.com:8080/cache/gcache.php <br /> * Host Output:<br /> o Ex: 66.132.55.12:6346 <br /> * Pong (ping variable response) - was explained below under the topic: variables.<br /> * Example Cache Output (Beacon Cache) For urlfile Command<br /> o Example &quot;urlfile Output&quot; URL: Ex: http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;urlfile=1<br /> + Example URL Output: <br /> <br /> <br /> Getting urls with a pong combined<br /> <br /> PONG Beacon Cache 0.1.5D Beta<br /> http://gwc.frodoslair.net/skulls/skulls.php<br /> http://bbs.robertwoolley.co.uk/GWebCache/gcache.php<br /> http://g2.tjtech.org/g2/<br /> http://g2.tjtech.org/g2/index.php<br /> http://gwc.monnsta.net/<br /> http://holograph.uni.cc/other/skulls.php<br /> http://gwc.nickstallman.net/<br /> http://gwc.eod.cc/skulls.php<br /> http://gwc.frodoslair.net/skulls/skulls<br /> http://gwc.werwin.net/skulls.php<br /> <br /> <br /> * Example Cache Output (Beacon Cache) For hostfile Command<br /> o Example &quot;hostfile Output&quot; URL: Ex: http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;hostfile=1<br /> + Example Host Output: <br /> <br /> <br /> Getting the hosts with a pong combined<br /> <br /> PONG Beacon Cache 0.1.5D Beta<br /> 71.8.84.153:3915<br /> 99.248.214.157:27529<br /> 69.60.241.55:16369<br /> 193.253.239.246:30218<br /> 68.156.175.121:6348<br /> 71.179.7.241:18344<br /> 74.196.22.241:6348<br /> 12.210.197.194:10531<br /> 222.150.143.77:10000<br /> 58.85.231.135:6346<br /> 24.141.199.164:20205<br /> 72.175.201.195:6348<br /> 69.81.129.228:4880<br /> 97.81.221.63:13219<br /> 70.15.130.224:7759<br /> 216.211.188.106:51903<br /> 75.167.168.156:48660<br /> 12.214.14.3:35916<br /> 76.177.244.106:24180<br /> 98.165.218.139:39630<br /> 68.112.182.125:3685<br /> 68.117.204.57:23482<br /> 65.12.154.25:40760<br /> 69.180.47.169:5711<br /> 75.138.40.173:24987<br /> 98.201.19.0:33662<br /> 70.187.2.144:6348<br /> 68.186.209.107:14429<br /> 69.159.7.61:6348<br /> 76.208.176.196:48199<br /> <br /> <br /> * For combining a hostfile and urlfile request:<br /> o Warning: This is non-standard.<br /> o Example Cache Output (Beacon Cache) For bfile Command<br /> + Example &quot;bfile Output&quot; URL: Ex: http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;bfile=1<br /> # Example Host and URL Output: <br /> <br /> <br /> Getting the hosts and urls with a pong combined<br /> <br /> PONG Beacon Cache 0.1.5D Beta<br /> 71.8.84.153:3915<br /> 99.248.214.157:27529<br /> 69.60.241.55:16369<br /> 193.253.239.246:30218<br /> 68.156.175.121:6348<br /> 71.179.7.241:18344<br /> 74.196.22.241:6348<br /> 12.210.197.194:10531<br /> 222.150.143.77:10000<br /> 58.85.231.135:6346<br /> 24.141.199.164:20205<br /> 72.175.201.195:6348<br /> 69.81.129.228:4880<br /> 97.81.221.63:13219<br /> 70.15.130.224:7759<br /> 216.211.188.106:51903<br /> 75.167.168.156:48660<br /> 12.214.14.3:35916<br /> 76.177.244.106:24180<br /> 98.165.218.139:39630<br /> 68.112.182.125:3685<br /> 68.117.204.57:23482<br /> 65.12.154.25:40760<br /> 69.180.47.169:5711<br /> 75.138.40.173:24987<br /> 98.201.19.0:33662<br /> 70.187.2.144:6348<br /> 68.186.209.107:14429<br /> 69.159.7.61:6348<br /> 76.208.176.196:48199<br /> http://gwc.frodoslair.net/skulls/skulls.php<br /> http://bbs.robertwoolley.co.uk/GWebCache/gcache.php<br /> http://g2.tjtech.org/g2/<br /> http://g2.tjtech.org/g2/index.php<br /> http://gwc.monnsta.net/<br /> http://holograph.uni.cc/other/skulls.php<br /> http://gwc.nickstallman.net/<br /> http://gwc.eod.cc/skulls.php<br /> http://gwc.frodoslair.net/skulls/skulls<br /> http://gwc.werwin.net/skulls.php<br /> <br /> <br /> * Variables<br /> o Mandatory<br /> + ping:<br /> # Response should have this always: PONG<br /> # After, put the cache's name. ex: PONG fakecache 0.01<br /> + client:<br /> # Four letter code of the client. ex: RAZA <br /> + version:<br /> # Version number of the client. <br /> + urlfile:<br /> # Used by the client to request alternate cache urls. <br /> + hostfile:<br /> # Used by the client to request IPs with port numbers attached. <br /> + url:<br /> # Client update giving an alternate cache URL.<br /> # Formatted with a http:// prefix to each cache. <br /> + ip:<br /> # Client update giving one's IP to submit. <br /> + url1:<br /> # OLD OUTDATED Client update giving an alternate cache URL.<br /> # Formatted with a http:// prefix to each cache. <br /> + ip1:<br /> # OLD OUTDATED Client update giving one's IP to submit. <br /> o Optional<br /> + bfile:<br /> # For clients to request both URLs and IPs from the cache at the same time. <br /> + statfile:<br /> # Statistics of the cache request:<br /> * First line: Total requests of the cache number.<br /> * Second line: Requests of the cache an hour number.<br /> * Third line: Updates of the cache an hour number. <br /> <br /> Specification 2:<br /> <br /> * Networks Served<br /> o Gnutella, Gnutella2, etc. <br /> * Format<br /> o Information Output<br /> + Starts with: I|<br /> # Categories<br /> * Pong (ping variable response) - Described below under the topic: variables.<br /> * Update Status Response<br /> o Format: I|update<br /> o Responses<br /> + I|update|OK<br /> # - Everything went fine. <br /> + I|update|OK|WARNING<br /> # Small warning. <br /> + I|update|WARNING<br /> # Severe warning <br /> * Plain Warnings<br /> o Format: I|WARNING<br /> + Append any warning messages after it - Ex: I|WARNING|You came back too early <br /> * Extra Info - Described below under the topic: variables. <br /> o Host Output<br /> + Starts with: H|<br /> + Add the IP with its port:<br /> # Ex: H|0.0.0.0:6346 <br /> + Add the time, thereafter, of the host's (In seconds*) time in cache:<br /> # Ex: H|0.0.0.0:6346|45 <br /> + If cluster exists with cluster=somerandomwords<br /> # Add the clustered words after the host's age:<br /> * Ex: H|0.0.0.0:6346|45|somerandomwords <br /> o URL Output<br /> + Starts with: U|<br /> + Add the URL with http:// before it, plus the port (if it's not 80).<br /> # Ex: U|http://somerandomcache.com/ <br /> + Add the time, thereafter, of the URL's time (In seconds*) in cache:<br /> # Ex: U|http://somerandomcache.com/|45 <br /> o Example Cache Output (Beacon Cache) For get Command<br /> + Example URL: http://grantgalitz.com/Beacon/gwc.php?get=1&amp;client=RAZA&amp;version=2.3.1.3&amp;net=gnutella2&amp;ping=1<br /> # Example &quot;Get&quot; Output: <br /> <br /> <br /> Getting the hosts and urls with a pong combined<br /> <br /> I|pong|Beacon Cache 0.1.5D Beta|gnutella-gnutella2<br /> H|65.9.200.243:4968|248261<br /> H|68.228.129.75:44599|242678<br /> H|98.240.196.122:8206|240719<br /> H|76.104.12.133:14921|218273<br /> H|69.136.1.12:3924|211610<br /> H|81.154.208.71:8595|174402<br /> H|97.96.105.51:2076|153610<br /> H|74.192.153.212:39340|144203<br /> H|72.190.106.57:12584|132984<br /> H|78.93.71.132:12334|125668<br /> H|82.43.248.184:27560|97974<br /> H|196.205.224.97:6357|86763<br /> H|74.129.219.30:33172|82005<br /> H|76.104.12.133:19185|57182<br /> H|69.59.83.131:18442|38628<br /> U|http://www.k33bz.com/g2/bazooka.php|248639<br /> U|http://gwebcache.ns1.net/|248592<br /> U|http://gwc2.wodi.org/skulls.php|248384<br /> U|http://gwc.guufshop.com/skulls/skulls.php|248322<br /> U|http://groovy.syxy.com/up/skulls.php|248300<br /> U|http://g2.tjtech.org/g2/index.php|247770<br /> U|http://midian.jayl.de/g2/bazooka.php|240719<br /> U|http://www.dom2porno.info/skulls/skulls.php|207473<br /> U|http://gwc.frodoslair.net/skulls/skulls|125668<br /> U|http://holograph.uni.cc/other/skulls.php|9642<br /> <br /> <br /> * Variables<br /> o Mandatory<br /> + ping:<br /> # Main Part: I|pong|<br /> # Then add the cache name and version: I|pong|fakecache 0.01<br /> # Then lastly add the network support:<br /> * I|pong|fakecache 0.01|gnutella<br /> o - Gnutella only <br /> * I|pong|fakecache 0.01|gnutella2<br /> o - Gnutella2 only <br /> * I|pong|fakecache 0.01|gnutella-gnutella2<br /> o - Gnutella and Gnutella2 served <br /> + get:<br /> # Used by clients to requests alternate cache URLs along with IPs and their port numbers. <br /> + update:<br /> # url:<br /> * Client update giving an alternate cache URL.<br /> * Formatted with a http:// prefix to each cache. <br /> # ip:<br /> * Client update giving one's IP to submit. <br /> + net:<br /> # Which network to serve the client.<br /> * Gnutella<br /> o Ex: net=gnutella <br /> * Gnutella2<br /> o Ex: net=gnutella2 <br /> * Should always be lowercase<br /> o GWCs should automatically convert network name given to lowercase to prevent Net ID mismatches <br /> <br /> solely on case alone.<br /> <br /> *<br /> o<br /> + client:<br /> # Four letter code of the client. ex: RAZA <br /> + version:<br /> # Version number of the client. <br /> o Optional<br /> + cluster:<br /> # To add extra info to an IP update.<br /> * Output by cache: H|0.0.0.0|AGE OF HOST (Seconds)|clustering some bull**** <br /> + statfile:<br /> # Exactly like the specification 1 statfile (Same routine and output style).<br /> # Statistics of the cache request:<br /> * First line: Total requests of the cache number.<br /> * Second line: Requests of the cache an hour number.<br /> * Third line: Updates of the cache an hour number. <br /> <br /> Specification 2.1<br /> <br /> * This is an extension of specification 2, not a separate specification!<br /> * Pong extension<br /> o Append the networks supported joined by a hyphen '-'.<br /> o Used for client-side validation of networks supported and for network support reporting to other web caches.<br /> o Format:<br /> + I|pong|cache name|network names joined by '-'<br /> + Format Examples:<br /> # I|pong|fakecache 0.01|gnutella<br /> * - Gnutella only <br /> # I|pong|fakecache 0.01|gnutella2<br /> * - Gnutella2 only <br /> # I|pong|fakecache 0.01|gnutella-gnutella2<br /> * - Gnutella and Gnutella2 served <br /> * Host Output<br /> o Just like specification 2, but with more fields supported for host output.<br /> + H|ip:port|age in cache|clustering|leaves|4 letter vendor code|reported uptime of host|max. leaves possible<br /> # The host, age, and clustering fields are all still the same as in specification 2.<br /> # The leaf count of the hub reported is in the 5th field.<br /> # The vendor code with version number is in the 6th field. <br /> * Request Control Variables:<br /> o getleaves<br /> + Used to obtain leaf counts of hubs given<br /> + 4th field ultilized for current leaf count.<br /> + 7th field ultilized for maximum leaf slots possible.<br /> + Use this as 'getleaves=1' or 'getleaves' to enable. <br /> o getclusters<br /> + Enables/Disables clustering.<br /> + Use this as 'getclusters=1'.<br /> + Using 'getclusters' or 'getclusters=0' disables cluster output. <br /> o getvendors<br /> + Used to obtain the vendor code w/ version number of the hubs given.<br /> + Found in the 5th field.<br /> + Use this as 'getvendors=1' or 'getvendors' to enable. <br /> o getuptime<br /> + Used to obtain the vendor code w/ version number of the hubs given.<br /> + Value is static, do not change the value given when time passes.<br /> + Found in the 6th field.<br /> + Use this as 'getuptime=1' or 'getuptime' to enable. <br /> o spec<br /> + To force the specification parameter<br /> + Currently is only supported by Beacon Cache II <br /> o pv<br /> + Similar to the 'spec' parameter, except that it does not force, instead it simply negotiates the specification. <br /> * Special Data Requests<br /> o info<br /> + Outputs extra details of your cache.<br /> # Start with the informational response: I|<br /> * Ex: I|open-source|1 <br /> o support<br /> + Outputs USEFUL details of your cache.<br /> # Start with the informational response: I|<br /> * Ex: I|support|gnutella2 <br /> o getnetworks<br /> + Outputs the enabled networks in two formats.<br /> # Start with the informational response: I|<br /> * For the 'I|nets|' line<br /> o The third field contains the supported networks joined by '-'. <br /> * For the 'I|networks|' line<br /> o Interpret the fields from 3 and beyond as individual network names to challenge against. <br /> # Examples<br /> *<br /> o I|nets|gnutella-gnutella2<br /> o I|networks|gnutella|gnutella2 <br /> * Update Extension Variables:<br /> o x_leaves<br /> + Number of leaves running on a given hub or ultrapeer.<br /> + Value must not be greater than an integer value of 2047.<br /> + Note: It is important to know that PHP automaticaly replace dots with underscores, so to keep compatibility with old/new version of clients all caches should support both variants, example: x.leaves x_leaves<br /> o x_max<br /> + Maximum number of leaves possible on a given hub or ultrapeer.<br /> + Value must not be greater than an integer value of 2047. <br /> o uptime<br /> + Value submitted must be an integer value of the number of seconds of uptime.<br /> + Value must not be greater than an integer value of 1 year (31536000) and less than 1 hour (60). <br /> <br /> Pinging Caches With Your Cache<br /> <br /> * Please follow this standard:<br /> o Client: TEST<br /> o Version: Your Cache's Name<br /> + The old value for &quot;version&quot; was 1 <br /> * Some variables to attach to the ping (compatibility):<br /> o multi<br /> + Used by some gwcs in their pings to other gwcs.<br /> + It tells the pinged cache to ignore the &quot;net&quot; parameter (so it should never say network not supported) and outputting the pong using this format, if possible, &quot;I|pong|[cache name] [cache version]|[supported networks list]|[url adding is enabled]&quot; - example: I|pong|Skulls 0.2.8a|gnutella-gnutella2|1<br /> + Used by Skulls GWC only, supported by Skulls and Beacon Cache II. <br /> o cache<br /> + This is added to every request made by some gwcs, it is for statistical purposes only.<br /> + It simply tells the remote cache that the client is a GWC. <br /> * Help<br /> o For PHP<br /> + Use the fsockopen() function to open a connection to a cache.<br /> # Make sure you &quot;write&quot; to the fsockopen carry value to open the GWC's target file.<br /> * http://us.php.net/manual/en/function.fsockopen.php <br /> <br /> Variable Combination Standards<br /> <br /> * Net variable decides specification!<br /> o There are many ways to determine spec., but going with net is the safe way.<br /> o Skulls GWC does not use the network parameter to determine specification level.<br /> o Beacon Cache (I and II) uses the network parameter to determine the specification level. <br /> * Your cache needs to be able to process certain combinations of variables.<br /> o Update variable<br /> + Update should not fail if absent if spec. 2.<br /> # A Specification 2 parameter. <br /> * Spec 1 parameters used in Spec 2:<br /> o Should still accept hostfile and urlfile responses for spec. 2.<br /> + Beacon Cache (I and II) accepts these parameters on spec 2. <br /> * The 'spec' paameter can be used to force a specification:<br /> o Only known to exist in Beacon Cache II, it can force the request to be handled as a specification 1 or 2 request.<br /> o Spec 1 = 'spec=1'<br /> o Spec 2 = 'spec=2'<br /> o If 'spec' is not equal to any current spec, then default to the predetermined spec. <br /> * Multiple variable requests<br /> o If for instance a ping and request exist, you should always handle them properly.<br /> + Same goes with other combos like an update and ping, statfile + ping and info. <br /> o Handle multiple variables as BEST as possible!<br /> + Some scanners and GWCs like to fit all their requests into one URL send. <br /> <br /> &lt;row recovery, end&gt; <br /> <br /> Further Information:<br /> <br /> * [http://www.gnucleus.com/gwebcache/ Original GWC site]<br /> ** [http://gnucleus.sourceforge.net/gwebcache/specs.html GWC Spec. 1]<br /> ** [http://gnucleus.sourceforge.net/gwebcache/newgwc.html GWC Spec. 2] <br /> <br /> <br /> <br /> <br /> <br /> &lt;content recovered from last aviable backup&gt; <br /> <br /> ===Gnutella Web Cache===<br /> Gnutella requires Gnutella Web Caches (GWC) to get IPs to establish a connection to the network. These are critical to ensuring the health of the network. If you have a dedicated server and can spare some extra bandwidth then please consider running a GWC. People that don't have a dedicated server or are on normal broadband consumer lines should not run a cache from home.<br /> <br /> A GWC is a simple script that can be put on any webserver that supports one of the following scripting languages:<br /> *JSP (Java Servlet)<br /> **[http://web.archive.org/web/20061108091447/http://www.mager.org/GWebCache/ Java Servlet GWebCache Application (Archive.org)]<br /> *C<br /> **[http://ghostwhitecrab.com/crab/ GhostWhiteCrab]<br /> *Perl <br /> **[http://www.jonatkins.com/perlgcache/ Jon Atkins' perlgcache] <br /> **The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache]<br /> *PHP <br /> **[http://gwcii.sourceforge.net/ PHPGnuCacheII] - MySQL<br /> **[http://www.bazookanetworks.com Bazooka G2WC] (recommended) - flat files<br /> **[http://sourceforge.net/projects/skulls/ Skulls! Multi-Network WebCache] - flat files<br /> === Further Information: ===<br /> * [http://www.gnucleus.com/gwebcache/ Original GWC site]<br /> <br /> [[Category:External Links]]</div>

Ale5000 https://shareaza.sourceforge.net/w/index.php?title=GWC_specs&diff=11509 2015-04-01T23:28:32Z

<p>Ale5000: Fixed GhostWhiteCrab link</p> <hr /> <div>''For general information on GWCs, have a look at the [[GWC]] Wiki page.''<br /> {{do not translate}}<br /> This page is thought to give an overview over the GWC specifications as they are implemented into Shareaza.<br /> <br /> A GWC is a simple script that can be put on any webserver that supports one of the following scripting languages: <br /> <br /> * JSP (Java Servlet) <br /> ** [http://www1.mager.org/GWebCache/ Jums Web Cache] (Excellent for heavy loads) <br /> * C <br /> ** [http://sourceforge.net/projects/frostwire/files/GhostWhiteCrab/ GhostWhiteCrab] (For dedicated server environments and people who know how to compile C source code!) <br /> * ASP <br /> ** [http://www.edazzle.net/downloads/gerry.zip Gerry GWC] <br /> ** [https://www.planet-source-code.com/vb/scripts/ShowCode.asp?txtCodeId=7846&amp;lngWId=4 Lynn (v.s. 0.5)] <br /> ** [https://www.planet-source-code.com/vb/scripts/ShowCode.asp?txtCodeId=7731&amp;lngWId=4 Lynn (v.s. 0.4)] <br /> ** [http://www.poundwebhosting.com/cgi-bin/lynnx.asp LynnX] <br /> * Perl <br /> ** [http://www.jonatkins.com/perlgcache/ Jon Atkins' perlgcache] <br /> ** The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache] <br /> * '''PHP''' ''(Tip: PHP GWCs are usually the easiest to run and setup on a server.)''<br /> ** [http://gwcii.sourceforge.net/ PHPGnuCacheII] <br /> ** Bazooka G2WC<br /> ** [http://sourceforge.net/projects/skulls/ Skulls! Multi-Network WebCache] <br /> ** [http://sourceforge.net/projects/beaconcache/ Beacon Cache] <br /> ** [http://code.google.com/p/cachechu/ Cachechu G2WC] <br /> ** The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache] ''(PHP version is no longer supported)'' <br /> <br /> == Breakdown Of The Gnutella Web Caches: == <br /> {{RecoveredPage|I recently put this into a table. The contents need to be verified -- [[User:Cyko 01|Cyko 01]]}}<br /> <br /> {| width= auto; style=&quot;font-size: 85%; text-align: center;text-valign: middle;&quot; class=&quot;wikitable&quot;<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Cache:<br /> ! rowspan=1 |Gnutella:<br /> ! rowspan=1 |Gnutella2:<br /> ! rowspan=1 |Spec 1:<br /> ! rowspan=1 |Spec 2:<br /> ! rowspan=1 |Flat-File:<br /> ! rowspan=1 |SQL:<br /> ! rowspan=1 |Installer:<br /> ! rowspan=1 |Other Networks:<br /> ! rowspan=1 |Different network instances:<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Beacon Cache (Core 2)<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> |style=&quot;background: #CCFFCC;&quot;| Yes (As of 0.2.0 Alpha)<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Beacon Cache (Core 1)<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Skulls<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|JumsWebCache<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|GnuWebCache (Perl)<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|GnuWebCache (PHP) <br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|GhostWhiteCrab(GWC) <br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> |style=&quot;background: #FFFFCC;&quot;| N/A<br /> |style=&quot;background: #FFFFCC;&quot;| N/A<br /> |style=&quot;background: #FFFFCC;&quot;| N/A<br /> | {{yes}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|PHPGnuCacheII <br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Bazooka <br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Cachechu<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Perlgcache<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Gerry GWC (v2)<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Gerry GWC (v1)<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Lynn<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|LynnX<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |}<br /> <br /> == Shareaza Specific Details == <br /> <br /> {{RecoveredPage|Warninig: here I have pasted better formatted recovery, but not verified. Row recovery has been mooved below as I don't know if anybody has made any changes in it. If not then row recovery can be deleted. Paste starts from &gt;&gt;Shareaza Specific Details&lt;&lt;, here, and ends at second &gt;&gt;Shareaza Specific Details&lt;&lt; I hope it is visible. --[[User:Ocexyz|Ocexyz]] 23:27, 27 July 2009 (UTC)}}<br /> <br /> '''Get String Breakdown:''' <br /> * Update a leaf <br /> ** &quot;?update=1&amp;ip=(ip):(port)&amp;x_leaves=(leaf count) <br /> * Ping Variable <br /> ** Appends &amp;ping=1 to identify the cache name in debug messages (for gnutella and gnutella2 in 2.4.0.0, but only for gnutella2 now in 2.4.0.X for spec1 cache compatibility). <br /> ** This feature new to Shareaza. <br /> * Network Variable <br /> ** Appends &amp;net=gnutella2 on Gnutella2 queries. <br /> ** Does NOT append a network variable on Gnutella(1) queries. <br /> * Client Name / Version Format (2.4.0.0 and earlier): <br /> ** &amp;client=(Shareaza 4 letter code (RAZA / RAZB) ) <br /> ** &amp;version=(Shareaza's version) <br /> * Client Name / Version Format (2.4.0.X): <br /> ** If Gnutella <br /> *** &amp;client=(Shareaza 4 letter code (RAZA / RAZB) ) <br /> *** &amp;version=(Shareaza's version) <br /> ** If Gnutella2 <br /> *** &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )+(Shareaza's version) <br /> <br /> '''GWC Response Matching:''' <br /> * i| <br /> ** Informational output alone will not be taken as GWC 'success.' <br /> * i|access|period|(time in sec.) <br /> ** Time in seconds before Shareaza is allowed to make a request to the cache. <br /> * i|update|period|(time in sec.) <br /> ** Time in seconds before Shareaza is allowed to update to the cache. <br /> * i|force|remove and i|update|warning|bad url <br /> ** Remove the GWC from the internal list. <br /> * Some Response Matches (added in 2.3.1.X) <br /> ** i|NO-URL-NO-HOSTS <br /> *** Outputs warning of the cache being totally empty to the system log. <br /> ** i|NO-URL <br /> *** Outputs warning of the cache having no alternative URLs to the system log. <br /> ** i|NO-HOSTS <br /> *** Outputs warning of the cache having no hosts to the system log. <br /> ** i|warning| <br /> *** Outputs warning of the cache to the system log. <br /> ** ERROR Something Failed <br /> *** Outputs warning of the cache to the system log(Buggy Bazooka GWCs workaround). <br /> ** i|warning|You came back too early (2.3.1.X) <br /> ** i|warning|client|early (2.3.1.X) <br /> ** WARNING: You came back too early (2.3.1.X) <br /> ** ERROR: Client returned too early (2.3.1.X) <br /> *** Flood detection for the update side. <br /> *** Outputs GWebCache(update) Too many connection attempts to the system log. <br /> ** too early (2.3.1.X) <br /> ** early (2.4.0.X) <br /> *** Flood detection for the request side. <br /> *** Outputs GWebCache URL: Too many connection attempts to the system log. <br /> ** i|update|OK <br /> *** Outputs &quot;GWebCache(v2) Update Passed: &quot; to the system log. <br /> ** OK <br /> *** Outputs &quot;GWebCache(v1) Update Passed: &quot; to the system log. <br /> <br /> == Gnutella Web Cache Specifications ==<br /> ==== Specification 1: ====<br /> * '''Networks Served''' <br /> ** Gnutella <br /> * '''Format''' <br /> ** Update went fine: <br /> *** Ex: OK <br /> ** Update Warning (Small prob., not that bad): <br /> *** Ex: OKWARNING: Error Message <br /> <br /> * Severe Warning (No 'OK' message sent) <br /> ** Ex: WARNING: Error Message<br /> <br /> * URL Output: <br /> ** Ex: [http://somefreakinrandomcache.com/cache/gcache.php http://somefreakinrandomcache.com/cache/gcache.php] <br /> *** OR - WITH A PORT NUMBER (If not 80) <br /> **** Ex: [http://somefreakinrandomcache.com:8080/cache/gcache.php http://somefreakinrandomcache.com:8080/cache/gcache.php] <br /> * Host Output: <br /> ** Ex: 66.132.55.12:6346 <br /> * Pong (ping variable response) - was explained below under the topic: variables. <br /> * '''Example Cache Output (Beacon Cache) For urlfile Command''' <br /> ** Example &quot;urlfile Output&quot; URL: Ex: [http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;urlfile=1 http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;urlfile=1] <br /> *** Example URL Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting urls with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | PONG Beacon Cache 0.1.5D Beta[http://gwc.frodoslair.net/skulls/skulls.php http://gwc.frodoslair.net/skulls/skulls.php][http://bbs.robertwoolley.co.uk/GWebCache/gcache.php http://bbs.robertwoolley.co.uk/GWebCache/gcache.php][http://g2.tjtech.org/g2/ http://g2.tjtech.org/g2/][http://g2.tjtech.org/g2/index.php http://g2.tjtech.org/g2/index.php][http://gwc.monnsta.net/ http://gwc.monnsta.net/][http://holograph.uni.cc/other/skulls.php http://holograph.uni.cc/other/skulls.php][http://gwc.nickstallman.net/ http://gwc.nickstallman.net/][http://gwc.eod.cc/skulls.php http://gwc.eod.cc/skulls.php][http://gwc.frodoslair.net/skulls/skulls http://gwc.frodoslair.net/skulls/skulls][http://gwc.werwin.net/skulls.php http://gwc.werwin.net/skulls.php] <br /> <br /> |}<br /> * '''Example Cache Output (Beacon Cache) For hostfile Command''' <br /> ** Example &quot;hostfile Output&quot; URL: Ex: [http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;hostfile=1 http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;hostfile=1] <br /> *** Example Host Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting the hosts with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | PONG Beacon Cache 0.1.5D Beta71.8.84.153:391599.248.214.157:2752969.60.241.55:16369193.253.239.246:3021868.156.175.121:634871.179.7.241:1834474.196.22.241:634812.210.197.194:10531222.150.143.77:1000058.85.231.135:634624.141.199.164:2020572.175.201.195:634869.81.129.228:488097.81.221.63:1321970.15.130.224:7759216.211.188.106:5190375.167.168.156:4866012.214.14.3:3591676.177.244.106:2418098.165.218.139:3963068.112.182.125:368568.117.204.57:2348265.12.154.25:4076069.180.47.169:571175.138.40.173:2498798.201.19.0:3366270.187.2.144:634868.186.209.107:1442969.159.7.61:634876.208.176.196:48199<br /> <br /> |}<br /> * '''For combining a hostfile and urlfile request:''' <br /> ** Warning: This is non-standard. <br /> ** '''Example Cache Output (Beacon Cache) For bfile Command''' <br /> *** Example &quot;bfile Output&quot; URL: Ex: [http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;bfile=1 http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;bfile=1] <br /> **** Example Host and URL Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting the hosts and urls with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | PONG Beacon Cache 0.1.5D Beta71.8.84.153:391599.248.214.157:2752969.60.241.55:16369193.253.239.246:3021868.156.175.121:634871.179.7.241:1834474.196.22.241:634812.210.197.194:10531222.150.143.77:1000058.85.231.135:634624.141.199.164:2020572.175.201.195:634869.81.129.228:488097.81.221.63:1321970.15.130.224:7759216.211.188.106:5190375.167.168.156:4866012.214.14.3:3591676.177.244.106:2418098.165.218.139:3963068.112.182.125:368568.117.204.57:2348265.12.154.25:4076069.180.47.169:571175.138.40.173:2498798.201.19.0:3366270.187.2.144:634868.186.209.107:1442969.159.7.61:634876.208.176.196:48199[http://gwc.frodoslair.net/skulls/skulls.php http://gwc.frodoslair.net/skulls/skulls.php][http://bbs.robertwoolley.co.uk/GWebCache/gcache.php http://bbs.robertwoolley.co.uk/GWebCache/gcache.php][http://g2.tjtech.org/g2/ http://g2.tjtech.org/g2/][http://g2.tjtech.org/g2/index.php http://g2.tjtech.org/g2/index.php][http://gwc.monnsta.net/ http://gwc.monnsta.net/][http://holograph.uni.cc/other/skulls.php http://holograph.uni.cc/other/skulls.php][http://gwc.nickstallman.net/ http://gwc.nickstallman.net/][http://gwc.eod.cc/skulls.php http://gwc.eod.cc/skulls.php][http://gwc.frodoslair.net/skulls/skulls http://gwc.frodoslair.net/skulls/skulls][http://gwc.werwin.net/skulls.php http://gwc.werwin.net/skulls.php] <br /> <br /> |}<br /> '''Variables''' <br /> * '''Mandatory''' <br /> ** ping: <br /> *** Response should have this always: PONG<br /> *** After, put the cache's name. ex: PONG fakecache 0.01<br /> ** client: <br /> *** Four letter code of the client. ex: RAZA <br /> ** version: <br /> *** Version number of the client. <br /> ** urlfile: <br /> *** Used by the client to request alternate cache urls. <br /> ** hostfile: <br /> *** Used by the client to request IPs with port numbers attached. <br /> ** url: <br /> *** Client update giving an alternate cache URL. <br /> *** Formatted with a http:// prefix to each cache. <br /> ** ip: <br /> *** Client update giving one's IP to submit. <br /> ** url1: <br /> *** OLD OUTDATED Client update giving an alternate cache URL. <br /> *** Formatted with a http:// prefix to each cache. <br /> ** ip1: <br /> *** OLD OUTDATED Client update giving one's IP to submit. <br /> * '''Optional''' <br /> ** bfile: <br /> *** For clients to request both URLs and IPs from the cache at the same time. <br /> ** statfile: <br /> *** Statistics of the cache request: <br /> **** First line: Total requests of the cache number. <br /> **** Second line: Requests of the cache an hour number. <br /> **** Third line: Updates of the cache an hour number.<br /> <br /> ==== Specification 2: ====<br /> '''Networks Served''' <br /> * Gnutella, Gnutella2, etc. <br /> '''Format''' <br /> * '''Information Output''' <br /> ** Starts with: I| <br /> *** '''Categories''' <br /> **** '''Pong''' (ping variable response) - Described below under the topic: variables. <br /> **** '''Update Status Response''' <br /> ***** Format: I|update <br /> ***** '''Responses''' <br /> ****** I|update|OK <br /> ******* - Everything went fine. <br /> ****** I|update|OK|WARNING <br /> ******* Small warning. <br /> ****** I|update|WARNING <br /> ******* Severe warning <br /> **** '''Plain Warnings''' <br /> ***** Format: I|WARNING <br /> ****** Append any warning messages after it - Ex: I|WARNING|You came back too early <br /> **** '''Extra Info''' - Described below under the topic: variables. <br /> * '''Host Output''' <br /> ** Starts with: H| <br /> ** Add the IP with its port: <br /> *** Ex: H|0.0.0.0:6346 <br /> ** Add the time, thereafter, of the host's (In seconds*) time in cache: <br /> *** Ex: H|0.0.0.0:6346|45 <br /> ** If cluster exists with cluster=somerandomwords <br /> *** Add the clustered words after the host's age: <br /> **** Ex: H|0.0.0.0:6346|45|somerandomwords <br /> * '''URL Output''' <br /> ** Starts with: U| <br /> ** Add the URL with http:// before it, plus the port (if it's not 80). <br /> *** Ex: U|[http://somerandomcache.com/ http://somerandomcache.com/] <br /> ** Add the time, thereafter, of the URL's time (In seconds*) in cache: <br /> *** Ex: U|[http://somerandomcache.com/%7C45 http://somerandomcache.com/|45] <br /> * '''Example Cache Output (Beacon Cache) For get Command''' <br /> ** Example URL: [http://grantgalitz.com/Beacon/gwc.php?get=1&amp;client=RAZA&amp;version=2.3.1.3&amp;net=gnutella2&amp;ping=1 http://grantgalitz.com/Beacon/gwc.php?get=1&amp;client=RAZA&amp;version=2.3.1.3&amp;net=gnutella2&amp;ping=1] <br /> *** Example &quot;Get&quot; Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting the hosts and urls with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | I|pong|Beacon Cache 0.1.5D Beta|gnutella-gnutella2H|65.9.200.243:4968|248261H|68.228.129.75:44599|242678H|98.240.196.122:8206|240719H|76.104.12.133:14921|218273H|69.136.1.12:3924|211610H|81.154.208.71:8595|174402H|97.96.105.51:2076|153610H|74.192.153.212:39340|144203H|72.190.106.57:12584|132984H|78.93.71.132:12334|125668H|82.43.248.184:27560|97974H|196.205.224.97:6357|86763H|74.129.219.30:33172|82005H|76.104.12.133:19185|57182H|69.59.83.131:18442|38628U|[http://www.k33bz.com/g2/bazooka.php%7C248639 http://www.k33bz.com/g2/bazooka.php|248639]U|[http://gwebcache.ns1.net/%7C248592 http://gwebcache.ns1.net/|248592]U|[http://gwc2.wodi.org/skulls.php%7C248384 http://gwc2.wodi.org/skulls.php|248384]U|[http://gwc.guufshop.com/skulls/skulls.php%7C248322 http://gwc.guufshop.com/skulls/skulls.php|248322]U|[http://groovy.syxy.com/up/skulls.php%7C248300 http://groovy.syxy.com/up/skulls.php|248300]U|[http://g2.tjtech.org/g2/index.php%7C247770 http://g2.tjtech.org/g2/index.php|247770]U|[http://midian.jayl.de/g2/bazooka.php%7C240719 http://midian.jayl.de/g2/bazooka.php|240719]U|[http://www.dom2porno.info/skulls/skulls.php%7C207473 http://www.dom2porno.info/skulls/skulls.php|207473]U|[http://gwc.frodoslair.net/skulls/skulls%7C125668 http://gwc.frodoslair.net/skulls/skulls|125668]U|[http://holograph.uni.cc/other/skulls.php%7C9642 http://holograph.uni.cc/other/skulls.php|9642] <br /> <br /> |}<br /> '''Variables''' <br /> * '''Mandatory''' <br /> ** ping: <br /> *** Main Part: I|pong| <br /> *** Then add the cache name and version: I|pong|fakecache 0.01 <br /> *** Then lastly add the network support: <br /> **** I|pong|fakecache 0.01|gnutella <br /> ***** - Gnutella only <br /> **** I|pong|fakecache 0.01|gnutella2 <br /> ***** - Gnutella2 only <br /> **** I|pong|fakecache 0.01|gnutella-gnutella2 <br /> ***** - Gnutella and Gnutella2 served <br /> ** get: <br /> *** Used by clients to requests alternate cache URLs along with IPs and their port numbers. <br /> ** update: <br /> *** url: <br /> **** Client update giving an alternate cache URL. <br /> **** Formatted with a http:// prefix to each cache. <br /> *** ip: <br /> **** Client update giving one's IP to submit. <br /> ** net: <br /> *** Which network to serve the client. <br /> **** Gnutella <br /> ***** Ex: net=gnutella <br /> **** Gnutella2 <br /> ***** Ex: net=gnutella2 <br /> **** '''Should always be lowercase''' <br /> ***** GWCs should automatically convert network name given to lowercase to prevent Net ID mismatches <br /> <br /> solely on case alone. <br /> <br /> <br /> * <br /> ** client: <br /> *** Four letter code of the client. ex: RAZA <br /> ** version: <br /> *** Version number of the client. <br /> * '''Optional''' <br /> ** cluster: <br /> *** To add extra info to an IP update. <br /> **** Output by cache: H|0.0.0.0|AGE OF HOST (Seconds)|clustering some bull**** <br /> ** statfile: <br /> *** Exactly like the specification 1 statfile '''(Same routine and output style)'''. <br /> *** Statistics of the cache request: <br /> **** First line: Total requests of the cache number. <br /> **** Second line: Requests of the cache an hour number. <br /> **** Third line: Updates of the cache an hour number. <br /> <br /> ==== Specification 2.1 ====<br /> '''This is an extension of specification 2, not a separate specification!''' <br /> Pong extension <br /> * Append the networks supported joined by a hyphen '-'. <br /> * Used for client-side validation of networks supported and for network support reporting to other web caches. <br /> * Format: <br /> ** I|pong|cache name|network names joined by '-' <br /> ** Format Examples: <br /> *** I|pong|fakecache 0.01|gnutella <br /> **** - Gnutella only <br /> *** I|pong|fakecache 0.01|gnutella2 <br /> **** - Gnutella2 only <br /> *** I|pong|fakecache 0.01|gnutella-gnutella2 <br /> **** - Gnutella and Gnutella2 served <br /> Host Output <br /> * Just like specification 2, but with more fields supported for host output. <br /> ** H|ip:port|age in cache|clustering|leaves|4 letter vendor code|reported uptime of host|max. leaves possible <br /> *** The host, age, and clustering fields are all still the same as in specification 2. <br /> *** The leaf count of the hub reported is in the 5th field. <br /> *** The vendor code with version number is in the 6th field. <br /> Request Control Variables: <br /> * getleaves <br /> ** Used to obtain leaf counts of hubs given <br /> ** 4th field ultilized for current leaf count. <br /> ** 7th field ultilized for maximum leaf slots possible. <br /> ** Use this as 'getleaves=1' or 'getleaves' to enable. <br /> * getclusters <br /> ** Enables/Disables clustering. <br /> ** Use this as 'getclusters=1'. <br /> ** Using 'getclusters' or 'getclusters=0' disables cluster output. <br /> * getvendors <br /> ** Used to obtain the vendor code w/ version number of the hubs given. <br /> ** Found in the 5th field. <br /> ** Use this as 'getvendors=1' or 'getvendors' to enable. <br /> * getuptime <br /> ** Used to obtain the vendor code w/ version number of the hubs given. <br /> ** Value is static, do not change the value given when time passes. <br /> ** Found in the 6th field. <br /> ** Use this as 'getuptime=1' or 'getuptime' to enable. <br /> * spec <br /> ** To force the specification parameter <br /> ** Currently is only supported by Beacon Cache II <br /> * pv <br /> ** Similar to the 'spec' parameter, except that it does not force, instead it simply negotiates the specification. <br /> Special Data Requests <br /> * info <br /> ** Outputs extra details of your cache. <br /> *** Start with the informational response: I| <br /> **** Ex: I|open-source|1 <br /> * support <br /> ** Outputs USEFUL details of your cache. <br /> *** Start with the informational response: I| <br /> **** Ex: I|support|gnutella2 <br /> * getnetworks <br /> ** Outputs the enabled networks in two formats. <br /> *** Start with the informational response: I| <br /> **** For the 'I|nets|' line <br /> ***** The third field contains the supported networks joined by '-'. <br /> **** For the 'I|networks|' line <br /> ***** Interpret the fields from 3 and beyond as individual network names to challenge against. <br /> *** Examples <br /> **** <br /> ***** I|nets|gnutella-gnutella2 <br /> ***** I|networks|gnutella|gnutella2 <br /> Update Extension Variables: <br /> * x_leaves <br /> ** Number of leaves running on a given hub or ultrapeer. <br /> ** '''Value must not be greater than an integer value of 2047.''' <br /> ** '''Note: It is important to know that PHP automaticaly replace dots with underscores, so to keep compatibility with old/new version of clients all caches should support both variants, example: x.leaves x_leaves''' <br /> * x_max <br /> ** Maximum number of leaves possible on a given hub or ultrapeer. <br /> ** '''Value must not be greater than an integer value of 2047.''' <br /> * uptime <br /> ** Value submitted must be an integer value of the number of seconds of uptime. <br /> ** '''Value must not be greater than an integer value of 1 year (31536000) and less than 1 hour (60).''' <br /> <br /> === Pinging Caches With Your Cache ===<br /> '''Please follow this standard:''' <br /> * '''Client: TEST''' <br /> * '''Version: Your Cache's Name''' <br /> ** The old value for &quot;version&quot; was 1 <br /> '''Some variables to attach to the ping (compatibility):''' <br /> * '''multi''' <br /> ** Used by some gwcs in their pings to other gwcs. <br /> ** &lt;nowiki&gt;It tells the pinged cache to ignore the &quot;net&quot; parameter (so it should never say network not supported) and outputting the pong using this format, if possible, &quot;I|pong|[cache name] [cache version]|[supported networks list]&quot; - example: I|pong|Skulls 0.2.9|gnutella-gnutella2 &lt;/nowiki&gt;<br /> ** Used by Skulls GWC only, supported by Skulls and Beacon Cache II. <br /> * '''cache''' <br /> ** This is added to every request made by some gwcs, it is for statistical purposes only. <br /> ** It simply tells the remote cache that the client is a GWC. <br /> '''Help''' <br /> * For PHP <br /> ** Use the fsockopen() function to open a connection to a cache. <br /> *** Make sure you &quot;write&quot; to the fsockopen carry value to open the GWC's target file. <br /> **** [http://us.php.net/manual/en/function.fsockopen.php http://us.php.net/manual/en/function.fsockopen.php] <br /> <br /> === Variable Combination Standards ===<br /> '''Net variable decides specification!''' <br /> * There are many ways to determine spec., but going with net is the safe way. <br /> * Skulls GWC does not use the network parameter to determine specification level. <br /> * Beacon Cache (I and II) uses the network parameter to determine the specification level. <br /> '''Your cache needs to be able to process certain combinations of variables.''' <br /> * Update variable <br /> ** Update should not fail if absent if spec. 2. <br /> *** A Specification 2 parameter. <br /> Spec 1 parameters used in Spec 2: <br /> * Should still accept hostfile and urlfile responses for spec. 2. <br /> ** Beacon Cache (I and II) accepts these parameters on spec 2. <br /> The 'spec' paameter can be used to force a specification: <br /> * Only known to exist in Beacon Cache II, it can force the request to be handled as a specification 1 or 2 request. <br /> * Spec 1 = 'spec=1' <br /> * Spec 2 = 'spec=2' <br /> * If 'spec' is not equal to any current spec, then default to the predetermined spec. <br /> '''Multiple variable requests''' <br /> * If for instance a ping and request exist, you should always handle them properly. <br /> ** Same goes with other combos like an update and ping, statfile + ping and info. <br /> * Handle multiple variables as BEST as possible! <br /> ** Some scanners and GWCs like to fit all their requests into one URL send. <br /> <br /> === Further Information: ===<br /> * [http://www.gnucleus.com/gwebcache/ Original GWC] [http://www.gnucleus.com/gwebcache/ site] <br /> ** [http://gnucleus.sourceforge.net/gwebcache/specs.html GWC Spec. 1] <br /> ** [http://gnucleus.sourceforge.net/gwebcache/newgwc.html GWC Spec. 2] <br /> <br /> === Gnutella Web Cache ===<br /> Gnutella requires Gnutella Web Caches (GWC) to get IPs to establish a connection to the network. These are critical to ensuring the health of the network. If you have a dedicated server and can spare some extra bandwidth then please consider running a GWC. People that don't have a dedicated server or are on normal broadband consumer lines should not run a cache from home.<br /> <br /> A GWC is a simple script that can be put on any webserver that supports one of the following scripting languages:<br /> *JSP (Java Servlet)<br /> **[http://web.archive.org/web/20061108091447/http://www.mager.org/GWebCache/ Java Servlet GWebCache Application (Archive.org)]<br /> *C<br /> **[http://ghostwhitecrab.com/crab/ GhostWhiteCrab]<br /> *Perl <br /> **[http://www.jonatkins.com/perlgcache/ Jon Atkins' perlgcache] <br /> **The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache]<br /> *PHP <br /> **[http://gwcii.sourceforge.net/ PHPGnuCacheII] - MySQL<br /> **[http://www.bazookanetworks.com Bazooka G2WC] (recommended) - flat files<br /> **[http://sourceforge.net/projects/skulls/ Skulls! Multi-Network WebCache] - flat files<br /> ====Further Information:====<br /> *[http://www.gnucleus.com/gwebcache/|Original GWC site]<br /> <br /> <br /> {{RecoveredPage|--&gt;Saved in timestamp 20090421202728Retrieved from &quot;[https://www.pantheraproject.net/wiki/index.php?title=GWC This page was last modified on April 18, 2009, at 23:25. &lt;/center&gt;<br /> <br /> &lt;center&gt;Copyright © 2002-2009 Shareaza Development Team. &lt;/center&gt;&lt;center&gt;[[Image:poweredby_mediawiki_88x31.png]] --[[User:Ocexyz|Ocexyz]] 16:20, 27 July 2009 (UTC)}}<br /> <br /> {{RecoveredPage|Warninig: here ends pasted better formatted recovery. Row recovery has been mooved below as I don't know if anybody has made any changes in it. If not then row recovery can be deleted I suppose. Paste starts from == Shareaza Specific Details == and ends at second == Shareaza Specific Details ==, here. I hope it is visible. --[[User:Ocexyz|Ocexyz]] 16:20, 27 July 2009 (UTC) }}<br /> <br /> ==Shareaza Specific Details==<br /> <br /> {{RecoveredPage|Warninig: here ends pasted better formatted recovery. Row recovery has been mooved below as I don't know if anybody has made any changes in it. If not then row recovery can be deleted I suppose. Paste starts from &gt;&gt;Shareaza Specific Details&lt;&lt; and ends at second &gt;&gt; Shareaza Specific Details&lt;&lt;, here. I hope it is visible. --[[User:Ocexyz|Ocexyz]] 23:27, 27 July 2009 (UTC) }}<br /> <br /> * Get String Breakdown:<br /> o Update a leaf<br /> + &quot;?update=1&amp;ip=(ip):(port)&amp;x_leaves=(leaf count) <br /> o Ping Variable<br /> + Appends &amp;ping=1 to identify the cache name in debug messages (for gnutella and gnutella2 in 2.4.0.0, but only for gnutella2 now in 2.4.0.X for spec1 cache compatibility).<br /> + This feature new to Shareaza. <br /> o Network Variable<br /> + Appends &amp;net=gnutella2 on Gnutella2 queries.<br /> + Does NOT append a network variable on Gnutella(1) queries. <br /> o Client Name / Version Format (2.4.0.0 and earlier):<br /> + &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )<br /> + &amp;version=(Shareaza's version) <br /> o Client Name / Version Format (2.4.0.X):<br /> + If Gnutella<br /> # &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )<br /> # &amp;version=(Shareaza's version) <br /> + If Gnutella2<br /> # &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )+(Shareaza's version) <br /> <br /> <br /> <br /> * GWC Response Matching:<br /> o i|<br /> + Informational output alone will not be taken as GWC 'success.' <br /> o i|access|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to make a request to the cache. <br /> o i|update|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to update to the cache. <br /> o i|force|remove and i|update|warning|bad url<br /> + Remove the GWC from the internal list. <br /> o Some Response Matches (added in 2.3.1.X)<br /> + i|NO-URL-NO-HOSTS<br /> # Outputs warning of the cache being totally empty to the system log. <br /> + i|NO-URL<br /> # Outputs warning of the cache having no alternative URLs to the system log. <br /> + i|NO-HOSTS<br /> # Outputs warning of the cache having no hosts to the system log. <br /> + i|warning|<br /> # Outputs warning of the cache to the system log. <br /> + ERROR Something Failed<br /> # Outputs warning of the cache to the system log(Buggy Bazooka GWCs workaround). <br /> + i|warning|You came back too early (2.3.1.X)<br /> + i|warning|client|early (2.3.1.X)<br /> + WARNING: You came back too early (2.3.1.X)<br /> + ERROR: Client returned too early (2.3.1.X)<br /> # Flood detection for the update side.<br /> # Outputs GWebCache(update) Too many connection attempts to the system log. <br /> + too early (2.3.1.X)<br /> + early (2.4.0.X)<br /> # Flood detection for the request side.<br /> # Outputs GWebCache URL: Too many connection attempts to the system log. <br /> + i|update|OK<br /> # Outputs &quot;GWebCache(v2) Update Passed: &quot; to the system log. <br /> + OK<br /> # Outputs &quot;GWebCache(v1) Update Passed: &quot; to the system log. <br /> <br /> <br /> <br /> * GWC Response Matching:<br /> o i|<br /> + Informational output alone will not be taken as GWC 'success.' <br /> o i|access|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to make a request to the cache. <br /> o i|update|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to update to the cache. <br /> o i|force|remove and i|update|warning|bad url<br /> + Remove the GWC from the internal list. <br /> o Some Response Matches (added in 2.3.1.X)<br /> + i|NO-URL-NO-HOSTS<br /> # Outputs warning of the cache being totally empty to the system log. <br /> + i|NO-URL<br /> # Outputs warning of the cache having no alternative URLs to the system log. <br /> + i|NO-HOSTS<br /> # Outputs warning of the cache having no hosts to the system log. <br /> + i|warning|<br /> # Outputs warning of the cache to the system log. <br /> + ERROR Something Failed<br /> # Outputs warning of the cache to the system log(Buggy Bazooka GWCs workaround). <br /> + i|warning|You came back too early (2.3.1.X)<br /> + i|warning|client|early (2.3.1.X)<br /> + WARNING: You came back too early (2.3.1.X)<br /> + ERROR: Client returned too early (2.3.1.X)<br /> # Flood detection for the update side.<br /> # Outputs GWebCache(update) Too many connection attempts to the system log. <br /> + too early (2.3.1.X)<br /> + early (2.4.0.X)<br /> # Flood detection for the request side.<br /> # Outputs GWebCache URL: Too many connection attempts to the system log. <br /> + i|update|OK<br /> # Outputs &quot;GWebCache(v2) Update Passed: &quot; to the system log. <br /> + OK<br /> # Outputs &quot;GWebCache(v1) Update Passed: &quot; to the system log. <br /> <br /> <br /> <br /> ==Gnutella Web Cache Specifications==<br /> &lt;end of partial recovery by OCE&gt;<br /> <br /> <br /> <br /> <br /> &lt;end of recovered content&gt;<br /> <br /> &lt;row recovery, start&gt; <br /> Specification 1:<br /> <br /> * Networks Served<br /> o Gnutella <br /> * Format<br /> o Update went fine:<br /> + Ex: OK <br /> o Update Warning (Small prob., not that bad):<br /> + Ex: <br /> <br /> OK<br /> WARNING: Error Message<br /> <br /> * Severe Warning (No 'OK' message sent)<br /> o Ex: <br /> <br /> WARNING: Error Message<br /> <br /> * URL Output:<br /> o Ex: http://somefreakinrandomcache.com/cache/gcache.php<br /> + OR - WITH A PORT NUMBER (If not 80)<br /> # Ex: http://somefreakinrandomcache.com:8080/cache/gcache.php <br /> * Host Output:<br /> o Ex: 66.132.55.12:6346 <br /> * Pong (ping variable response) - was explained below under the topic: variables.<br /> * Example Cache Output (Beacon Cache) For urlfile Command<br /> o Example &quot;urlfile Output&quot; URL: Ex: http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;urlfile=1<br /> + Example URL Output: <br /> <br /> <br /> Getting urls with a pong combined<br /> <br /> PONG Beacon Cache 0.1.5D Beta<br /> http://gwc.frodoslair.net/skulls/skulls.php<br /> http://bbs.robertwoolley.co.uk/GWebCache/gcache.php<br /> http://g2.tjtech.org/g2/<br /> http://g2.tjtech.org/g2/index.php<br /> http://gwc.monnsta.net/<br /> http://holograph.uni.cc/other/skulls.php<br /> http://gwc.nickstallman.net/<br /> http://gwc.eod.cc/skulls.php<br /> http://gwc.frodoslair.net/skulls/skulls<br /> http://gwc.werwin.net/skulls.php<br /> <br /> <br /> * Example Cache Output (Beacon Cache) For hostfile Command<br /> o Example &quot;hostfile Output&quot; URL: Ex: http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;hostfile=1<br /> + Example Host Output: <br /> <br /> <br /> Getting the hosts with a pong combined<br /> <br /> PONG Beacon Cache 0.1.5D Beta<br /> 71.8.84.153:3915<br /> 99.248.214.157:27529<br /> 69.60.241.55:16369<br /> 193.253.239.246:30218<br /> 68.156.175.121:6348<br /> 71.179.7.241:18344<br /> 74.196.22.241:6348<br /> 12.210.197.194:10531<br /> 222.150.143.77:10000<br /> 58.85.231.135:6346<br /> 24.141.199.164:20205<br /> 72.175.201.195:6348<br /> 69.81.129.228:4880<br /> 97.81.221.63:13219<br /> 70.15.130.224:7759<br /> 216.211.188.106:51903<br /> 75.167.168.156:48660<br /> 12.214.14.3:35916<br /> 76.177.244.106:24180<br /> 98.165.218.139:39630<br /> 68.112.182.125:3685<br /> 68.117.204.57:23482<br /> 65.12.154.25:40760<br /> 69.180.47.169:5711<br /> 75.138.40.173:24987<br /> 98.201.19.0:33662<br /> 70.187.2.144:6348<br /> 68.186.209.107:14429<br /> 69.159.7.61:6348<br /> 76.208.176.196:48199<br /> <br /> <br /> * For combining a hostfile and urlfile request:<br /> o Warning: This is non-standard.<br /> o Example Cache Output (Beacon Cache) For bfile Command<br /> + Example &quot;bfile Output&quot; URL: Ex: http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;bfile=1<br /> # Example Host and URL Output: <br /> <br /> <br /> Getting the hosts and urls with a pong combined<br /> <br /> PONG Beacon Cache 0.1.5D Beta<br /> 71.8.84.153:3915<br /> 99.248.214.157:27529<br /> 69.60.241.55:16369<br /> 193.253.239.246:30218<br /> 68.156.175.121:6348<br /> 71.179.7.241:18344<br /> 74.196.22.241:6348<br /> 12.210.197.194:10531<br /> 222.150.143.77:10000<br /> 58.85.231.135:6346<br /> 24.141.199.164:20205<br /> 72.175.201.195:6348<br /> 69.81.129.228:4880<br /> 97.81.221.63:13219<br /> 70.15.130.224:7759<br /> 216.211.188.106:51903<br /> 75.167.168.156:48660<br /> 12.214.14.3:35916<br /> 76.177.244.106:24180<br /> 98.165.218.139:39630<br /> 68.112.182.125:3685<br /> 68.117.204.57:23482<br /> 65.12.154.25:40760<br /> 69.180.47.169:5711<br /> 75.138.40.173:24987<br /> 98.201.19.0:33662<br /> 70.187.2.144:6348<br /> 68.186.209.107:14429<br /> 69.159.7.61:6348<br /> 76.208.176.196:48199<br /> http://gwc.frodoslair.net/skulls/skulls.php<br /> http://bbs.robertwoolley.co.uk/GWebCache/gcache.php<br /> http://g2.tjtech.org/g2/<br /> http://g2.tjtech.org/g2/index.php<br /> http://gwc.monnsta.net/<br /> http://holograph.uni.cc/other/skulls.php<br /> http://gwc.nickstallman.net/<br /> http://gwc.eod.cc/skulls.php<br /> http://gwc.frodoslair.net/skulls/skulls<br /> http://gwc.werwin.net/skulls.php<br /> <br /> <br /> * Variables<br /> o Mandatory<br /> + ping:<br /> # Response should have this always: PONG<br /> # After, put the cache's name. ex: PONG fakecache 0.01<br /> + client:<br /> # Four letter code of the client. ex: RAZA <br /> + version:<br /> # Version number of the client. <br /> + urlfile:<br /> # Used by the client to request alternate cache urls. <br /> + hostfile:<br /> # Used by the client to request IPs with port numbers attached. <br /> + url:<br /> # Client update giving an alternate cache URL.<br /> # Formatted with a http:// prefix to each cache. <br /> + ip:<br /> # Client update giving one's IP to submit. <br /> + url1:<br /> # OLD OUTDATED Client update giving an alternate cache URL.<br /> # Formatted with a http:// prefix to each cache. <br /> + ip1:<br /> # OLD OUTDATED Client update giving one's IP to submit. <br /> o Optional<br /> + bfile:<br /> # For clients to request both URLs and IPs from the cache at the same time. <br /> + statfile:<br /> # Statistics of the cache request:<br /> * First line: Total requests of the cache number.<br /> * Second line: Requests of the cache an hour number.<br /> * Third line: Updates of the cache an hour number. <br /> <br /> Specification 2:<br /> <br /> * Networks Served<br /> o Gnutella, Gnutella2, etc. <br /> * Format<br /> o Information Output<br /> + Starts with: I|<br /> # Categories<br /> * Pong (ping variable response) - Described below under the topic: variables.<br /> * Update Status Response<br /> o Format: I|update<br /> o Responses<br /> + I|update|OK<br /> # - Everything went fine. <br /> + I|update|OK|WARNING<br /> # Small warning. <br /> + I|update|WARNING<br /> # Severe warning <br /> * Plain Warnings<br /> o Format: I|WARNING<br /> + Append any warning messages after it - Ex: I|WARNING|You came back too early <br /> * Extra Info - Described below under the topic: variables. <br /> o Host Output<br /> + Starts with: H|<br /> + Add the IP with its port:<br /> # Ex: H|0.0.0.0:6346 <br /> + Add the time, thereafter, of the host's (In seconds*) time in cache:<br /> # Ex: H|0.0.0.0:6346|45 <br /> + If cluster exists with cluster=somerandomwords<br /> # Add the clustered words after the host's age:<br /> * Ex: H|0.0.0.0:6346|45|somerandomwords <br /> o URL Output<br /> + Starts with: U|<br /> + Add the URL with http:// before it, plus the port (if it's not 80).<br /> # Ex: U|http://somerandomcache.com/ <br /> + Add the time, thereafter, of the URL's time (In seconds*) in cache:<br /> # Ex: U|http://somerandomcache.com/|45 <br /> o Example Cache Output (Beacon Cache) For get Command<br /> + Example URL: http://grantgalitz.com/Beacon/gwc.php?get=1&amp;client=RAZA&amp;version=2.3.1.3&amp;net=gnutella2&amp;ping=1<br /> # Example &quot;Get&quot; Output: <br /> <br /> <br /> Getting the hosts and urls with a pong combined<br /> <br /> I|pong|Beacon Cache 0.1.5D Beta|gnutella-gnutella2<br /> H|65.9.200.243:4968|248261<br /> H|68.228.129.75:44599|242678<br /> H|98.240.196.122:8206|240719<br /> H|76.104.12.133:14921|218273<br /> H|69.136.1.12:3924|211610<br /> H|81.154.208.71:8595|174402<br /> H|97.96.105.51:2076|153610<br /> H|74.192.153.212:39340|144203<br /> H|72.190.106.57:12584|132984<br /> H|78.93.71.132:12334|125668<br /> H|82.43.248.184:27560|97974<br /> H|196.205.224.97:6357|86763<br /> H|74.129.219.30:33172|82005<br /> H|76.104.12.133:19185|57182<br /> H|69.59.83.131:18442|38628<br /> U|http://www.k33bz.com/g2/bazooka.php|248639<br /> U|http://gwebcache.ns1.net/|248592<br /> U|http://gwc2.wodi.org/skulls.php|248384<br /> U|http://gwc.guufshop.com/skulls/skulls.php|248322<br /> U|http://groovy.syxy.com/up/skulls.php|248300<br /> U|http://g2.tjtech.org/g2/index.php|247770<br /> U|http://midian.jayl.de/g2/bazooka.php|240719<br /> U|http://www.dom2porno.info/skulls/skulls.php|207473<br /> U|http://gwc.frodoslair.net/skulls/skulls|125668<br /> U|http://holograph.uni.cc/other/skulls.php|9642<br /> <br /> <br /> * Variables<br /> o Mandatory<br /> + ping:<br /> # Main Part: I|pong|<br /> # Then add the cache name and version: I|pong|fakecache 0.01<br /> # Then lastly add the network support:<br /> * I|pong|fakecache 0.01|gnutella<br /> o - Gnutella only <br /> * I|pong|fakecache 0.01|gnutella2<br /> o - Gnutella2 only <br /> * I|pong|fakecache 0.01|gnutella-gnutella2<br /> o - Gnutella and Gnutella2 served <br /> + get:<br /> # Used by clients to requests alternate cache URLs along with IPs and their port numbers. <br /> + update:<br /> # url:<br /> * Client update giving an alternate cache URL.<br /> * Formatted with a http:// prefix to each cache. <br /> # ip:<br /> * Client update giving one's IP to submit. <br /> + net:<br /> # Which network to serve the client.<br /> * Gnutella<br /> o Ex: net=gnutella <br /> * Gnutella2<br /> o Ex: net=gnutella2 <br /> * Should always be lowercase<br /> o GWCs should automatically convert network name given to lowercase to prevent Net ID mismatches <br /> <br /> solely on case alone.<br /> <br /> *<br /> o<br /> + client:<br /> # Four letter code of the client. ex: RAZA <br /> + version:<br /> # Version number of the client. <br /> o Optional<br /> + cluster:<br /> # To add extra info to an IP update.<br /> * Output by cache: H|0.0.0.0|AGE OF HOST (Seconds)|clustering some bull**** <br /> + statfile:<br /> # Exactly like the specification 1 statfile (Same routine and output style).<br /> # Statistics of the cache request:<br /> * First line: Total requests of the cache number.<br /> * Second line: Requests of the cache an hour number.<br /> * Third line: Updates of the cache an hour number. <br /> <br /> Specification 2.1<br /> <br /> * This is an extension of specification 2, not a separate specification!<br /> * Pong extension<br /> o Append the networks supported joined by a hyphen '-'.<br /> o Used for client-side validation of networks supported and for network support reporting to other web caches.<br /> o Format:<br /> + I|pong|cache name|network names joined by '-'<br /> + Format Examples:<br /> # I|pong|fakecache 0.01|gnutella<br /> * - Gnutella only <br /> # I|pong|fakecache 0.01|gnutella2<br /> * - Gnutella2 only <br /> # I|pong|fakecache 0.01|gnutella-gnutella2<br /> * - Gnutella and Gnutella2 served <br /> * Host Output<br /> o Just like specification 2, but with more fields supported for host output.<br /> + H|ip:port|age in cache|clustering|leaves|4 letter vendor code|reported uptime of host|max. leaves possible<br /> # The host, age, and clustering fields are all still the same as in specification 2.<br /> # The leaf count of the hub reported is in the 5th field.<br /> # The vendor code with version number is in the 6th field. <br /> * Request Control Variables:<br /> o getleaves<br /> + Used to obtain leaf counts of hubs given<br /> + 4th field ultilized for current leaf count.<br /> + 7th field ultilized for maximum leaf slots possible.<br /> + Use this as 'getleaves=1' or 'getleaves' to enable. <br /> o getclusters<br /> + Enables/Disables clustering.<br /> + Use this as 'getclusters=1'.<br /> + Using 'getclusters' or 'getclusters=0' disables cluster output. <br /> o getvendors<br /> + Used to obtain the vendor code w/ version number of the hubs given.<br /> + Found in the 5th field.<br /> + Use this as 'getvendors=1' or 'getvendors' to enable. <br /> o getuptime<br /> + Used to obtain the vendor code w/ version number of the hubs given.<br /> + Value is static, do not change the value given when time passes.<br /> + Found in the 6th field.<br /> + Use this as 'getuptime=1' or 'getuptime' to enable. <br /> o spec<br /> + To force the specification parameter<br /> + Currently is only supported by Beacon Cache II <br /> o pv<br /> + Similar to the 'spec' parameter, except that it does not force, instead it simply negotiates the specification. <br /> * Special Data Requests<br /> o info<br /> + Outputs extra details of your cache.<br /> # Start with the informational response: I|<br /> * Ex: I|open-source|1 <br /> o support<br /> + Outputs USEFUL details of your cache.<br /> # Start with the informational response: I|<br /> * Ex: I|support|gnutella2 <br /> o getnetworks<br /> + Outputs the enabled networks in two formats.<br /> # Start with the informational response: I|<br /> * For the 'I|nets|' line<br /> o The third field contains the supported networks joined by '-'. <br /> * For the 'I|networks|' line<br /> o Interpret the fields from 3 and beyond as individual network names to challenge against. <br /> # Examples<br /> *<br /> o I|nets|gnutella-gnutella2<br /> o I|networks|gnutella|gnutella2 <br /> * Update Extension Variables:<br /> o x_leaves<br /> + Number of leaves running on a given hub or ultrapeer.<br /> + Value must not be greater than an integer value of 2047.<br /> + Note: It is important to know that PHP automaticaly replace dots with underscores, so to keep compatibility with old/new version of clients all caches should support both variants, example: x.leaves x_leaves<br /> o x_max<br /> + Maximum number of leaves possible on a given hub or ultrapeer.<br /> + Value must not be greater than an integer value of 2047. <br /> o uptime<br /> + Value submitted must be an integer value of the number of seconds of uptime.<br /> + Value must not be greater than an integer value of 1 year (31536000) and less than 1 hour (60). <br /> <br /> Pinging Caches With Your Cache<br /> <br /> * Please follow this standard:<br /> o Client: TEST<br /> o Version: Your Cache's Name<br /> + The old value for &quot;version&quot; was 1 <br /> * Some variables to attach to the ping (compatibility):<br /> o multi<br /> + Used by some gwcs in their pings to other gwcs.<br /> + It tells the pinged cache to ignore the &quot;net&quot; parameter (so it should never say network not supported) and outputting the pong using this format, if possible, &quot;I|pong|[cache name] [cache version]|[supported networks list]|[url adding is enabled]&quot; - example: I|pong|Skulls 0.2.8a|gnutella-gnutella2|1<br /> + Used by Skulls GWC only, supported by Skulls and Beacon Cache II. <br /> o cache<br /> + This is added to every request made by some gwcs, it is for statistical purposes only.<br /> + It simply tells the remote cache that the client is a GWC. <br /> * Help<br /> o For PHP<br /> + Use the fsockopen() function to open a connection to a cache.<br /> # Make sure you &quot;write&quot; to the fsockopen carry value to open the GWC's target file.<br /> * http://us.php.net/manual/en/function.fsockopen.php <br /> <br /> Variable Combination Standards<br /> <br /> * Net variable decides specification!<br /> o There are many ways to determine spec., but going with net is the safe way.<br /> o Skulls GWC does not use the network parameter to determine specification level.<br /> o Beacon Cache (I and II) uses the network parameter to determine the specification level. <br /> * Your cache needs to be able to process certain combinations of variables.<br /> o Update variable<br /> + Update should not fail if absent if spec. 2.<br /> # A Specification 2 parameter. <br /> * Spec 1 parameters used in Spec 2:<br /> o Should still accept hostfile and urlfile responses for spec. 2.<br /> + Beacon Cache (I and II) accepts these parameters on spec 2. <br /> * The 'spec' paameter can be used to force a specification:<br /> o Only known to exist in Beacon Cache II, it can force the request to be handled as a specification 1 or 2 request.<br /> o Spec 1 = 'spec=1'<br /> o Spec 2 = 'spec=2'<br /> o If 'spec' is not equal to any current spec, then default to the predetermined spec. <br /> * Multiple variable requests<br /> o If for instance a ping and request exist, you should always handle them properly.<br /> + Same goes with other combos like an update and ping, statfile + ping and info. <br /> o Handle multiple variables as BEST as possible!<br /> + Some scanners and GWCs like to fit all their requests into one URL send. <br /> <br /> &lt;row recovery, end&gt; <br /> <br /> Further Information:<br /> <br /> * [http://www.gnucleus.com/gwebcache/ Original GWC site]<br /> ** [http://gnucleus.sourceforge.net/gwebcache/specs.html GWC Spec. 1]<br /> ** [http://gnucleus.sourceforge.net/gwebcache/newgwc.html GWC Spec. 2] <br /> <br /> <br /> <br /> <br /> <br /> &lt;content recovered from last aviable backup&gt; <br /> <br /> ===Gnutella Web Cache===<br /> Gnutella requires Gnutella Web Caches (GWC) to get IPs to establish a connection to the network. These are critical to ensuring the health of the network. If you have a dedicated server and can spare some extra bandwidth then please consider running a GWC. People that don't have a dedicated server or are on normal broadband consumer lines should not run a cache from home.<br /> <br /> A GWC is a simple script that can be put on any webserver that supports one of the following scripting languages:<br /> *JSP (Java Servlet)<br /> **[http://web.archive.org/web/20061108091447/http://www.mager.org/GWebCache/ Java Servlet GWebCache Application (Archive.org)]<br /> *C<br /> **[http://ghostwhitecrab.com/crab/ GhostWhiteCrab]<br /> *Perl <br /> **[http://www.jonatkins.com/perlgcache/ Jon Atkins' perlgcache] <br /> **The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache]<br /> *PHP <br /> **[http://gwcii.sourceforge.net/ PHPGnuCacheII] - MySQL<br /> **[http://www.bazookanetworks.com Bazooka G2WC] (recommended) - flat files<br /> **[http://sourceforge.net/projects/skulls/ Skulls! Multi-Network WebCache] - flat files<br /> === Further Information: ===<br /> * [http://www.gnucleus.com/gwebcache/ Original GWC site]<br /> <br /> [[Category:External Links]]</div>

Ale5000 https://shareaza.sourceforge.net/w/index.php?title=GWC_specs&diff=11508 2015-04-01T23:27:55Z

<p>Ale5000: Removed died link</p> <hr /> <div>''For general information on GWCs, have a look at the [[GWC]] Wiki page.''<br /> {{do not translate}}<br /> This page is thought to give an overview over the GWC specifications as they are implemented into Shareaza.<br /> <br /> A GWC is a simple script that can be put on any webserver that supports one of the following scripting languages: <br /> <br /> * JSP (Java Servlet) <br /> ** [http://www1.mager.org/GWebCache/ Jums Web Cache] (Excellent for heavy loads) <br /> * C <br /> ** [http://wiki.limewire.org/index.php?title=GhostWhiteCrab GhostWhiteCrab] (For dedicated server environments and people who know how to compile C source code!) <br /> * ASP <br /> ** [http://www.edazzle.net/downloads/gerry.zip Gerry GWC] <br /> ** [https://www.planet-source-code.com/vb/scripts/ShowCode.asp?txtCodeId=7846&amp;lngWId=4 Lynn (v.s. 0.5)] <br /> ** [https://www.planet-source-code.com/vb/scripts/ShowCode.asp?txtCodeId=7731&amp;lngWId=4 Lynn (v.s. 0.4)] <br /> ** [http://www.poundwebhosting.com/cgi-bin/lynnx.asp LynnX] <br /> * Perl <br /> ** [http://www.jonatkins.com/perlgcache/ Jon Atkins' perlgcache] <br /> ** The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache] <br /> * '''PHP''' ''(Tip: PHP GWCs are usually the easiest to run and setup on a server.)''<br /> ** [http://gwcii.sourceforge.net/ PHPGnuCacheII] <br /> ** Bazooka G2WC<br /> ** [http://sourceforge.net/projects/skulls/ Skulls! Multi-Network WebCache] <br /> ** [http://sourceforge.net/projects/beaconcache/ Beacon Cache] <br /> ** [http://code.google.com/p/cachechu/ Cachechu G2WC] <br /> ** The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache] ''(PHP version is no longer supported)'' <br /> <br /> == Breakdown Of The Gnutella Web Caches: == <br /> {{RecoveredPage|I recently put this into a table. The contents need to be verified -- [[User:Cyko 01|Cyko 01]]}}<br /> <br /> {| width= auto; style=&quot;font-size: 85%; text-align: center;text-valign: middle;&quot; class=&quot;wikitable&quot;<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Cache:<br /> ! rowspan=1 |Gnutella:<br /> ! rowspan=1 |Gnutella2:<br /> ! rowspan=1 |Spec 1:<br /> ! rowspan=1 |Spec 2:<br /> ! rowspan=1 |Flat-File:<br /> ! rowspan=1 |SQL:<br /> ! rowspan=1 |Installer:<br /> ! rowspan=1 |Other Networks:<br /> ! rowspan=1 |Different network instances:<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Beacon Cache (Core 2)<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> |style=&quot;background: #CCFFCC;&quot;| Yes (As of 0.2.0 Alpha)<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Beacon Cache (Core 1)<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Skulls<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|JumsWebCache<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|GnuWebCache (Perl)<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|GnuWebCache (PHP) <br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|GhostWhiteCrab(GWC) <br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> |style=&quot;background: #FFFFCC;&quot;| N/A<br /> |style=&quot;background: #FFFFCC;&quot;| N/A<br /> |style=&quot;background: #FFFFCC;&quot;| N/A<br /> | {{yes}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|PHPGnuCacheII <br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Bazooka <br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Cachechu<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Perlgcache<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Gerry GWC (v2)<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Gerry GWC (v1)<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Lynn<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|LynnX<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |}<br /> <br /> == Shareaza Specific Details == <br /> <br /> {{RecoveredPage|Warninig: here I have pasted better formatted recovery, but not verified. Row recovery has been mooved below as I don't know if anybody has made any changes in it. If not then row recovery can be deleted. Paste starts from &gt;&gt;Shareaza Specific Details&lt;&lt;, here, and ends at second &gt;&gt;Shareaza Specific Details&lt;&lt; I hope it is visible. --[[User:Ocexyz|Ocexyz]] 23:27, 27 July 2009 (UTC)}}<br /> <br /> '''Get String Breakdown:''' <br /> * Update a leaf <br /> ** &quot;?update=1&amp;ip=(ip):(port)&amp;x_leaves=(leaf count) <br /> * Ping Variable <br /> ** Appends &amp;ping=1 to identify the cache name in debug messages (for gnutella and gnutella2 in 2.4.0.0, but only for gnutella2 now in 2.4.0.X for spec1 cache compatibility). <br /> ** This feature new to Shareaza. <br /> * Network Variable <br /> ** Appends &amp;net=gnutella2 on Gnutella2 queries. <br /> ** Does NOT append a network variable on Gnutella(1) queries. <br /> * Client Name / Version Format (2.4.0.0 and earlier): <br /> ** &amp;client=(Shareaza 4 letter code (RAZA / RAZB) ) <br /> ** &amp;version=(Shareaza's version) <br /> * Client Name / Version Format (2.4.0.X): <br /> ** If Gnutella <br /> *** &amp;client=(Shareaza 4 letter code (RAZA / RAZB) ) <br /> *** &amp;version=(Shareaza's version) <br /> ** If Gnutella2 <br /> *** &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )+(Shareaza's version) <br /> <br /> '''GWC Response Matching:''' <br /> * i| <br /> ** Informational output alone will not be taken as GWC 'success.' <br /> * i|access|period|(time in sec.) <br /> ** Time in seconds before Shareaza is allowed to make a request to the cache. <br /> * i|update|period|(time in sec.) <br /> ** Time in seconds before Shareaza is allowed to update to the cache. <br /> * i|force|remove and i|update|warning|bad url <br /> ** Remove the GWC from the internal list. <br /> * Some Response Matches (added in 2.3.1.X) <br /> ** i|NO-URL-NO-HOSTS <br /> *** Outputs warning of the cache being totally empty to the system log. <br /> ** i|NO-URL <br /> *** Outputs warning of the cache having no alternative URLs to the system log. <br /> ** i|NO-HOSTS <br /> *** Outputs warning of the cache having no hosts to the system log. <br /> ** i|warning| <br /> *** Outputs warning of the cache to the system log. <br /> ** ERROR Something Failed <br /> *** Outputs warning of the cache to the system log(Buggy Bazooka GWCs workaround). <br /> ** i|warning|You came back too early (2.3.1.X) <br /> ** i|warning|client|early (2.3.1.X) <br /> ** WARNING: You came back too early (2.3.1.X) <br /> ** ERROR: Client returned too early (2.3.1.X) <br /> *** Flood detection for the update side. <br /> *** Outputs GWebCache(update) Too many connection attempts to the system log. <br /> ** too early (2.3.1.X) <br /> ** early (2.4.0.X) <br /> *** Flood detection for the request side. <br /> *** Outputs GWebCache URL: Too many connection attempts to the system log. <br /> ** i|update|OK <br /> *** Outputs &quot;GWebCache(v2) Update Passed: &quot; to the system log. <br /> ** OK <br /> *** Outputs &quot;GWebCache(v1) Update Passed: &quot; to the system log. <br /> <br /> == Gnutella Web Cache Specifications ==<br /> ==== Specification 1: ====<br /> * '''Networks Served''' <br /> ** Gnutella <br /> * '''Format''' <br /> ** Update went fine: <br /> *** Ex: OK <br /> ** Update Warning (Small prob., not that bad): <br /> *** Ex: OKWARNING: Error Message <br /> <br /> * Severe Warning (No 'OK' message sent) <br /> ** Ex: WARNING: Error Message<br /> <br /> * URL Output: <br /> ** Ex: [http://somefreakinrandomcache.com/cache/gcache.php http://somefreakinrandomcache.com/cache/gcache.php] <br /> *** OR - WITH A PORT NUMBER (If not 80) <br /> **** Ex: [http://somefreakinrandomcache.com:8080/cache/gcache.php http://somefreakinrandomcache.com:8080/cache/gcache.php] <br /> * Host Output: <br /> ** Ex: 66.132.55.12:6346 <br /> * Pong (ping variable response) - was explained below under the topic: variables. <br /> * '''Example Cache Output (Beacon Cache) For urlfile Command''' <br /> ** Example &quot;urlfile Output&quot; URL: Ex: [http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;urlfile=1 http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;urlfile=1] <br /> *** Example URL Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting urls with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | PONG Beacon Cache 0.1.5D Beta[http://gwc.frodoslair.net/skulls/skulls.php http://gwc.frodoslair.net/skulls/skulls.php][http://bbs.robertwoolley.co.uk/GWebCache/gcache.php http://bbs.robertwoolley.co.uk/GWebCache/gcache.php][http://g2.tjtech.org/g2/ http://g2.tjtech.org/g2/][http://g2.tjtech.org/g2/index.php http://g2.tjtech.org/g2/index.php][http://gwc.monnsta.net/ http://gwc.monnsta.net/][http://holograph.uni.cc/other/skulls.php http://holograph.uni.cc/other/skulls.php][http://gwc.nickstallman.net/ http://gwc.nickstallman.net/][http://gwc.eod.cc/skulls.php http://gwc.eod.cc/skulls.php][http://gwc.frodoslair.net/skulls/skulls http://gwc.frodoslair.net/skulls/skulls][http://gwc.werwin.net/skulls.php http://gwc.werwin.net/skulls.php] <br /> <br /> |}<br /> * '''Example Cache Output (Beacon Cache) For hostfile Command''' <br /> ** Example &quot;hostfile Output&quot; URL: Ex: [http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;hostfile=1 http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;hostfile=1] <br /> *** Example Host Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting the hosts with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | PONG Beacon Cache 0.1.5D Beta71.8.84.153:391599.248.214.157:2752969.60.241.55:16369193.253.239.246:3021868.156.175.121:634871.179.7.241:1834474.196.22.241:634812.210.197.194:10531222.150.143.77:1000058.85.231.135:634624.141.199.164:2020572.175.201.195:634869.81.129.228:488097.81.221.63:1321970.15.130.224:7759216.211.188.106:5190375.167.168.156:4866012.214.14.3:3591676.177.244.106:2418098.165.218.139:3963068.112.182.125:368568.117.204.57:2348265.12.154.25:4076069.180.47.169:571175.138.40.173:2498798.201.19.0:3366270.187.2.144:634868.186.209.107:1442969.159.7.61:634876.208.176.196:48199<br /> <br /> |}<br /> * '''For combining a hostfile and urlfile request:''' <br /> ** Warning: This is non-standard. <br /> ** '''Example Cache Output (Beacon Cache) For bfile Command''' <br /> *** Example &quot;bfile Output&quot; URL: Ex: [http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;bfile=1 http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;bfile=1] <br /> **** Example Host and URL Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting the hosts and urls with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | PONG Beacon Cache 0.1.5D Beta71.8.84.153:391599.248.214.157:2752969.60.241.55:16369193.253.239.246:3021868.156.175.121:634871.179.7.241:1834474.196.22.241:634812.210.197.194:10531222.150.143.77:1000058.85.231.135:634624.141.199.164:2020572.175.201.195:634869.81.129.228:488097.81.221.63:1321970.15.130.224:7759216.211.188.106:5190375.167.168.156:4866012.214.14.3:3591676.177.244.106:2418098.165.218.139:3963068.112.182.125:368568.117.204.57:2348265.12.154.25:4076069.180.47.169:571175.138.40.173:2498798.201.19.0:3366270.187.2.144:634868.186.209.107:1442969.159.7.61:634876.208.176.196:48199[http://gwc.frodoslair.net/skulls/skulls.php http://gwc.frodoslair.net/skulls/skulls.php][http://bbs.robertwoolley.co.uk/GWebCache/gcache.php http://bbs.robertwoolley.co.uk/GWebCache/gcache.php][http://g2.tjtech.org/g2/ http://g2.tjtech.org/g2/][http://g2.tjtech.org/g2/index.php http://g2.tjtech.org/g2/index.php][http://gwc.monnsta.net/ http://gwc.monnsta.net/][http://holograph.uni.cc/other/skulls.php http://holograph.uni.cc/other/skulls.php][http://gwc.nickstallman.net/ http://gwc.nickstallman.net/][http://gwc.eod.cc/skulls.php http://gwc.eod.cc/skulls.php][http://gwc.frodoslair.net/skulls/skulls http://gwc.frodoslair.net/skulls/skulls][http://gwc.werwin.net/skulls.php http://gwc.werwin.net/skulls.php] <br /> <br /> |}<br /> '''Variables''' <br /> * '''Mandatory''' <br /> ** ping: <br /> *** Response should have this always: PONG<br /> *** After, put the cache's name. ex: PONG fakecache 0.01<br /> ** client: <br /> *** Four letter code of the client. ex: RAZA <br /> ** version: <br /> *** Version number of the client. <br /> ** urlfile: <br /> *** Used by the client to request alternate cache urls. <br /> ** hostfile: <br /> *** Used by the client to request IPs with port numbers attached. <br /> ** url: <br /> *** Client update giving an alternate cache URL. <br /> *** Formatted with a http:// prefix to each cache. <br /> ** ip: <br /> *** Client update giving one's IP to submit. <br /> ** url1: <br /> *** OLD OUTDATED Client update giving an alternate cache URL. <br /> *** Formatted with a http:// prefix to each cache. <br /> ** ip1: <br /> *** OLD OUTDATED Client update giving one's IP to submit. <br /> * '''Optional''' <br /> ** bfile: <br /> *** For clients to request both URLs and IPs from the cache at the same time. <br /> ** statfile: <br /> *** Statistics of the cache request: <br /> **** First line: Total requests of the cache number. <br /> **** Second line: Requests of the cache an hour number. <br /> **** Third line: Updates of the cache an hour number.<br /> <br /> ==== Specification 2: ====<br /> '''Networks Served''' <br /> * Gnutella, Gnutella2, etc. <br /> '''Format''' <br /> * '''Information Output''' <br /> ** Starts with: I| <br /> *** '''Categories''' <br /> **** '''Pong''' (ping variable response) - Described below under the topic: variables. <br /> **** '''Update Status Response''' <br /> ***** Format: I|update <br /> ***** '''Responses''' <br /> ****** I|update|OK <br /> ******* - Everything went fine. <br /> ****** I|update|OK|WARNING <br /> ******* Small warning. <br /> ****** I|update|WARNING <br /> ******* Severe warning <br /> **** '''Plain Warnings''' <br /> ***** Format: I|WARNING <br /> ****** Append any warning messages after it - Ex: I|WARNING|You came back too early <br /> **** '''Extra Info''' - Described below under the topic: variables. <br /> * '''Host Output''' <br /> ** Starts with: H| <br /> ** Add the IP with its port: <br /> *** Ex: H|0.0.0.0:6346 <br /> ** Add the time, thereafter, of the host's (In seconds*) time in cache: <br /> *** Ex: H|0.0.0.0:6346|45 <br /> ** If cluster exists with cluster=somerandomwords <br /> *** Add the clustered words after the host's age: <br /> **** Ex: H|0.0.0.0:6346|45|somerandomwords <br /> * '''URL Output''' <br /> ** Starts with: U| <br /> ** Add the URL with http:// before it, plus the port (if it's not 80). <br /> *** Ex: U|[http://somerandomcache.com/ http://somerandomcache.com/] <br /> ** Add the time, thereafter, of the URL's time (In seconds*) in cache: <br /> *** Ex: U|[http://somerandomcache.com/%7C45 http://somerandomcache.com/|45] <br /> * '''Example Cache Output (Beacon Cache) For get Command''' <br /> ** Example URL: [http://grantgalitz.com/Beacon/gwc.php?get=1&amp;client=RAZA&amp;version=2.3.1.3&amp;net=gnutella2&amp;ping=1 http://grantgalitz.com/Beacon/gwc.php?get=1&amp;client=RAZA&amp;version=2.3.1.3&amp;net=gnutella2&amp;ping=1] <br /> *** Example &quot;Get&quot; Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting the hosts and urls with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | I|pong|Beacon Cache 0.1.5D Beta|gnutella-gnutella2H|65.9.200.243:4968|248261H|68.228.129.75:44599|242678H|98.240.196.122:8206|240719H|76.104.12.133:14921|218273H|69.136.1.12:3924|211610H|81.154.208.71:8595|174402H|97.96.105.51:2076|153610H|74.192.153.212:39340|144203H|72.190.106.57:12584|132984H|78.93.71.132:12334|125668H|82.43.248.184:27560|97974H|196.205.224.97:6357|86763H|74.129.219.30:33172|82005H|76.104.12.133:19185|57182H|69.59.83.131:18442|38628U|[http://www.k33bz.com/g2/bazooka.php%7C248639 http://www.k33bz.com/g2/bazooka.php|248639]U|[http://gwebcache.ns1.net/%7C248592 http://gwebcache.ns1.net/|248592]U|[http://gwc2.wodi.org/skulls.php%7C248384 http://gwc2.wodi.org/skulls.php|248384]U|[http://gwc.guufshop.com/skulls/skulls.php%7C248322 http://gwc.guufshop.com/skulls/skulls.php|248322]U|[http://groovy.syxy.com/up/skulls.php%7C248300 http://groovy.syxy.com/up/skulls.php|248300]U|[http://g2.tjtech.org/g2/index.php%7C247770 http://g2.tjtech.org/g2/index.php|247770]U|[http://midian.jayl.de/g2/bazooka.php%7C240719 http://midian.jayl.de/g2/bazooka.php|240719]U|[http://www.dom2porno.info/skulls/skulls.php%7C207473 http://www.dom2porno.info/skulls/skulls.php|207473]U|[http://gwc.frodoslair.net/skulls/skulls%7C125668 http://gwc.frodoslair.net/skulls/skulls|125668]U|[http://holograph.uni.cc/other/skulls.php%7C9642 http://holograph.uni.cc/other/skulls.php|9642] <br /> <br /> |}<br /> '''Variables''' <br /> * '''Mandatory''' <br /> ** ping: <br /> *** Main Part: I|pong| <br /> *** Then add the cache name and version: I|pong|fakecache 0.01 <br /> *** Then lastly add the network support: <br /> **** I|pong|fakecache 0.01|gnutella <br /> ***** - Gnutella only <br /> **** I|pong|fakecache 0.01|gnutella2 <br /> ***** - Gnutella2 only <br /> **** I|pong|fakecache 0.01|gnutella-gnutella2 <br /> ***** - Gnutella and Gnutella2 served <br /> ** get: <br /> *** Used by clients to requests alternate cache URLs along with IPs and their port numbers. <br /> ** update: <br /> *** url: <br /> **** Client update giving an alternate cache URL. <br /> **** Formatted with a http:// prefix to each cache. <br /> *** ip: <br /> **** Client update giving one's IP to submit. <br /> ** net: <br /> *** Which network to serve the client. <br /> **** Gnutella <br /> ***** Ex: net=gnutella <br /> **** Gnutella2 <br /> ***** Ex: net=gnutella2 <br /> **** '''Should always be lowercase''' <br /> ***** GWCs should automatically convert network name given to lowercase to prevent Net ID mismatches <br /> <br /> solely on case alone. <br /> <br /> <br /> * <br /> ** client: <br /> *** Four letter code of the client. ex: RAZA <br /> ** version: <br /> *** Version number of the client. <br /> * '''Optional''' <br /> ** cluster: <br /> *** To add extra info to an IP update. <br /> **** Output by cache: H|0.0.0.0|AGE OF HOST (Seconds)|clustering some bull**** <br /> ** statfile: <br /> *** Exactly like the specification 1 statfile '''(Same routine and output style)'''. <br /> *** Statistics of the cache request: <br /> **** First line: Total requests of the cache number. <br /> **** Second line: Requests of the cache an hour number. <br /> **** Third line: Updates of the cache an hour number. <br /> <br /> ==== Specification 2.1 ====<br /> '''This is an extension of specification 2, not a separate specification!''' <br /> Pong extension <br /> * Append the networks supported joined by a hyphen '-'. <br /> * Used for client-side validation of networks supported and for network support reporting to other web caches. <br /> * Format: <br /> ** I|pong|cache name|network names joined by '-' <br /> ** Format Examples: <br /> *** I|pong|fakecache 0.01|gnutella <br /> **** - Gnutella only <br /> *** I|pong|fakecache 0.01|gnutella2 <br /> **** - Gnutella2 only <br /> *** I|pong|fakecache 0.01|gnutella-gnutella2 <br /> **** - Gnutella and Gnutella2 served <br /> Host Output <br /> * Just like specification 2, but with more fields supported for host output. <br /> ** H|ip:port|age in cache|clustering|leaves|4 letter vendor code|reported uptime of host|max. leaves possible <br /> *** The host, age, and clustering fields are all still the same as in specification 2. <br /> *** The leaf count of the hub reported is in the 5th field. <br /> *** The vendor code with version number is in the 6th field. <br /> Request Control Variables: <br /> * getleaves <br /> ** Used to obtain leaf counts of hubs given <br /> ** 4th field ultilized for current leaf count. <br /> ** 7th field ultilized for maximum leaf slots possible. <br /> ** Use this as 'getleaves=1' or 'getleaves' to enable. <br /> * getclusters <br /> ** Enables/Disables clustering. <br /> ** Use this as 'getclusters=1'. <br /> ** Using 'getclusters' or 'getclusters=0' disables cluster output. <br /> * getvendors <br /> ** Used to obtain the vendor code w/ version number of the hubs given. <br /> ** Found in the 5th field. <br /> ** Use this as 'getvendors=1' or 'getvendors' to enable. <br /> * getuptime <br /> ** Used to obtain the vendor code w/ version number of the hubs given. <br /> ** Value is static, do not change the value given when time passes. <br /> ** Found in the 6th field. <br /> ** Use this as 'getuptime=1' or 'getuptime' to enable. <br /> * spec <br /> ** To force the specification parameter <br /> ** Currently is only supported by Beacon Cache II <br /> * pv <br /> ** Similar to the 'spec' parameter, except that it does not force, instead it simply negotiates the specification. <br /> Special Data Requests <br /> * info <br /> ** Outputs extra details of your cache. <br /> *** Start with the informational response: I| <br /> **** Ex: I|open-source|1 <br /> * support <br /> ** Outputs USEFUL details of your cache. <br /> *** Start with the informational response: I| <br /> **** Ex: I|support|gnutella2 <br /> * getnetworks <br /> ** Outputs the enabled networks in two formats. <br /> *** Start with the informational response: I| <br /> **** For the 'I|nets|' line <br /> ***** The third field contains the supported networks joined by '-'. <br /> **** For the 'I|networks|' line <br /> ***** Interpret the fields from 3 and beyond as individual network names to challenge against. <br /> *** Examples <br /> **** <br /> ***** I|nets|gnutella-gnutella2 <br /> ***** I|networks|gnutella|gnutella2 <br /> Update Extension Variables: <br /> * x_leaves <br /> ** Number of leaves running on a given hub or ultrapeer. <br /> ** '''Value must not be greater than an integer value of 2047.''' <br /> ** '''Note: It is important to know that PHP automaticaly replace dots with underscores, so to keep compatibility with old/new version of clients all caches should support both variants, example: x.leaves x_leaves''' <br /> * x_max <br /> ** Maximum number of leaves possible on a given hub or ultrapeer. <br /> ** '''Value must not be greater than an integer value of 2047.''' <br /> * uptime <br /> ** Value submitted must be an integer value of the number of seconds of uptime. <br /> ** '''Value must not be greater than an integer value of 1 year (31536000) and less than 1 hour (60).''' <br /> <br /> === Pinging Caches With Your Cache ===<br /> '''Please follow this standard:''' <br /> * '''Client: TEST''' <br /> * '''Version: Your Cache's Name''' <br /> ** The old value for &quot;version&quot; was 1 <br /> '''Some variables to attach to the ping (compatibility):''' <br /> * '''multi''' <br /> ** Used by some gwcs in their pings to other gwcs. <br /> ** &lt;nowiki&gt;It tells the pinged cache to ignore the &quot;net&quot; parameter (so it should never say network not supported) and outputting the pong using this format, if possible, &quot;I|pong|[cache name] [cache version]|[supported networks list]&quot; - example: I|pong|Skulls 0.2.9|gnutella-gnutella2 &lt;/nowiki&gt;<br /> ** Used by Skulls GWC only, supported by Skulls and Beacon Cache II. <br /> * '''cache''' <br /> ** This is added to every request made by some gwcs, it is for statistical purposes only. <br /> ** It simply tells the remote cache that the client is a GWC. <br /> '''Help''' <br /> * For PHP <br /> ** Use the fsockopen() function to open a connection to a cache. <br /> *** Make sure you &quot;write&quot; to the fsockopen carry value to open the GWC's target file. <br /> **** [http://us.php.net/manual/en/function.fsockopen.php http://us.php.net/manual/en/function.fsockopen.php] <br /> <br /> === Variable Combination Standards ===<br /> '''Net variable decides specification!''' <br /> * There are many ways to determine spec., but going with net is the safe way. <br /> * Skulls GWC does not use the network parameter to determine specification level. <br /> * Beacon Cache (I and II) uses the network parameter to determine the specification level. <br /> '''Your cache needs to be able to process certain combinations of variables.''' <br /> * Update variable <br /> ** Update should not fail if absent if spec. 2. <br /> *** A Specification 2 parameter. <br /> Spec 1 parameters used in Spec 2: <br /> * Should still accept hostfile and urlfile responses for spec. 2. <br /> ** Beacon Cache (I and II) accepts these parameters on spec 2. <br /> The 'spec' paameter can be used to force a specification: <br /> * Only known to exist in Beacon Cache II, it can force the request to be handled as a specification 1 or 2 request. <br /> * Spec 1 = 'spec=1' <br /> * Spec 2 = 'spec=2' <br /> * If 'spec' is not equal to any current spec, then default to the predetermined spec. <br /> '''Multiple variable requests''' <br /> * If for instance a ping and request exist, you should always handle them properly. <br /> ** Same goes with other combos like an update and ping, statfile + ping and info. <br /> * Handle multiple variables as BEST as possible! <br /> ** Some scanners and GWCs like to fit all their requests into one URL send. <br /> <br /> === Further Information: ===<br /> * [http://www.gnucleus.com/gwebcache/ Original GWC] [http://www.gnucleus.com/gwebcache/ site] <br /> ** [http://gnucleus.sourceforge.net/gwebcache/specs.html GWC Spec. 1] <br /> ** [http://gnucleus.sourceforge.net/gwebcache/newgwc.html GWC Spec. 2] <br /> <br /> === Gnutella Web Cache ===<br /> Gnutella requires Gnutella Web Caches (GWC) to get IPs to establish a connection to the network. These are critical to ensuring the health of the network. If you have a dedicated server and can spare some extra bandwidth then please consider running a GWC. People that don't have a dedicated server or are on normal broadband consumer lines should not run a cache from home.<br /> <br /> A GWC is a simple script that can be put on any webserver that supports one of the following scripting languages:<br /> *JSP (Java Servlet)<br /> **[http://web.archive.org/web/20061108091447/http://www.mager.org/GWebCache/ Java Servlet GWebCache Application (Archive.org)]<br /> *C<br /> **[http://ghostwhitecrab.com/crab/ GhostWhiteCrab]<br /> *Perl <br /> **[http://www.jonatkins.com/perlgcache/ Jon Atkins' perlgcache] <br /> **The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache]<br /> *PHP <br /> **[http://gwcii.sourceforge.net/ PHPGnuCacheII] - MySQL<br /> **[http://www.bazookanetworks.com Bazooka G2WC] (recommended) - flat files<br /> **[http://sourceforge.net/projects/skulls/ Skulls! Multi-Network WebCache] - flat files<br /> ====Further Information:====<br /> *[http://www.gnucleus.com/gwebcache/|Original GWC site]<br /> <br /> <br /> {{RecoveredPage|--&gt;Saved in timestamp 20090421202728Retrieved from &quot;[https://www.pantheraproject.net/wiki/index.php?title=GWC This page was last modified on April 18, 2009, at 23:25. &lt;/center&gt;<br /> <br /> &lt;center&gt;Copyright © 2002-2009 Shareaza Development Team. &lt;/center&gt;&lt;center&gt;[[Image:poweredby_mediawiki_88x31.png]] --[[User:Ocexyz|Ocexyz]] 16:20, 27 July 2009 (UTC)}}<br /> <br /> {{RecoveredPage|Warninig: here ends pasted better formatted recovery. Row recovery has been mooved below as I don't know if anybody has made any changes in it. If not then row recovery can be deleted I suppose. Paste starts from == Shareaza Specific Details == and ends at second == Shareaza Specific Details ==, here. I hope it is visible. --[[User:Ocexyz|Ocexyz]] 16:20, 27 July 2009 (UTC) }}<br /> <br /> ==Shareaza Specific Details==<br /> <br /> {{RecoveredPage|Warninig: here ends pasted better formatted recovery. Row recovery has been mooved below as I don't know if anybody has made any changes in it. If not then row recovery can be deleted I suppose. Paste starts from &gt;&gt;Shareaza Specific Details&lt;&lt; and ends at second &gt;&gt; Shareaza Specific Details&lt;&lt;, here. I hope it is visible. --[[User:Ocexyz|Ocexyz]] 23:27, 27 July 2009 (UTC) }}<br /> <br /> * Get String Breakdown:<br /> o Update a leaf<br /> + &quot;?update=1&amp;ip=(ip):(port)&amp;x_leaves=(leaf count) <br /> o Ping Variable<br /> + Appends &amp;ping=1 to identify the cache name in debug messages (for gnutella and gnutella2 in 2.4.0.0, but only for gnutella2 now in 2.4.0.X for spec1 cache compatibility).<br /> + This feature new to Shareaza. <br /> o Network Variable<br /> + Appends &amp;net=gnutella2 on Gnutella2 queries.<br /> + Does NOT append a network variable on Gnutella(1) queries. <br /> o Client Name / Version Format (2.4.0.0 and earlier):<br /> + &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )<br /> + &amp;version=(Shareaza's version) <br /> o Client Name / Version Format (2.4.0.X):<br /> + If Gnutella<br /> # &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )<br /> # &amp;version=(Shareaza's version) <br /> + If Gnutella2<br /> # &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )+(Shareaza's version) <br /> <br /> <br /> <br /> * GWC Response Matching:<br /> o i|<br /> + Informational output alone will not be taken as GWC 'success.' <br /> o i|access|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to make a request to the cache. <br /> o i|update|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to update to the cache. <br /> o i|force|remove and i|update|warning|bad url<br /> + Remove the GWC from the internal list. <br /> o Some Response Matches (added in 2.3.1.X)<br /> + i|NO-URL-NO-HOSTS<br /> # Outputs warning of the cache being totally empty to the system log. <br /> + i|NO-URL<br /> # Outputs warning of the cache having no alternative URLs to the system log. <br /> + i|NO-HOSTS<br /> # Outputs warning of the cache having no hosts to the system log. <br /> + i|warning|<br /> # Outputs warning of the cache to the system log. <br /> + ERROR Something Failed<br /> # Outputs warning of the cache to the system log(Buggy Bazooka GWCs workaround). <br /> + i|warning|You came back too early (2.3.1.X)<br /> + i|warning|client|early (2.3.1.X)<br /> + WARNING: You came back too early (2.3.1.X)<br /> + ERROR: Client returned too early (2.3.1.X)<br /> # Flood detection for the update side.<br /> # Outputs GWebCache(update) Too many connection attempts to the system log. <br /> + too early (2.3.1.X)<br /> + early (2.4.0.X)<br /> # Flood detection for the request side.<br /> # Outputs GWebCache URL: Too many connection attempts to the system log. <br /> + i|update|OK<br /> # Outputs &quot;GWebCache(v2) Update Passed: &quot; to the system log. <br /> + OK<br /> # Outputs &quot;GWebCache(v1) Update Passed: &quot; to the system log. <br /> <br /> <br /> <br /> * GWC Response Matching:<br /> o i|<br /> + Informational output alone will not be taken as GWC 'success.' <br /> o i|access|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to make a request to the cache. <br /> o i|update|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to update to the cache. <br /> o i|force|remove and i|update|warning|bad url<br /> + Remove the GWC from the internal list. <br /> o Some Response Matches (added in 2.3.1.X)<br /> + i|NO-URL-NO-HOSTS<br /> # Outputs warning of the cache being totally empty to the system log. <br /> + i|NO-URL<br /> # Outputs warning of the cache having no alternative URLs to the system log. <br /> + i|NO-HOSTS<br /> # Outputs warning of the cache having no hosts to the system log. <br /> + i|warning|<br /> # Outputs warning of the cache to the system log. <br /> + ERROR Something Failed<br /> # Outputs warning of the cache to the system log(Buggy Bazooka GWCs workaround). <br /> + i|warning|You came back too early (2.3.1.X)<br /> + i|warning|client|early (2.3.1.X)<br /> + WARNING: You came back too early (2.3.1.X)<br /> + ERROR: Client returned too early (2.3.1.X)<br /> # Flood detection for the update side.<br /> # Outputs GWebCache(update) Too many connection attempts to the system log. <br /> + too early (2.3.1.X)<br /> + early (2.4.0.X)<br /> # Flood detection for the request side.<br /> # Outputs GWebCache URL: Too many connection attempts to the system log. <br /> + i|update|OK<br /> # Outputs &quot;GWebCache(v2) Update Passed: &quot; to the system log. <br /> + OK<br /> # Outputs &quot;GWebCache(v1) Update Passed: &quot; to the system log. <br /> <br /> <br /> <br /> ==Gnutella Web Cache Specifications==<br /> &lt;end of partial recovery by OCE&gt;<br /> <br /> <br /> <br /> <br /> &lt;end of recovered content&gt;<br /> <br /> &lt;row recovery, start&gt; <br /> Specification 1:<br /> <br /> * Networks Served<br /> o Gnutella <br /> * Format<br /> o Update went fine:<br /> + Ex: OK <br /> o Update Warning (Small prob., not that bad):<br /> + Ex: <br /> <br /> OK<br /> WARNING: Error Message<br /> <br /> * Severe Warning (No 'OK' message sent)<br /> o Ex: <br /> <br /> WARNING: Error Message<br /> <br /> * URL Output:<br /> o Ex: http://somefreakinrandomcache.com/cache/gcache.php<br /> + OR - WITH A PORT NUMBER (If not 80)<br /> # Ex: http://somefreakinrandomcache.com:8080/cache/gcache.php <br /> * Host Output:<br /> o Ex: 66.132.55.12:6346 <br /> * Pong (ping variable response) - was explained below under the topic: variables.<br /> * Example Cache Output (Beacon Cache) For urlfile Command<br /> o Example &quot;urlfile Output&quot; URL: Ex: http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;urlfile=1<br /> + Example URL Output: <br /> <br /> <br /> Getting urls with a pong combined<br /> <br /> PONG Beacon Cache 0.1.5D Beta<br /> http://gwc.frodoslair.net/skulls/skulls.php<br /> http://bbs.robertwoolley.co.uk/GWebCache/gcache.php<br /> http://g2.tjtech.org/g2/<br /> http://g2.tjtech.org/g2/index.php<br /> http://gwc.monnsta.net/<br /> http://holograph.uni.cc/other/skulls.php<br /> http://gwc.nickstallman.net/<br /> http://gwc.eod.cc/skulls.php<br /> http://gwc.frodoslair.net/skulls/skulls<br /> http://gwc.werwin.net/skulls.php<br /> <br /> <br /> * Example Cache Output (Beacon Cache) For hostfile Command<br /> o Example &quot;hostfile Output&quot; URL: Ex: http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;hostfile=1<br /> + Example Host Output: <br /> <br /> <br /> Getting the hosts with a pong combined<br /> <br /> PONG Beacon Cache 0.1.5D Beta<br /> 71.8.84.153:3915<br /> 99.248.214.157:27529<br /> 69.60.241.55:16369<br /> 193.253.239.246:30218<br /> 68.156.175.121:6348<br /> 71.179.7.241:18344<br /> 74.196.22.241:6348<br /> 12.210.197.194:10531<br /> 222.150.143.77:10000<br /> 58.85.231.135:6346<br /> 24.141.199.164:20205<br /> 72.175.201.195:6348<br /> 69.81.129.228:4880<br /> 97.81.221.63:13219<br /> 70.15.130.224:7759<br /> 216.211.188.106:51903<br /> 75.167.168.156:48660<br /> 12.214.14.3:35916<br /> 76.177.244.106:24180<br /> 98.165.218.139:39630<br /> 68.112.182.125:3685<br /> 68.117.204.57:23482<br /> 65.12.154.25:40760<br /> 69.180.47.169:5711<br /> 75.138.40.173:24987<br /> 98.201.19.0:33662<br /> 70.187.2.144:6348<br /> 68.186.209.107:14429<br /> 69.159.7.61:6348<br /> 76.208.176.196:48199<br /> <br /> <br /> * For combining a hostfile and urlfile request:<br /> o Warning: This is non-standard.<br /> o Example Cache Output (Beacon Cache) For bfile Command<br /> + Example &quot;bfile Output&quot; URL: Ex: http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;bfile=1<br /> # Example Host and URL Output: <br /> <br /> <br /> Getting the hosts and urls with a pong combined<br /> <br /> PONG Beacon Cache 0.1.5D Beta<br /> 71.8.84.153:3915<br /> 99.248.214.157:27529<br /> 69.60.241.55:16369<br /> 193.253.239.246:30218<br /> 68.156.175.121:6348<br /> 71.179.7.241:18344<br /> 74.196.22.241:6348<br /> 12.210.197.194:10531<br /> 222.150.143.77:10000<br /> 58.85.231.135:6346<br /> 24.141.199.164:20205<br /> 72.175.201.195:6348<br /> 69.81.129.228:4880<br /> 97.81.221.63:13219<br /> 70.15.130.224:7759<br /> 216.211.188.106:51903<br /> 75.167.168.156:48660<br /> 12.214.14.3:35916<br /> 76.177.244.106:24180<br /> 98.165.218.139:39630<br /> 68.112.182.125:3685<br /> 68.117.204.57:23482<br /> 65.12.154.25:40760<br /> 69.180.47.169:5711<br /> 75.138.40.173:24987<br /> 98.201.19.0:33662<br /> 70.187.2.144:6348<br /> 68.186.209.107:14429<br /> 69.159.7.61:6348<br /> 76.208.176.196:48199<br /> http://gwc.frodoslair.net/skulls/skulls.php<br /> http://bbs.robertwoolley.co.uk/GWebCache/gcache.php<br /> http://g2.tjtech.org/g2/<br /> http://g2.tjtech.org/g2/index.php<br /> http://gwc.monnsta.net/<br /> http://holograph.uni.cc/other/skulls.php<br /> http://gwc.nickstallman.net/<br /> http://gwc.eod.cc/skulls.php<br /> http://gwc.frodoslair.net/skulls/skulls<br /> http://gwc.werwin.net/skulls.php<br /> <br /> <br /> * Variables<br /> o Mandatory<br /> + ping:<br /> # Response should have this always: PONG<br /> # After, put the cache's name. ex: PONG fakecache 0.01<br /> + client:<br /> # Four letter code of the client. ex: RAZA <br /> + version:<br /> # Version number of the client. <br /> + urlfile:<br /> # Used by the client to request alternate cache urls. <br /> + hostfile:<br /> # Used by the client to request IPs with port numbers attached. <br /> + url:<br /> # Client update giving an alternate cache URL.<br /> # Formatted with a http:// prefix to each cache. <br /> + ip:<br /> # Client update giving one's IP to submit. <br /> + url1:<br /> # OLD OUTDATED Client update giving an alternate cache URL.<br /> # Formatted with a http:// prefix to each cache. <br /> + ip1:<br /> # OLD OUTDATED Client update giving one's IP to submit. <br /> o Optional<br /> + bfile:<br /> # For clients to request both URLs and IPs from the cache at the same time. <br /> + statfile:<br /> # Statistics of the cache request:<br /> * First line: Total requests of the cache number.<br /> * Second line: Requests of the cache an hour number.<br /> * Third line: Updates of the cache an hour number. <br /> <br /> Specification 2:<br /> <br /> * Networks Served<br /> o Gnutella, Gnutella2, etc. <br /> * Format<br /> o Information Output<br /> + Starts with: I|<br /> # Categories<br /> * Pong (ping variable response) - Described below under the topic: variables.<br /> * Update Status Response<br /> o Format: I|update<br /> o Responses<br /> + I|update|OK<br /> # - Everything went fine. <br /> + I|update|OK|WARNING<br /> # Small warning. <br /> + I|update|WARNING<br /> # Severe warning <br /> * Plain Warnings<br /> o Format: I|WARNING<br /> + Append any warning messages after it - Ex: I|WARNING|You came back too early <br /> * Extra Info - Described below under the topic: variables. <br /> o Host Output<br /> + Starts with: H|<br /> + Add the IP with its port:<br /> # Ex: H|0.0.0.0:6346 <br /> + Add the time, thereafter, of the host's (In seconds*) time in cache:<br /> # Ex: H|0.0.0.0:6346|45 <br /> + If cluster exists with cluster=somerandomwords<br /> # Add the clustered words after the host's age:<br /> * Ex: H|0.0.0.0:6346|45|somerandomwords <br /> o URL Output<br /> + Starts with: U|<br /> + Add the URL with http:// before it, plus the port (if it's not 80).<br /> # Ex: U|http://somerandomcache.com/ <br /> + Add the time, thereafter, of the URL's time (In seconds*) in cache:<br /> # Ex: U|http://somerandomcache.com/|45 <br /> o Example Cache Output (Beacon Cache) For get Command<br /> + Example URL: http://grantgalitz.com/Beacon/gwc.php?get=1&amp;client=RAZA&amp;version=2.3.1.3&amp;net=gnutella2&amp;ping=1<br /> # Example &quot;Get&quot; Output: <br /> <br /> <br /> Getting the hosts and urls with a pong combined<br /> <br /> I|pong|Beacon Cache 0.1.5D Beta|gnutella-gnutella2<br /> H|65.9.200.243:4968|248261<br /> H|68.228.129.75:44599|242678<br /> H|98.240.196.122:8206|240719<br /> H|76.104.12.133:14921|218273<br /> H|69.136.1.12:3924|211610<br /> H|81.154.208.71:8595|174402<br /> H|97.96.105.51:2076|153610<br /> H|74.192.153.212:39340|144203<br /> H|72.190.106.57:12584|132984<br /> H|78.93.71.132:12334|125668<br /> H|82.43.248.184:27560|97974<br /> H|196.205.224.97:6357|86763<br /> H|74.129.219.30:33172|82005<br /> H|76.104.12.133:19185|57182<br /> H|69.59.83.131:18442|38628<br /> U|http://www.k33bz.com/g2/bazooka.php|248639<br /> U|http://gwebcache.ns1.net/|248592<br /> U|http://gwc2.wodi.org/skulls.php|248384<br /> U|http://gwc.guufshop.com/skulls/skulls.php|248322<br /> U|http://groovy.syxy.com/up/skulls.php|248300<br /> U|http://g2.tjtech.org/g2/index.php|247770<br /> U|http://midian.jayl.de/g2/bazooka.php|240719<br /> U|http://www.dom2porno.info/skulls/skulls.php|207473<br /> U|http://gwc.frodoslair.net/skulls/skulls|125668<br /> U|http://holograph.uni.cc/other/skulls.php|9642<br /> <br /> <br /> * Variables<br /> o Mandatory<br /> + ping:<br /> # Main Part: I|pong|<br /> # Then add the cache name and version: I|pong|fakecache 0.01<br /> # Then lastly add the network support:<br /> * I|pong|fakecache 0.01|gnutella<br /> o - Gnutella only <br /> * I|pong|fakecache 0.01|gnutella2<br /> o - Gnutella2 only <br /> * I|pong|fakecache 0.01|gnutella-gnutella2<br /> o - Gnutella and Gnutella2 served <br /> + get:<br /> # Used by clients to requests alternate cache URLs along with IPs and their port numbers. <br /> + update:<br /> # url:<br /> * Client update giving an alternate cache URL.<br /> * Formatted with a http:// prefix to each cache. <br /> # ip:<br /> * Client update giving one's IP to submit. <br /> + net:<br /> # Which network to serve the client.<br /> * Gnutella<br /> o Ex: net=gnutella <br /> * Gnutella2<br /> o Ex: net=gnutella2 <br /> * Should always be lowercase<br /> o GWCs should automatically convert network name given to lowercase to prevent Net ID mismatches <br /> <br /> solely on case alone.<br /> <br /> *<br /> o<br /> + client:<br /> # Four letter code of the client. ex: RAZA <br /> + version:<br /> # Version number of the client. <br /> o Optional<br /> + cluster:<br /> # To add extra info to an IP update.<br /> * Output by cache: H|0.0.0.0|AGE OF HOST (Seconds)|clustering some bull**** <br /> + statfile:<br /> # Exactly like the specification 1 statfile (Same routine and output style).<br /> # Statistics of the cache request:<br /> * First line: Total requests of the cache number.<br /> * Second line: Requests of the cache an hour number.<br /> * Third line: Updates of the cache an hour number. <br /> <br /> Specification 2.1<br /> <br /> * This is an extension of specification 2, not a separate specification!<br /> * Pong extension<br /> o Append the networks supported joined by a hyphen '-'.<br /> o Used for client-side validation of networks supported and for network support reporting to other web caches.<br /> o Format:<br /> + I|pong|cache name|network names joined by '-'<br /> + Format Examples:<br /> # I|pong|fakecache 0.01|gnutella<br /> * - Gnutella only <br /> # I|pong|fakecache 0.01|gnutella2<br /> * - Gnutella2 only <br /> # I|pong|fakecache 0.01|gnutella-gnutella2<br /> * - Gnutella and Gnutella2 served <br /> * Host Output<br /> o Just like specification 2, but with more fields supported for host output.<br /> + H|ip:port|age in cache|clustering|leaves|4 letter vendor code|reported uptime of host|max. leaves possible<br /> # The host, age, and clustering fields are all still the same as in specification 2.<br /> # The leaf count of the hub reported is in the 5th field.<br /> # The vendor code with version number is in the 6th field. <br /> * Request Control Variables:<br /> o getleaves<br /> + Used to obtain leaf counts of hubs given<br /> + 4th field ultilized for current leaf count.<br /> + 7th field ultilized for maximum leaf slots possible.<br /> + Use this as 'getleaves=1' or 'getleaves' to enable. <br /> o getclusters<br /> + Enables/Disables clustering.<br /> + Use this as 'getclusters=1'.<br /> + Using 'getclusters' or 'getclusters=0' disables cluster output. <br /> o getvendors<br /> + Used to obtain the vendor code w/ version number of the hubs given.<br /> + Found in the 5th field.<br /> + Use this as 'getvendors=1' or 'getvendors' to enable. <br /> o getuptime<br /> + Used to obtain the vendor code w/ version number of the hubs given.<br /> + Value is static, do not change the value given when time passes.<br /> + Found in the 6th field.<br /> + Use this as 'getuptime=1' or 'getuptime' to enable. <br /> o spec<br /> + To force the specification parameter<br /> + Currently is only supported by Beacon Cache II <br /> o pv<br /> + Similar to the 'spec' parameter, except that it does not force, instead it simply negotiates the specification. <br /> * Special Data Requests<br /> o info<br /> + Outputs extra details of your cache.<br /> # Start with the informational response: I|<br /> * Ex: I|open-source|1 <br /> o support<br /> + Outputs USEFUL details of your cache.<br /> # Start with the informational response: I|<br /> * Ex: I|support|gnutella2 <br /> o getnetworks<br /> + Outputs the enabled networks in two formats.<br /> # Start with the informational response: I|<br /> * For the 'I|nets|' line<br /> o The third field contains the supported networks joined by '-'. <br /> * For the 'I|networks|' line<br /> o Interpret the fields from 3 and beyond as individual network names to challenge against. <br /> # Examples<br /> *<br /> o I|nets|gnutella-gnutella2<br /> o I|networks|gnutella|gnutella2 <br /> * Update Extension Variables:<br /> o x_leaves<br /> + Number of leaves running on a given hub or ultrapeer.<br /> + Value must not be greater than an integer value of 2047.<br /> + Note: It is important to know that PHP automaticaly replace dots with underscores, so to keep compatibility with old/new version of clients all caches should support both variants, example: x.leaves x_leaves<br /> o x_max<br /> + Maximum number of leaves possible on a given hub or ultrapeer.<br /> + Value must not be greater than an integer value of 2047. <br /> o uptime<br /> + Value submitted must be an integer value of the number of seconds of uptime.<br /> + Value must not be greater than an integer value of 1 year (31536000) and less than 1 hour (60). <br /> <br /> Pinging Caches With Your Cache<br /> <br /> * Please follow this standard:<br /> o Client: TEST<br /> o Version: Your Cache's Name<br /> + The old value for &quot;version&quot; was 1 <br /> * Some variables to attach to the ping (compatibility):<br /> o multi<br /> + Used by some gwcs in their pings to other gwcs.<br /> + It tells the pinged cache to ignore the &quot;net&quot; parameter (so it should never say network not supported) and outputting the pong using this format, if possible, &quot;I|pong|[cache name] [cache version]|[supported networks list]|[url adding is enabled]&quot; - example: I|pong|Skulls 0.2.8a|gnutella-gnutella2|1<br /> + Used by Skulls GWC only, supported by Skulls and Beacon Cache II. <br /> o cache<br /> + This is added to every request made by some gwcs, it is for statistical purposes only.<br /> + It simply tells the remote cache that the client is a GWC. <br /> * Help<br /> o For PHP<br /> + Use the fsockopen() function to open a connection to a cache.<br /> # Make sure you &quot;write&quot; to the fsockopen carry value to open the GWC's target file.<br /> * http://us.php.net/manual/en/function.fsockopen.php <br /> <br /> Variable Combination Standards<br /> <br /> * Net variable decides specification!<br /> o There are many ways to determine spec., but going with net is the safe way.<br /> o Skulls GWC does not use the network parameter to determine specification level.<br /> o Beacon Cache (I and II) uses the network parameter to determine the specification level. <br /> * Your cache needs to be able to process certain combinations of variables.<br /> o Update variable<br /> + Update should not fail if absent if spec. 2.<br /> # A Specification 2 parameter. <br /> * Spec 1 parameters used in Spec 2:<br /> o Should still accept hostfile and urlfile responses for spec. 2.<br /> + Beacon Cache (I and II) accepts these parameters on spec 2. <br /> * The 'spec' paameter can be used to force a specification:<br /> o Only known to exist in Beacon Cache II, it can force the request to be handled as a specification 1 or 2 request.<br /> o Spec 1 = 'spec=1'<br /> o Spec 2 = 'spec=2'<br /> o If 'spec' is not equal to any current spec, then default to the predetermined spec. <br /> * Multiple variable requests<br /> o If for instance a ping and request exist, you should always handle them properly.<br /> + Same goes with other combos like an update and ping, statfile + ping and info. <br /> o Handle multiple variables as BEST as possible!<br /> + Some scanners and GWCs like to fit all their requests into one URL send. <br /> <br /> &lt;row recovery, end&gt; <br /> <br /> Further Information:<br /> <br /> * [http://www.gnucleus.com/gwebcache/ Original GWC site]<br /> ** [http://gnucleus.sourceforge.net/gwebcache/specs.html GWC Spec. 1]<br /> ** [http://gnucleus.sourceforge.net/gwebcache/newgwc.html GWC Spec. 2] <br /> <br /> <br /> <br /> <br /> <br /> &lt;content recovered from last aviable backup&gt; <br /> <br /> ===Gnutella Web Cache===<br /> Gnutella requires Gnutella Web Caches (GWC) to get IPs to establish a connection to the network. These are critical to ensuring the health of the network. If you have a dedicated server and can spare some extra bandwidth then please consider running a GWC. People that don't have a dedicated server or are on normal broadband consumer lines should not run a cache from home.<br /> <br /> A GWC is a simple script that can be put on any webserver that supports one of the following scripting languages:<br /> *JSP (Java Servlet)<br /> **[http://web.archive.org/web/20061108091447/http://www.mager.org/GWebCache/ Java Servlet GWebCache Application (Archive.org)]<br /> *C<br /> **[http://ghostwhitecrab.com/crab/ GhostWhiteCrab]<br /> *Perl <br /> **[http://www.jonatkins.com/perlgcache/ Jon Atkins' perlgcache] <br /> **The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache]<br /> *PHP <br /> **[http://gwcii.sourceforge.net/ PHPGnuCacheII] - MySQL<br /> **[http://www.bazookanetworks.com Bazooka G2WC] (recommended) - flat files<br /> **[http://sourceforge.net/projects/skulls/ Skulls! Multi-Network WebCache] - flat files<br /> === Further Information: ===<br /> * [http://www.gnucleus.com/gwebcache/ Original GWC site]<br /> <br /> [[Category:External Links]]</div>

Ale5000 https://shareaza.sourceforge.net/w/index.php?title=GWC_specs&diff=11507 2015-03-25T15:12:14Z

<p>Ale5000: Update multi=1 info in the other part of the page BWT this page has duplicate content</p> <hr /> <div>''For general information on GWCs, have a look at the [[GWC]] Wiki page.''<br /> {{do not translate}}<br /> This page is thought to give an overview over the GWC specifications as they are implemented into Shareaza.<br /> <br /> A GWC is a simple script that can be put on any webserver that supports one of the following scripting languages: <br /> <br /> * JSP (Java Servlet) <br /> ** [http://www1.mager.org/GWebCache/ Jums Web Cache] (Excellent for heavy loads) <br /> * C <br /> ** [http://wiki.limewire.org/index.php?title=GhostWhiteCrab GhostWhiteCrab] (For dedicated server environments and people who know how to compile C source code!) <br /> * ASP <br /> ** [http://www.edazzle.net/downloads/gerry.zip Gerry GWC] <br /> ** [https://www.planet-source-code.com/vb/scripts/ShowCode.asp?txtCodeId=7846&amp;lngWId=4 Lynn (v.s. 0.5)] <br /> ** [https://www.planet-source-code.com/vb/scripts/ShowCode.asp?txtCodeId=7731&amp;lngWId=4 Lynn (v.s. 0.4)] <br /> ** [http://www.poundwebhosting.com/cgi-bin/lynnx.asp LynnX] <br /> * Perl <br /> ** [http://www.jonatkins.com/perlgcache/ Jon Atkins' perlgcache] <br /> ** The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache] <br /> * '''PHP''' ''(Tip: PHP GWCs are usually the easiest to run and setup on a server.)''<br /> ** [http://gwcii.sourceforge.net/ PHPGnuCacheII] <br /> ** [http://www.bazookanetworks.com/ Bazooka G2WC] <br /> ** [http://sourceforge.net/projects/skulls/ Skulls! Multi-Network WebCache] <br /> ** [http://sourceforge.net/projects/beaconcache/ Beacon Cache] <br /> ** [http://code.google.com/p/cachechu/ Cachechu G2WC] <br /> ** The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache] ''(PHP version is no longer supported)'' <br /> <br /> == Breakdown Of The Gnutella Web Caches: == <br /> {{RecoveredPage|I recently put this into a table. The contents need to be verified -- [[User:Cyko 01|Cyko 01]]}}<br /> <br /> {| width= auto; style=&quot;font-size: 85%; text-align: center;text-valign: middle;&quot; class=&quot;wikitable&quot;<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Cache:<br /> ! rowspan=1 |Gnutella:<br /> ! rowspan=1 |Gnutella2:<br /> ! rowspan=1 |Spec 1:<br /> ! rowspan=1 |Spec 2:<br /> ! rowspan=1 |Flat-File:<br /> ! rowspan=1 |SQL:<br /> ! rowspan=1 |Installer:<br /> ! rowspan=1 |Other Networks:<br /> ! rowspan=1 |Different network instances:<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Beacon Cache (Core 2)<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> |style=&quot;background: #CCFFCC;&quot;| Yes (As of 0.2.0 Alpha)<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Beacon Cache (Core 1)<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Skulls<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|JumsWebCache<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|GnuWebCache (Perl)<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|GnuWebCache (PHP) <br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|GhostWhiteCrab(GWC) <br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> |style=&quot;background: #FFFFCC;&quot;| N/A<br /> |style=&quot;background: #FFFFCC;&quot;| N/A<br /> |style=&quot;background: #FFFFCC;&quot;| N/A<br /> | {{yes}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|PHPGnuCacheII <br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Bazooka <br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Cachechu<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Perlgcache<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Gerry GWC (v2)<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Gerry GWC (v1)<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Lynn<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|LynnX<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |}<br /> <br /> == Shareaza Specific Details == <br /> <br /> {{RecoveredPage|Warninig: here I have pasted better formatted recovery, but not verified. Row recovery has been mooved below as I don't know if anybody has made any changes in it. If not then row recovery can be deleted. Paste starts from &gt;&gt;Shareaza Specific Details&lt;&lt;, here, and ends at second &gt;&gt;Shareaza Specific Details&lt;&lt; I hope it is visible. --[[User:Ocexyz|Ocexyz]] 23:27, 27 July 2009 (UTC)}}<br /> <br /> '''Get String Breakdown:''' <br /> * Update a leaf <br /> ** &quot;?update=1&amp;ip=(ip):(port)&amp;x_leaves=(leaf count) <br /> * Ping Variable <br /> ** Appends &amp;ping=1 to identify the cache name in debug messages (for gnutella and gnutella2 in 2.4.0.0, but only for gnutella2 now in 2.4.0.X for spec1 cache compatibility). <br /> ** This feature new to Shareaza. <br /> * Network Variable <br /> ** Appends &amp;net=gnutella2 on Gnutella2 queries. <br /> ** Does NOT append a network variable on Gnutella(1) queries. <br /> * Client Name / Version Format (2.4.0.0 and earlier): <br /> ** &amp;client=(Shareaza 4 letter code (RAZA / RAZB) ) <br /> ** &amp;version=(Shareaza's version) <br /> * Client Name / Version Format (2.4.0.X): <br /> ** If Gnutella <br /> *** &amp;client=(Shareaza 4 letter code (RAZA / RAZB) ) <br /> *** &amp;version=(Shareaza's version) <br /> ** If Gnutella2 <br /> *** &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )+(Shareaza's version) <br /> <br /> '''GWC Response Matching:''' <br /> * i| <br /> ** Informational output alone will not be taken as GWC 'success.' <br /> * i|access|period|(time in sec.) <br /> ** Time in seconds before Shareaza is allowed to make a request to the cache. <br /> * i|update|period|(time in sec.) <br /> ** Time in seconds before Shareaza is allowed to update to the cache. <br /> * i|force|remove and i|update|warning|bad url <br /> ** Remove the GWC from the internal list. <br /> * Some Response Matches (added in 2.3.1.X) <br /> ** i|NO-URL-NO-HOSTS <br /> *** Outputs warning of the cache being totally empty to the system log. <br /> ** i|NO-URL <br /> *** Outputs warning of the cache having no alternative URLs to the system log. <br /> ** i|NO-HOSTS <br /> *** Outputs warning of the cache having no hosts to the system log. <br /> ** i|warning| <br /> *** Outputs warning of the cache to the system log. <br /> ** ERROR Something Failed <br /> *** Outputs warning of the cache to the system log(Buggy Bazooka GWCs workaround). <br /> ** i|warning|You came back too early (2.3.1.X) <br /> ** i|warning|client|early (2.3.1.X) <br /> ** WARNING: You came back too early (2.3.1.X) <br /> ** ERROR: Client returned too early (2.3.1.X) <br /> *** Flood detection for the update side. <br /> *** Outputs GWebCache(update) Too many connection attempts to the system log. <br /> ** too early (2.3.1.X) <br /> ** early (2.4.0.X) <br /> *** Flood detection for the request side. <br /> *** Outputs GWebCache URL: Too many connection attempts to the system log. <br /> ** i|update|OK <br /> *** Outputs &quot;GWebCache(v2) Update Passed: &quot; to the system log. <br /> ** OK <br /> *** Outputs &quot;GWebCache(v1) Update Passed: &quot; to the system log. <br /> <br /> == Gnutella Web Cache Specifications ==<br /> ==== Specification 1: ====<br /> * '''Networks Served''' <br /> ** Gnutella <br /> * '''Format''' <br /> ** Update went fine: <br /> *** Ex: OK <br /> ** Update Warning (Small prob., not that bad): <br /> *** Ex: OKWARNING: Error Message <br /> <br /> * Severe Warning (No 'OK' message sent) <br /> ** Ex: WARNING: Error Message<br /> <br /> * URL Output: <br /> ** Ex: [http://somefreakinrandomcache.com/cache/gcache.php http://somefreakinrandomcache.com/cache/gcache.php] <br /> *** OR - WITH A PORT NUMBER (If not 80) <br /> **** Ex: [http://somefreakinrandomcache.com:8080/cache/gcache.php http://somefreakinrandomcache.com:8080/cache/gcache.php] <br /> * Host Output: <br /> ** Ex: 66.132.55.12:6346 <br /> * Pong (ping variable response) - was explained below under the topic: variables. <br /> * '''Example Cache Output (Beacon Cache) For urlfile Command''' <br /> ** Example &quot;urlfile Output&quot; URL: Ex: [http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;urlfile=1 http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;urlfile=1] <br /> *** Example URL Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting urls with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | PONG Beacon Cache 0.1.5D Beta[http://gwc.frodoslair.net/skulls/skulls.php http://gwc.frodoslair.net/skulls/skulls.php][http://bbs.robertwoolley.co.uk/GWebCache/gcache.php http://bbs.robertwoolley.co.uk/GWebCache/gcache.php][http://g2.tjtech.org/g2/ http://g2.tjtech.org/g2/][http://g2.tjtech.org/g2/index.php http://g2.tjtech.org/g2/index.php][http://gwc.monnsta.net/ http://gwc.monnsta.net/][http://holograph.uni.cc/other/skulls.php http://holograph.uni.cc/other/skulls.php][http://gwc.nickstallman.net/ http://gwc.nickstallman.net/][http://gwc.eod.cc/skulls.php http://gwc.eod.cc/skulls.php][http://gwc.frodoslair.net/skulls/skulls http://gwc.frodoslair.net/skulls/skulls][http://gwc.werwin.net/skulls.php http://gwc.werwin.net/skulls.php] <br /> <br /> |}<br /> * '''Example Cache Output (Beacon Cache) For hostfile Command''' <br /> ** Example &quot;hostfile Output&quot; URL: Ex: [http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;hostfile=1 http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;hostfile=1] <br /> *** Example Host Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting the hosts with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | PONG Beacon Cache 0.1.5D Beta71.8.84.153:391599.248.214.157:2752969.60.241.55:16369193.253.239.246:3021868.156.175.121:634871.179.7.241:1834474.196.22.241:634812.210.197.194:10531222.150.143.77:1000058.85.231.135:634624.141.199.164:2020572.175.201.195:634869.81.129.228:488097.81.221.63:1321970.15.130.224:7759216.211.188.106:5190375.167.168.156:4866012.214.14.3:3591676.177.244.106:2418098.165.218.139:3963068.112.182.125:368568.117.204.57:2348265.12.154.25:4076069.180.47.169:571175.138.40.173:2498798.201.19.0:3366270.187.2.144:634868.186.209.107:1442969.159.7.61:634876.208.176.196:48199<br /> <br /> |}<br /> * '''For combining a hostfile and urlfile request:''' <br /> ** Warning: This is non-standard. <br /> ** '''Example Cache Output (Beacon Cache) For bfile Command''' <br /> *** Example &quot;bfile Output&quot; URL: Ex: [http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;bfile=1 http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;bfile=1] <br /> **** Example Host and URL Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting the hosts and urls with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | PONG Beacon Cache 0.1.5D Beta71.8.84.153:391599.248.214.157:2752969.60.241.55:16369193.253.239.246:3021868.156.175.121:634871.179.7.241:1834474.196.22.241:634812.210.197.194:10531222.150.143.77:1000058.85.231.135:634624.141.199.164:2020572.175.201.195:634869.81.129.228:488097.81.221.63:1321970.15.130.224:7759216.211.188.106:5190375.167.168.156:4866012.214.14.3:3591676.177.244.106:2418098.165.218.139:3963068.112.182.125:368568.117.204.57:2348265.12.154.25:4076069.180.47.169:571175.138.40.173:2498798.201.19.0:3366270.187.2.144:634868.186.209.107:1442969.159.7.61:634876.208.176.196:48199[http://gwc.frodoslair.net/skulls/skulls.php http://gwc.frodoslair.net/skulls/skulls.php][http://bbs.robertwoolley.co.uk/GWebCache/gcache.php http://bbs.robertwoolley.co.uk/GWebCache/gcache.php][http://g2.tjtech.org/g2/ http://g2.tjtech.org/g2/][http://g2.tjtech.org/g2/index.php http://g2.tjtech.org/g2/index.php][http://gwc.monnsta.net/ http://gwc.monnsta.net/][http://holograph.uni.cc/other/skulls.php http://holograph.uni.cc/other/skulls.php][http://gwc.nickstallman.net/ http://gwc.nickstallman.net/][http://gwc.eod.cc/skulls.php http://gwc.eod.cc/skulls.php][http://gwc.frodoslair.net/skulls/skulls http://gwc.frodoslair.net/skulls/skulls][http://gwc.werwin.net/skulls.php http://gwc.werwin.net/skulls.php] <br /> <br /> |}<br /> '''Variables''' <br /> * '''Mandatory''' <br /> ** ping: <br /> *** Response should have this always: PONG<br /> *** After, put the cache's name. ex: PONG fakecache 0.01<br /> ** client: <br /> *** Four letter code of the client. ex: RAZA <br /> ** version: <br /> *** Version number of the client. <br /> ** urlfile: <br /> *** Used by the client to request alternate cache urls. <br /> ** hostfile: <br /> *** Used by the client to request IPs with port numbers attached. <br /> ** url: <br /> *** Client update giving an alternate cache URL. <br /> *** Formatted with a http:// prefix to each cache. <br /> ** ip: <br /> *** Client update giving one's IP to submit. <br /> ** url1: <br /> *** OLD OUTDATED Client update giving an alternate cache URL. <br /> *** Formatted with a http:// prefix to each cache. <br /> ** ip1: <br /> *** OLD OUTDATED Client update giving one's IP to submit. <br /> * '''Optional''' <br /> ** bfile: <br /> *** For clients to request both URLs and IPs from the cache at the same time. <br /> ** statfile: <br /> *** Statistics of the cache request: <br /> **** First line: Total requests of the cache number. <br /> **** Second line: Requests of the cache an hour number. <br /> **** Third line: Updates of the cache an hour number.<br /> <br /> ==== Specification 2: ====<br /> '''Networks Served''' <br /> * Gnutella, Gnutella2, etc. <br /> '''Format''' <br /> * '''Information Output''' <br /> ** Starts with: I| <br /> *** '''Categories''' <br /> **** '''Pong''' (ping variable response) - Described below under the topic: variables. <br /> **** '''Update Status Response''' <br /> ***** Format: I|update <br /> ***** '''Responses''' <br /> ****** I|update|OK <br /> ******* - Everything went fine. <br /> ****** I|update|OK|WARNING <br /> ******* Small warning. <br /> ****** I|update|WARNING <br /> ******* Severe warning <br /> **** '''Plain Warnings''' <br /> ***** Format: I|WARNING <br /> ****** Append any warning messages after it - Ex: I|WARNING|You came back too early <br /> **** '''Extra Info''' - Described below under the topic: variables. <br /> * '''Host Output''' <br /> ** Starts with: H| <br /> ** Add the IP with its port: <br /> *** Ex: H|0.0.0.0:6346 <br /> ** Add the time, thereafter, of the host's (In seconds*) time in cache: <br /> *** Ex: H|0.0.0.0:6346|45 <br /> ** If cluster exists with cluster=somerandomwords <br /> *** Add the clustered words after the host's age: <br /> **** Ex: H|0.0.0.0:6346|45|somerandomwords <br /> * '''URL Output''' <br /> ** Starts with: U| <br /> ** Add the URL with http:// before it, plus the port (if it's not 80). <br /> *** Ex: U|[http://somerandomcache.com/ http://somerandomcache.com/] <br /> ** Add the time, thereafter, of the URL's time (In seconds*) in cache: <br /> *** Ex: U|[http://somerandomcache.com/%7C45 http://somerandomcache.com/|45] <br /> * '''Example Cache Output (Beacon Cache) For get Command''' <br /> ** Example URL: [http://grantgalitz.com/Beacon/gwc.php?get=1&amp;client=RAZA&amp;version=2.3.1.3&amp;net=gnutella2&amp;ping=1 http://grantgalitz.com/Beacon/gwc.php?get=1&amp;client=RAZA&amp;version=2.3.1.3&amp;net=gnutella2&amp;ping=1] <br /> *** Example &quot;Get&quot; Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting the hosts and urls with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | I|pong|Beacon Cache 0.1.5D Beta|gnutella-gnutella2H|65.9.200.243:4968|248261H|68.228.129.75:44599|242678H|98.240.196.122:8206|240719H|76.104.12.133:14921|218273H|69.136.1.12:3924|211610H|81.154.208.71:8595|174402H|97.96.105.51:2076|153610H|74.192.153.212:39340|144203H|72.190.106.57:12584|132984H|78.93.71.132:12334|125668H|82.43.248.184:27560|97974H|196.205.224.97:6357|86763H|74.129.219.30:33172|82005H|76.104.12.133:19185|57182H|69.59.83.131:18442|38628U|[http://www.k33bz.com/g2/bazooka.php%7C248639 http://www.k33bz.com/g2/bazooka.php|248639]U|[http://gwebcache.ns1.net/%7C248592 http://gwebcache.ns1.net/|248592]U|[http://gwc2.wodi.org/skulls.php%7C248384 http://gwc2.wodi.org/skulls.php|248384]U|[http://gwc.guufshop.com/skulls/skulls.php%7C248322 http://gwc.guufshop.com/skulls/skulls.php|248322]U|[http://groovy.syxy.com/up/skulls.php%7C248300 http://groovy.syxy.com/up/skulls.php|248300]U|[http://g2.tjtech.org/g2/index.php%7C247770 http://g2.tjtech.org/g2/index.php|247770]U|[http://midian.jayl.de/g2/bazooka.php%7C240719 http://midian.jayl.de/g2/bazooka.php|240719]U|[http://www.dom2porno.info/skulls/skulls.php%7C207473 http://www.dom2porno.info/skulls/skulls.php|207473]U|[http://gwc.frodoslair.net/skulls/skulls%7C125668 http://gwc.frodoslair.net/skulls/skulls|125668]U|[http://holograph.uni.cc/other/skulls.php%7C9642 http://holograph.uni.cc/other/skulls.php|9642] <br /> <br /> |}<br /> '''Variables''' <br /> * '''Mandatory''' <br /> ** ping: <br /> *** Main Part: I|pong| <br /> *** Then add the cache name and version: I|pong|fakecache 0.01 <br /> *** Then lastly add the network support: <br /> **** I|pong|fakecache 0.01|gnutella <br /> ***** - Gnutella only <br /> **** I|pong|fakecache 0.01|gnutella2 <br /> ***** - Gnutella2 only <br /> **** I|pong|fakecache 0.01|gnutella-gnutella2 <br /> ***** - Gnutella and Gnutella2 served <br /> ** get: <br /> *** Used by clients to requests alternate cache URLs along with IPs and their port numbers. <br /> ** update: <br /> *** url: <br /> **** Client update giving an alternate cache URL. <br /> **** Formatted with a http:// prefix to each cache. <br /> *** ip: <br /> **** Client update giving one's IP to submit. <br /> ** net: <br /> *** Which network to serve the client. <br /> **** Gnutella <br /> ***** Ex: net=gnutella <br /> **** Gnutella2 <br /> ***** Ex: net=gnutella2 <br /> **** '''Should always be lowercase''' <br /> ***** GWCs should automatically convert network name given to lowercase to prevent Net ID mismatches <br /> <br /> solely on case alone. <br /> <br /> <br /> * <br /> ** client: <br /> *** Four letter code of the client. ex: RAZA <br /> ** version: <br /> *** Version number of the client. <br /> * '''Optional''' <br /> ** cluster: <br /> *** To add extra info to an IP update. <br /> **** Output by cache: H|0.0.0.0|AGE OF HOST (Seconds)|clustering some bull**** <br /> ** statfile: <br /> *** Exactly like the specification 1 statfile '''(Same routine and output style)'''. <br /> *** Statistics of the cache request: <br /> **** First line: Total requests of the cache number. <br /> **** Second line: Requests of the cache an hour number. <br /> **** Third line: Updates of the cache an hour number. <br /> <br /> ==== Specification 2.1 ====<br /> '''This is an extension of specification 2, not a separate specification!''' <br /> Pong extension <br /> * Append the networks supported joined by a hyphen '-'. <br /> * Used for client-side validation of networks supported and for network support reporting to other web caches. <br /> * Format: <br /> ** I|pong|cache name|network names joined by '-' <br /> ** Format Examples: <br /> *** I|pong|fakecache 0.01|gnutella <br /> **** - Gnutella only <br /> *** I|pong|fakecache 0.01|gnutella2 <br /> **** - Gnutella2 only <br /> *** I|pong|fakecache 0.01|gnutella-gnutella2 <br /> **** - Gnutella and Gnutella2 served <br /> Host Output <br /> * Just like specification 2, but with more fields supported for host output. <br /> ** H|ip:port|age in cache|clustering|leaves|4 letter vendor code|reported uptime of host|max. leaves possible <br /> *** The host, age, and clustering fields are all still the same as in specification 2. <br /> *** The leaf count of the hub reported is in the 5th field. <br /> *** The vendor code with version number is in the 6th field. <br /> Request Control Variables: <br /> * getleaves <br /> ** Used to obtain leaf counts of hubs given <br /> ** 4th field ultilized for current leaf count. <br /> ** 7th field ultilized for maximum leaf slots possible. <br /> ** Use this as 'getleaves=1' or 'getleaves' to enable. <br /> * getclusters <br /> ** Enables/Disables clustering. <br /> ** Use this as 'getclusters=1'. <br /> ** Using 'getclusters' or 'getclusters=0' disables cluster output. <br /> * getvendors <br /> ** Used to obtain the vendor code w/ version number of the hubs given. <br /> ** Found in the 5th field. <br /> ** Use this as 'getvendors=1' or 'getvendors' to enable. <br /> * getuptime <br /> ** Used to obtain the vendor code w/ version number of the hubs given. <br /> ** Value is static, do not change the value given when time passes. <br /> ** Found in the 6th field. <br /> ** Use this as 'getuptime=1' or 'getuptime' to enable. <br /> * spec <br /> ** To force the specification parameter <br /> ** Currently is only supported by Beacon Cache II <br /> * pv <br /> ** Similar to the 'spec' parameter, except that it does not force, instead it simply negotiates the specification. <br /> Special Data Requests <br /> * info <br /> ** Outputs extra details of your cache. <br /> *** Start with the informational response: I| <br /> **** Ex: I|open-source|1 <br /> * support <br /> ** Outputs USEFUL details of your cache. <br /> *** Start with the informational response: I| <br /> **** Ex: I|support|gnutella2 <br /> * getnetworks <br /> ** Outputs the enabled networks in two formats. <br /> *** Start with the informational response: I| <br /> **** For the 'I|nets|' line <br /> ***** The third field contains the supported networks joined by '-'. <br /> **** For the 'I|networks|' line <br /> ***** Interpret the fields from 3 and beyond as individual network names to challenge against. <br /> *** Examples <br /> **** <br /> ***** I|nets|gnutella-gnutella2 <br /> ***** I|networks|gnutella|gnutella2 <br /> Update Extension Variables: <br /> * x_leaves <br /> ** Number of leaves running on a given hub or ultrapeer. <br /> ** '''Value must not be greater than an integer value of 2047.''' <br /> ** '''Note: It is important to know that PHP automaticaly replace dots with underscores, so to keep compatibility with old/new version of clients all caches should support both variants, example: x.leaves x_leaves''' <br /> * x_max <br /> ** Maximum number of leaves possible on a given hub or ultrapeer. <br /> ** '''Value must not be greater than an integer value of 2047.''' <br /> * uptime <br /> ** Value submitted must be an integer value of the number of seconds of uptime. <br /> ** '''Value must not be greater than an integer value of 1 year (31536000) and less than 1 hour (60).''' <br /> <br /> === Pinging Caches With Your Cache ===<br /> '''Please follow this standard:''' <br /> * '''Client: TEST''' <br /> * '''Version: Your Cache's Name''' <br /> ** The old value for &quot;version&quot; was 1 <br /> '''Some variables to attach to the ping (compatibility):''' <br /> * '''multi''' <br /> ** Used by some gwcs in their pings to other gwcs. <br /> ** &lt;nowiki&gt;It tells the pinged cache to ignore the &quot;net&quot; parameter (so it should never say network not supported) and outputting the pong using this format, if possible, &quot;I|pong|[cache name] [cache version]|[supported networks list]&quot; - example: I|pong|Skulls 0.2.9|gnutella-gnutella2 &lt;/nowiki&gt;<br /> ** Used by Skulls GWC only, supported by Skulls and Beacon Cache II. <br /> * '''cache''' <br /> ** This is added to every request made by some gwcs, it is for statistical purposes only. <br /> ** It simply tells the remote cache that the client is a GWC. <br /> '''Help''' <br /> * For PHP <br /> ** Use the fsockopen() function to open a connection to a cache. <br /> *** Make sure you &quot;write&quot; to the fsockopen carry value to open the GWC's target file. <br /> **** [http://us.php.net/manual/en/function.fsockopen.php http://us.php.net/manual/en/function.fsockopen.php] <br /> <br /> === Variable Combination Standards ===<br /> '''Net variable decides specification!''' <br /> * There are many ways to determine spec., but going with net is the safe way. <br /> * Skulls GWC does not use the network parameter to determine specification level. <br /> * Beacon Cache (I and II) uses the network parameter to determine the specification level. <br /> '''Your cache needs to be able to process certain combinations of variables.''' <br /> * Update variable <br /> ** Update should not fail if absent if spec. 2. <br /> *** A Specification 2 parameter. <br /> Spec 1 parameters used in Spec 2: <br /> * Should still accept hostfile and urlfile responses for spec. 2. <br /> ** Beacon Cache (I and II) accepts these parameters on spec 2. <br /> The 'spec' paameter can be used to force a specification: <br /> * Only known to exist in Beacon Cache II, it can force the request to be handled as a specification 1 or 2 request. <br /> * Spec 1 = 'spec=1' <br /> * Spec 2 = 'spec=2' <br /> * If 'spec' is not equal to any current spec, then default to the predetermined spec. <br /> '''Multiple variable requests''' <br /> * If for instance a ping and request exist, you should always handle them properly. <br /> ** Same goes with other combos like an update and ping, statfile + ping and info. <br /> * Handle multiple variables as BEST as possible! <br /> ** Some scanners and GWCs like to fit all their requests into one URL send. <br /> <br /> === Further Information: ===<br /> * [http://www.gnucleus.com/gwebcache/ Original GWC] [http://www.gnucleus.com/gwebcache/ site] <br /> ** [http://gnucleus.sourceforge.net/gwebcache/specs.html GWC Spec. 1] <br /> ** [http://gnucleus.sourceforge.net/gwebcache/newgwc.html GWC Spec. 2] <br /> <br /> === Gnutella Web Cache ===<br /> Gnutella requires Gnutella Web Caches (GWC) to get IPs to establish a connection to the network. These are critical to ensuring the health of the network. If you have a dedicated server and can spare some extra bandwidth then please consider running a GWC. People that don't have a dedicated server or are on normal broadband consumer lines should not run a cache from home.<br /> <br /> A GWC is a simple script that can be put on any webserver that supports one of the following scripting languages:<br /> *JSP (Java Servlet)<br /> **[http://web.archive.org/web/20061108091447/http://www.mager.org/GWebCache/ Java Servlet GWebCache Application (Archive.org)]<br /> *C<br /> **[http://ghostwhitecrab.com/crab/ GhostWhiteCrab]<br /> *Perl <br /> **[http://www.jonatkins.com/perlgcache/ Jon Atkins' perlgcache] <br /> **The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache]<br /> *PHP <br /> **[http://gwcii.sourceforge.net/ PHPGnuCacheII] - MySQL<br /> **[http://www.bazookanetworks.com Bazooka G2WC] (recommended) - flat files<br /> **[http://sourceforge.net/projects/skulls/ Skulls! Multi-Network WebCache] - flat files<br /> ====Further Information:====<br /> *[http://www.gnucleus.com/gwebcache/|Original GWC site]<br /> <br /> <br /> {{RecoveredPage|--&gt;Saved in timestamp 20090421202728Retrieved from &quot;[https://www.pantheraproject.net/wiki/index.php?title=GWC This page was last modified on April 18, 2009, at 23:25. &lt;/center&gt;<br /> <br /> &lt;center&gt;Copyright © 2002-2009 Shareaza Development Team. &lt;/center&gt;&lt;center&gt;[[Image:poweredby_mediawiki_88x31.png]] --[[User:Ocexyz|Ocexyz]] 16:20, 27 July 2009 (UTC)}}<br /> <br /> {{RecoveredPage|Warninig: here ends pasted better formatted recovery. Row recovery has been mooved below as I don't know if anybody has made any changes in it. If not then row recovery can be deleted I suppose. Paste starts from == Shareaza Specific Details == and ends at second == Shareaza Specific Details ==, here. I hope it is visible. --[[User:Ocexyz|Ocexyz]] 16:20, 27 July 2009 (UTC) }}<br /> <br /> ==Shareaza Specific Details==<br /> <br /> {{RecoveredPage|Warninig: here ends pasted better formatted recovery. Row recovery has been mooved below as I don't know if anybody has made any changes in it. If not then row recovery can be deleted I suppose. Paste starts from &gt;&gt;Shareaza Specific Details&lt;&lt; and ends at second &gt;&gt; Shareaza Specific Details&lt;&lt;, here. I hope it is visible. --[[User:Ocexyz|Ocexyz]] 23:27, 27 July 2009 (UTC) }}<br /> <br /> * Get String Breakdown:<br /> o Update a leaf<br /> + &quot;?update=1&amp;ip=(ip):(port)&amp;x_leaves=(leaf count) <br /> o Ping Variable<br /> + Appends &amp;ping=1 to identify the cache name in debug messages (for gnutella and gnutella2 in 2.4.0.0, but only for gnutella2 now in 2.4.0.X for spec1 cache compatibility).<br /> + This feature new to Shareaza. <br /> o Network Variable<br /> + Appends &amp;net=gnutella2 on Gnutella2 queries.<br /> + Does NOT append a network variable on Gnutella(1) queries. <br /> o Client Name / Version Format (2.4.0.0 and earlier):<br /> + &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )<br /> + &amp;version=(Shareaza's version) <br /> o Client Name / Version Format (2.4.0.X):<br /> + If Gnutella<br /> # &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )<br /> # &amp;version=(Shareaza's version) <br /> + If Gnutella2<br /> # &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )+(Shareaza's version) <br /> <br /> <br /> <br /> * GWC Response Matching:<br /> o i|<br /> + Informational output alone will not be taken as GWC 'success.' <br /> o i|access|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to make a request to the cache. <br /> o i|update|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to update to the cache. <br /> o i|force|remove and i|update|warning|bad url<br /> + Remove the GWC from the internal list. <br /> o Some Response Matches (added in 2.3.1.X)<br /> + i|NO-URL-NO-HOSTS<br /> # Outputs warning of the cache being totally empty to the system log. <br /> + i|NO-URL<br /> # Outputs warning of the cache having no alternative URLs to the system log. <br /> + i|NO-HOSTS<br /> # Outputs warning of the cache having no hosts to the system log. <br /> + i|warning|<br /> # Outputs warning of the cache to the system log. <br /> + ERROR Something Failed<br /> # Outputs warning of the cache to the system log(Buggy Bazooka GWCs workaround). <br /> + i|warning|You came back too early (2.3.1.X)<br /> + i|warning|client|early (2.3.1.X)<br /> + WARNING: You came back too early (2.3.1.X)<br /> + ERROR: Client returned too early (2.3.1.X)<br /> # Flood detection for the update side.<br /> # Outputs GWebCache(update) Too many connection attempts to the system log. <br /> + too early (2.3.1.X)<br /> + early (2.4.0.X)<br /> # Flood detection for the request side.<br /> # Outputs GWebCache URL: Too many connection attempts to the system log. <br /> + i|update|OK<br /> # Outputs &quot;GWebCache(v2) Update Passed: &quot; to the system log. <br /> + OK<br /> # Outputs &quot;GWebCache(v1) Update Passed: &quot; to the system log. <br /> <br /> <br /> <br /> * GWC Response Matching:<br /> o i|<br /> + Informational output alone will not be taken as GWC 'success.' <br /> o i|access|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to make a request to the cache. <br /> o i|update|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to update to the cache. <br /> o i|force|remove and i|update|warning|bad url<br /> + Remove the GWC from the internal list. <br /> o Some Response Matches (added in 2.3.1.X)<br /> + i|NO-URL-NO-HOSTS<br /> # Outputs warning of the cache being totally empty to the system log. <br /> + i|NO-URL<br /> # Outputs warning of the cache having no alternative URLs to the system log. <br /> + i|NO-HOSTS<br /> # Outputs warning of the cache having no hosts to the system log. <br /> + i|warning|<br /> # Outputs warning of the cache to the system log. <br /> + ERROR Something Failed<br /> # Outputs warning of the cache to the system log(Buggy Bazooka GWCs workaround). <br /> + i|warning|You came back too early (2.3.1.X)<br /> + i|warning|client|early (2.3.1.X)<br /> + WARNING: You came back too early (2.3.1.X)<br /> + ERROR: Client returned too early (2.3.1.X)<br /> # Flood detection for the update side.<br /> # Outputs GWebCache(update) Too many connection attempts to the system log. <br /> + too early (2.3.1.X)<br /> + early (2.4.0.X)<br /> # Flood detection for the request side.<br /> # Outputs GWebCache URL: Too many connection attempts to the system log. <br /> + i|update|OK<br /> # Outputs &quot;GWebCache(v2) Update Passed: &quot; to the system log. <br /> + OK<br /> # Outputs &quot;GWebCache(v1) Update Passed: &quot; to the system log. <br /> <br /> <br /> <br /> ==Gnutella Web Cache Specifications==<br /> &lt;end of partial recovery by OCE&gt;<br /> <br /> <br /> <br /> <br /> &lt;end of recovered content&gt;<br /> <br /> &lt;row recovery, start&gt; <br /> Specification 1:<br /> <br /> * Networks Served<br /> o Gnutella <br /> * Format<br /> o Update went fine:<br /> + Ex: OK <br /> o Update Warning (Small prob., not that bad):<br /> + Ex: <br /> <br /> OK<br /> WARNING: Error Message<br /> <br /> * Severe Warning (No 'OK' message sent)<br /> o Ex: <br /> <br /> WARNING: Error Message<br /> <br /> * URL Output:<br /> o Ex: http://somefreakinrandomcache.com/cache/gcache.php<br /> + OR - WITH A PORT NUMBER (If not 80)<br /> # Ex: http://somefreakinrandomcache.com:8080/cache/gcache.php <br /> * Host Output:<br /> o Ex: 66.132.55.12:6346 <br /> * Pong (ping variable response) - was explained below under the topic: variables.<br /> * Example Cache Output (Beacon Cache) For urlfile Command<br /> o Example &quot;urlfile Output&quot; URL: Ex: http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;urlfile=1<br /> + Example URL Output: <br /> <br /> <br /> Getting urls with a pong combined<br /> <br /> PONG Beacon Cache 0.1.5D Beta<br /> http://gwc.frodoslair.net/skulls/skulls.php<br /> http://bbs.robertwoolley.co.uk/GWebCache/gcache.php<br /> http://g2.tjtech.org/g2/<br /> http://g2.tjtech.org/g2/index.php<br /> http://gwc.monnsta.net/<br /> http://holograph.uni.cc/other/skulls.php<br /> http://gwc.nickstallman.net/<br /> http://gwc.eod.cc/skulls.php<br /> http://gwc.frodoslair.net/skulls/skulls<br /> http://gwc.werwin.net/skulls.php<br /> <br /> <br /> * Example Cache Output (Beacon Cache) For hostfile Command<br /> o Example &quot;hostfile Output&quot; URL: Ex: http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;hostfile=1<br /> + Example Host Output: <br /> <br /> <br /> Getting the hosts with a pong combined<br /> <br /> PONG Beacon Cache 0.1.5D Beta<br /> 71.8.84.153:3915<br /> 99.248.214.157:27529<br /> 69.60.241.55:16369<br /> 193.253.239.246:30218<br /> 68.156.175.121:6348<br /> 71.179.7.241:18344<br /> 74.196.22.241:6348<br /> 12.210.197.194:10531<br /> 222.150.143.77:10000<br /> 58.85.231.135:6346<br /> 24.141.199.164:20205<br /> 72.175.201.195:6348<br /> 69.81.129.228:4880<br /> 97.81.221.63:13219<br /> 70.15.130.224:7759<br /> 216.211.188.106:51903<br /> 75.167.168.156:48660<br /> 12.214.14.3:35916<br /> 76.177.244.106:24180<br /> 98.165.218.139:39630<br /> 68.112.182.125:3685<br /> 68.117.204.57:23482<br /> 65.12.154.25:40760<br /> 69.180.47.169:5711<br /> 75.138.40.173:24987<br /> 98.201.19.0:33662<br /> 70.187.2.144:6348<br /> 68.186.209.107:14429<br /> 69.159.7.61:6348<br /> 76.208.176.196:48199<br /> <br /> <br /> * For combining a hostfile and urlfile request:<br /> o Warning: This is non-standard.<br /> o Example Cache Output (Beacon Cache) For bfile Command<br /> + Example &quot;bfile Output&quot; URL: Ex: http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;bfile=1<br /> # Example Host and URL Output: <br /> <br /> <br /> Getting the hosts and urls with a pong combined<br /> <br /> PONG Beacon Cache 0.1.5D Beta<br /> 71.8.84.153:3915<br /> 99.248.214.157:27529<br /> 69.60.241.55:16369<br /> 193.253.239.246:30218<br /> 68.156.175.121:6348<br /> 71.179.7.241:18344<br /> 74.196.22.241:6348<br /> 12.210.197.194:10531<br /> 222.150.143.77:10000<br /> 58.85.231.135:6346<br /> 24.141.199.164:20205<br /> 72.175.201.195:6348<br /> 69.81.129.228:4880<br /> 97.81.221.63:13219<br /> 70.15.130.224:7759<br /> 216.211.188.106:51903<br /> 75.167.168.156:48660<br /> 12.214.14.3:35916<br /> 76.177.244.106:24180<br /> 98.165.218.139:39630<br /> 68.112.182.125:3685<br /> 68.117.204.57:23482<br /> 65.12.154.25:40760<br /> 69.180.47.169:5711<br /> 75.138.40.173:24987<br /> 98.201.19.0:33662<br /> 70.187.2.144:6348<br /> 68.186.209.107:14429<br /> 69.159.7.61:6348<br /> 76.208.176.196:48199<br /> http://gwc.frodoslair.net/skulls/skulls.php<br /> http://bbs.robertwoolley.co.uk/GWebCache/gcache.php<br /> http://g2.tjtech.org/g2/<br /> http://g2.tjtech.org/g2/index.php<br /> http://gwc.monnsta.net/<br /> http://holograph.uni.cc/other/skulls.php<br /> http://gwc.nickstallman.net/<br /> http://gwc.eod.cc/skulls.php<br /> http://gwc.frodoslair.net/skulls/skulls<br /> http://gwc.werwin.net/skulls.php<br /> <br /> <br /> * Variables<br /> o Mandatory<br /> + ping:<br /> # Response should have this always: PONG<br /> # After, put the cache's name. ex: PONG fakecache 0.01<br /> + client:<br /> # Four letter code of the client. ex: RAZA <br /> + version:<br /> # Version number of the client. <br /> + urlfile:<br /> # Used by the client to request alternate cache urls. <br /> + hostfile:<br /> # Used by the client to request IPs with port numbers attached. <br /> + url:<br /> # Client update giving an alternate cache URL.<br /> # Formatted with a http:// prefix to each cache. <br /> + ip:<br /> # Client update giving one's IP to submit. <br /> + url1:<br /> # OLD OUTDATED Client update giving an alternate cache URL.<br /> # Formatted with a http:// prefix to each cache. <br /> + ip1:<br /> # OLD OUTDATED Client update giving one's IP to submit. <br /> o Optional<br /> + bfile:<br /> # For clients to request both URLs and IPs from the cache at the same time. <br /> + statfile:<br /> # Statistics of the cache request:<br /> * First line: Total requests of the cache number.<br /> * Second line: Requests of the cache an hour number.<br /> * Third line: Updates of the cache an hour number. <br /> <br /> Specification 2:<br /> <br /> * Networks Served<br /> o Gnutella, Gnutella2, etc. <br /> * Format<br /> o Information Output<br /> + Starts with: I|<br /> # Categories<br /> * Pong (ping variable response) - Described below under the topic: variables.<br /> * Update Status Response<br /> o Format: I|update<br /> o Responses<br /> + I|update|OK<br /> # - Everything went fine. <br /> + I|update|OK|WARNING<br /> # Small warning. <br /> + I|update|WARNING<br /> # Severe warning <br /> * Plain Warnings<br /> o Format: I|WARNING<br /> + Append any warning messages after it - Ex: I|WARNING|You came back too early <br /> * Extra Info - Described below under the topic: variables. <br /> o Host Output<br /> + Starts with: H|<br /> + Add the IP with its port:<br /> # Ex: H|0.0.0.0:6346 <br /> + Add the time, thereafter, of the host's (In seconds*) time in cache:<br /> # Ex: H|0.0.0.0:6346|45 <br /> + If cluster exists with cluster=somerandomwords<br /> # Add the clustered words after the host's age:<br /> * Ex: H|0.0.0.0:6346|45|somerandomwords <br /> o URL Output<br /> + Starts with: U|<br /> + Add the URL with http:// before it, plus the port (if it's not 80).<br /> # Ex: U|http://somerandomcache.com/ <br /> + Add the time, thereafter, of the URL's time (In seconds*) in cache:<br /> # Ex: U|http://somerandomcache.com/|45 <br /> o Example Cache Output (Beacon Cache) For get Command<br /> + Example URL: http://grantgalitz.com/Beacon/gwc.php?get=1&amp;client=RAZA&amp;version=2.3.1.3&amp;net=gnutella2&amp;ping=1<br /> # Example &quot;Get&quot; Output: <br /> <br /> <br /> Getting the hosts and urls with a pong combined<br /> <br /> I|pong|Beacon Cache 0.1.5D Beta|gnutella-gnutella2<br /> H|65.9.200.243:4968|248261<br /> H|68.228.129.75:44599|242678<br /> H|98.240.196.122:8206|240719<br /> H|76.104.12.133:14921|218273<br /> H|69.136.1.12:3924|211610<br /> H|81.154.208.71:8595|174402<br /> H|97.96.105.51:2076|153610<br /> H|74.192.153.212:39340|144203<br /> H|72.190.106.57:12584|132984<br /> H|78.93.71.132:12334|125668<br /> H|82.43.248.184:27560|97974<br /> H|196.205.224.97:6357|86763<br /> H|74.129.219.30:33172|82005<br /> H|76.104.12.133:19185|57182<br /> H|69.59.83.131:18442|38628<br /> U|http://www.k33bz.com/g2/bazooka.php|248639<br /> U|http://gwebcache.ns1.net/|248592<br /> U|http://gwc2.wodi.org/skulls.php|248384<br /> U|http://gwc.guufshop.com/skulls/skulls.php|248322<br /> U|http://groovy.syxy.com/up/skulls.php|248300<br /> U|http://g2.tjtech.org/g2/index.php|247770<br /> U|http://midian.jayl.de/g2/bazooka.php|240719<br /> U|http://www.dom2porno.info/skulls/skulls.php|207473<br /> U|http://gwc.frodoslair.net/skulls/skulls|125668<br /> U|http://holograph.uni.cc/other/skulls.php|9642<br /> <br /> <br /> * Variables<br /> o Mandatory<br /> + ping:<br /> # Main Part: I|pong|<br /> # Then add the cache name and version: I|pong|fakecache 0.01<br /> # Then lastly add the network support:<br /> * I|pong|fakecache 0.01|gnutella<br /> o - Gnutella only <br /> * I|pong|fakecache 0.01|gnutella2<br /> o - Gnutella2 only <br /> * I|pong|fakecache 0.01|gnutella-gnutella2<br /> o - Gnutella and Gnutella2 served <br /> + get:<br /> # Used by clients to requests alternate cache URLs along with IPs and their port numbers. <br /> + update:<br /> # url:<br /> * Client update giving an alternate cache URL.<br /> * Formatted with a http:// prefix to each cache. <br /> # ip:<br /> * Client update giving one's IP to submit. <br /> + net:<br /> # Which network to serve the client.<br /> * Gnutella<br /> o Ex: net=gnutella <br /> * Gnutella2<br /> o Ex: net=gnutella2 <br /> * Should always be lowercase<br /> o GWCs should automatically convert network name given to lowercase to prevent Net ID mismatches <br /> <br /> solely on case alone.<br /> <br /> *<br /> o<br /> + client:<br /> # Four letter code of the client. ex: RAZA <br /> + version:<br /> # Version number of the client. <br /> o Optional<br /> + cluster:<br /> # To add extra info to an IP update.<br /> * Output by cache: H|0.0.0.0|AGE OF HOST (Seconds)|clustering some bull**** <br /> + statfile:<br /> # Exactly like the specification 1 statfile (Same routine and output style).<br /> # Statistics of the cache request:<br /> * First line: Total requests of the cache number.<br /> * Second line: Requests of the cache an hour number.<br /> * Third line: Updates of the cache an hour number. <br /> <br /> Specification 2.1<br /> <br /> * This is an extension of specification 2, not a separate specification!<br /> * Pong extension<br /> o Append the networks supported joined by a hyphen '-'.<br /> o Used for client-side validation of networks supported and for network support reporting to other web caches.<br /> o Format:<br /> + I|pong|cache name|network names joined by '-'<br /> + Format Examples:<br /> # I|pong|fakecache 0.01|gnutella<br /> * - Gnutella only <br /> # I|pong|fakecache 0.01|gnutella2<br /> * - Gnutella2 only <br /> # I|pong|fakecache 0.01|gnutella-gnutella2<br /> * - Gnutella and Gnutella2 served <br /> * Host Output<br /> o Just like specification 2, but with more fields supported for host output.<br /> + H|ip:port|age in cache|clustering|leaves|4 letter vendor code|reported uptime of host|max. leaves possible<br /> # The host, age, and clustering fields are all still the same as in specification 2.<br /> # The leaf count of the hub reported is in the 5th field.<br /> # The vendor code with version number is in the 6th field. <br /> * Request Control Variables:<br /> o getleaves<br /> + Used to obtain leaf counts of hubs given<br /> + 4th field ultilized for current leaf count.<br /> + 7th field ultilized for maximum leaf slots possible.<br /> + Use this as 'getleaves=1' or 'getleaves' to enable. <br /> o getclusters<br /> + Enables/Disables clustering.<br /> + Use this as 'getclusters=1'.<br /> + Using 'getclusters' or 'getclusters=0' disables cluster output. <br /> o getvendors<br /> + Used to obtain the vendor code w/ version number of the hubs given.<br /> + Found in the 5th field.<br /> + Use this as 'getvendors=1' or 'getvendors' to enable. <br /> o getuptime<br /> + Used to obtain the vendor code w/ version number of the hubs given.<br /> + Value is static, do not change the value given when time passes.<br /> + Found in the 6th field.<br /> + Use this as 'getuptime=1' or 'getuptime' to enable. <br /> o spec<br /> + To force the specification parameter<br /> + Currently is only supported by Beacon Cache II <br /> o pv<br /> + Similar to the 'spec' parameter, except that it does not force, instead it simply negotiates the specification. <br /> * Special Data Requests<br /> o info<br /> + Outputs extra details of your cache.<br /> # Start with the informational response: I|<br /> * Ex: I|open-source|1 <br /> o support<br /> + Outputs USEFUL details of your cache.<br /> # Start with the informational response: I|<br /> * Ex: I|support|gnutella2 <br /> o getnetworks<br /> + Outputs the enabled networks in two formats.<br /> # Start with the informational response: I|<br /> * For the 'I|nets|' line<br /> o The third field contains the supported networks joined by '-'. <br /> * For the 'I|networks|' line<br /> o Interpret the fields from 3 and beyond as individual network names to challenge against. <br /> # Examples<br /> *<br /> o I|nets|gnutella-gnutella2<br /> o I|networks|gnutella|gnutella2 <br /> * Update Extension Variables:<br /> o x_leaves<br /> + Number of leaves running on a given hub or ultrapeer.<br /> + Value must not be greater than an integer value of 2047.<br /> + Note: It is important to know that PHP automaticaly replace dots with underscores, so to keep compatibility with old/new version of clients all caches should support both variants, example: x.leaves x_leaves<br /> o x_max<br /> + Maximum number of leaves possible on a given hub or ultrapeer.<br /> + Value must not be greater than an integer value of 2047. <br /> o uptime<br /> + Value submitted must be an integer value of the number of seconds of uptime.<br /> + Value must not be greater than an integer value of 1 year (31536000) and less than 1 hour (60). <br /> <br /> Pinging Caches With Your Cache<br /> <br /> * Please follow this standard:<br /> o Client: TEST<br /> o Version: Your Cache's Name<br /> + The old value for &quot;version&quot; was 1 <br /> * Some variables to attach to the ping (compatibility):<br /> o multi<br /> + Used by some gwcs in their pings to other gwcs.<br /> + It tells the pinged cache to ignore the &quot;net&quot; parameter (so it should never say network not supported) and outputting the pong using this format, if possible, &quot;I|pong|[cache name] [cache version]|[supported networks list]|[url adding is enabled]&quot; - example: I|pong|Skulls 0.2.8a|gnutella-gnutella2|1<br /> + Used by Skulls GWC only, supported by Skulls and Beacon Cache II. <br /> o cache<br /> + This is added to every request made by some gwcs, it is for statistical purposes only.<br /> + It simply tells the remote cache that the client is a GWC. <br /> * Help<br /> o For PHP<br /> + Use the fsockopen() function to open a connection to a cache.<br /> # Make sure you &quot;write&quot; to the fsockopen carry value to open the GWC's target file.<br /> * http://us.php.net/manual/en/function.fsockopen.php <br /> <br /> Variable Combination Standards<br /> <br /> * Net variable decides specification!<br /> o There are many ways to determine spec., but going with net is the safe way.<br /> o Skulls GWC does not use the network parameter to determine specification level.<br /> o Beacon Cache (I and II) uses the network parameter to determine the specification level. <br /> * Your cache needs to be able to process certain combinations of variables.<br /> o Update variable<br /> + Update should not fail if absent if spec. 2.<br /> # A Specification 2 parameter. <br /> * Spec 1 parameters used in Spec 2:<br /> o Should still accept hostfile and urlfile responses for spec. 2.<br /> + Beacon Cache (I and II) accepts these parameters on spec 2. <br /> * The 'spec' paameter can be used to force a specification:<br /> o Only known to exist in Beacon Cache II, it can force the request to be handled as a specification 1 or 2 request.<br /> o Spec 1 = 'spec=1'<br /> o Spec 2 = 'spec=2'<br /> o If 'spec' is not equal to any current spec, then default to the predetermined spec. <br /> * Multiple variable requests<br /> o If for instance a ping and request exist, you should always handle them properly.<br /> + Same goes with other combos like an update and ping, statfile + ping and info. <br /> o Handle multiple variables as BEST as possible!<br /> + Some scanners and GWCs like to fit all their requests into one URL send. <br /> <br /> &lt;row recovery, end&gt; <br /> <br /> Further Information:<br /> <br /> * [http://www.gnucleus.com/gwebcache/ Original GWC site]<br /> ** [http://gnucleus.sourceforge.net/gwebcache/specs.html GWC Spec. 1]<br /> ** [http://gnucleus.sourceforge.net/gwebcache/newgwc.html GWC Spec. 2] <br /> <br /> <br /> <br /> <br /> <br /> &lt;content recovered from last aviable backup&gt; <br /> <br /> ===Gnutella Web Cache===<br /> Gnutella requires Gnutella Web Caches (GWC) to get IPs to establish a connection to the network. These are critical to ensuring the health of the network. If you have a dedicated server and can spare some extra bandwidth then please consider running a GWC. People that don't have a dedicated server or are on normal broadband consumer lines should not run a cache from home.<br /> <br /> A GWC is a simple script that can be put on any webserver that supports one of the following scripting languages:<br /> *JSP (Java Servlet)<br /> **[http://web.archive.org/web/20061108091447/http://www.mager.org/GWebCache/ Java Servlet GWebCache Application (Archive.org)]<br /> *C<br /> **[http://ghostwhitecrab.com/crab/ GhostWhiteCrab]<br /> *Perl <br /> **[http://www.jonatkins.com/perlgcache/ Jon Atkins' perlgcache] <br /> **The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache]<br /> *PHP <br /> **[http://gwcii.sourceforge.net/ PHPGnuCacheII] - MySQL<br /> **[http://www.bazookanetworks.com Bazooka G2WC] (recommended) - flat files<br /> **[http://sourceforge.net/projects/skulls/ Skulls! Multi-Network WebCache] - flat files<br /> === Further Information: ===<br /> * [http://www.gnucleus.com/gwebcache/ Original GWC site]<br /> <br /> [[Category:External Links]]</div>

Ale5000 https://shareaza.sourceforge.net/w/index.php?title=GWC_specs&diff=11506 2015-03-25T15:07:40Z

<p>Ale5000: Moved the original GnuWebCache to the bottom since the site is died / fixed impagination</p> <hr /> <div>''For general information on GWCs, have a look at the [[GWC]] Wiki page.''<br /> {{do not translate}}<br /> This page is thought to give an overview over the GWC specifications as they are implemented into Shareaza.<br /> <br /> A GWC is a simple script that can be put on any webserver that supports one of the following scripting languages: <br /> <br /> * JSP (Java Servlet) <br /> ** [http://www1.mager.org/GWebCache/ Jums Web Cache] (Excellent for heavy loads) <br /> * C <br /> ** [http://wiki.limewire.org/index.php?title=GhostWhiteCrab GhostWhiteCrab] (For dedicated server environments and people who know how to compile C source code!) <br /> * ASP <br /> ** [http://www.edazzle.net/downloads/gerry.zip Gerry GWC] <br /> ** [https://www.planet-source-code.com/vb/scripts/ShowCode.asp?txtCodeId=7846&amp;lngWId=4 Lynn (v.s. 0.5)] <br /> ** [https://www.planet-source-code.com/vb/scripts/ShowCode.asp?txtCodeId=7731&amp;lngWId=4 Lynn (v.s. 0.4)] <br /> ** [http://www.poundwebhosting.com/cgi-bin/lynnx.asp LynnX] <br /> * Perl <br /> ** [http://www.jonatkins.com/perlgcache/ Jon Atkins' perlgcache] <br /> ** The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache] <br /> * '''PHP''' ''(Tip: PHP GWCs are usually the easiest to run and setup on a server.)''<br /> ** [http://gwcii.sourceforge.net/ PHPGnuCacheII] <br /> ** [http://www.bazookanetworks.com/ Bazooka G2WC] <br /> ** [http://sourceforge.net/projects/skulls/ Skulls! Multi-Network WebCache] <br /> ** [http://sourceforge.net/projects/beaconcache/ Beacon Cache] <br /> ** [http://code.google.com/p/cachechu/ Cachechu G2WC] <br /> ** The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache] ''(PHP version is no longer supported)'' <br /> <br /> == Breakdown Of The Gnutella Web Caches: == <br /> {{RecoveredPage|I recently put this into a table. The contents need to be verified -- [[User:Cyko 01|Cyko 01]]}}<br /> <br /> {| width= auto; style=&quot;font-size: 85%; text-align: center;text-valign: middle;&quot; class=&quot;wikitable&quot;<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Cache:<br /> ! rowspan=1 |Gnutella:<br /> ! rowspan=1 |Gnutella2:<br /> ! rowspan=1 |Spec 1:<br /> ! rowspan=1 |Spec 2:<br /> ! rowspan=1 |Flat-File:<br /> ! rowspan=1 |SQL:<br /> ! rowspan=1 |Installer:<br /> ! rowspan=1 |Other Networks:<br /> ! rowspan=1 |Different network instances:<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Beacon Cache (Core 2)<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> |style=&quot;background: #CCFFCC;&quot;| Yes (As of 0.2.0 Alpha)<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Beacon Cache (Core 1)<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Skulls<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|JumsWebCache<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|GnuWebCache (Perl)<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|GnuWebCache (PHP) <br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|GhostWhiteCrab(GWC) <br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> |style=&quot;background: #FFFFCC;&quot;| N/A<br /> |style=&quot;background: #FFFFCC;&quot;| N/A<br /> |style=&quot;background: #FFFFCC;&quot;| N/A<br /> | {{yes}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|PHPGnuCacheII <br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Bazooka <br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Cachechu<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Perlgcache<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Gerry GWC (v2)<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Gerry GWC (v1)<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Lynn<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|LynnX<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |}<br /> <br /> == Shareaza Specific Details == <br /> <br /> {{RecoveredPage|Warninig: here I have pasted better formatted recovery, but not verified. Row recovery has been mooved below as I don't know if anybody has made any changes in it. If not then row recovery can be deleted. Paste starts from &gt;&gt;Shareaza Specific Details&lt;&lt;, here, and ends at second &gt;&gt;Shareaza Specific Details&lt;&lt; I hope it is visible. --[[User:Ocexyz|Ocexyz]] 23:27, 27 July 2009 (UTC)}}<br /> <br /> '''Get String Breakdown:''' <br /> * Update a leaf <br /> ** &quot;?update=1&amp;ip=(ip):(port)&amp;x_leaves=(leaf count) <br /> * Ping Variable <br /> ** Appends &amp;ping=1 to identify the cache name in debug messages (for gnutella and gnutella2 in 2.4.0.0, but only for gnutella2 now in 2.4.0.X for spec1 cache compatibility). <br /> ** This feature new to Shareaza. <br /> * Network Variable <br /> ** Appends &amp;net=gnutella2 on Gnutella2 queries. <br /> ** Does NOT append a network variable on Gnutella(1) queries. <br /> * Client Name / Version Format (2.4.0.0 and earlier): <br /> ** &amp;client=(Shareaza 4 letter code (RAZA / RAZB) ) <br /> ** &amp;version=(Shareaza's version) <br /> * Client Name / Version Format (2.4.0.X): <br /> ** If Gnutella <br /> *** &amp;client=(Shareaza 4 letter code (RAZA / RAZB) ) <br /> *** &amp;version=(Shareaza's version) <br /> ** If Gnutella2 <br /> *** &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )+(Shareaza's version) <br /> <br /> '''GWC Response Matching:''' <br /> * i| <br /> ** Informational output alone will not be taken as GWC 'success.' <br /> * i|access|period|(time in sec.) <br /> ** Time in seconds before Shareaza is allowed to make a request to the cache. <br /> * i|update|period|(time in sec.) <br /> ** Time in seconds before Shareaza is allowed to update to the cache. <br /> * i|force|remove and i|update|warning|bad url <br /> ** Remove the GWC from the internal list. <br /> * Some Response Matches (added in 2.3.1.X) <br /> ** i|NO-URL-NO-HOSTS <br /> *** Outputs warning of the cache being totally empty to the system log. <br /> ** i|NO-URL <br /> *** Outputs warning of the cache having no alternative URLs to the system log. <br /> ** i|NO-HOSTS <br /> *** Outputs warning of the cache having no hosts to the system log. <br /> ** i|warning| <br /> *** Outputs warning of the cache to the system log. <br /> ** ERROR Something Failed <br /> *** Outputs warning of the cache to the system log(Buggy Bazooka GWCs workaround). <br /> ** i|warning|You came back too early (2.3.1.X) <br /> ** i|warning|client|early (2.3.1.X) <br /> ** WARNING: You came back too early (2.3.1.X) <br /> ** ERROR: Client returned too early (2.3.1.X) <br /> *** Flood detection for the update side. <br /> *** Outputs GWebCache(update) Too many connection attempts to the system log. <br /> ** too early (2.3.1.X) <br /> ** early (2.4.0.X) <br /> *** Flood detection for the request side. <br /> *** Outputs GWebCache URL: Too many connection attempts to the system log. <br /> ** i|update|OK <br /> *** Outputs &quot;GWebCache(v2) Update Passed: &quot; to the system log. <br /> ** OK <br /> *** Outputs &quot;GWebCache(v1) Update Passed: &quot; to the system log. <br /> <br /> == Gnutella Web Cache Specifications ==<br /> ==== Specification 1: ====<br /> * '''Networks Served''' <br /> ** Gnutella <br /> * '''Format''' <br /> ** Update went fine: <br /> *** Ex: OK <br /> ** Update Warning (Small prob., not that bad): <br /> *** Ex: OKWARNING: Error Message <br /> <br /> * Severe Warning (No 'OK' message sent) <br /> ** Ex: WARNING: Error Message<br /> <br /> * URL Output: <br /> ** Ex: [http://somefreakinrandomcache.com/cache/gcache.php http://somefreakinrandomcache.com/cache/gcache.php] <br /> *** OR - WITH A PORT NUMBER (If not 80) <br /> **** Ex: [http://somefreakinrandomcache.com:8080/cache/gcache.php http://somefreakinrandomcache.com:8080/cache/gcache.php] <br /> * Host Output: <br /> ** Ex: 66.132.55.12:6346 <br /> * Pong (ping variable response) - was explained below under the topic: variables. <br /> * '''Example Cache Output (Beacon Cache) For urlfile Command''' <br /> ** Example &quot;urlfile Output&quot; URL: Ex: [http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;urlfile=1 http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;urlfile=1] <br /> *** Example URL Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting urls with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | PONG Beacon Cache 0.1.5D Beta[http://gwc.frodoslair.net/skulls/skulls.php http://gwc.frodoslair.net/skulls/skulls.php][http://bbs.robertwoolley.co.uk/GWebCache/gcache.php http://bbs.robertwoolley.co.uk/GWebCache/gcache.php][http://g2.tjtech.org/g2/ http://g2.tjtech.org/g2/][http://g2.tjtech.org/g2/index.php http://g2.tjtech.org/g2/index.php][http://gwc.monnsta.net/ http://gwc.monnsta.net/][http://holograph.uni.cc/other/skulls.php http://holograph.uni.cc/other/skulls.php][http://gwc.nickstallman.net/ http://gwc.nickstallman.net/][http://gwc.eod.cc/skulls.php http://gwc.eod.cc/skulls.php][http://gwc.frodoslair.net/skulls/skulls http://gwc.frodoslair.net/skulls/skulls][http://gwc.werwin.net/skulls.php http://gwc.werwin.net/skulls.php] <br /> <br /> |}<br /> * '''Example Cache Output (Beacon Cache) For hostfile Command''' <br /> ** Example &quot;hostfile Output&quot; URL: Ex: [http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;hostfile=1 http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;hostfile=1] <br /> *** Example Host Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting the hosts with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | PONG Beacon Cache 0.1.5D Beta71.8.84.153:391599.248.214.157:2752969.60.241.55:16369193.253.239.246:3021868.156.175.121:634871.179.7.241:1834474.196.22.241:634812.210.197.194:10531222.150.143.77:1000058.85.231.135:634624.141.199.164:2020572.175.201.195:634869.81.129.228:488097.81.221.63:1321970.15.130.224:7759216.211.188.106:5190375.167.168.156:4866012.214.14.3:3591676.177.244.106:2418098.165.218.139:3963068.112.182.125:368568.117.204.57:2348265.12.154.25:4076069.180.47.169:571175.138.40.173:2498798.201.19.0:3366270.187.2.144:634868.186.209.107:1442969.159.7.61:634876.208.176.196:48199<br /> <br /> |}<br /> * '''For combining a hostfile and urlfile request:''' <br /> ** Warning: This is non-standard. <br /> ** '''Example Cache Output (Beacon Cache) For bfile Command''' <br /> *** Example &quot;bfile Output&quot; URL: Ex: [http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;bfile=1 http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;bfile=1] <br /> **** Example Host and URL Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting the hosts and urls with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | PONG Beacon Cache 0.1.5D Beta71.8.84.153:391599.248.214.157:2752969.60.241.55:16369193.253.239.246:3021868.156.175.121:634871.179.7.241:1834474.196.22.241:634812.210.197.194:10531222.150.143.77:1000058.85.231.135:634624.141.199.164:2020572.175.201.195:634869.81.129.228:488097.81.221.63:1321970.15.130.224:7759216.211.188.106:5190375.167.168.156:4866012.214.14.3:3591676.177.244.106:2418098.165.218.139:3963068.112.182.125:368568.117.204.57:2348265.12.154.25:4076069.180.47.169:571175.138.40.173:2498798.201.19.0:3366270.187.2.144:634868.186.209.107:1442969.159.7.61:634876.208.176.196:48199[http://gwc.frodoslair.net/skulls/skulls.php http://gwc.frodoslair.net/skulls/skulls.php][http://bbs.robertwoolley.co.uk/GWebCache/gcache.php http://bbs.robertwoolley.co.uk/GWebCache/gcache.php][http://g2.tjtech.org/g2/ http://g2.tjtech.org/g2/][http://g2.tjtech.org/g2/index.php http://g2.tjtech.org/g2/index.php][http://gwc.monnsta.net/ http://gwc.monnsta.net/][http://holograph.uni.cc/other/skulls.php http://holograph.uni.cc/other/skulls.php][http://gwc.nickstallman.net/ http://gwc.nickstallman.net/][http://gwc.eod.cc/skulls.php http://gwc.eod.cc/skulls.php][http://gwc.frodoslair.net/skulls/skulls http://gwc.frodoslair.net/skulls/skulls][http://gwc.werwin.net/skulls.php http://gwc.werwin.net/skulls.php] <br /> <br /> |}<br /> '''Variables''' <br /> * '''Mandatory''' <br /> ** ping: <br /> *** Response should have this always: PONG<br /> *** After, put the cache's name. ex: PONG fakecache 0.01<br /> ** client: <br /> *** Four letter code of the client. ex: RAZA <br /> ** version: <br /> *** Version number of the client. <br /> ** urlfile: <br /> *** Used by the client to request alternate cache urls. <br /> ** hostfile: <br /> *** Used by the client to request IPs with port numbers attached. <br /> ** url: <br /> *** Client update giving an alternate cache URL. <br /> *** Formatted with a http:// prefix to each cache. <br /> ** ip: <br /> *** Client update giving one's IP to submit. <br /> ** url1: <br /> *** OLD OUTDATED Client update giving an alternate cache URL. <br /> *** Formatted with a http:// prefix to each cache. <br /> ** ip1: <br /> *** OLD OUTDATED Client update giving one's IP to submit. <br /> * '''Optional''' <br /> ** bfile: <br /> *** For clients to request both URLs and IPs from the cache at the same time. <br /> ** statfile: <br /> *** Statistics of the cache request: <br /> **** First line: Total requests of the cache number. <br /> **** Second line: Requests of the cache an hour number. <br /> **** Third line: Updates of the cache an hour number.<br /> <br /> ==== Specification 2: ====<br /> '''Networks Served''' <br /> * Gnutella, Gnutella2, etc. <br /> '''Format''' <br /> * '''Information Output''' <br /> ** Starts with: I| <br /> *** '''Categories''' <br /> **** '''Pong''' (ping variable response) - Described below under the topic: variables. <br /> **** '''Update Status Response''' <br /> ***** Format: I|update <br /> ***** '''Responses''' <br /> ****** I|update|OK <br /> ******* - Everything went fine. <br /> ****** I|update|OK|WARNING <br /> ******* Small warning. <br /> ****** I|update|WARNING <br /> ******* Severe warning <br /> **** '''Plain Warnings''' <br /> ***** Format: I|WARNING <br /> ****** Append any warning messages after it - Ex: I|WARNING|You came back too early <br /> **** '''Extra Info''' - Described below under the topic: variables. <br /> * '''Host Output''' <br /> ** Starts with: H| <br /> ** Add the IP with its port: <br /> *** Ex: H|0.0.0.0:6346 <br /> ** Add the time, thereafter, of the host's (In seconds*) time in cache: <br /> *** Ex: H|0.0.0.0:6346|45 <br /> ** If cluster exists with cluster=somerandomwords <br /> *** Add the clustered words after the host's age: <br /> **** Ex: H|0.0.0.0:6346|45|somerandomwords <br /> * '''URL Output''' <br /> ** Starts with: U| <br /> ** Add the URL with http:// before it, plus the port (if it's not 80). <br /> *** Ex: U|[http://somerandomcache.com/ http://somerandomcache.com/] <br /> ** Add the time, thereafter, of the URL's time (In seconds*) in cache: <br /> *** Ex: U|[http://somerandomcache.com/%7C45 http://somerandomcache.com/|45] <br /> * '''Example Cache Output (Beacon Cache) For get Command''' <br /> ** Example URL: [http://grantgalitz.com/Beacon/gwc.php?get=1&amp;client=RAZA&amp;version=2.3.1.3&amp;net=gnutella2&amp;ping=1 http://grantgalitz.com/Beacon/gwc.php?get=1&amp;client=RAZA&amp;version=2.3.1.3&amp;net=gnutella2&amp;ping=1] <br /> *** Example &quot;Get&quot; Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting the hosts and urls with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | I|pong|Beacon Cache 0.1.5D Beta|gnutella-gnutella2H|65.9.200.243:4968|248261H|68.228.129.75:44599|242678H|98.240.196.122:8206|240719H|76.104.12.133:14921|218273H|69.136.1.12:3924|211610H|81.154.208.71:8595|174402H|97.96.105.51:2076|153610H|74.192.153.212:39340|144203H|72.190.106.57:12584|132984H|78.93.71.132:12334|125668H|82.43.248.184:27560|97974H|196.205.224.97:6357|86763H|74.129.219.30:33172|82005H|76.104.12.133:19185|57182H|69.59.83.131:18442|38628U|[http://www.k33bz.com/g2/bazooka.php%7C248639 http://www.k33bz.com/g2/bazooka.php|248639]U|[http://gwebcache.ns1.net/%7C248592 http://gwebcache.ns1.net/|248592]U|[http://gwc2.wodi.org/skulls.php%7C248384 http://gwc2.wodi.org/skulls.php|248384]U|[http://gwc.guufshop.com/skulls/skulls.php%7C248322 http://gwc.guufshop.com/skulls/skulls.php|248322]U|[http://groovy.syxy.com/up/skulls.php%7C248300 http://groovy.syxy.com/up/skulls.php|248300]U|[http://g2.tjtech.org/g2/index.php%7C247770 http://g2.tjtech.org/g2/index.php|247770]U|[http://midian.jayl.de/g2/bazooka.php%7C240719 http://midian.jayl.de/g2/bazooka.php|240719]U|[http://www.dom2porno.info/skulls/skulls.php%7C207473 http://www.dom2porno.info/skulls/skulls.php|207473]U|[http://gwc.frodoslair.net/skulls/skulls%7C125668 http://gwc.frodoslair.net/skulls/skulls|125668]U|[http://holograph.uni.cc/other/skulls.php%7C9642 http://holograph.uni.cc/other/skulls.php|9642] <br /> <br /> |}<br /> '''Variables''' <br /> * '''Mandatory''' <br /> ** ping: <br /> *** Main Part: I|pong| <br /> *** Then add the cache name and version: I|pong|fakecache 0.01 <br /> *** Then lastly add the network support: <br /> **** I|pong|fakecache 0.01|gnutella <br /> ***** - Gnutella only <br /> **** I|pong|fakecache 0.01|gnutella2 <br /> ***** - Gnutella2 only <br /> **** I|pong|fakecache 0.01|gnutella-gnutella2 <br /> ***** - Gnutella and Gnutella2 served <br /> ** get: <br /> *** Used by clients to requests alternate cache URLs along with IPs and their port numbers. <br /> ** update: <br /> *** url: <br /> **** Client update giving an alternate cache URL. <br /> **** Formatted with a http:// prefix to each cache. <br /> *** ip: <br /> **** Client update giving one's IP to submit. <br /> ** net: <br /> *** Which network to serve the client. <br /> **** Gnutella <br /> ***** Ex: net=gnutella <br /> **** Gnutella2 <br /> ***** Ex: net=gnutella2 <br /> **** '''Should always be lowercase''' <br /> ***** GWCs should automatically convert network name given to lowercase to prevent Net ID mismatches <br /> <br /> solely on case alone. <br /> <br /> <br /> * <br /> ** client: <br /> *** Four letter code of the client. ex: RAZA <br /> ** version: <br /> *** Version number of the client. <br /> * '''Optional''' <br /> ** cluster: <br /> *** To add extra info to an IP update. <br /> **** Output by cache: H|0.0.0.0|AGE OF HOST (Seconds)|clustering some bull**** <br /> ** statfile: <br /> *** Exactly like the specification 1 statfile '''(Same routine and output style)'''. <br /> *** Statistics of the cache request: <br /> **** First line: Total requests of the cache number. <br /> **** Second line: Requests of the cache an hour number. <br /> **** Third line: Updates of the cache an hour number. <br /> <br /> ==== Specification 2.1 ====<br /> '''This is an extension of specification 2, not a separate specification!''' <br /> Pong extension <br /> * Append the networks supported joined by a hyphen '-'. <br /> * Used for client-side validation of networks supported and for network support reporting to other web caches. <br /> * Format: <br /> ** I|pong|cache name|network names joined by '-' <br /> ** Format Examples: <br /> *** I|pong|fakecache 0.01|gnutella <br /> **** - Gnutella only <br /> *** I|pong|fakecache 0.01|gnutella2 <br /> **** - Gnutella2 only <br /> *** I|pong|fakecache 0.01|gnutella-gnutella2 <br /> **** - Gnutella and Gnutella2 served <br /> Host Output <br /> * Just like specification 2, but with more fields supported for host output. <br /> ** H|ip:port|age in cache|clustering|leaves|4 letter vendor code|reported uptime of host|max. leaves possible <br /> *** The host, age, and clustering fields are all still the same as in specification 2. <br /> *** The leaf count of the hub reported is in the 5th field. <br /> *** The vendor code with version number is in the 6th field. <br /> Request Control Variables: <br /> * getleaves <br /> ** Used to obtain leaf counts of hubs given <br /> ** 4th field ultilized for current leaf count. <br /> ** 7th field ultilized for maximum leaf slots possible. <br /> ** Use this as 'getleaves=1' or 'getleaves' to enable. <br /> * getclusters <br /> ** Enables/Disables clustering. <br /> ** Use this as 'getclusters=1'. <br /> ** Using 'getclusters' or 'getclusters=0' disables cluster output. <br /> * getvendors <br /> ** Used to obtain the vendor code w/ version number of the hubs given. <br /> ** Found in the 5th field. <br /> ** Use this as 'getvendors=1' or 'getvendors' to enable. <br /> * getuptime <br /> ** Used to obtain the vendor code w/ version number of the hubs given. <br /> ** Value is static, do not change the value given when time passes. <br /> ** Found in the 6th field. <br /> ** Use this as 'getuptime=1' or 'getuptime' to enable. <br /> * spec <br /> ** To force the specification parameter <br /> ** Currently is only supported by Beacon Cache II <br /> * pv <br /> ** Similar to the 'spec' parameter, except that it does not force, instead it simply negotiates the specification. <br /> Special Data Requests <br /> * info <br /> ** Outputs extra details of your cache. <br /> *** Start with the informational response: I| <br /> **** Ex: I|open-source|1 <br /> * support <br /> ** Outputs USEFUL details of your cache. <br /> *** Start with the informational response: I| <br /> **** Ex: I|support|gnutella2 <br /> * getnetworks <br /> ** Outputs the enabled networks in two formats. <br /> *** Start with the informational response: I| <br /> **** For the 'I|nets|' line <br /> ***** The third field contains the supported networks joined by '-'. <br /> **** For the 'I|networks|' line <br /> ***** Interpret the fields from 3 and beyond as individual network names to challenge against. <br /> *** Examples <br /> **** <br /> ***** I|nets|gnutella-gnutella2 <br /> ***** I|networks|gnutella|gnutella2 <br /> Update Extension Variables: <br /> * x_leaves <br /> ** Number of leaves running on a given hub or ultrapeer. <br /> ** '''Value must not be greater than an integer value of 2047.''' <br /> ** '''Note: It is important to know that PHP automaticaly replace dots with underscores, so to keep compatibility with old/new version of clients all caches should support both variants, example: x.leaves x_leaves''' <br /> * x_max <br /> ** Maximum number of leaves possible on a given hub or ultrapeer. <br /> ** '''Value must not be greater than an integer value of 2047.''' <br /> * uptime <br /> ** Value submitted must be an integer value of the number of seconds of uptime. <br /> ** '''Value must not be greater than an integer value of 1 year (31536000) and less than 1 hour (60).''' <br /> <br /> === Pinging Caches With Your Cache ===<br /> '''Please follow this standard:''' <br /> * '''Client: TEST''' <br /> * '''Version: Your Cache's Name''' <br /> ** The old value for &quot;version&quot; was 1 <br /> '''Some variables to attach to the ping (compatibility):''' <br /> * '''multi''' <br /> ** Used by some gwcs in their pings to other gwcs. <br /> ** &lt;nowiki&gt;It tells the pinged cache to ignore the &quot;net&quot; parameter (so it should never say network not supported) and outputting the pong using this format, if possible, &quot;I|pong|[cache name] [cache version]|[supported networks list]&quot; - example: I|pong|Skulls 0.2.9|gnutella-gnutella2 &lt;/nowiki&gt;<br /> ** Used by Skulls GWC only, supported by Skulls and Beacon Cache II. <br /> * '''cache''' <br /> ** This is added to every request made by some gwcs, it is for statistical purposes only. <br /> ** It simply tells the remote cache that the client is a GWC. <br /> '''Help''' <br /> * For PHP <br /> ** Use the fsockopen() function to open a connection to a cache. <br /> *** Make sure you &quot;write&quot; to the fsockopen carry value to open the GWC's target file. <br /> **** [http://us.php.net/manual/en/function.fsockopen.php http://us.php.net/manual/en/function.fsockopen.php] <br /> <br /> === Variable Combination Standards ===<br /> '''Net variable decides specification!''' <br /> * There are many ways to determine spec., but going with net is the safe way. <br /> * Skulls GWC does not use the network parameter to determine specification level. <br /> * Beacon Cache (I and II) uses the network parameter to determine the specification level. <br /> '''Your cache needs to be able to process certain combinations of variables.''' <br /> * Update variable <br /> ** Update should not fail if absent if spec. 2. <br /> *** A Specification 2 parameter. <br /> Spec 1 parameters used in Spec 2: <br /> * Should still accept hostfile and urlfile responses for spec. 2. <br /> ** Beacon Cache (I and II) accepts these parameters on spec 2. <br /> The 'spec' paameter can be used to force a specification: <br /> * Only known to exist in Beacon Cache II, it can force the request to be handled as a specification 1 or 2 request. <br /> * Spec 1 = 'spec=1' <br /> * Spec 2 = 'spec=2' <br /> * If 'spec' is not equal to any current spec, then default to the predetermined spec. <br /> '''Multiple variable requests''' <br /> * If for instance a ping and request exist, you should always handle them properly. <br /> ** Same goes with other combos like an update and ping, statfile + ping and info. <br /> * Handle multiple variables as BEST as possible! <br /> ** Some scanners and GWCs like to fit all their requests into one URL send. <br /> <br /> === Further Information: ===<br /> * [http://www.gnucleus.com/gwebcache/ Original GWC] [http://www.gnucleus.com/gwebcache/ site] <br /> ** [http://gnucleus.sourceforge.net/gwebcache/specs.html GWC Spec. 1] <br /> ** [http://gnucleus.sourceforge.net/gwebcache/newgwc.html GWC Spec. 2] <br /> <br /> === Gnutella Web Cache ===<br /> Gnutella requires Gnutella Web Caches (GWC) to get IPs to establish a connection to the network. These are critical to ensuring the health of the network. If you have a dedicated server and can spare some extra bandwidth then please consider running a GWC. People that don't have a dedicated server or are on normal broadband consumer lines should not run a cache from home.<br /> <br /> A GWC is a simple script that can be put on any webserver that supports one of the following scripting languages:<br /> *JSP (Java Servlet)<br /> **[http://web.archive.org/web/20061108091447/http://www.mager.org/GWebCache/ Java Servlet GWebCache Application (Archive.org)]<br /> *C<br /> **[http://ghostwhitecrab.com/crab/ GhostWhiteCrab]<br /> *Perl <br /> **[http://www.jonatkins.com/perlgcache/ Jon Atkins' perlgcache] <br /> **The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache]<br /> *PHP <br /> **[http://gwcii.sourceforge.net/ PHPGnuCacheII] - MySQL<br /> **[http://www.bazookanetworks.com Bazooka G2WC] (recommended) - flat files<br /> **[http://sourceforge.net/projects/skulls/ Skulls! Multi-Network WebCache] - flat files<br /> ====Further Information:====<br /> *[http://www.gnucleus.com/gwebcache/|Original GWC site]<br /> <br /> <br /> {{RecoveredPage|--&gt;Saved in timestamp 20090421202728Retrieved from &quot;[https://www.pantheraproject.net/wiki/index.php?title=GWC This page was last modified on April 18, 2009, at 23:25. &lt;/center&gt;<br /> <br /> &lt;center&gt;Copyright © 2002-2009 Shareaza Development Team. &lt;/center&gt;&lt;center&gt;[[Image:poweredby_mediawiki_88x31.png]] --[[User:Ocexyz|Ocexyz]] 16:20, 27 July 2009 (UTC)}}<br /> <br /> {{RecoveredPage|Warninig: here ends pasted better formatted recovery. Row recovery has been mooved below as I don't know if anybody has made any changes in it. If not then row recovery can be deleted I suppose. Paste starts from == Shareaza Specific Details == and ends at second == Shareaza Specific Details ==, here. I hope it is visible. --[[User:Ocexyz|Ocexyz]] 16:20, 27 July 2009 (UTC) }}<br /> <br /> ==Shareaza Specific Details==<br /> <br /> {{RecoveredPage|Warninig: here ends pasted better formatted recovery. Row recovery has been mooved below as I don't know if anybody has made any changes in it. If not then row recovery can be deleted I suppose. Paste starts from &gt;&gt;Shareaza Specific Details&lt;&lt; and ends at second &gt;&gt; Shareaza Specific Details&lt;&lt;, here. I hope it is visible. --[[User:Ocexyz|Ocexyz]] 23:27, 27 July 2009 (UTC) }}<br /> <br /> * Get String Breakdown:<br /> o Update a leaf<br /> + &quot;?update=1&amp;ip=(ip):(port)&amp;x_leaves=(leaf count) <br /> o Ping Variable<br /> + Appends &amp;ping=1 to identify the cache name in debug messages (for gnutella and gnutella2 in 2.4.0.0, but only for gnutella2 now in 2.4.0.X for spec1 cache compatibility).<br /> + This feature new to Shareaza. <br /> o Network Variable<br /> + Appends &amp;net=gnutella2 on Gnutella2 queries.<br /> + Does NOT append a network variable on Gnutella(1) queries. <br /> o Client Name / Version Format (2.4.0.0 and earlier):<br /> + &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )<br /> + &amp;version=(Shareaza's version) <br /> o Client Name / Version Format (2.4.0.X):<br /> + If Gnutella<br /> # &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )<br /> # &amp;version=(Shareaza's version) <br /> + If Gnutella2<br /> # &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )+(Shareaza's version) <br /> <br /> <br /> <br /> * GWC Response Matching:<br /> o i|<br /> + Informational output alone will not be taken as GWC 'success.' <br /> o i|access|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to make a request to the cache. <br /> o i|update|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to update to the cache. <br /> o i|force|remove and i|update|warning|bad url<br /> + Remove the GWC from the internal list. <br /> o Some Response Matches (added in 2.3.1.X)<br /> + i|NO-URL-NO-HOSTS<br /> # Outputs warning of the cache being totally empty to the system log. <br /> + i|NO-URL<br /> # Outputs warning of the cache having no alternative URLs to the system log. <br /> + i|NO-HOSTS<br /> # Outputs warning of the cache having no hosts to the system log. <br /> + i|warning|<br /> # Outputs warning of the cache to the system log. <br /> + ERROR Something Failed<br /> # Outputs warning of the cache to the system log(Buggy Bazooka GWCs workaround). <br /> + i|warning|You came back too early (2.3.1.X)<br /> + i|warning|client|early (2.3.1.X)<br /> + WARNING: You came back too early (2.3.1.X)<br /> + ERROR: Client returned too early (2.3.1.X)<br /> # Flood detection for the update side.<br /> # Outputs GWebCache(update) Too many connection attempts to the system log. <br /> + too early (2.3.1.X)<br /> + early (2.4.0.X)<br /> # Flood detection for the request side.<br /> # Outputs GWebCache URL: Too many connection attempts to the system log. <br /> + i|update|OK<br /> # Outputs &quot;GWebCache(v2) Update Passed: &quot; to the system log. <br /> + OK<br /> # Outputs &quot;GWebCache(v1) Update Passed: &quot; to the system log. <br /> <br /> <br /> <br /> * GWC Response Matching:<br /> o i|<br /> + Informational output alone will not be taken as GWC 'success.' <br /> o i|access|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to make a request to the cache. <br /> o i|update|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to update to the cache. <br /> o i|force|remove and i|update|warning|bad url<br /> + Remove the GWC from the internal list. <br /> o Some Response Matches (added in 2.3.1.X)<br /> + i|NO-URL-NO-HOSTS<br /> # Outputs warning of the cache being totally empty to the system log. <br /> + i|NO-URL<br /> # Outputs warning of the cache having no alternative URLs to the system log. <br /> + i|NO-HOSTS<br /> # Outputs warning of the cache having no hosts to the system log. <br /> + i|warning|<br /> # Outputs warning of the cache to the system log. <br /> + ERROR Something Failed<br /> # Outputs warning of the cache to the system log(Buggy Bazooka GWCs workaround). <br /> + i|warning|You came back too early (2.3.1.X)<br /> + i|warning|client|early (2.3.1.X)<br /> + WARNING: You came back too early (2.3.1.X)<br /> + ERROR: Client returned too early (2.3.1.X)<br /> # Flood detection for the update side.<br /> # Outputs GWebCache(update) Too many connection attempts to the system log. <br /> + too early (2.3.1.X)<br /> + early (2.4.0.X)<br /> # Flood detection for the request side.<br /> # Outputs GWebCache URL: Too many connection attempts to the system log. <br /> + i|update|OK<br /> # Outputs &quot;GWebCache(v2) Update Passed: &quot; to the system log. <br /> + OK<br /> # Outputs &quot;GWebCache(v1) Update Passed: &quot; to the system log. <br /> <br /> <br /> <br /> ==Gnutella Web Cache Specifications==<br /> &lt;end of partial recovery by OCE&gt;<br /> <br /> <br /> <br /> <br /> &lt;end of recovered content&gt;<br /> <br /> &lt;row recovery, start&gt; <br /> Specification 1:<br /> <br /> * Networks Served<br /> o Gnutella <br /> * Format<br /> o Update went fine:<br /> + Ex: OK <br /> o Update Warning (Small prob., not that bad):<br /> + Ex: <br /> <br /> OK<br /> WARNING: Error Message<br /> <br /> * Severe Warning (No 'OK' message sent)<br /> o Ex: <br /> <br /> WARNING: Error Message<br /> <br /> * URL Output:<br /> o Ex: http://somefreakinrandomcache.com/cache/gcache.php<br /> + OR - WITH A PORT NUMBER (If not 80)<br /> # Ex: http://somefreakinrandomcache.com:8080/cache/gcache.php <br /> * Host Output:<br /> o Ex: 66.132.55.12:6346 <br /> * Pong (ping variable response) - was explained below under the topic: variables.<br /> * Example Cache Output (Beacon Cache) For urlfile Command<br /> o Example &quot;urlfile Output&quot; URL: Ex: http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;urlfile=1<br /> + Example URL Output: <br /> <br /> <br /> Getting urls with a pong combined<br /> <br /> PONG Beacon Cache 0.1.5D Beta<br /> http://gwc.frodoslair.net/skulls/skulls.php<br /> http://bbs.robertwoolley.co.uk/GWebCache/gcache.php<br /> http://g2.tjtech.org/g2/<br /> http://g2.tjtech.org/g2/index.php<br /> http://gwc.monnsta.net/<br /> http://holograph.uni.cc/other/skulls.php<br /> http://gwc.nickstallman.net/<br /> http://gwc.eod.cc/skulls.php<br /> http://gwc.frodoslair.net/skulls/skulls<br /> http://gwc.werwin.net/skulls.php<br /> <br /> <br /> * Example Cache Output (Beacon Cache) For hostfile Command<br /> o Example &quot;hostfile Output&quot; URL: Ex: http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;hostfile=1<br /> + Example Host Output: <br /> <br /> <br /> Getting the hosts with a pong combined<br /> <br /> PONG Beacon Cache 0.1.5D Beta<br /> 71.8.84.153:3915<br /> 99.248.214.157:27529<br /> 69.60.241.55:16369<br /> 193.253.239.246:30218<br /> 68.156.175.121:6348<br /> 71.179.7.241:18344<br /> 74.196.22.241:6348<br /> 12.210.197.194:10531<br /> 222.150.143.77:10000<br /> 58.85.231.135:6346<br /> 24.141.199.164:20205<br /> 72.175.201.195:6348<br /> 69.81.129.228:4880<br /> 97.81.221.63:13219<br /> 70.15.130.224:7759<br /> 216.211.188.106:51903<br /> 75.167.168.156:48660<br /> 12.214.14.3:35916<br /> 76.177.244.106:24180<br /> 98.165.218.139:39630<br /> 68.112.182.125:3685<br /> 68.117.204.57:23482<br /> 65.12.154.25:40760<br /> 69.180.47.169:5711<br /> 75.138.40.173:24987<br /> 98.201.19.0:33662<br /> 70.187.2.144:6348<br /> 68.186.209.107:14429<br /> 69.159.7.61:6348<br /> 76.208.176.196:48199<br /> <br /> <br /> * For combining a hostfile and urlfile request:<br /> o Warning: This is non-standard.<br /> o Example Cache Output (Beacon Cache) For bfile Command<br /> + Example &quot;bfile Output&quot; URL: Ex: http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;bfile=1<br /> # Example Host and URL Output: <br /> <br /> <br /> Getting the hosts and urls with a pong combined<br /> <br /> PONG Beacon Cache 0.1.5D Beta<br /> 71.8.84.153:3915<br /> 99.248.214.157:27529<br /> 69.60.241.55:16369<br /> 193.253.239.246:30218<br /> 68.156.175.121:6348<br /> 71.179.7.241:18344<br /> 74.196.22.241:6348<br /> 12.210.197.194:10531<br /> 222.150.143.77:10000<br /> 58.85.231.135:6346<br /> 24.141.199.164:20205<br /> 72.175.201.195:6348<br /> 69.81.129.228:4880<br /> 97.81.221.63:13219<br /> 70.15.130.224:7759<br /> 216.211.188.106:51903<br /> 75.167.168.156:48660<br /> 12.214.14.3:35916<br /> 76.177.244.106:24180<br /> 98.165.218.139:39630<br /> 68.112.182.125:3685<br /> 68.117.204.57:23482<br /> 65.12.154.25:40760<br /> 69.180.47.169:5711<br /> 75.138.40.173:24987<br /> 98.201.19.0:33662<br /> 70.187.2.144:6348<br /> 68.186.209.107:14429<br /> 69.159.7.61:6348<br /> 76.208.176.196:48199<br /> http://gwc.frodoslair.net/skulls/skulls.php<br /> http://bbs.robertwoolley.co.uk/GWebCache/gcache.php<br /> http://g2.tjtech.org/g2/<br /> http://g2.tjtech.org/g2/index.php<br /> http://gwc.monnsta.net/<br /> http://holograph.uni.cc/other/skulls.php<br /> http://gwc.nickstallman.net/<br /> http://gwc.eod.cc/skulls.php<br /> http://gwc.frodoslair.net/skulls/skulls<br /> http://gwc.werwin.net/skulls.php<br /> <br /> <br /> * Variables<br /> o Mandatory<br /> + ping:<br /> # Response should have this always: PONG<br /> # After, put the cache's name. ex: PONG fakecache 0.01<br /> + client:<br /> # Four letter code of the client. ex: RAZA <br /> + version:<br /> # Version number of the client. <br /> + urlfile:<br /> # Used by the client to request alternate cache urls. <br /> + hostfile:<br /> # Used by the client to request IPs with port numbers attached. <br /> + url:<br /> # Client update giving an alternate cache URL.<br /> # Formatted with a http:// prefix to each cache. <br /> + ip:<br /> # Client update giving one's IP to submit. <br /> + url1:<br /> # OLD OUTDATED Client update giving an alternate cache URL.<br /> # Formatted with a http:// prefix to each cache. <br /> + ip1:<br /> # OLD OUTDATED Client update giving one's IP to submit. <br /> o Optional<br /> + bfile:<br /> # For clients to request both URLs and IPs from the cache at the same time. <br /> + statfile:<br /> # Statistics of the cache request:<br /> * First line: Total requests of the cache number.<br /> * Second line: Requests of the cache an hour number.<br /> * Third line: Updates of the cache an hour number. <br /> <br /> Specification 2:<br /> <br /> * Networks Served<br /> o Gnutella, Gnutella2, etc. <br /> * Format<br /> o Information Output<br /> + Starts with: I|<br /> # Categories<br /> * Pong (ping variable response) - Described below under the topic: variables.<br /> * Update Status Response<br /> o Format: I|update<br /> o Responses<br /> + I|update|OK<br /> # - Everything went fine. <br /> + I|update|OK|WARNING<br /> # Small warning. <br /> + I|update|WARNING<br /> # Severe warning <br /> * Plain Warnings<br /> o Format: I|WARNING<br /> + Append any warning messages after it - Ex: I|WARNING|You came back too early <br /> * Extra Info - Described below under the topic: variables. <br /> o Host Output<br /> + Starts with: H|<br /> + Add the IP with its port:<br /> # Ex: H|0.0.0.0:6346 <br /> + Add the time, thereafter, of the host's (In seconds*) time in cache:<br /> # Ex: H|0.0.0.0:6346|45 <br /> + If cluster exists with cluster=somerandomwords<br /> # Add the clustered words after the host's age:<br /> * Ex: H|0.0.0.0:6346|45|somerandomwords <br /> o URL Output<br /> + Starts with: U|<br /> + Add the URL with http:// before it, plus the port (if it's not 80).<br /> # Ex: U|http://somerandomcache.com/ <br /> + Add the time, thereafter, of the URL's time (In seconds*) in cache:<br /> # Ex: U|http://somerandomcache.com/|45 <br /> o Example Cache Output (Beacon Cache) For get Command<br /> + Example URL: http://grantgalitz.com/Beacon/gwc.php?get=1&amp;client=RAZA&amp;version=2.3.1.3&amp;net=gnutella2&amp;ping=1<br /> # Example &quot;Get&quot; Output: <br /> <br /> <br /> Getting the hosts and urls with a pong combined<br /> <br /> I|pong|Beacon Cache 0.1.5D Beta|gnutella-gnutella2<br /> H|65.9.200.243:4968|248261<br /> H|68.228.129.75:44599|242678<br /> H|98.240.196.122:8206|240719<br /> H|76.104.12.133:14921|218273<br /> H|69.136.1.12:3924|211610<br /> H|81.154.208.71:8595|174402<br /> H|97.96.105.51:2076|153610<br /> H|74.192.153.212:39340|144203<br /> H|72.190.106.57:12584|132984<br /> H|78.93.71.132:12334|125668<br /> H|82.43.248.184:27560|97974<br /> H|196.205.224.97:6357|86763<br /> H|74.129.219.30:33172|82005<br /> H|76.104.12.133:19185|57182<br /> H|69.59.83.131:18442|38628<br /> U|http://www.k33bz.com/g2/bazooka.php|248639<br /> U|http://gwebcache.ns1.net/|248592<br /> U|http://gwc2.wodi.org/skulls.php|248384<br /> U|http://gwc.guufshop.com/skulls/skulls.php|248322<br /> U|http://groovy.syxy.com/up/skulls.php|248300<br /> U|http://g2.tjtech.org/g2/index.php|247770<br /> U|http://midian.jayl.de/g2/bazooka.php|240719<br /> U|http://www.dom2porno.info/skulls/skulls.php|207473<br /> U|http://gwc.frodoslair.net/skulls/skulls|125668<br /> U|http://holograph.uni.cc/other/skulls.php|9642<br /> <br /> <br /> * Variables<br /> o Mandatory<br /> + ping:<br /> # Main Part: I|pong|<br /> # Then add the cache name and version: I|pong|fakecache 0.01<br /> # Then lastly add the network support:<br /> * I|pong|fakecache 0.01|gnutella<br /> o - Gnutella only <br /> * I|pong|fakecache 0.01|gnutella2<br /> o - Gnutella2 only <br /> * I|pong|fakecache 0.01|gnutella-gnutella2<br /> o - Gnutella and Gnutella2 served <br /> + get:<br /> # Used by clients to requests alternate cache URLs along with IPs and their port numbers. <br /> + update:<br /> # url:<br /> * Client update giving an alternate cache URL.<br /> * Formatted with a http:// prefix to each cache. <br /> # ip:<br /> * Client update giving one's IP to submit. <br /> + net:<br /> # Which network to serve the client.<br /> * Gnutella<br /> o Ex: net=gnutella <br /> * Gnutella2<br /> o Ex: net=gnutella2 <br /> * Should always be lowercase<br /> o GWCs should automatically convert network name given to lowercase to prevent Net ID mismatches <br /> <br /> solely on case alone.<br /> <br /> *<br /> o<br /> + client:<br /> # Four letter code of the client. ex: RAZA <br /> + version:<br /> # Version number of the client. <br /> o Optional<br /> + cluster:<br /> # To add extra info to an IP update.<br /> * Output by cache: H|0.0.0.0|AGE OF HOST (Seconds)|clustering some bull**** <br /> + statfile:<br /> # Exactly like the specification 1 statfile (Same routine and output style).<br /> # Statistics of the cache request:<br /> * First line: Total requests of the cache number.<br /> * Second line: Requests of the cache an hour number.<br /> * Third line: Updates of the cache an hour number. <br /> <br /> Specification 2.1<br /> <br /> * This is an extension of specification 2, not a separate specification!<br /> * Pong extension<br /> o Append the networks supported joined by a hyphen '-'.<br /> o Used for client-side validation of networks supported and for network support reporting to other web caches.<br /> o Format:<br /> + I|pong|cache name|network names joined by '-'<br /> + Format Examples:<br /> # I|pong|fakecache 0.01|gnutella<br /> * - Gnutella only <br /> # I|pong|fakecache 0.01|gnutella2<br /> * - Gnutella2 only <br /> # I|pong|fakecache 0.01|gnutella-gnutella2<br /> * - Gnutella and Gnutella2 served <br /> * Host Output<br /> o Just like specification 2, but with more fields supported for host output.<br /> + H|ip:port|age in cache|clustering|leaves|4 letter vendor code|reported uptime of host|max. leaves possible<br /> # The host, age, and clustering fields are all still the same as in specification 2.<br /> # The leaf count of the hub reported is in the 5th field.<br /> # The vendor code with version number is in the 6th field. <br /> * Request Control Variables:<br /> o getleaves<br /> + Used to obtain leaf counts of hubs given<br /> + 4th field ultilized for current leaf count.<br /> + 7th field ultilized for maximum leaf slots possible.<br /> + Use this as 'getleaves=1' or 'getleaves' to enable. <br /> o getclusters<br /> + Enables/Disables clustering.<br /> + Use this as 'getclusters=1'.<br /> + Using 'getclusters' or 'getclusters=0' disables cluster output. <br /> o getvendors<br /> + Used to obtain the vendor code w/ version number of the hubs given.<br /> + Found in the 5th field.<br /> + Use this as 'getvendors=1' or 'getvendors' to enable. <br /> o getuptime<br /> + Used to obtain the vendor code w/ version number of the hubs given.<br /> + Value is static, do not change the value given when time passes.<br /> + Found in the 6th field.<br /> + Use this as 'getuptime=1' or 'getuptime' to enable. <br /> o spec<br /> + To force the specification parameter<br /> + Currently is only supported by Beacon Cache II <br /> o pv<br /> + Similar to the 'spec' parameter, except that it does not force, instead it simply negotiates the specification. <br /> * Special Data Requests<br /> o info<br /> + Outputs extra details of your cache.<br /> # Start with the informational response: I|<br /> * Ex: I|open-source|1 <br /> o support<br /> + Outputs USEFUL details of your cache.<br /> # Start with the informational response: I|<br /> * Ex: I|support|gnutella2 <br /> o getnetworks<br /> + Outputs the enabled networks in two formats.<br /> # Start with the informational response: I|<br /> * For the 'I|nets|' line<br /> o The third field contains the supported networks joined by '-'. <br /> * For the 'I|networks|' line<br /> o Interpret the fields from 3 and beyond as individual network names to challenge against. <br /> # Examples<br /> *<br /> o I|nets|gnutella-gnutella2<br /> o I|networks|gnutella|gnutella2 <br /> * Update Extension Variables:<br /> o x_leaves<br /> + Number of leaves running on a given hub or ultrapeer.<br /> + Value must not be greater than an integer value of 2047.<br /> + Note: It is important to know that PHP automaticaly replace dots with underscores, so to keep compatibility with old/new version of clients all caches should support both variants, example: x.leaves x_leaves<br /> o x_max<br /> + Maximum number of leaves possible on a given hub or ultrapeer.<br /> + Value must not be greater than an integer value of 2047. <br /> o uptime<br /> + Value submitted must be an integer value of the number of seconds of uptime.<br /> + Value must not be greater than an integer value of 1 year (31536000) and less than 1 hour (60). <br /> <br /> Pinging Caches With Your Cache<br /> <br /> * Please follow this standard:<br /> o Client: TEST<br /> o Version: Your Cache's Name<br /> + The old value for &quot;version&quot; was 1 <br /> * Some variables to attach to the ping (compatibility):<br /> o multi<br /> + Used by some gwcs in their pings to other gwcs.<br /> + It tells the pinged cache to ignore the &quot;net&quot; parameter (so it should never say network not supported) and outputting the pong using this format, if possible, &quot;I|pong|[cache name] [cache version]|[supported networks list]|[url adding is enabled]&quot; - example: I|pong|Skulls 0.2.8a|gnutella-gnutella2|1<br /> + Used by Skulls GWC only. <br /> o cache<br /> + This is added to every request made by some gwcs, it is for statistical purposes only.<br /> + It simply tells the remote cache that the client is a GWC. <br /> * Help<br /> o For PHP<br /> + Use the fsockopen() function to open a connection to a cache.<br /> # Make sure you &quot;write&quot; to the fsockopen carry value to open the GWC's target file.<br /> * http://us.php.net/manual/en/function.fsockopen.php <br /> <br /> Variable Combination Standards<br /> <br /> * Net variable decides specification!<br /> o There are many ways to determine spec., but going with net is the safe way.<br /> o Skulls GWC does not use the network parameter to determine specification level.<br /> o Beacon Cache (I and II) uses the network parameter to determine the specification level. <br /> * Your cache needs to be able to process certain combinations of variables.<br /> o Update variable<br /> + Update should not fail if absent if spec. 2.<br /> # A Specification 2 parameter. <br /> * Spec 1 parameters used in Spec 2:<br /> o Should still accept hostfile and urlfile responses for spec. 2.<br /> + Beacon Cache (I and II) accepts these parameters on spec 2. <br /> * The 'spec' paameter can be used to force a specification:<br /> o Only known to exist in Beacon Cache II, it can force the request to be handled as a specification 1 or 2 request.<br /> o Spec 1 = 'spec=1'<br /> o Spec 2 = 'spec=2'<br /> o If 'spec' is not equal to any current spec, then default to the predetermined spec. <br /> * Multiple variable requests<br /> o If for instance a ping and request exist, you should always handle them properly.<br /> + Same goes with other combos like an update and ping, statfile + ping and info. <br /> o Handle multiple variables as BEST as possible!<br /> + Some scanners and GWCs like to fit all their requests into one URL send. <br /> <br /> &lt;row recovery, end&gt; <br /> <br /> Further Information:<br /> <br /> * [http://www.gnucleus.com/gwebcache/ Original GWC site]<br /> ** [http://gnucleus.sourceforge.net/gwebcache/specs.html GWC Spec. 1]<br /> ** [http://gnucleus.sourceforge.net/gwebcache/newgwc.html GWC Spec. 2] <br /> <br /> <br /> <br /> <br /> <br /> &lt;content recovered from last aviable backup&gt; <br /> <br /> ===Gnutella Web Cache===<br /> Gnutella requires Gnutella Web Caches (GWC) to get IPs to establish a connection to the network. These are critical to ensuring the health of the network. If you have a dedicated server and can spare some extra bandwidth then please consider running a GWC. People that don't have a dedicated server or are on normal broadband consumer lines should not run a cache from home.<br /> <br /> A GWC is a simple script that can be put on any webserver that supports one of the following scripting languages:<br /> *JSP (Java Servlet)<br /> **[http://web.archive.org/web/20061108091447/http://www.mager.org/GWebCache/ Java Servlet GWebCache Application (Archive.org)]<br /> *C<br /> **[http://ghostwhitecrab.com/crab/ GhostWhiteCrab]<br /> *Perl <br /> **[http://www.jonatkins.com/perlgcache/ Jon Atkins' perlgcache] <br /> **The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache]<br /> *PHP <br /> **[http://gwcii.sourceforge.net/ PHPGnuCacheII] - MySQL<br /> **[http://www.bazookanetworks.com Bazooka G2WC] (recommended) - flat files<br /> **[http://sourceforge.net/projects/skulls/ Skulls! Multi-Network WebCache] - flat files<br /> === Further Information: ===<br /> * [http://www.gnucleus.com/gwebcache/ Original GWC site]<br /> <br /> [[Category:External Links]]</div>

Ale5000 https://shareaza.sourceforge.net/w/index.php?title=GWC_specs&diff=11505 2015-03-25T15:00:10Z

<p>Ale5000: Added note about x.leaves</p> <hr /> <div>''For general information on GWCs, have a look at the [[GWC]] Wiki page.''<br /> {{do not translate}}<br /> This page is thought to give an overview over the GWC specifications as they are implemented into Shareaza.<br /> <br /> A GWC is a simple script that can be put on any webserver that supports one of the following scripting languages: <br /> <br /> * JSP (Java Servlet) <br /> ** [http://www1.mager.org/GWebCache/ Jums Web Cache] (Excellent for heavy loads) <br /> * C <br /> ** [http://wiki.limewire.org/index.php?title=GhostWhiteCrab GhostWhiteCrab] (For dedicated server environments and people who know how to compile C source code!) <br /> * ASP <br /> ** [http://www.edazzle.net/downloads/gerry.zip Gerry GWC] <br /> ** [https://www.planet-source-code.com/vb/scripts/ShowCode.asp?txtCodeId=7846&amp;lngWId=4 Lynn (v.s. 0.5)] <br /> ** [https://www.planet-source-code.com/vb/scripts/ShowCode.asp?txtCodeId=7731&amp;lngWId=4 Lynn (v.s. 0.4)] <br /> ** [http://www.poundwebhosting.com/cgi-bin/lynnx.asp LynnX] <br /> * Perl <br /> ** [http://www.jonatkins.com/perlgcache/ Jon Atkins' perlgcache] <br /> ** The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache] <br /> '''PHP''' ''(Tip: PHP GWCs are usually the easiest to run and setup on a server.)''<br /> ** [http://gwcii.sourceforge.net/ PHPGnuCacheII] <br /> ** [http://www.bazookanetworks.com/ Bazooka G2WC] <br /> * The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache] ''(PHP version is no longer supported)'' <br /> ** [http://sourceforge.net/projects/skulls/ Skulls! Multi-Network WebCache] <br /> ** [http://sourceforge.net/projects/beaconcache/ Beacon Cache] <br /> ** [http://code.google.com/p/cachechu/ Cachechu G2WC] <br /> <br /> == Breakdown Of The Gnutella Web Caches: == <br /> {{RecoveredPage|I recently put this into a table. The contents need to be verified -- [[User:Cyko 01|Cyko 01]]}}<br /> <br /> {| width= auto; style=&quot;font-size: 85%; text-align: center;text-valign: middle;&quot; class=&quot;wikitable&quot;<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Cache:<br /> ! rowspan=1 |Gnutella:<br /> ! rowspan=1 |Gnutella2:<br /> ! rowspan=1 |Spec 1:<br /> ! rowspan=1 |Spec 2:<br /> ! rowspan=1 |Flat-File:<br /> ! rowspan=1 |SQL:<br /> ! rowspan=1 |Installer:<br /> ! rowspan=1 |Other Networks:<br /> ! rowspan=1 |Different network instances:<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Beacon Cache (Core 2)<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> |style=&quot;background: #CCFFCC;&quot;| Yes (As of 0.2.0 Alpha)<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Beacon Cache (Core 1)<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Skulls<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|JumsWebCache<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|GnuWebCache (Perl)<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|GnuWebCache (PHP) <br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|GhostWhiteCrab(GWC) <br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> |style=&quot;background: #FFFFCC;&quot;| N/A<br /> |style=&quot;background: #FFFFCC;&quot;| N/A<br /> |style=&quot;background: #FFFFCC;&quot;| N/A<br /> | {{yes}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|PHPGnuCacheII <br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Bazooka <br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Cachechu<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Perlgcache<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Gerry GWC (v2)<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Gerry GWC (v1)<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Lynn<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|LynnX<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |}<br /> <br /> == Shareaza Specific Details == <br /> <br /> {{RecoveredPage|Warninig: here I have pasted better formatted recovery, but not verified. Row recovery has been mooved below as I don't know if anybody has made any changes in it. If not then row recovery can be deleted. Paste starts from &gt;&gt;Shareaza Specific Details&lt;&lt;, here, and ends at second &gt;&gt;Shareaza Specific Details&lt;&lt; I hope it is visible. --[[User:Ocexyz|Ocexyz]] 23:27, 27 July 2009 (UTC)}}<br /> <br /> '''Get String Breakdown:''' <br /> * Update a leaf <br /> ** &quot;?update=1&amp;ip=(ip):(port)&amp;x_leaves=(leaf count) <br /> * Ping Variable <br /> ** Appends &amp;ping=1 to identify the cache name in debug messages (for gnutella and gnutella2 in 2.4.0.0, but only for gnutella2 now in 2.4.0.X for spec1 cache compatibility). <br /> ** This feature new to Shareaza. <br /> * Network Variable <br /> ** Appends &amp;net=gnutella2 on Gnutella2 queries. <br /> ** Does NOT append a network variable on Gnutella(1) queries. <br /> * Client Name / Version Format (2.4.0.0 and earlier): <br /> ** &amp;client=(Shareaza 4 letter code (RAZA / RAZB) ) <br /> ** &amp;version=(Shareaza's version) <br /> * Client Name / Version Format (2.4.0.X): <br /> ** If Gnutella <br /> *** &amp;client=(Shareaza 4 letter code (RAZA / RAZB) ) <br /> *** &amp;version=(Shareaza's version) <br /> ** If Gnutella2 <br /> *** &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )+(Shareaza's version) <br /> <br /> '''GWC Response Matching:''' <br /> * i| <br /> ** Informational output alone will not be taken as GWC 'success.' <br /> * i|access|period|(time in sec.) <br /> ** Time in seconds before Shareaza is allowed to make a request to the cache. <br /> * i|update|period|(time in sec.) <br /> ** Time in seconds before Shareaza is allowed to update to the cache. <br /> * i|force|remove and i|update|warning|bad url <br /> ** Remove the GWC from the internal list. <br /> * Some Response Matches (added in 2.3.1.X) <br /> ** i|NO-URL-NO-HOSTS <br /> *** Outputs warning of the cache being totally empty to the system log. <br /> ** i|NO-URL <br /> *** Outputs warning of the cache having no alternative URLs to the system log. <br /> ** i|NO-HOSTS <br /> *** Outputs warning of the cache having no hosts to the system log. <br /> ** i|warning| <br /> *** Outputs warning of the cache to the system log. <br /> ** ERROR Something Failed <br /> *** Outputs warning of the cache to the system log(Buggy Bazooka GWCs workaround). <br /> ** i|warning|You came back too early (2.3.1.X) <br /> ** i|warning|client|early (2.3.1.X) <br /> ** WARNING: You came back too early (2.3.1.X) <br /> ** ERROR: Client returned too early (2.3.1.X) <br /> *** Flood detection for the update side. <br /> *** Outputs GWebCache(update) Too many connection attempts to the system log. <br /> ** too early (2.3.1.X) <br /> ** early (2.4.0.X) <br /> *** Flood detection for the request side. <br /> *** Outputs GWebCache URL: Too many connection attempts to the system log. <br /> ** i|update|OK <br /> *** Outputs &quot;GWebCache(v2) Update Passed: &quot; to the system log. <br /> ** OK <br /> *** Outputs &quot;GWebCache(v1) Update Passed: &quot; to the system log. <br /> <br /> == Gnutella Web Cache Specifications ==<br /> ==== Specification 1: ====<br /> * '''Networks Served''' <br /> ** Gnutella <br /> * '''Format''' <br /> ** Update went fine: <br /> *** Ex: OK <br /> ** Update Warning (Small prob., not that bad): <br /> *** Ex: OKWARNING: Error Message <br /> <br /> * Severe Warning (No 'OK' message sent) <br /> ** Ex: WARNING: Error Message<br /> <br /> * URL Output: <br /> ** Ex: [http://somefreakinrandomcache.com/cache/gcache.php http://somefreakinrandomcache.com/cache/gcache.php] <br /> *** OR - WITH A PORT NUMBER (If not 80) <br /> **** Ex: [http://somefreakinrandomcache.com:8080/cache/gcache.php http://somefreakinrandomcache.com:8080/cache/gcache.php] <br /> * Host Output: <br /> ** Ex: 66.132.55.12:6346 <br /> * Pong (ping variable response) - was explained below under the topic: variables. <br /> * '''Example Cache Output (Beacon Cache) For urlfile Command''' <br /> ** Example &quot;urlfile Output&quot; URL: Ex: [http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;urlfile=1 http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;urlfile=1] <br /> *** Example URL Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting urls with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | PONG Beacon Cache 0.1.5D Beta[http://gwc.frodoslair.net/skulls/skulls.php http://gwc.frodoslair.net/skulls/skulls.php][http://bbs.robertwoolley.co.uk/GWebCache/gcache.php http://bbs.robertwoolley.co.uk/GWebCache/gcache.php][http://g2.tjtech.org/g2/ http://g2.tjtech.org/g2/][http://g2.tjtech.org/g2/index.php http://g2.tjtech.org/g2/index.php][http://gwc.monnsta.net/ http://gwc.monnsta.net/][http://holograph.uni.cc/other/skulls.php http://holograph.uni.cc/other/skulls.php][http://gwc.nickstallman.net/ http://gwc.nickstallman.net/][http://gwc.eod.cc/skulls.php http://gwc.eod.cc/skulls.php][http://gwc.frodoslair.net/skulls/skulls http://gwc.frodoslair.net/skulls/skulls][http://gwc.werwin.net/skulls.php http://gwc.werwin.net/skulls.php] <br /> <br /> |}<br /> * '''Example Cache Output (Beacon Cache) For hostfile Command''' <br /> ** Example &quot;hostfile Output&quot; URL: Ex: [http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;hostfile=1 http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;hostfile=1] <br /> *** Example Host Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting the hosts with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | PONG Beacon Cache 0.1.5D Beta71.8.84.153:391599.248.214.157:2752969.60.241.55:16369193.253.239.246:3021868.156.175.121:634871.179.7.241:1834474.196.22.241:634812.210.197.194:10531222.150.143.77:1000058.85.231.135:634624.141.199.164:2020572.175.201.195:634869.81.129.228:488097.81.221.63:1321970.15.130.224:7759216.211.188.106:5190375.167.168.156:4866012.214.14.3:3591676.177.244.106:2418098.165.218.139:3963068.112.182.125:368568.117.204.57:2348265.12.154.25:4076069.180.47.169:571175.138.40.173:2498798.201.19.0:3366270.187.2.144:634868.186.209.107:1442969.159.7.61:634876.208.176.196:48199<br /> <br /> |}<br /> * '''For combining a hostfile and urlfile request:''' <br /> ** Warning: This is non-standard. <br /> ** '''Example Cache Output (Beacon Cache) For bfile Command''' <br /> *** Example &quot;bfile Output&quot; URL: Ex: [http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;bfile=1 http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;bfile=1] <br /> **** Example Host and URL Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting the hosts and urls with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | PONG Beacon Cache 0.1.5D Beta71.8.84.153:391599.248.214.157:2752969.60.241.55:16369193.253.239.246:3021868.156.175.121:634871.179.7.241:1834474.196.22.241:634812.210.197.194:10531222.150.143.77:1000058.85.231.135:634624.141.199.164:2020572.175.201.195:634869.81.129.228:488097.81.221.63:1321970.15.130.224:7759216.211.188.106:5190375.167.168.156:4866012.214.14.3:3591676.177.244.106:2418098.165.218.139:3963068.112.182.125:368568.117.204.57:2348265.12.154.25:4076069.180.47.169:571175.138.40.173:2498798.201.19.0:3366270.187.2.144:634868.186.209.107:1442969.159.7.61:634876.208.176.196:48199[http://gwc.frodoslair.net/skulls/skulls.php http://gwc.frodoslair.net/skulls/skulls.php][http://bbs.robertwoolley.co.uk/GWebCache/gcache.php http://bbs.robertwoolley.co.uk/GWebCache/gcache.php][http://g2.tjtech.org/g2/ http://g2.tjtech.org/g2/][http://g2.tjtech.org/g2/index.php http://g2.tjtech.org/g2/index.php][http://gwc.monnsta.net/ http://gwc.monnsta.net/][http://holograph.uni.cc/other/skulls.php http://holograph.uni.cc/other/skulls.php][http://gwc.nickstallman.net/ http://gwc.nickstallman.net/][http://gwc.eod.cc/skulls.php http://gwc.eod.cc/skulls.php][http://gwc.frodoslair.net/skulls/skulls http://gwc.frodoslair.net/skulls/skulls][http://gwc.werwin.net/skulls.php http://gwc.werwin.net/skulls.php] <br /> <br /> |}<br /> '''Variables''' <br /> * '''Mandatory''' <br /> ** ping: <br /> *** Response should have this always: PONG<br /> *** After, put the cache's name. ex: PONG fakecache 0.01<br /> ** client: <br /> *** Four letter code of the client. ex: RAZA <br /> ** version: <br /> *** Version number of the client. <br /> ** urlfile: <br /> *** Used by the client to request alternate cache urls. <br /> ** hostfile: <br /> *** Used by the client to request IPs with port numbers attached. <br /> ** url: <br /> *** Client update giving an alternate cache URL. <br /> *** Formatted with a http:// prefix to each cache. <br /> ** ip: <br /> *** Client update giving one's IP to submit. <br /> ** url1: <br /> *** OLD OUTDATED Client update giving an alternate cache URL. <br /> *** Formatted with a http:// prefix to each cache. <br /> ** ip1: <br /> *** OLD OUTDATED Client update giving one's IP to submit. <br /> * '''Optional''' <br /> ** bfile: <br /> *** For clients to request both URLs and IPs from the cache at the same time. <br /> ** statfile: <br /> *** Statistics of the cache request: <br /> **** First line: Total requests of the cache number. <br /> **** Second line: Requests of the cache an hour number. <br /> **** Third line: Updates of the cache an hour number.<br /> <br /> ==== Specification 2: ====<br /> '''Networks Served''' <br /> * Gnutella, Gnutella2, etc. <br /> '''Format''' <br /> * '''Information Output''' <br /> ** Starts with: I| <br /> *** '''Categories''' <br /> **** '''Pong''' (ping variable response) - Described below under the topic: variables. <br /> **** '''Update Status Response''' <br /> ***** Format: I|update <br /> ***** '''Responses''' <br /> ****** I|update|OK <br /> ******* - Everything went fine. <br /> ****** I|update|OK|WARNING <br /> ******* Small warning. <br /> ****** I|update|WARNING <br /> ******* Severe warning <br /> **** '''Plain Warnings''' <br /> ***** Format: I|WARNING <br /> ****** Append any warning messages after it - Ex: I|WARNING|You came back too early <br /> **** '''Extra Info''' - Described below under the topic: variables. <br /> * '''Host Output''' <br /> ** Starts with: H| <br /> ** Add the IP with its port: <br /> *** Ex: H|0.0.0.0:6346 <br /> ** Add the time, thereafter, of the host's (In seconds*) time in cache: <br /> *** Ex: H|0.0.0.0:6346|45 <br /> ** If cluster exists with cluster=somerandomwords <br /> *** Add the clustered words after the host's age: <br /> **** Ex: H|0.0.0.0:6346|45|somerandomwords <br /> * '''URL Output''' <br /> ** Starts with: U| <br /> ** Add the URL with http:// before it, plus the port (if it's not 80). <br /> *** Ex: U|[http://somerandomcache.com/ http://somerandomcache.com/] <br /> ** Add the time, thereafter, of the URL's time (In seconds*) in cache: <br /> *** Ex: U|[http://somerandomcache.com/%7C45 http://somerandomcache.com/|45] <br /> * '''Example Cache Output (Beacon Cache) For get Command''' <br /> ** Example URL: [http://grantgalitz.com/Beacon/gwc.php?get=1&amp;client=RAZA&amp;version=2.3.1.3&amp;net=gnutella2&amp;ping=1 http://grantgalitz.com/Beacon/gwc.php?get=1&amp;client=RAZA&amp;version=2.3.1.3&amp;net=gnutella2&amp;ping=1] <br /> *** Example &quot;Get&quot; Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting the hosts and urls with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | I|pong|Beacon Cache 0.1.5D Beta|gnutella-gnutella2H|65.9.200.243:4968|248261H|68.228.129.75:44599|242678H|98.240.196.122:8206|240719H|76.104.12.133:14921|218273H|69.136.1.12:3924|211610H|81.154.208.71:8595|174402H|97.96.105.51:2076|153610H|74.192.153.212:39340|144203H|72.190.106.57:12584|132984H|78.93.71.132:12334|125668H|82.43.248.184:27560|97974H|196.205.224.97:6357|86763H|74.129.219.30:33172|82005H|76.104.12.133:19185|57182H|69.59.83.131:18442|38628U|[http://www.k33bz.com/g2/bazooka.php%7C248639 http://www.k33bz.com/g2/bazooka.php|248639]U|[http://gwebcache.ns1.net/%7C248592 http://gwebcache.ns1.net/|248592]U|[http://gwc2.wodi.org/skulls.php%7C248384 http://gwc2.wodi.org/skulls.php|248384]U|[http://gwc.guufshop.com/skulls/skulls.php%7C248322 http://gwc.guufshop.com/skulls/skulls.php|248322]U|[http://groovy.syxy.com/up/skulls.php%7C248300 http://groovy.syxy.com/up/skulls.php|248300]U|[http://g2.tjtech.org/g2/index.php%7C247770 http://g2.tjtech.org/g2/index.php|247770]U|[http://midian.jayl.de/g2/bazooka.php%7C240719 http://midian.jayl.de/g2/bazooka.php|240719]U|[http://www.dom2porno.info/skulls/skulls.php%7C207473 http://www.dom2porno.info/skulls/skulls.php|207473]U|[http://gwc.frodoslair.net/skulls/skulls%7C125668 http://gwc.frodoslair.net/skulls/skulls|125668]U|[http://holograph.uni.cc/other/skulls.php%7C9642 http://holograph.uni.cc/other/skulls.php|9642] <br /> <br /> |}<br /> '''Variables''' <br /> * '''Mandatory''' <br /> ** ping: <br /> *** Main Part: I|pong| <br /> *** Then add the cache name and version: I|pong|fakecache 0.01 <br /> *** Then lastly add the network support: <br /> **** I|pong|fakecache 0.01|gnutella <br /> ***** - Gnutella only <br /> **** I|pong|fakecache 0.01|gnutella2 <br /> ***** - Gnutella2 only <br /> **** I|pong|fakecache 0.01|gnutella-gnutella2 <br /> ***** - Gnutella and Gnutella2 served <br /> ** get: <br /> *** Used by clients to requests alternate cache URLs along with IPs and their port numbers. <br /> ** update: <br /> *** url: <br /> **** Client update giving an alternate cache URL. <br /> **** Formatted with a http:// prefix to each cache. <br /> *** ip: <br /> **** Client update giving one's IP to submit. <br /> ** net: <br /> *** Which network to serve the client. <br /> **** Gnutella <br /> ***** Ex: net=gnutella <br /> **** Gnutella2 <br /> ***** Ex: net=gnutella2 <br /> **** '''Should always be lowercase''' <br /> ***** GWCs should automatically convert network name given to lowercase to prevent Net ID mismatches <br /> <br /> solely on case alone. <br /> <br /> <br /> * <br /> ** client: <br /> *** Four letter code of the client. ex: RAZA <br /> ** version: <br /> *** Version number of the client. <br /> * '''Optional''' <br /> ** cluster: <br /> *** To add extra info to an IP update. <br /> **** Output by cache: H|0.0.0.0|AGE OF HOST (Seconds)|clustering some bull**** <br /> ** statfile: <br /> *** Exactly like the specification 1 statfile '''(Same routine and output style)'''. <br /> *** Statistics of the cache request: <br /> **** First line: Total requests of the cache number. <br /> **** Second line: Requests of the cache an hour number. <br /> **** Third line: Updates of the cache an hour number. <br /> <br /> ==== Specification 2.1 ====<br /> '''This is an extension of specification 2, not a separate specification!''' <br /> Pong extension <br /> * Append the networks supported joined by a hyphen '-'. <br /> * Used for client-side validation of networks supported and for network support reporting to other web caches. <br /> * Format: <br /> ** I|pong|cache name|network names joined by '-' <br /> ** Format Examples: <br /> *** I|pong|fakecache 0.01|gnutella <br /> **** - Gnutella only <br /> *** I|pong|fakecache 0.01|gnutella2 <br /> **** - Gnutella2 only <br /> *** I|pong|fakecache 0.01|gnutella-gnutella2 <br /> **** - Gnutella and Gnutella2 served <br /> Host Output <br /> * Just like specification 2, but with more fields supported for host output. <br /> ** H|ip:port|age in cache|clustering|leaves|4 letter vendor code|reported uptime of host|max. leaves possible <br /> *** The host, age, and clustering fields are all still the same as in specification 2. <br /> *** The leaf count of the hub reported is in the 5th field. <br /> *** The vendor code with version number is in the 6th field. <br /> Request Control Variables: <br /> * getleaves <br /> ** Used to obtain leaf counts of hubs given <br /> ** 4th field ultilized for current leaf count. <br /> ** 7th field ultilized for maximum leaf slots possible. <br /> ** Use this as 'getleaves=1' or 'getleaves' to enable. <br /> * getclusters <br /> ** Enables/Disables clustering. <br /> ** Use this as 'getclusters=1'. <br /> ** Using 'getclusters' or 'getclusters=0' disables cluster output. <br /> * getvendors <br /> ** Used to obtain the vendor code w/ version number of the hubs given. <br /> ** Found in the 5th field. <br /> ** Use this as 'getvendors=1' or 'getvendors' to enable. <br /> * getuptime <br /> ** Used to obtain the vendor code w/ version number of the hubs given. <br /> ** Value is static, do not change the value given when time passes. <br /> ** Found in the 6th field. <br /> ** Use this as 'getuptime=1' or 'getuptime' to enable. <br /> * spec <br /> ** To force the specification parameter <br /> ** Currently is only supported by Beacon Cache II <br /> * pv <br /> ** Similar to the 'spec' parameter, except that it does not force, instead it simply negotiates the specification. <br /> Special Data Requests <br /> * info <br /> ** Outputs extra details of your cache. <br /> *** Start with the informational response: I| <br /> **** Ex: I|open-source|1 <br /> * support <br /> ** Outputs USEFUL details of your cache. <br /> *** Start with the informational response: I| <br /> **** Ex: I|support|gnutella2 <br /> * getnetworks <br /> ** Outputs the enabled networks in two formats. <br /> *** Start with the informational response: I| <br /> **** For the 'I|nets|' line <br /> ***** The third field contains the supported networks joined by '-'. <br /> **** For the 'I|networks|' line <br /> ***** Interpret the fields from 3 and beyond as individual network names to challenge against. <br /> *** Examples <br /> **** <br /> ***** I|nets|gnutella-gnutella2 <br /> ***** I|networks|gnutella|gnutella2 <br /> Update Extension Variables: <br /> * x_leaves <br /> ** Number of leaves running on a given hub or ultrapeer. <br /> ** '''Value must not be greater than an integer value of 2047.''' <br /> ** '''Note: It is important to know that PHP automaticaly replace dots with underscores, so to keep compatibility with old/new version of clients all caches should support both variants, example: x.leaves x_leaves''' <br /> * x_max <br /> ** Maximum number of leaves possible on a given hub or ultrapeer. <br /> ** '''Value must not be greater than an integer value of 2047.''' <br /> * uptime <br /> ** Value submitted must be an integer value of the number of seconds of uptime. <br /> ** '''Value must not be greater than an integer value of 1 year (31536000) and less than 1 hour (60).''' <br /> <br /> === Pinging Caches With Your Cache ===<br /> '''Please follow this standard:''' <br /> * '''Client: TEST''' <br /> * '''Version: Your Cache's Name''' <br /> ** The old value for &quot;version&quot; was 1 <br /> '''Some variables to attach to the ping (compatibility):''' <br /> * '''multi''' <br /> ** Used by some gwcs in their pings to other gwcs. <br /> ** &lt;nowiki&gt;It tells the pinged cache to ignore the &quot;net&quot; parameter (so it should never say network not supported) and outputting the pong using this format, if possible, &quot;I|pong|[cache name] [cache version]|[supported networks list]&quot; - example: I|pong|Skulls 0.2.9|gnutella-gnutella2 &lt;/nowiki&gt;<br /> ** Used by Skulls GWC only, supported by Skulls and Beacon Cache II. <br /> * '''cache''' <br /> ** This is added to every request made by some gwcs, it is for statistical purposes only. <br /> ** It simply tells the remote cache that the client is a GWC. <br /> '''Help''' <br /> * For PHP <br /> ** Use the fsockopen() function to open a connection to a cache. <br /> *** Make sure you &quot;write&quot; to the fsockopen carry value to open the GWC's target file. <br /> **** [http://us.php.net/manual/en/function.fsockopen.php http://us.php.net/manual/en/function.fsockopen.php] <br /> <br /> === Variable Combination Standards ===<br /> '''Net variable decides specification!''' <br /> * There are many ways to determine spec., but going with net is the safe way. <br /> * Skulls GWC does not use the network parameter to determine specification level. <br /> * Beacon Cache (I and II) uses the network parameter to determine the specification level. <br /> '''Your cache needs to be able to process certain combinations of variables.''' <br /> * Update variable <br /> ** Update should not fail if absent if spec. 2. <br /> *** A Specification 2 parameter. <br /> Spec 1 parameters used in Spec 2: <br /> * Should still accept hostfile and urlfile responses for spec. 2. <br /> ** Beacon Cache (I and II) accepts these parameters on spec 2. <br /> The 'spec' paameter can be used to force a specification: <br /> * Only known to exist in Beacon Cache II, it can force the request to be handled as a specification 1 or 2 request. <br /> * Spec 1 = 'spec=1' <br /> * Spec 2 = 'spec=2' <br /> * If 'spec' is not equal to any current spec, then default to the predetermined spec. <br /> '''Multiple variable requests''' <br /> * If for instance a ping and request exist, you should always handle them properly. <br /> ** Same goes with other combos like an update and ping, statfile + ping and info. <br /> * Handle multiple variables as BEST as possible! <br /> ** Some scanners and GWCs like to fit all their requests into one URL send. <br /> <br /> === Further Information: ===<br /> * [http://www.gnucleus.com/gwebcache/ Original GWC] [http://www.gnucleus.com/gwebcache/ site] <br /> ** [http://gnucleus.sourceforge.net/gwebcache/specs.html GWC Spec. 1] <br /> ** [http://gnucleus.sourceforge.net/gwebcache/newgwc.html GWC Spec. 2] <br /> <br /> === Gnutella Web Cache ===<br /> Gnutella requires Gnutella Web Caches (GWC) to get IPs to establish a connection to the network. These are critical to ensuring the health of the network. If you have a dedicated server and can spare some extra bandwidth then please consider running a GWC. People that don't have a dedicated server or are on normal broadband consumer lines should not run a cache from home.<br /> <br /> A GWC is a simple script that can be put on any webserver that supports one of the following scripting languages:<br /> *JSP (Java Servlet)<br /> **[http://web.archive.org/web/20061108091447/http://www.mager.org/GWebCache/ Java Servlet GWebCache Application (Archive.org)]<br /> *C<br /> **[http://ghostwhitecrab.com/crab/ GhostWhiteCrab]<br /> *Perl <br /> **[http://www.jonatkins.com/perlgcache/ Jon Atkins' perlgcache] <br /> **The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache]<br /> *PHP <br /> **[http://gwcii.sourceforge.net/ PHPGnuCacheII] - MySQL<br /> **[http://www.bazookanetworks.com Bazooka G2WC] (recommended) - flat files<br /> **[http://sourceforge.net/projects/skulls/ Skulls! Multi-Network WebCache] - flat files<br /> ====Further Information:====<br /> *[http://www.gnucleus.com/gwebcache/|Original GWC site]<br /> <br /> <br /> {{RecoveredPage|--&gt;Saved in timestamp 20090421202728Retrieved from &quot;[https://www.pantheraproject.net/wiki/index.php?title=GWC This page was last modified on April 18, 2009, at 23:25. &lt;/center&gt;<br /> <br /> &lt;center&gt;Copyright © 2002-2009 Shareaza Development Team. &lt;/center&gt;&lt;center&gt;[[Image:poweredby_mediawiki_88x31.png]] --[[User:Ocexyz|Ocexyz]] 16:20, 27 July 2009 (UTC)}}<br /> <br /> {{RecoveredPage|Warninig: here ends pasted better formatted recovery. Row recovery has been mooved below as I don't know if anybody has made any changes in it. If not then row recovery can be deleted I suppose. Paste starts from == Shareaza Specific Details == and ends at second == Shareaza Specific Details ==, here. I hope it is visible. --[[User:Ocexyz|Ocexyz]] 16:20, 27 July 2009 (UTC) }}<br /> <br /> ==Shareaza Specific Details==<br /> <br /> {{RecoveredPage|Warninig: here ends pasted better formatted recovery. Row recovery has been mooved below as I don't know if anybody has made any changes in it. If not then row recovery can be deleted I suppose. Paste starts from &gt;&gt;Shareaza Specific Details&lt;&lt; and ends at second &gt;&gt; Shareaza Specific Details&lt;&lt;, here. I hope it is visible. --[[User:Ocexyz|Ocexyz]] 23:27, 27 July 2009 (UTC) }}<br /> <br /> * Get String Breakdown:<br /> o Update a leaf<br /> + &quot;?update=1&amp;ip=(ip):(port)&amp;x_leaves=(leaf count) <br /> o Ping Variable<br /> + Appends &amp;ping=1 to identify the cache name in debug messages (for gnutella and gnutella2 in 2.4.0.0, but only for gnutella2 now in 2.4.0.X for spec1 cache compatibility).<br /> + This feature new to Shareaza. <br /> o Network Variable<br /> + Appends &amp;net=gnutella2 on Gnutella2 queries.<br /> + Does NOT append a network variable on Gnutella(1) queries. <br /> o Client Name / Version Format (2.4.0.0 and earlier):<br /> + &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )<br /> + &amp;version=(Shareaza's version) <br /> o Client Name / Version Format (2.4.0.X):<br /> + If Gnutella<br /> # &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )<br /> # &amp;version=(Shareaza's version) <br /> + If Gnutella2<br /> # &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )+(Shareaza's version) <br /> <br /> <br /> <br /> * GWC Response Matching:<br /> o i|<br /> + Informational output alone will not be taken as GWC 'success.' <br /> o i|access|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to make a request to the cache. <br /> o i|update|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to update to the cache. <br /> o i|force|remove and i|update|warning|bad url<br /> + Remove the GWC from the internal list. <br /> o Some Response Matches (added in 2.3.1.X)<br /> + i|NO-URL-NO-HOSTS<br /> # Outputs warning of the cache being totally empty to the system log. <br /> + i|NO-URL<br /> # Outputs warning of the cache having no alternative URLs to the system log. <br /> + i|NO-HOSTS<br /> # Outputs warning of the cache having no hosts to the system log. <br /> + i|warning|<br /> # Outputs warning of the cache to the system log. <br /> + ERROR Something Failed<br /> # Outputs warning of the cache to the system log(Buggy Bazooka GWCs workaround). <br /> + i|warning|You came back too early (2.3.1.X)<br /> + i|warning|client|early (2.3.1.X)<br /> + WARNING: You came back too early (2.3.1.X)<br /> + ERROR: Client returned too early (2.3.1.X)<br /> # Flood detection for the update side.<br /> # Outputs GWebCache(update) Too many connection attempts to the system log. <br /> + too early (2.3.1.X)<br /> + early (2.4.0.X)<br /> # Flood detection for the request side.<br /> # Outputs GWebCache URL: Too many connection attempts to the system log. <br /> + i|update|OK<br /> # Outputs &quot;GWebCache(v2) Update Passed: &quot; to the system log. <br /> + OK<br /> # Outputs &quot;GWebCache(v1) Update Passed: &quot; to the system log. <br /> <br /> <br /> <br /> * GWC Response Matching:<br /> o i|<br /> + Informational output alone will not be taken as GWC 'success.' <br /> o i|access|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to make a request to the cache. <br /> o i|update|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to update to the cache. <br /> o i|force|remove and i|update|warning|bad url<br /> + Remove the GWC from the internal list. <br /> o Some Response Matches (added in 2.3.1.X)<br /> + i|NO-URL-NO-HOSTS<br /> # Outputs warning of the cache being totally empty to the system log. <br /> + i|NO-URL<br /> # Outputs warning of the cache having no alternative URLs to the system log. <br /> + i|NO-HOSTS<br /> # Outputs warning of the cache having no hosts to the system log. <br /> + i|warning|<br /> # Outputs warning of the cache to the system log. <br /> + ERROR Something Failed<br /> # Outputs warning of the cache to the system log(Buggy Bazooka GWCs workaround). <br /> + i|warning|You came back too early (2.3.1.X)<br /> + i|warning|client|early (2.3.1.X)<br /> + WARNING: You came back too early (2.3.1.X)<br /> + ERROR: Client returned too early (2.3.1.X)<br /> # Flood detection for the update side.<br /> # Outputs GWebCache(update) Too many connection attempts to the system log. <br /> + too early (2.3.1.X)<br /> + early (2.4.0.X)<br /> # Flood detection for the request side.<br /> # Outputs GWebCache URL: Too many connection attempts to the system log. <br /> + i|update|OK<br /> # Outputs &quot;GWebCache(v2) Update Passed: &quot; to the system log. <br /> + OK<br /> # Outputs &quot;GWebCache(v1) Update Passed: &quot; to the system log. <br /> <br /> <br /> <br /> ==Gnutella Web Cache Specifications==<br /> &lt;end of partial recovery by OCE&gt;<br /> <br /> <br /> <br /> <br /> &lt;end of recovered content&gt;<br /> <br /> &lt;row recovery, start&gt; <br /> Specification 1:<br /> <br /> * Networks Served<br /> o Gnutella <br /> * Format<br /> o Update went fine:<br /> + Ex: OK <br /> o Update Warning (Small prob., not that bad):<br /> + Ex: <br /> <br /> OK<br /> WARNING: Error Message<br /> <br /> * Severe Warning (No 'OK' message sent)<br /> o Ex: <br /> <br /> WARNING: Error Message<br /> <br /> * URL Output:<br /> o Ex: http://somefreakinrandomcache.com/cache/gcache.php<br /> + OR - WITH A PORT NUMBER (If not 80)<br /> # Ex: http://somefreakinrandomcache.com:8080/cache/gcache.php <br /> * Host Output:<br /> o Ex: 66.132.55.12:6346 <br /> * Pong (ping variable response) - was explained below under the topic: variables.<br /> * Example Cache Output (Beacon Cache) For urlfile Command<br /> o Example &quot;urlfile Output&quot; URL: Ex: http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;urlfile=1<br /> + Example URL Output: <br /> <br /> <br /> Getting urls with a pong combined<br /> <br /> PONG Beacon Cache 0.1.5D Beta<br /> http://gwc.frodoslair.net/skulls/skulls.php<br /> http://bbs.robertwoolley.co.uk/GWebCache/gcache.php<br /> http://g2.tjtech.org/g2/<br /> http://g2.tjtech.org/g2/index.php<br /> http://gwc.monnsta.net/<br /> http://holograph.uni.cc/other/skulls.php<br /> http://gwc.nickstallman.net/<br /> http://gwc.eod.cc/skulls.php<br /> http://gwc.frodoslair.net/skulls/skulls<br /> http://gwc.werwin.net/skulls.php<br /> <br /> <br /> * Example Cache Output (Beacon Cache) For hostfile Command<br /> o Example &quot;hostfile Output&quot; URL: Ex: http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;hostfile=1<br /> + Example Host Output: <br /> <br /> <br /> Getting the hosts with a pong combined<br /> <br /> PONG Beacon Cache 0.1.5D Beta<br /> 71.8.84.153:3915<br /> 99.248.214.157:27529<br /> 69.60.241.55:16369<br /> 193.253.239.246:30218<br /> 68.156.175.121:6348<br /> 71.179.7.241:18344<br /> 74.196.22.241:6348<br /> 12.210.197.194:10531<br /> 222.150.143.77:10000<br /> 58.85.231.135:6346<br /> 24.141.199.164:20205<br /> 72.175.201.195:6348<br /> 69.81.129.228:4880<br /> 97.81.221.63:13219<br /> 70.15.130.224:7759<br /> 216.211.188.106:51903<br /> 75.167.168.156:48660<br /> 12.214.14.3:35916<br /> 76.177.244.106:24180<br /> 98.165.218.139:39630<br /> 68.112.182.125:3685<br /> 68.117.204.57:23482<br /> 65.12.154.25:40760<br /> 69.180.47.169:5711<br /> 75.138.40.173:24987<br /> 98.201.19.0:33662<br /> 70.187.2.144:6348<br /> 68.186.209.107:14429<br /> 69.159.7.61:6348<br /> 76.208.176.196:48199<br /> <br /> <br /> * For combining a hostfile and urlfile request:<br /> o Warning: This is non-standard.<br /> o Example Cache Output (Beacon Cache) For bfile Command<br /> + Example &quot;bfile Output&quot; URL: Ex: http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;bfile=1<br /> # Example Host and URL Output: <br /> <br /> <br /> Getting the hosts and urls with a pong combined<br /> <br /> PONG Beacon Cache 0.1.5D Beta<br /> 71.8.84.153:3915<br /> 99.248.214.157:27529<br /> 69.60.241.55:16369<br /> 193.253.239.246:30218<br /> 68.156.175.121:6348<br /> 71.179.7.241:18344<br /> 74.196.22.241:6348<br /> 12.210.197.194:10531<br /> 222.150.143.77:10000<br /> 58.85.231.135:6346<br /> 24.141.199.164:20205<br /> 72.175.201.195:6348<br /> 69.81.129.228:4880<br /> 97.81.221.63:13219<br /> 70.15.130.224:7759<br /> 216.211.188.106:51903<br /> 75.167.168.156:48660<br /> 12.214.14.3:35916<br /> 76.177.244.106:24180<br /> 98.165.218.139:39630<br /> 68.112.182.125:3685<br /> 68.117.204.57:23482<br /> 65.12.154.25:40760<br /> 69.180.47.169:5711<br /> 75.138.40.173:24987<br /> 98.201.19.0:33662<br /> 70.187.2.144:6348<br /> 68.186.209.107:14429<br /> 69.159.7.61:6348<br /> 76.208.176.196:48199<br /> http://gwc.frodoslair.net/skulls/skulls.php<br /> http://bbs.robertwoolley.co.uk/GWebCache/gcache.php<br /> http://g2.tjtech.org/g2/<br /> http://g2.tjtech.org/g2/index.php<br /> http://gwc.monnsta.net/<br /> http://holograph.uni.cc/other/skulls.php<br /> http://gwc.nickstallman.net/<br /> http://gwc.eod.cc/skulls.php<br /> http://gwc.frodoslair.net/skulls/skulls<br /> http://gwc.werwin.net/skulls.php<br /> <br /> <br /> * Variables<br /> o Mandatory<br /> + ping:<br /> # Response should have this always: PONG<br /> # After, put the cache's name. ex: PONG fakecache 0.01<br /> + client:<br /> # Four letter code of the client. ex: RAZA <br /> + version:<br /> # Version number of the client. <br /> + urlfile:<br /> # Used by the client to request alternate cache urls. <br /> + hostfile:<br /> # Used by the client to request IPs with port numbers attached. <br /> + url:<br /> # Client update giving an alternate cache URL.<br /> # Formatted with a http:// prefix to each cache. <br /> + ip:<br /> # Client update giving one's IP to submit. <br /> + url1:<br /> # OLD OUTDATED Client update giving an alternate cache URL.<br /> # Formatted with a http:// prefix to each cache. <br /> + ip1:<br /> # OLD OUTDATED Client update giving one's IP to submit. <br /> o Optional<br /> + bfile:<br /> # For clients to request both URLs and IPs from the cache at the same time. <br /> + statfile:<br /> # Statistics of the cache request:<br /> * First line: Total requests of the cache number.<br /> * Second line: Requests of the cache an hour number.<br /> * Third line: Updates of the cache an hour number. <br /> <br /> Specification 2:<br /> <br /> * Networks Served<br /> o Gnutella, Gnutella2, etc. <br /> * Format<br /> o Information Output<br /> + Starts with: I|<br /> # Categories<br /> * Pong (ping variable response) - Described below under the topic: variables.<br /> * Update Status Response<br /> o Format: I|update<br /> o Responses<br /> + I|update|OK<br /> # - Everything went fine. <br /> + I|update|OK|WARNING<br /> # Small warning. <br /> + I|update|WARNING<br /> # Severe warning <br /> * Plain Warnings<br /> o Format: I|WARNING<br /> + Append any warning messages after it - Ex: I|WARNING|You came back too early <br /> * Extra Info - Described below under the topic: variables. <br /> o Host Output<br /> + Starts with: H|<br /> + Add the IP with its port:<br /> # Ex: H|0.0.0.0:6346 <br /> + Add the time, thereafter, of the host's (In seconds*) time in cache:<br /> # Ex: H|0.0.0.0:6346|45 <br /> + If cluster exists with cluster=somerandomwords<br /> # Add the clustered words after the host's age:<br /> * Ex: H|0.0.0.0:6346|45|somerandomwords <br /> o URL Output<br /> + Starts with: U|<br /> + Add the URL with http:// before it, plus the port (if it's not 80).<br /> # Ex: U|http://somerandomcache.com/ <br /> + Add the time, thereafter, of the URL's time (In seconds*) in cache:<br /> # Ex: U|http://somerandomcache.com/|45 <br /> o Example Cache Output (Beacon Cache) For get Command<br /> + Example URL: http://grantgalitz.com/Beacon/gwc.php?get=1&amp;client=RAZA&amp;version=2.3.1.3&amp;net=gnutella2&amp;ping=1<br /> # Example &quot;Get&quot; Output: <br /> <br /> <br /> Getting the hosts and urls with a pong combined<br /> <br /> I|pong|Beacon Cache 0.1.5D Beta|gnutella-gnutella2<br /> H|65.9.200.243:4968|248261<br /> H|68.228.129.75:44599|242678<br /> H|98.240.196.122:8206|240719<br /> H|76.104.12.133:14921|218273<br /> H|69.136.1.12:3924|211610<br /> H|81.154.208.71:8595|174402<br /> H|97.96.105.51:2076|153610<br /> H|74.192.153.212:39340|144203<br /> H|72.190.106.57:12584|132984<br /> H|78.93.71.132:12334|125668<br /> H|82.43.248.184:27560|97974<br /> H|196.205.224.97:6357|86763<br /> H|74.129.219.30:33172|82005<br /> H|76.104.12.133:19185|57182<br /> H|69.59.83.131:18442|38628<br /> U|http://www.k33bz.com/g2/bazooka.php|248639<br /> U|http://gwebcache.ns1.net/|248592<br /> U|http://gwc2.wodi.org/skulls.php|248384<br /> U|http://gwc.guufshop.com/skulls/skulls.php|248322<br /> U|http://groovy.syxy.com/up/skulls.php|248300<br /> U|http://g2.tjtech.org/g2/index.php|247770<br /> U|http://midian.jayl.de/g2/bazooka.php|240719<br /> U|http://www.dom2porno.info/skulls/skulls.php|207473<br /> U|http://gwc.frodoslair.net/skulls/skulls|125668<br /> U|http://holograph.uni.cc/other/skulls.php|9642<br /> <br /> <br /> * Variables<br /> o Mandatory<br /> + ping:<br /> # Main Part: I|pong|<br /> # Then add the cache name and version: I|pong|fakecache 0.01<br /> # Then lastly add the network support:<br /> * I|pong|fakecache 0.01|gnutella<br /> o - Gnutella only <br /> * I|pong|fakecache 0.01|gnutella2<br /> o - Gnutella2 only <br /> * I|pong|fakecache 0.01|gnutella-gnutella2<br /> o - Gnutella and Gnutella2 served <br /> + get:<br /> # Used by clients to requests alternate cache URLs along with IPs and their port numbers. <br /> + update:<br /> # url:<br /> * Client update giving an alternate cache URL.<br /> * Formatted with a http:// prefix to each cache. <br /> # ip:<br /> * Client update giving one's IP to submit. <br /> + net:<br /> # Which network to serve the client.<br /> * Gnutella<br /> o Ex: net=gnutella <br /> * Gnutella2<br /> o Ex: net=gnutella2 <br /> * Should always be lowercase<br /> o GWCs should automatically convert network name given to lowercase to prevent Net ID mismatches <br /> <br /> solely on case alone.<br /> <br /> *<br /> o<br /> + client:<br /> # Four letter code of the client. ex: RAZA <br /> + version:<br /> # Version number of the client. <br /> o Optional<br /> + cluster:<br /> # To add extra info to an IP update.<br /> * Output by cache: H|0.0.0.0|AGE OF HOST (Seconds)|clustering some bull**** <br /> + statfile:<br /> # Exactly like the specification 1 statfile (Same routine and output style).<br /> # Statistics of the cache request:<br /> * First line: Total requests of the cache number.<br /> * Second line: Requests of the cache an hour number.<br /> * Third line: Updates of the cache an hour number. <br /> <br /> Specification 2.1<br /> <br /> * This is an extension of specification 2, not a separate specification!<br /> * Pong extension<br /> o Append the networks supported joined by a hyphen '-'.<br /> o Used for client-side validation of networks supported and for network support reporting to other web caches.<br /> o Format:<br /> + I|pong|cache name|network names joined by '-'<br /> + Format Examples:<br /> # I|pong|fakecache 0.01|gnutella<br /> * - Gnutella only <br /> # I|pong|fakecache 0.01|gnutella2<br /> * - Gnutella2 only <br /> # I|pong|fakecache 0.01|gnutella-gnutella2<br /> * - Gnutella and Gnutella2 served <br /> * Host Output<br /> o Just like specification 2, but with more fields supported for host output.<br /> + H|ip:port|age in cache|clustering|leaves|4 letter vendor code|reported uptime of host|max. leaves possible<br /> # The host, age, and clustering fields are all still the same as in specification 2.<br /> # The leaf count of the hub reported is in the 5th field.<br /> # The vendor code with version number is in the 6th field. <br /> * Request Control Variables:<br /> o getleaves<br /> + Used to obtain leaf counts of hubs given<br /> + 4th field ultilized for current leaf count.<br /> + 7th field ultilized for maximum leaf slots possible.<br /> + Use this as 'getleaves=1' or 'getleaves' to enable. <br /> o getclusters<br /> + Enables/Disables clustering.<br /> + Use this as 'getclusters=1'.<br /> + Using 'getclusters' or 'getclusters=0' disables cluster output. <br /> o getvendors<br /> + Used to obtain the vendor code w/ version number of the hubs given.<br /> + Found in the 5th field.<br /> + Use this as 'getvendors=1' or 'getvendors' to enable. <br /> o getuptime<br /> + Used to obtain the vendor code w/ version number of the hubs given.<br /> + Value is static, do not change the value given when time passes.<br /> + Found in the 6th field.<br /> + Use this as 'getuptime=1' or 'getuptime' to enable. <br /> o spec<br /> + To force the specification parameter<br /> + Currently is only supported by Beacon Cache II <br /> o pv<br /> + Similar to the 'spec' parameter, except that it does not force, instead it simply negotiates the specification. <br /> * Special Data Requests<br /> o info<br /> + Outputs extra details of your cache.<br /> # Start with the informational response: I|<br /> * Ex: I|open-source|1 <br /> o support<br /> + Outputs USEFUL details of your cache.<br /> # Start with the informational response: I|<br /> * Ex: I|support|gnutella2 <br /> o getnetworks<br /> + Outputs the enabled networks in two formats.<br /> # Start with the informational response: I|<br /> * For the 'I|nets|' line<br /> o The third field contains the supported networks joined by '-'. <br /> * For the 'I|networks|' line<br /> o Interpret the fields from 3 and beyond as individual network names to challenge against. <br /> # Examples<br /> *<br /> o I|nets|gnutella-gnutella2<br /> o I|networks|gnutella|gnutella2 <br /> * Update Extension Variables:<br /> o x_leaves<br /> + Number of leaves running on a given hub or ultrapeer.<br /> + Value must not be greater than an integer value of 2047.<br /> + Note: It is important to know that PHP automaticaly replace dots with underscores, so to keep compatibility with old/new version of clients all caches should support both variants, example: x.leaves x_leaves<br /> o x_max<br /> + Maximum number of leaves possible on a given hub or ultrapeer.<br /> + Value must not be greater than an integer value of 2047. <br /> o uptime<br /> + Value submitted must be an integer value of the number of seconds of uptime.<br /> + Value must not be greater than an integer value of 1 year (31536000) and less than 1 hour (60). <br /> <br /> Pinging Caches With Your Cache<br /> <br /> * Please follow this standard:<br /> o Client: TEST<br /> o Version: Your Cache's Name<br /> + The old value for &quot;version&quot; was 1 <br /> * Some variables to attach to the ping (compatibility):<br /> o multi<br /> + Used by some gwcs in their pings to other gwcs.<br /> + It tells the pinged cache to ignore the &quot;net&quot; parameter (so it should never say network not supported) and outputting the pong using this format, if possible, &quot;I|pong|[cache name] [cache version]|[supported networks list]|[url adding is enabled]&quot; - example: I|pong|Skulls 0.2.8a|gnutella-gnutella2|1<br /> + Used by Skulls GWC only. <br /> o cache<br /> + This is added to every request made by some gwcs, it is for statistical purposes only.<br /> + It simply tells the remote cache that the client is a GWC. <br /> * Help<br /> o For PHP<br /> + Use the fsockopen() function to open a connection to a cache.<br /> # Make sure you &quot;write&quot; to the fsockopen carry value to open the GWC's target file.<br /> * http://us.php.net/manual/en/function.fsockopen.php <br /> <br /> Variable Combination Standards<br /> <br /> * Net variable decides specification!<br /> o There are many ways to determine spec., but going with net is the safe way.<br /> o Skulls GWC does not use the network parameter to determine specification level.<br /> o Beacon Cache (I and II) uses the network parameter to determine the specification level. <br /> * Your cache needs to be able to process certain combinations of variables.<br /> o Update variable<br /> + Update should not fail if absent if spec. 2.<br /> # A Specification 2 parameter. <br /> * Spec 1 parameters used in Spec 2:<br /> o Should still accept hostfile and urlfile responses for spec. 2.<br /> + Beacon Cache (I and II) accepts these parameters on spec 2. <br /> * The 'spec' paameter can be used to force a specification:<br /> o Only known to exist in Beacon Cache II, it can force the request to be handled as a specification 1 or 2 request.<br /> o Spec 1 = 'spec=1'<br /> o Spec 2 = 'spec=2'<br /> o If 'spec' is not equal to any current spec, then default to the predetermined spec. <br /> * Multiple variable requests<br /> o If for instance a ping and request exist, you should always handle them properly.<br /> + Same goes with other combos like an update and ping, statfile + ping and info. <br /> o Handle multiple variables as BEST as possible!<br /> + Some scanners and GWCs like to fit all their requests into one URL send. <br /> <br /> &lt;row recovery, end&gt; <br /> <br /> Further Information:<br /> <br /> * [http://www.gnucleus.com/gwebcache/ Original GWC site]<br /> ** [http://gnucleus.sourceforge.net/gwebcache/specs.html GWC Spec. 1]<br /> ** [http://gnucleus.sourceforge.net/gwebcache/newgwc.html GWC Spec. 2] <br /> <br /> <br /> <br /> <br /> <br /> &lt;content recovered from last aviable backup&gt; <br /> <br /> ===Gnutella Web Cache===<br /> Gnutella requires Gnutella Web Caches (GWC) to get IPs to establish a connection to the network. These are critical to ensuring the health of the network. If you have a dedicated server and can spare some extra bandwidth then please consider running a GWC. People that don't have a dedicated server or are on normal broadband consumer lines should not run a cache from home.<br /> <br /> A GWC is a simple script that can be put on any webserver that supports one of the following scripting languages:<br /> *JSP (Java Servlet)<br /> **[http://web.archive.org/web/20061108091447/http://www.mager.org/GWebCache/ Java Servlet GWebCache Application (Archive.org)]<br /> *C<br /> **[http://ghostwhitecrab.com/crab/ GhostWhiteCrab]<br /> *Perl <br /> **[http://www.jonatkins.com/perlgcache/ Jon Atkins' perlgcache] <br /> **The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache]<br /> *PHP <br /> **[http://gwcii.sourceforge.net/ PHPGnuCacheII] - MySQL<br /> **[http://www.bazookanetworks.com Bazooka G2WC] (recommended) - flat files<br /> **[http://sourceforge.net/projects/skulls/ Skulls! Multi-Network WebCache] - flat files<br /> === Further Information: ===<br /> * [http://www.gnucleus.com/gwebcache/ Original GWC site]<br /> <br /> [[Category:External Links]]</div>

Ale5000 https://shareaza.sourceforge.net/w/index.php?title=GWC_specs&diff=11504 2015-03-25T12:32:31Z

<p>Ale5000: Corrected wrong examples</p> <hr /> <div>''For general information on GWCs, have a look at the [[GWC]] Wiki page.''<br /> {{do not translate}}<br /> This page is thought to give an overview over the GWC specifications as they are implemented into Shareaza.<br /> <br /> A GWC is a simple script that can be put on any webserver that supports one of the following scripting languages: <br /> <br /> * JSP (Java Servlet) <br /> ** [http://www1.mager.org/GWebCache/ Jums Web Cache] (Excellent for heavy loads) <br /> * C <br /> ** [http://wiki.limewire.org/index.php?title=GhostWhiteCrab GhostWhiteCrab] (For dedicated server environments and people who know how to compile C source code!) <br /> * ASP <br /> ** [http://www.edazzle.net/downloads/gerry.zip Gerry GWC] <br /> ** [https://www.planet-source-code.com/vb/scripts/ShowCode.asp?txtCodeId=7846&amp;lngWId=4 Lynn (v.s. 0.5)] <br /> ** [https://www.planet-source-code.com/vb/scripts/ShowCode.asp?txtCodeId=7731&amp;lngWId=4 Lynn (v.s. 0.4)] <br /> ** [http://www.poundwebhosting.com/cgi-bin/lynnx.asp LynnX] <br /> * Perl <br /> ** [http://www.jonatkins.com/perlgcache/ Jon Atkins' perlgcache] <br /> ** The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache] <br /> '''PHP''' ''(Tip: PHP GWCs are usually the easiest to run and setup on a server.)''<br /> ** [http://gwcii.sourceforge.net/ PHPGnuCacheII] <br /> ** [http://www.bazookanetworks.com/ Bazooka G2WC] <br /> * The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache] ''(PHP version is no longer supported)'' <br /> ** [http://sourceforge.net/projects/skulls/ Skulls! Multi-Network WebCache] <br /> ** [http://sourceforge.net/projects/beaconcache/ Beacon Cache] <br /> ** [http://code.google.com/p/cachechu/ Cachechu G2WC] <br /> <br /> == Breakdown Of The Gnutella Web Caches: == <br /> {{RecoveredPage|I recently put this into a table. The contents need to be verified -- [[User:Cyko 01|Cyko 01]]}}<br /> <br /> {| width= auto; style=&quot;font-size: 85%; text-align: center;text-valign: middle;&quot; class=&quot;wikitable&quot;<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Cache:<br /> ! rowspan=1 |Gnutella:<br /> ! rowspan=1 |Gnutella2:<br /> ! rowspan=1 |Spec 1:<br /> ! rowspan=1 |Spec 2:<br /> ! rowspan=1 |Flat-File:<br /> ! rowspan=1 |SQL:<br /> ! rowspan=1 |Installer:<br /> ! rowspan=1 |Other Networks:<br /> ! rowspan=1 |Different network instances:<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Beacon Cache (Core 2)<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> |style=&quot;background: #CCFFCC;&quot;| Yes (As of 0.2.0 Alpha)<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Beacon Cache (Core 1)<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Skulls<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|JumsWebCache<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|GnuWebCache (Perl)<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|GnuWebCache (PHP) <br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|GhostWhiteCrab(GWC) <br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> |style=&quot;background: #FFFFCC;&quot;| N/A<br /> |style=&quot;background: #FFFFCC;&quot;| N/A<br /> |style=&quot;background: #FFFFCC;&quot;| N/A<br /> | {{yes}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|PHPGnuCacheII <br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Bazooka <br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Cachechu<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Perlgcache<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Gerry GWC (v2)<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Gerry GWC (v1)<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Lynn<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|LynnX<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |}<br /> <br /> == Shareaza Specific Details == <br /> <br /> {{RecoveredPage|Warninig: here I have pasted better formatted recovery, but not verified. Row recovery has been mooved below as I don't know if anybody has made any changes in it. If not then row recovery can be deleted. Paste starts from &gt;&gt;Shareaza Specific Details&lt;&lt;, here, and ends at second &gt;&gt;Shareaza Specific Details&lt;&lt; I hope it is visible. --[[User:Ocexyz|Ocexyz]] 23:27, 27 July 2009 (UTC)}}<br /> <br /> '''Get String Breakdown:''' <br /> * Update a leaf <br /> ** &quot;?update=1&amp;ip=(ip):(port)&amp;x_leaves=(leaf count) <br /> * Ping Variable <br /> ** Appends &amp;ping=1 to identify the cache name in debug messages (for gnutella and gnutella2 in 2.4.0.0, but only for gnutella2 now in 2.4.0.X for spec1 cache compatibility). <br /> ** This feature new to Shareaza. <br /> * Network Variable <br /> ** Appends &amp;net=gnutella2 on Gnutella2 queries. <br /> ** Does NOT append a network variable on Gnutella(1) queries. <br /> * Client Name / Version Format (2.4.0.0 and earlier): <br /> ** &amp;client=(Shareaza 4 letter code (RAZA / RAZB) ) <br /> ** &amp;version=(Shareaza's version) <br /> * Client Name / Version Format (2.4.0.X): <br /> ** If Gnutella <br /> *** &amp;client=(Shareaza 4 letter code (RAZA / RAZB) ) <br /> *** &amp;version=(Shareaza's version) <br /> ** If Gnutella2 <br /> *** &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )+(Shareaza's version) <br /> <br /> '''GWC Response Matching:''' <br /> * i| <br /> ** Informational output alone will not be taken as GWC 'success.' <br /> * i|access|period|(time in sec.) <br /> ** Time in seconds before Shareaza is allowed to make a request to the cache. <br /> * i|update|period|(time in sec.) <br /> ** Time in seconds before Shareaza is allowed to update to the cache. <br /> * i|force|remove and i|update|warning|bad url <br /> ** Remove the GWC from the internal list. <br /> * Some Response Matches (added in 2.3.1.X) <br /> ** i|NO-URL-NO-HOSTS <br /> *** Outputs warning of the cache being totally empty to the system log. <br /> ** i|NO-URL <br /> *** Outputs warning of the cache having no alternative URLs to the system log. <br /> ** i|NO-HOSTS <br /> *** Outputs warning of the cache having no hosts to the system log. <br /> ** i|warning| <br /> *** Outputs warning of the cache to the system log. <br /> ** ERROR Something Failed <br /> *** Outputs warning of the cache to the system log(Buggy Bazooka GWCs workaround). <br /> ** i|warning|You came back too early (2.3.1.X) <br /> ** i|warning|client|early (2.3.1.X) <br /> ** WARNING: You came back too early (2.3.1.X) <br /> ** ERROR: Client returned too early (2.3.1.X) <br /> *** Flood detection for the update side. <br /> *** Outputs GWebCache(update) Too many connection attempts to the system log. <br /> ** too early (2.3.1.X) <br /> ** early (2.4.0.X) <br /> *** Flood detection for the request side. <br /> *** Outputs GWebCache URL: Too many connection attempts to the system log. <br /> ** i|update|OK <br /> *** Outputs &quot;GWebCache(v2) Update Passed: &quot; to the system log. <br /> ** OK <br /> *** Outputs &quot;GWebCache(v1) Update Passed: &quot; to the system log. <br /> <br /> == Gnutella Web Cache Specifications ==<br /> ==== Specification 1: ====<br /> * '''Networks Served''' <br /> ** Gnutella <br /> * '''Format''' <br /> ** Update went fine: <br /> *** Ex: OK <br /> ** Update Warning (Small prob., not that bad): <br /> *** Ex: OKWARNING: Error Message <br /> <br /> * Severe Warning (No 'OK' message sent) <br /> ** Ex: WARNING: Error Message<br /> <br /> * URL Output: <br /> ** Ex: [http://somefreakinrandomcache.com/cache/gcache.php http://somefreakinrandomcache.com/cache/gcache.php] <br /> *** OR - WITH A PORT NUMBER (If not 80) <br /> **** Ex: [http://somefreakinrandomcache.com:8080/cache/gcache.php http://somefreakinrandomcache.com:8080/cache/gcache.php] <br /> * Host Output: <br /> ** Ex: 66.132.55.12:6346 <br /> * Pong (ping variable response) - was explained below under the topic: variables. <br /> * '''Example Cache Output (Beacon Cache) For urlfile Command''' <br /> ** Example &quot;urlfile Output&quot; URL: Ex: [http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;urlfile=1 http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;urlfile=1] <br /> *** Example URL Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting urls with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | PONG Beacon Cache 0.1.5D Beta[http://gwc.frodoslair.net/skulls/skulls.php http://gwc.frodoslair.net/skulls/skulls.php][http://bbs.robertwoolley.co.uk/GWebCache/gcache.php http://bbs.robertwoolley.co.uk/GWebCache/gcache.php][http://g2.tjtech.org/g2/ http://g2.tjtech.org/g2/][http://g2.tjtech.org/g2/index.php http://g2.tjtech.org/g2/index.php][http://gwc.monnsta.net/ http://gwc.monnsta.net/][http://holograph.uni.cc/other/skulls.php http://holograph.uni.cc/other/skulls.php][http://gwc.nickstallman.net/ http://gwc.nickstallman.net/][http://gwc.eod.cc/skulls.php http://gwc.eod.cc/skulls.php][http://gwc.frodoslair.net/skulls/skulls http://gwc.frodoslair.net/skulls/skulls][http://gwc.werwin.net/skulls.php http://gwc.werwin.net/skulls.php] <br /> <br /> |}<br /> * '''Example Cache Output (Beacon Cache) For hostfile Command''' <br /> ** Example &quot;hostfile Output&quot; URL: Ex: [http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;hostfile=1 http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;hostfile=1] <br /> *** Example Host Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting the hosts with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | PONG Beacon Cache 0.1.5D Beta71.8.84.153:391599.248.214.157:2752969.60.241.55:16369193.253.239.246:3021868.156.175.121:634871.179.7.241:1834474.196.22.241:634812.210.197.194:10531222.150.143.77:1000058.85.231.135:634624.141.199.164:2020572.175.201.195:634869.81.129.228:488097.81.221.63:1321970.15.130.224:7759216.211.188.106:5190375.167.168.156:4866012.214.14.3:3591676.177.244.106:2418098.165.218.139:3963068.112.182.125:368568.117.204.57:2348265.12.154.25:4076069.180.47.169:571175.138.40.173:2498798.201.19.0:3366270.187.2.144:634868.186.209.107:1442969.159.7.61:634876.208.176.196:48199<br /> <br /> |}<br /> * '''For combining a hostfile and urlfile request:''' <br /> ** Warning: This is non-standard. <br /> ** '''Example Cache Output (Beacon Cache) For bfile Command''' <br /> *** Example &quot;bfile Output&quot; URL: Ex: [http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;bfile=1 http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;bfile=1] <br /> **** Example Host and URL Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting the hosts and urls with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | PONG Beacon Cache 0.1.5D Beta71.8.84.153:391599.248.214.157:2752969.60.241.55:16369193.253.239.246:3021868.156.175.121:634871.179.7.241:1834474.196.22.241:634812.210.197.194:10531222.150.143.77:1000058.85.231.135:634624.141.199.164:2020572.175.201.195:634869.81.129.228:488097.81.221.63:1321970.15.130.224:7759216.211.188.106:5190375.167.168.156:4866012.214.14.3:3591676.177.244.106:2418098.165.218.139:3963068.112.182.125:368568.117.204.57:2348265.12.154.25:4076069.180.47.169:571175.138.40.173:2498798.201.19.0:3366270.187.2.144:634868.186.209.107:1442969.159.7.61:634876.208.176.196:48199[http://gwc.frodoslair.net/skulls/skulls.php http://gwc.frodoslair.net/skulls/skulls.php][http://bbs.robertwoolley.co.uk/GWebCache/gcache.php http://bbs.robertwoolley.co.uk/GWebCache/gcache.php][http://g2.tjtech.org/g2/ http://g2.tjtech.org/g2/][http://g2.tjtech.org/g2/index.php http://g2.tjtech.org/g2/index.php][http://gwc.monnsta.net/ http://gwc.monnsta.net/][http://holograph.uni.cc/other/skulls.php http://holograph.uni.cc/other/skulls.php][http://gwc.nickstallman.net/ http://gwc.nickstallman.net/][http://gwc.eod.cc/skulls.php http://gwc.eod.cc/skulls.php][http://gwc.frodoslair.net/skulls/skulls http://gwc.frodoslair.net/skulls/skulls][http://gwc.werwin.net/skulls.php http://gwc.werwin.net/skulls.php] <br /> <br /> |}<br /> '''Variables''' <br /> * '''Mandatory''' <br /> ** ping: <br /> *** Response should have this always: PONG<br /> *** After, put the cache's name. ex: PONG fakecache 0.01<br /> ** client: <br /> *** Four letter code of the client. ex: RAZA <br /> ** version: <br /> *** Version number of the client. <br /> ** urlfile: <br /> *** Used by the client to request alternate cache urls. <br /> ** hostfile: <br /> *** Used by the client to request IPs with port numbers attached. <br /> ** url: <br /> *** Client update giving an alternate cache URL. <br /> *** Formatted with a http:// prefix to each cache. <br /> ** ip: <br /> *** Client update giving one's IP to submit. <br /> ** url1: <br /> *** OLD OUTDATED Client update giving an alternate cache URL. <br /> *** Formatted with a http:// prefix to each cache. <br /> ** ip1: <br /> *** OLD OUTDATED Client update giving one's IP to submit. <br /> * '''Optional''' <br /> ** bfile: <br /> *** For clients to request both URLs and IPs from the cache at the same time. <br /> ** statfile: <br /> *** Statistics of the cache request: <br /> **** First line: Total requests of the cache number. <br /> **** Second line: Requests of the cache an hour number. <br /> **** Third line: Updates of the cache an hour number.<br /> <br /> ==== Specification 2: ====<br /> '''Networks Served''' <br /> * Gnutella, Gnutella2, etc. <br /> '''Format''' <br /> * '''Information Output''' <br /> ** Starts with: I| <br /> *** '''Categories''' <br /> **** '''Pong''' (ping variable response) - Described below under the topic: variables. <br /> **** '''Update Status Response''' <br /> ***** Format: I|update <br /> ***** '''Responses''' <br /> ****** I|update|OK <br /> ******* - Everything went fine. <br /> ****** I|update|OK|WARNING <br /> ******* Small warning. <br /> ****** I|update|WARNING <br /> ******* Severe warning <br /> **** '''Plain Warnings''' <br /> ***** Format: I|WARNING <br /> ****** Append any warning messages after it - Ex: I|WARNING|You came back too early <br /> **** '''Extra Info''' - Described below under the topic: variables. <br /> * '''Host Output''' <br /> ** Starts with: H| <br /> ** Add the IP with its port: <br /> *** Ex: H|0.0.0.0:6346 <br /> ** Add the time, thereafter, of the host's (In seconds*) time in cache: <br /> *** Ex: H|0.0.0.0:6346|45 <br /> ** If cluster exists with cluster=somerandomwords <br /> *** Add the clustered words after the host's age: <br /> **** Ex: H|0.0.0.0:6346|45|somerandomwords <br /> * '''URL Output''' <br /> ** Starts with: U| <br /> ** Add the URL with http:// before it, plus the port (if it's not 80). <br /> *** Ex: U|[http://somerandomcache.com/ http://somerandomcache.com/] <br /> ** Add the time, thereafter, of the URL's time (In seconds*) in cache: <br /> *** Ex: U|[http://somerandomcache.com/%7C45 http://somerandomcache.com/|45] <br /> * '''Example Cache Output (Beacon Cache) For get Command''' <br /> ** Example URL: [http://grantgalitz.com/Beacon/gwc.php?get=1&amp;client=RAZA&amp;version=2.3.1.3&amp;net=gnutella2&amp;ping=1 http://grantgalitz.com/Beacon/gwc.php?get=1&amp;client=RAZA&amp;version=2.3.1.3&amp;net=gnutella2&amp;ping=1] <br /> *** Example &quot;Get&quot; Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting the hosts and urls with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | I|pong|Beacon Cache 0.1.5D Beta|gnutella-gnutella2H|65.9.200.243:4968|248261H|68.228.129.75:44599|242678H|98.240.196.122:8206|240719H|76.104.12.133:14921|218273H|69.136.1.12:3924|211610H|81.154.208.71:8595|174402H|97.96.105.51:2076|153610H|74.192.153.212:39340|144203H|72.190.106.57:12584|132984H|78.93.71.132:12334|125668H|82.43.248.184:27560|97974H|196.205.224.97:6357|86763H|74.129.219.30:33172|82005H|76.104.12.133:19185|57182H|69.59.83.131:18442|38628U|[http://www.k33bz.com/g2/bazooka.php%7C248639 http://www.k33bz.com/g2/bazooka.php|248639]U|[http://gwebcache.ns1.net/%7C248592 http://gwebcache.ns1.net/|248592]U|[http://gwc2.wodi.org/skulls.php%7C248384 http://gwc2.wodi.org/skulls.php|248384]U|[http://gwc.guufshop.com/skulls/skulls.php%7C248322 http://gwc.guufshop.com/skulls/skulls.php|248322]U|[http://groovy.syxy.com/up/skulls.php%7C248300 http://groovy.syxy.com/up/skulls.php|248300]U|[http://g2.tjtech.org/g2/index.php%7C247770 http://g2.tjtech.org/g2/index.php|247770]U|[http://midian.jayl.de/g2/bazooka.php%7C240719 http://midian.jayl.de/g2/bazooka.php|240719]U|[http://www.dom2porno.info/skulls/skulls.php%7C207473 http://www.dom2porno.info/skulls/skulls.php|207473]U|[http://gwc.frodoslair.net/skulls/skulls%7C125668 http://gwc.frodoslair.net/skulls/skulls|125668]U|[http://holograph.uni.cc/other/skulls.php%7C9642 http://holograph.uni.cc/other/skulls.php|9642] <br /> <br /> |}<br /> '''Variables''' <br /> * '''Mandatory''' <br /> ** ping: <br /> *** Main Part: I|pong| <br /> *** Then add the cache name and version: I|pong|fakecache 0.01 <br /> *** Then lastly add the network support: <br /> **** I|pong|fakecache 0.01|gnutella <br /> ***** - Gnutella only <br /> **** I|pong|fakecache 0.01|gnutella2 <br /> ***** - Gnutella2 only <br /> **** I|pong|fakecache 0.01|gnutella-gnutella2 <br /> ***** - Gnutella and Gnutella2 served <br /> ** get: <br /> *** Used by clients to requests alternate cache URLs along with IPs and their port numbers. <br /> ** update: <br /> *** url: <br /> **** Client update giving an alternate cache URL. <br /> **** Formatted with a http:// prefix to each cache. <br /> *** ip: <br /> **** Client update giving one's IP to submit. <br /> ** net: <br /> *** Which network to serve the client. <br /> **** Gnutella <br /> ***** Ex: net=gnutella <br /> **** Gnutella2 <br /> ***** Ex: net=gnutella2 <br /> **** '''Should always be lowercase''' <br /> ***** GWCs should automatically convert network name given to lowercase to prevent Net ID mismatches <br /> <br /> solely on case alone. <br /> <br /> <br /> * <br /> ** client: <br /> *** Four letter code of the client. ex: RAZA <br /> ** version: <br /> *** Version number of the client. <br /> * '''Optional''' <br /> ** cluster: <br /> *** To add extra info to an IP update. <br /> **** Output by cache: H|0.0.0.0|AGE OF HOST (Seconds)|clustering some bull**** <br /> ** statfile: <br /> *** Exactly like the specification 1 statfile '''(Same routine and output style)'''. <br /> *** Statistics of the cache request: <br /> **** First line: Total requests of the cache number. <br /> **** Second line: Requests of the cache an hour number. <br /> **** Third line: Updates of the cache an hour number. <br /> <br /> ==== Specification 2.1 ====<br /> '''This is an extension of specification 2, not a separate specification!''' <br /> Pong extension <br /> * Append the networks supported joined by a hyphen '-'. <br /> * Used for client-side validation of networks supported and for network support reporting to other web caches. <br /> * Format: <br /> ** I|pong|cache name|network names joined by '-' <br /> ** Format Examples: <br /> *** I|pong|fakecache 0.01|gnutella <br /> **** - Gnutella only <br /> *** I|pong|fakecache 0.01|gnutella2 <br /> **** - Gnutella2 only <br /> *** I|pong|fakecache 0.01|gnutella-gnutella2 <br /> **** - Gnutella and Gnutella2 served <br /> Host Output <br /> * Just like specification 2, but with more fields supported for host output. <br /> ** H|ip:port|age in cache|clustering|leaves|4 letter vendor code|reported uptime of host|max. leaves possible <br /> *** The host, age, and clustering fields are all still the same as in specification 2. <br /> *** The leaf count of the hub reported is in the 5th field. <br /> *** The vendor code with version number is in the 6th field. <br /> Request Control Variables: <br /> * getleaves <br /> ** Used to obtain leaf counts of hubs given <br /> ** 4th field ultilized for current leaf count. <br /> ** 7th field ultilized for maximum leaf slots possible. <br /> ** Use this as 'getleaves=1' or 'getleaves' to enable. <br /> * getclusters <br /> ** Enables/Disables clustering. <br /> ** Use this as 'getclusters=1'. <br /> ** Using 'getclusters' or 'getclusters=0' disables cluster output. <br /> * getvendors <br /> ** Used to obtain the vendor code w/ version number of the hubs given. <br /> ** Found in the 5th field. <br /> ** Use this as 'getvendors=1' or 'getvendors' to enable. <br /> * getuptime <br /> ** Used to obtain the vendor code w/ version number of the hubs given. <br /> ** Value is static, do not change the value given when time passes. <br /> ** Found in the 6th field. <br /> ** Use this as 'getuptime=1' or 'getuptime' to enable. <br /> * spec <br /> ** To force the specification parameter <br /> ** Currently is only supported by Beacon Cache II <br /> * pv <br /> ** Similar to the 'spec' parameter, except that it does not force, instead it simply negotiates the specification. <br /> Special Data Requests <br /> * info <br /> ** Outputs extra details of your cache. <br /> *** Start with the informational response: I| <br /> **** Ex: I|open-source|1 <br /> * support <br /> ** Outputs USEFUL details of your cache. <br /> *** Start with the informational response: I| <br /> **** Ex: I|support|gnutella2 <br /> * getnetworks <br /> ** Outputs the enabled networks in two formats. <br /> *** Start with the informational response: I| <br /> **** For the 'I|nets|' line <br /> ***** The third field contains the supported networks joined by '-'. <br /> **** For the 'I|networks|' line <br /> ***** Interpret the fields from 3 and beyond as individual network names to challenge against. <br /> *** Examples <br /> **** <br /> ***** I|nets|gnutella-gnutella2 <br /> ***** I|networks|gnutella|gnutella2 <br /> Update Extension Variables: <br /> * x_leaves <br /> ** Number of leaves running on a given hub or ultrapeer. <br /> ** '''Value must not be greater than an integer value of 2047.''' <br /> * x_max <br /> ** Maximum number of leaves possible on a given hub or ultrapeer. <br /> ** '''Value must not be greater than an integer value of 2047.''' <br /> * uptime <br /> ** Value submitted must be an integer value of the number of seconds of uptime. <br /> ** '''Value must not be greater than an integer value of 1 year (31536000) and less than 1 hour (60).''' <br /> <br /> === Pinging Caches With Your Cache ===<br /> '''Please follow this standard:''' <br /> * '''Client: TEST''' <br /> * '''Version: Your Cache's Name''' <br /> ** The old value for &quot;version&quot; was 1 <br /> '''Some variables to attach to the ping (compatibility):''' <br /> * '''multi''' <br /> ** Used by some gwcs in their pings to other gwcs. <br /> ** &lt;nowiki&gt;It tells the pinged cache to ignore the &quot;net&quot; parameter (so it should never say network not supported) and outputting the pong using this format, if possible, &quot;I|pong|[cache name] [cache version]|[supported networks list]&quot; - example: I|pong|Skulls 0.2.9|gnutella-gnutella2 &lt;/nowiki&gt;<br /> ** Used by Skulls GWC only, supported by Skulls and Beacon Cache II. <br /> * '''cache''' <br /> ** This is added to every request made by some gwcs, it is for statistical purposes only. <br /> ** It simply tells the remote cache that the client is a GWC. <br /> '''Help''' <br /> * For PHP <br /> ** Use the fsockopen() function to open a connection to a cache. <br /> *** Make sure you &quot;write&quot; to the fsockopen carry value to open the GWC's target file. <br /> **** [http://us.php.net/manual/en/function.fsockopen.php http://us.php.net/manual/en/function.fsockopen.php] <br /> <br /> === Variable Combination Standards ===<br /> '''Net variable decides specification!''' <br /> * There are many ways to determine spec., but going with net is the safe way. <br /> * Skulls GWC does not use the network parameter to determine specification level. <br /> * Beacon Cache (I and II) uses the network parameter to determine the specification level. <br /> '''Your cache needs to be able to process certain combinations of variables.''' <br /> * Update variable <br /> ** Update should not fail if absent if spec. 2. <br /> *** A Specification 2 parameter. <br /> Spec 1 parameters used in Spec 2: <br /> * Should still accept hostfile and urlfile responses for spec. 2. <br /> ** Beacon Cache (I and II) accepts these parameters on spec 2. <br /> The 'spec' paameter can be used to force a specification: <br /> * Only known to exist in Beacon Cache II, it can force the request to be handled as a specification 1 or 2 request. <br /> * Spec 1 = 'spec=1' <br /> * Spec 2 = 'spec=2' <br /> * If 'spec' is not equal to any current spec, then default to the predetermined spec. <br /> '''Multiple variable requests''' <br /> * If for instance a ping and request exist, you should always handle them properly. <br /> ** Same goes with other combos like an update and ping, statfile + ping and info. <br /> * Handle multiple variables as BEST as possible! <br /> ** Some scanners and GWCs like to fit all their requests into one URL send. <br /> <br /> === Further Information: ===<br /> * [http://www.gnucleus.com/gwebcache/ Original GWC] [http://www.gnucleus.com/gwebcache/ site] <br /> ** [http://gnucleus.sourceforge.net/gwebcache/specs.html GWC Spec. 1] <br /> ** [http://gnucleus.sourceforge.net/gwebcache/newgwc.html GWC Spec. 2] <br /> <br /> === Gnutella Web Cache ===<br /> Gnutella requires Gnutella Web Caches (GWC) to get IPs to establish a connection to the network. These are critical to ensuring the health of the network. If you have a dedicated server and can spare some extra bandwidth then please consider running a GWC. People that don't have a dedicated server or are on normal broadband consumer lines should not run a cache from home.<br /> <br /> A GWC is a simple script that can be put on any webserver that supports one of the following scripting languages:<br /> *JSP (Java Servlet)<br /> **[http://web.archive.org/web/20061108091447/http://www.mager.org/GWebCache/ Java Servlet GWebCache Application (Archive.org)]<br /> *C<br /> **[http://ghostwhitecrab.com/crab/ GhostWhiteCrab]<br /> *Perl <br /> **[http://www.jonatkins.com/perlgcache/ Jon Atkins' perlgcache] <br /> **The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache]<br /> *PHP <br /> **[http://gwcii.sourceforge.net/ PHPGnuCacheII] - MySQL<br /> **[http://www.bazookanetworks.com Bazooka G2WC] (recommended) - flat files<br /> **[http://sourceforge.net/projects/skulls/ Skulls! Multi-Network WebCache] - flat files<br /> ====Further Information:====<br /> *[http://www.gnucleus.com/gwebcache/|Original GWC site]<br /> <br /> <br /> {{RecoveredPage|--&gt;Saved in timestamp 20090421202728Retrieved from &quot;[https://www.pantheraproject.net/wiki/index.php?title=GWC This page was last modified on April 18, 2009, at 23:25. &lt;/center&gt;<br /> <br /> &lt;center&gt;Copyright © 2002-2009 Shareaza Development Team. &lt;/center&gt;&lt;center&gt;[[Image:poweredby_mediawiki_88x31.png]] --[[User:Ocexyz|Ocexyz]] 16:20, 27 July 2009 (UTC)}}<br /> <br /> {{RecoveredPage|Warninig: here ends pasted better formatted recovery. Row recovery has been mooved below as I don't know if anybody has made any changes in it. If not then row recovery can be deleted I suppose. Paste starts from == Shareaza Specific Details == and ends at second == Shareaza Specific Details ==, here. I hope it is visible. --[[User:Ocexyz|Ocexyz]] 16:20, 27 July 2009 (UTC) }}<br /> <br /> ==Shareaza Specific Details==<br /> <br /> {{RecoveredPage|Warninig: here ends pasted better formatted recovery. Row recovery has been mooved below as I don't know if anybody has made any changes in it. If not then row recovery can be deleted I suppose. Paste starts from &gt;&gt;Shareaza Specific Details&lt;&lt; and ends at second &gt;&gt; Shareaza Specific Details&lt;&lt;, here. I hope it is visible. --[[User:Ocexyz|Ocexyz]] 23:27, 27 July 2009 (UTC) }}<br /> <br /> * Get String Breakdown:<br /> o Update a leaf<br /> + &quot;?update=1&amp;ip=(ip):(port)&amp;x_leaves=(leaf count) <br /> o Ping Variable<br /> + Appends &amp;ping=1 to identify the cache name in debug messages (for gnutella and gnutella2 in 2.4.0.0, but only for gnutella2 now in 2.4.0.X for spec1 cache compatibility).<br /> + This feature new to Shareaza. <br /> o Network Variable<br /> + Appends &amp;net=gnutella2 on Gnutella2 queries.<br /> + Does NOT append a network variable on Gnutella(1) queries. <br /> o Client Name / Version Format (2.4.0.0 and earlier):<br /> + &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )<br /> + &amp;version=(Shareaza's version) <br /> o Client Name / Version Format (2.4.0.X):<br /> + If Gnutella<br /> # &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )<br /> # &amp;version=(Shareaza's version) <br /> + If Gnutella2<br /> # &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )+(Shareaza's version) <br /> <br /> <br /> <br /> * GWC Response Matching:<br /> o i|<br /> + Informational output alone will not be taken as GWC 'success.' <br /> o i|access|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to make a request to the cache. <br /> o i|update|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to update to the cache. <br /> o i|force|remove and i|update|warning|bad url<br /> + Remove the GWC from the internal list. <br /> o Some Response Matches (added in 2.3.1.X)<br /> + i|NO-URL-NO-HOSTS<br /> # Outputs warning of the cache being totally empty to the system log. <br /> + i|NO-URL<br /> # Outputs warning of the cache having no alternative URLs to the system log. <br /> + i|NO-HOSTS<br /> # Outputs warning of the cache having no hosts to the system log. <br /> + i|warning|<br /> # Outputs warning of the cache to the system log. <br /> + ERROR Something Failed<br /> # Outputs warning of the cache to the system log(Buggy Bazooka GWCs workaround). <br /> + i|warning|You came back too early (2.3.1.X)<br /> + i|warning|client|early (2.3.1.X)<br /> + WARNING: You came back too early (2.3.1.X)<br /> + ERROR: Client returned too early (2.3.1.X)<br /> # Flood detection for the update side.<br /> # Outputs GWebCache(update) Too many connection attempts to the system log. <br /> + too early (2.3.1.X)<br /> + early (2.4.0.X)<br /> # Flood detection for the request side.<br /> # Outputs GWebCache URL: Too many connection attempts to the system log. <br /> + i|update|OK<br /> # Outputs &quot;GWebCache(v2) Update Passed: &quot; to the system log. <br /> + OK<br /> # Outputs &quot;GWebCache(v1) Update Passed: &quot; to the system log. <br /> <br /> <br /> <br /> * GWC Response Matching:<br /> o i|<br /> + Informational output alone will not be taken as GWC 'success.' <br /> o i|access|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to make a request to the cache. <br /> o i|update|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to update to the cache. <br /> o i|force|remove and i|update|warning|bad url<br /> + Remove the GWC from the internal list. <br /> o Some Response Matches (added in 2.3.1.X)<br /> + i|NO-URL-NO-HOSTS<br /> # Outputs warning of the cache being totally empty to the system log. <br /> + i|NO-URL<br /> # Outputs warning of the cache having no alternative URLs to the system log. <br /> + i|NO-HOSTS<br /> # Outputs warning of the cache having no hosts to the system log. <br /> + i|warning|<br /> # Outputs warning of the cache to the system log. <br /> + ERROR Something Failed<br /> # Outputs warning of the cache to the system log(Buggy Bazooka GWCs workaround). <br /> + i|warning|You came back too early (2.3.1.X)<br /> + i|warning|client|early (2.3.1.X)<br /> + WARNING: You came back too early (2.3.1.X)<br /> + ERROR: Client returned too early (2.3.1.X)<br /> # Flood detection for the update side.<br /> # Outputs GWebCache(update) Too many connection attempts to the system log. <br /> + too early (2.3.1.X)<br /> + early (2.4.0.X)<br /> # Flood detection for the request side.<br /> # Outputs GWebCache URL: Too many connection attempts to the system log. <br /> + i|update|OK<br /> # Outputs &quot;GWebCache(v2) Update Passed: &quot; to the system log. <br /> + OK<br /> # Outputs &quot;GWebCache(v1) Update Passed: &quot; to the system log. <br /> <br /> <br /> <br /> ==Gnutella Web Cache Specifications==<br /> &lt;end of partial recovery by OCE&gt;<br /> <br /> <br /> <br /> <br /> &lt;end of recovered content&gt;<br /> <br /> &lt;row recovery, start&gt; <br /> Specification 1:<br /> <br /> * Networks Served<br /> o Gnutella <br /> * Format<br /> o Update went fine:<br /> + Ex: OK <br /> o Update Warning (Small prob., not that bad):<br /> + Ex: <br /> <br /> OK<br /> WARNING: Error Message<br /> <br /> * Severe Warning (No 'OK' message sent)<br /> o Ex: <br /> <br /> WARNING: Error Message<br /> <br /> * URL Output:<br /> o Ex: http://somefreakinrandomcache.com/cache/gcache.php<br /> + OR - WITH A PORT NUMBER (If not 80)<br /> # Ex: http://somefreakinrandomcache.com:8080/cache/gcache.php <br /> * Host Output:<br /> o Ex: 66.132.55.12:6346 <br /> * Pong (ping variable response) - was explained below under the topic: variables.<br /> * Example Cache Output (Beacon Cache) For urlfile Command<br /> o Example &quot;urlfile Output&quot; URL: Ex: http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;urlfile=1<br /> + Example URL Output: <br /> <br /> <br /> Getting urls with a pong combined<br /> <br /> PONG Beacon Cache 0.1.5D Beta<br /> http://gwc.frodoslair.net/skulls/skulls.php<br /> http://bbs.robertwoolley.co.uk/GWebCache/gcache.php<br /> http://g2.tjtech.org/g2/<br /> http://g2.tjtech.org/g2/index.php<br /> http://gwc.monnsta.net/<br /> http://holograph.uni.cc/other/skulls.php<br /> http://gwc.nickstallman.net/<br /> http://gwc.eod.cc/skulls.php<br /> http://gwc.frodoslair.net/skulls/skulls<br /> http://gwc.werwin.net/skulls.php<br /> <br /> <br /> * Example Cache Output (Beacon Cache) For hostfile Command<br /> o Example &quot;hostfile Output&quot; URL: Ex: http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;hostfile=1<br /> + Example Host Output: <br /> <br /> <br /> Getting the hosts with a pong combined<br /> <br /> PONG Beacon Cache 0.1.5D Beta<br /> 71.8.84.153:3915<br /> 99.248.214.157:27529<br /> 69.60.241.55:16369<br /> 193.253.239.246:30218<br /> 68.156.175.121:6348<br /> 71.179.7.241:18344<br /> 74.196.22.241:6348<br /> 12.210.197.194:10531<br /> 222.150.143.77:10000<br /> 58.85.231.135:6346<br /> 24.141.199.164:20205<br /> 72.175.201.195:6348<br /> 69.81.129.228:4880<br /> 97.81.221.63:13219<br /> 70.15.130.224:7759<br /> 216.211.188.106:51903<br /> 75.167.168.156:48660<br /> 12.214.14.3:35916<br /> 76.177.244.106:24180<br /> 98.165.218.139:39630<br /> 68.112.182.125:3685<br /> 68.117.204.57:23482<br /> 65.12.154.25:40760<br /> 69.180.47.169:5711<br /> 75.138.40.173:24987<br /> 98.201.19.0:33662<br /> 70.187.2.144:6348<br /> 68.186.209.107:14429<br /> 69.159.7.61:6348<br /> 76.208.176.196:48199<br /> <br /> <br /> * For combining a hostfile and urlfile request:<br /> o Warning: This is non-standard.<br /> o Example Cache Output (Beacon Cache) For bfile Command<br /> + Example &quot;bfile Output&quot; URL: Ex: http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;bfile=1<br /> # Example Host and URL Output: <br /> <br /> <br /> Getting the hosts and urls with a pong combined<br /> <br /> PONG Beacon Cache 0.1.5D Beta<br /> 71.8.84.153:3915<br /> 99.248.214.157:27529<br /> 69.60.241.55:16369<br /> 193.253.239.246:30218<br /> 68.156.175.121:6348<br /> 71.179.7.241:18344<br /> 74.196.22.241:6348<br /> 12.210.197.194:10531<br /> 222.150.143.77:10000<br /> 58.85.231.135:6346<br /> 24.141.199.164:20205<br /> 72.175.201.195:6348<br /> 69.81.129.228:4880<br /> 97.81.221.63:13219<br /> 70.15.130.224:7759<br /> 216.211.188.106:51903<br /> 75.167.168.156:48660<br /> 12.214.14.3:35916<br /> 76.177.244.106:24180<br /> 98.165.218.139:39630<br /> 68.112.182.125:3685<br /> 68.117.204.57:23482<br /> 65.12.154.25:40760<br /> 69.180.47.169:5711<br /> 75.138.40.173:24987<br /> 98.201.19.0:33662<br /> 70.187.2.144:6348<br /> 68.186.209.107:14429<br /> 69.159.7.61:6348<br /> 76.208.176.196:48199<br /> http://gwc.frodoslair.net/skulls/skulls.php<br /> http://bbs.robertwoolley.co.uk/GWebCache/gcache.php<br /> http://g2.tjtech.org/g2/<br /> http://g2.tjtech.org/g2/index.php<br /> http://gwc.monnsta.net/<br /> http://holograph.uni.cc/other/skulls.php<br /> http://gwc.nickstallman.net/<br /> http://gwc.eod.cc/skulls.php<br /> http://gwc.frodoslair.net/skulls/skulls<br /> http://gwc.werwin.net/skulls.php<br /> <br /> <br /> * Variables<br /> o Mandatory<br /> + ping:<br /> # Response should have this always: PONG<br /> # After, put the cache's name. ex: PONG fakecache 0.01<br /> + client:<br /> # Four letter code of the client. ex: RAZA <br /> + version:<br /> # Version number of the client. <br /> + urlfile:<br /> # Used by the client to request alternate cache urls. <br /> + hostfile:<br /> # Used by the client to request IPs with port numbers attached. <br /> + url:<br /> # Client update giving an alternate cache URL.<br /> # Formatted with a http:// prefix to each cache. <br /> + ip:<br /> # Client update giving one's IP to submit. <br /> + url1:<br /> # OLD OUTDATED Client update giving an alternate cache URL.<br /> # Formatted with a http:// prefix to each cache. <br /> + ip1:<br /> # OLD OUTDATED Client update giving one's IP to submit. <br /> o Optional<br /> + bfile:<br /> # For clients to request both URLs and IPs from the cache at the same time. <br /> + statfile:<br /> # Statistics of the cache request:<br /> * First line: Total requests of the cache number.<br /> * Second line: Requests of the cache an hour number.<br /> * Third line: Updates of the cache an hour number. <br /> <br /> Specification 2:<br /> <br /> * Networks Served<br /> o Gnutella, Gnutella2, etc. <br /> * Format<br /> o Information Output<br /> + Starts with: I|<br /> # Categories<br /> * Pong (ping variable response) - Described below under the topic: variables.<br /> * Update Status Response<br /> o Format: I|update<br /> o Responses<br /> + I|update|OK<br /> # - Everything went fine. <br /> + I|update|OK|WARNING<br /> # Small warning. <br /> + I|update|WARNING<br /> # Severe warning <br /> * Plain Warnings<br /> o Format: I|WARNING<br /> + Append any warning messages after it - Ex: I|WARNING|You came back too early <br /> * Extra Info - Described below under the topic: variables. <br /> o Host Output<br /> + Starts with: H|<br /> + Add the IP with its port:<br /> # Ex: H|0.0.0.0:6346 <br /> + Add the time, thereafter, of the host's (In seconds*) time in cache:<br /> # Ex: H|0.0.0.0:6346|45 <br /> + If cluster exists with cluster=somerandomwords<br /> # Add the clustered words after the host's age:<br /> * Ex: H|0.0.0.0:6346|45|somerandomwords <br /> o URL Output<br /> + Starts with: U|<br /> + Add the URL with http:// before it, plus the port (if it's not 80).<br /> # Ex: U|http://somerandomcache.com/ <br /> + Add the time, thereafter, of the URL's time (In seconds*) in cache:<br /> # Ex: U|http://somerandomcache.com/|45 <br /> o Example Cache Output (Beacon Cache) For get Command<br /> + Example URL: http://grantgalitz.com/Beacon/gwc.php?get=1&amp;client=RAZA&amp;version=2.3.1.3&amp;net=gnutella2&amp;ping=1<br /> # Example &quot;Get&quot; Output: <br /> <br /> <br /> Getting the hosts and urls with a pong combined<br /> <br /> I|pong|Beacon Cache 0.1.5D Beta|gnutella-gnutella2<br /> H|65.9.200.243:4968|248261<br /> H|68.228.129.75:44599|242678<br /> H|98.240.196.122:8206|240719<br /> H|76.104.12.133:14921|218273<br /> H|69.136.1.12:3924|211610<br /> H|81.154.208.71:8595|174402<br /> H|97.96.105.51:2076|153610<br /> H|74.192.153.212:39340|144203<br /> H|72.190.106.57:12584|132984<br /> H|78.93.71.132:12334|125668<br /> H|82.43.248.184:27560|97974<br /> H|196.205.224.97:6357|86763<br /> H|74.129.219.30:33172|82005<br /> H|76.104.12.133:19185|57182<br /> H|69.59.83.131:18442|38628<br /> U|http://www.k33bz.com/g2/bazooka.php|248639<br /> U|http://gwebcache.ns1.net/|248592<br /> U|http://gwc2.wodi.org/skulls.php|248384<br /> U|http://gwc.guufshop.com/skulls/skulls.php|248322<br /> U|http://groovy.syxy.com/up/skulls.php|248300<br /> U|http://g2.tjtech.org/g2/index.php|247770<br /> U|http://midian.jayl.de/g2/bazooka.php|240719<br /> U|http://www.dom2porno.info/skulls/skulls.php|207473<br /> U|http://gwc.frodoslair.net/skulls/skulls|125668<br /> U|http://holograph.uni.cc/other/skulls.php|9642<br /> <br /> <br /> * Variables<br /> o Mandatory<br /> + ping:<br /> # Main Part: I|pong|<br /> # Then add the cache name and version: I|pong|fakecache 0.01<br /> # Then lastly add the network support:<br /> * I|pong|fakecache 0.01|gnutella<br /> o - Gnutella only <br /> * I|pong|fakecache 0.01|gnutella2<br /> o - Gnutella2 only <br /> * I|pong|fakecache 0.01|gnutella-gnutella2<br /> o - Gnutella and Gnutella2 served <br /> + get:<br /> # Used by clients to requests alternate cache URLs along with IPs and their port numbers. <br /> + update:<br /> # url:<br /> * Client update giving an alternate cache URL.<br /> * Formatted with a http:// prefix to each cache. <br /> # ip:<br /> * Client update giving one's IP to submit. <br /> + net:<br /> # Which network to serve the client.<br /> * Gnutella<br /> o Ex: net=gnutella <br /> * Gnutella2<br /> o Ex: net=gnutella2 <br /> * Should always be lowercase<br /> o GWCs should automatically convert network name given to lowercase to prevent Net ID mismatches <br /> <br /> solely on case alone.<br /> <br /> *<br /> o<br /> + client:<br /> # Four letter code of the client. ex: RAZA <br /> + version:<br /> # Version number of the client. <br /> o Optional<br /> + cluster:<br /> # To add extra info to an IP update.<br /> * Output by cache: H|0.0.0.0|AGE OF HOST (Seconds)|clustering some bull**** <br /> + statfile:<br /> # Exactly like the specification 1 statfile (Same routine and output style).<br /> # Statistics of the cache request:<br /> * First line: Total requests of the cache number.<br /> * Second line: Requests of the cache an hour number.<br /> * Third line: Updates of the cache an hour number. <br /> <br /> Specification 2.1<br /> <br /> * This is an extension of specification 2, not a separate specification!<br /> * Pong extension<br /> o Append the networks supported joined by a hyphen '-'.<br /> o Used for client-side validation of networks supported and for network support reporting to other web caches.<br /> o Format:<br /> + I|pong|cache name|network names joined by '-'<br /> + Format Examples:<br /> # I|pong|fakecache 0.01|gnutella<br /> * - Gnutella only <br /> # I|pong|fakecache 0.01|gnutella2<br /> * - Gnutella2 only <br /> # I|pong|fakecache 0.01|gnutella-gnutella2<br /> * - Gnutella and Gnutella2 served <br /> * Host Output<br /> o Just like specification 2, but with more fields supported for host output.<br /> + H|ip:port|age in cache|clustering|leaves|4 letter vendor code|reported uptime of host|max. leaves possible<br /> # The host, age, and clustering fields are all still the same as in specification 2.<br /> # The leaf count of the hub reported is in the 5th field.<br /> # The vendor code with version number is in the 6th field. <br /> * Request Control Variables:<br /> o getleaves<br /> + Used to obtain leaf counts of hubs given<br /> + 4th field ultilized for current leaf count.<br /> + 7th field ultilized for maximum leaf slots possible.<br /> + Use this as 'getleaves=1' or 'getleaves' to enable. <br /> o getclusters<br /> + Enables/Disables clustering.<br /> + Use this as 'getclusters=1'.<br /> + Using 'getclusters' or 'getclusters=0' disables cluster output. <br /> o getvendors<br /> + Used to obtain the vendor code w/ version number of the hubs given.<br /> + Found in the 5th field.<br /> + Use this as 'getvendors=1' or 'getvendors' to enable. <br /> o getuptime<br /> + Used to obtain the vendor code w/ version number of the hubs given.<br /> + Value is static, do not change the value given when time passes.<br /> + Found in the 6th field.<br /> + Use this as 'getuptime=1' or 'getuptime' to enable. <br /> o spec<br /> + To force the specification parameter<br /> + Currently is only supported by Beacon Cache II <br /> o pv<br /> + Similar to the 'spec' parameter, except that it does not force, instead it simply negotiates the specification. <br /> * Special Data Requests<br /> o info<br /> + Outputs extra details of your cache.<br /> # Start with the informational response: I|<br /> * Ex: I|open-source|1 <br /> o support<br /> + Outputs USEFUL details of your cache.<br /> # Start with the informational response: I|<br /> * Ex: I|support|gnutella2 <br /> o getnetworks<br /> + Outputs the enabled networks in two formats.<br /> # Start with the informational response: I|<br /> * For the 'I|nets|' line<br /> o The third field contains the supported networks joined by '-'. <br /> * For the 'I|networks|' line<br /> o Interpret the fields from 3 and beyond as individual network names to challenge against. <br /> # Examples<br /> *<br /> o I|nets|gnutella-gnutella2<br /> o I|networks|gnutella|gnutella2 <br /> * Update Extension Variables:<br /> o x_leaves<br /> + Number of leaves running on a given hub or ultrapeer.<br /> + Value must not be greater than an integer value of 2047. <br /> o x_max<br /> + Maximum number of leaves possible on a given hub or ultrapeer.<br /> + Value must not be greater than an integer value of 2047. <br /> o uptime<br /> + Value submitted must be an integer value of the number of seconds of uptime.<br /> + Value must not be greater than an integer value of 1 year (31536000) and less than 1 hour (60). <br /> <br /> Pinging Caches With Your Cache<br /> <br /> * Please follow this standard:<br /> o Client: TEST<br /> o Version: Your Cache's Name<br /> + The old value for &quot;version&quot; was 1 <br /> * Some variables to attach to the ping (compatibility):<br /> o multi<br /> + Used by some gwcs in their pings to other gwcs.<br /> + It tells the pinged cache to ignore the &quot;net&quot; parameter (so it should never say network not supported) and outputting the pong using this format, if possible, &quot;I|pong|[cache name] [cache version]|[supported networks list]|[url adding is enabled]&quot; - example: I|pong|Skulls 0.2.8a|gnutella-gnutella2|1<br /> + Used by Skulls GWC only. <br /> o cache<br /> + This is added to every request made by some gwcs, it is for statistical purposes only.<br /> + It simply tells the remote cache that the client is a GWC. <br /> * Help<br /> o For PHP<br /> + Use the fsockopen() function to open a connection to a cache.<br /> # Make sure you &quot;write&quot; to the fsockopen carry value to open the GWC's target file.<br /> * http://us.php.net/manual/en/function.fsockopen.php <br /> <br /> Variable Combination Standards<br /> <br /> * Net variable decides specification!<br /> o There are many ways to determine spec., but going with net is the safe way.<br /> o Skulls GWC does not use the network parameter to determine specification level.<br /> o Beacon Cache (I and II) uses the network parameter to determine the specification level. <br /> * Your cache needs to be able to process certain combinations of variables.<br /> o Update variable<br /> + Update should not fail if absent if spec. 2.<br /> # A Specification 2 parameter. <br /> * Spec 1 parameters used in Spec 2:<br /> o Should still accept hostfile and urlfile responses for spec. 2.<br /> + Beacon Cache (I and II) accepts these parameters on spec 2. <br /> * The 'spec' paameter can be used to force a specification:<br /> o Only known to exist in Beacon Cache II, it can force the request to be handled as a specification 1 or 2 request.<br /> o Spec 1 = 'spec=1'<br /> o Spec 2 = 'spec=2'<br /> o If 'spec' is not equal to any current spec, then default to the predetermined spec. <br /> * Multiple variable requests<br /> o If for instance a ping and request exist, you should always handle them properly.<br /> + Same goes with other combos like an update and ping, statfile + ping and info. <br /> o Handle multiple variables as BEST as possible!<br /> + Some scanners and GWCs like to fit all their requests into one URL send. <br /> <br /> &lt;row recovery, end&gt; <br /> <br /> Further Information:<br /> <br /> * [http://www.gnucleus.com/gwebcache/ Original GWC site]<br /> ** [http://gnucleus.sourceforge.net/gwebcache/specs.html GWC Spec. 1]<br /> ** [http://gnucleus.sourceforge.net/gwebcache/newgwc.html GWC Spec. 2] <br /> <br /> <br /> <br /> <br /> <br /> &lt;content recovered from last aviable backup&gt; <br /> <br /> ===Gnutella Web Cache===<br /> Gnutella requires Gnutella Web Caches (GWC) to get IPs to establish a connection to the network. These are critical to ensuring the health of the network. If you have a dedicated server and can spare some extra bandwidth then please consider running a GWC. People that don't have a dedicated server or are on normal broadband consumer lines should not run a cache from home.<br /> <br /> A GWC is a simple script that can be put on any webserver that supports one of the following scripting languages:<br /> *JSP (Java Servlet)<br /> **[http://web.archive.org/web/20061108091447/http://www.mager.org/GWebCache/ Java Servlet GWebCache Application (Archive.org)]<br /> *C<br /> **[http://ghostwhitecrab.com/crab/ GhostWhiteCrab]<br /> *Perl <br /> **[http://www.jonatkins.com/perlgcache/ Jon Atkins' perlgcache] <br /> **The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache]<br /> *PHP <br /> **[http://gwcii.sourceforge.net/ PHPGnuCacheII] - MySQL<br /> **[http://www.bazookanetworks.com Bazooka G2WC] (recommended) - flat files<br /> **[http://sourceforge.net/projects/skulls/ Skulls! Multi-Network WebCache] - flat files<br /> === Further Information: ===<br /> * [http://www.gnucleus.com/gwebcache/ Original GWC site]<br /> <br /> [[Category:External Links]]</div>

Ale5000 https://shareaza.sourceforge.net/w/index.php?title=Talk:GWC_specs&diff=11503 2015-03-25T12:26:18Z

<p>Ale5000: Sorry, wrong place</p> <hr /> <div></div>

Ale5000 https://shareaza.sourceforge.net/w/index.php?title=GWC_specs&diff=11502 2015-03-25T12:25:38Z

<p>Ale5000: Updated multi=1 details</p> <hr /> <div>''For general information on GWCs, have a look at the [[GWC]] Wiki page.''<br /> {{do not translate}}<br /> This page is thought to give an overview over the GWC specifications as they are implemented into Shareaza.<br /> <br /> A GWC is a simple script that can be put on any webserver that supports one of the following scripting languages: <br /> <br /> * JSP (Java Servlet) <br /> ** [http://www1.mager.org/GWebCache/ Jums Web Cache] (Excellent for heavy loads) <br /> * C <br /> ** [http://wiki.limewire.org/index.php?title=GhostWhiteCrab GhostWhiteCrab] (For dedicated server environments and people who know how to compile C source code!) <br /> * ASP <br /> ** [http://www.edazzle.net/downloads/gerry.zip Gerry GWC] <br /> ** [https://www.planet-source-code.com/vb/scripts/ShowCode.asp?txtCodeId=7846&amp;lngWId=4 Lynn (v.s. 0.5)] <br /> ** [https://www.planet-source-code.com/vb/scripts/ShowCode.asp?txtCodeId=7731&amp;lngWId=4 Lynn (v.s. 0.4)] <br /> ** [http://www.poundwebhosting.com/cgi-bin/lynnx.asp LynnX] <br /> * Perl <br /> ** [http://www.jonatkins.com/perlgcache/ Jon Atkins' perlgcache] <br /> ** The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache] <br /> '''PHP''' ''(Tip: PHP GWCs are usually the easiest to run and setup on a server.)''<br /> ** [http://gwcii.sourceforge.net/ PHPGnuCacheII] <br /> ** [http://www.bazookanetworks.com/ Bazooka G2WC] <br /> * The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache] ''(PHP version is no longer supported)'' <br /> ** [http://sourceforge.net/projects/skulls/ Skulls! Multi-Network WebCache] <br /> ** [http://sourceforge.net/projects/beaconcache/ Beacon Cache] <br /> ** [http://code.google.com/p/cachechu/ Cachechu G2WC] <br /> <br /> == Breakdown Of The Gnutella Web Caches: == <br /> {{RecoveredPage|I recently put this into a table. The contents need to be verified -- [[User:Cyko 01|Cyko 01]]}}<br /> <br /> {| width= auto; style=&quot;font-size: 85%; text-align: center;text-valign: middle;&quot; class=&quot;wikitable&quot;<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Cache:<br /> ! rowspan=1 |Gnutella:<br /> ! rowspan=1 |Gnutella2:<br /> ! rowspan=1 |Spec 1:<br /> ! rowspan=1 |Spec 2:<br /> ! rowspan=1 |Flat-File:<br /> ! rowspan=1 |SQL:<br /> ! rowspan=1 |Installer:<br /> ! rowspan=1 |Other Networks:<br /> ! rowspan=1 |Different network instances:<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Beacon Cache (Core 2)<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> |style=&quot;background: #CCFFCC;&quot;| Yes (As of 0.2.0 Alpha)<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Beacon Cache (Core 1)<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Skulls<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|JumsWebCache<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|GnuWebCache (Perl)<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|GnuWebCache (PHP) <br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|GhostWhiteCrab(GWC) <br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> |style=&quot;background: #FFFFCC;&quot;| N/A<br /> |style=&quot;background: #FFFFCC;&quot;| N/A<br /> |style=&quot;background: #FFFFCC;&quot;| N/A<br /> | {{yes}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|PHPGnuCacheII <br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Bazooka <br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Cachechu<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Perlgcache<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Gerry GWC (v2)<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Gerry GWC (v1)<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|Lynn<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |-<br /> ! colspan=2 style=&quot;background: #CCCCCC;&quot;|LynnX<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{yes}}<br /> | {{yes}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> | {{no}}<br /> |}<br /> <br /> == Shareaza Specific Details == <br /> <br /> {{RecoveredPage|Warninig: here I have pasted better formatted recovery, but not verified. Row recovery has been mooved below as I don't know if anybody has made any changes in it. If not then row recovery can be deleted. Paste starts from &gt;&gt;Shareaza Specific Details&lt;&lt;, here, and ends at second &gt;&gt;Shareaza Specific Details&lt;&lt; I hope it is visible. --[[User:Ocexyz|Ocexyz]] 23:27, 27 July 2009 (UTC)}}<br /> <br /> '''Get String Breakdown:''' <br /> * Update a leaf <br /> ** &quot;?update=1&amp;ip=(ip):(port)&amp;x_leaves=(leaf count) <br /> * Ping Variable <br /> ** Appends &amp;ping=1 to identify the cache name in debug messages (for gnutella and gnutella2 in 2.4.0.0, but only for gnutella2 now in 2.4.0.X for spec1 cache compatibility). <br /> ** This feature new to Shareaza. <br /> * Network Variable <br /> ** Appends &amp;net=gnutella2 on Gnutella2 queries. <br /> ** Does NOT append a network variable on Gnutella(1) queries. <br /> * Client Name / Version Format (2.4.0.0 and earlier): <br /> ** &amp;client=(Shareaza 4 letter code (RAZA / RAZB) ) <br /> ** &amp;version=(Shareaza's version) <br /> * Client Name / Version Format (2.4.0.X): <br /> ** If Gnutella <br /> *** &amp;client=(Shareaza 4 letter code (RAZA / RAZB) ) <br /> *** &amp;version=(Shareaza's version) <br /> ** If Gnutella2 <br /> *** &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )+(Shareaza's version) <br /> <br /> '''GWC Response Matching:''' <br /> * i| <br /> ** Informational output alone will not be taken as GWC 'success.' <br /> * i|access|period|(time in sec.) <br /> ** Time in seconds before Shareaza is allowed to make a request to the cache. <br /> * i|update|period|(time in sec.) <br /> ** Time in seconds before Shareaza is allowed to update to the cache. <br /> * i|force|remove and i|update|warning|bad url <br /> ** Remove the GWC from the internal list. <br /> * Some Response Matches (added in 2.3.1.X) <br /> ** i|NO-URL-NO-HOSTS <br /> *** Outputs warning of the cache being totally empty to the system log. <br /> ** i|NO-URL <br /> *** Outputs warning of the cache having no alternative URLs to the system log. <br /> ** i|NO-HOSTS <br /> *** Outputs warning of the cache having no hosts to the system log. <br /> ** i|warning| <br /> *** Outputs warning of the cache to the system log. <br /> ** ERROR Something Failed <br /> *** Outputs warning of the cache to the system log(Buggy Bazooka GWCs workaround). <br /> ** i|warning|You came back too early (2.3.1.X) <br /> ** i|warning|client|early (2.3.1.X) <br /> ** WARNING: You came back too early (2.3.1.X) <br /> ** ERROR: Client returned too early (2.3.1.X) <br /> *** Flood detection for the update side. <br /> *** Outputs GWebCache(update) Too many connection attempts to the system log. <br /> ** too early (2.3.1.X) <br /> ** early (2.4.0.X) <br /> *** Flood detection for the request side. <br /> *** Outputs GWebCache URL: Too many connection attempts to the system log. <br /> ** i|update|OK <br /> *** Outputs &quot;GWebCache(v2) Update Passed: &quot; to the system log. <br /> ** OK <br /> *** Outputs &quot;GWebCache(v1) Update Passed: &quot; to the system log. <br /> <br /> == Gnutella Web Cache Specifications ==<br /> ==== Specification 1: ====<br /> * '''Networks Served''' <br /> ** Gnutella <br /> * '''Format''' <br /> ** Update went fine: <br /> *** Ex: OK <br /> ** Update Warning (Small prob., not that bad): <br /> *** Ex: OKWARNING: Error Message <br /> <br /> * Severe Warning (No 'OK' message sent) <br /> ** Ex: WARNING: Error Message<br /> <br /> * URL Output: <br /> ** Ex: [http://somefreakinrandomcache.com/cache/gcache.php http://somefreakinrandomcache.com/cache/gcache.php] <br /> *** OR - WITH A PORT NUMBER (If not 80) <br /> **** Ex: [http://somefreakinrandomcache.com:8080/cache/gcache.php http://somefreakinrandomcache.com:8080/cache/gcache.php] <br /> * Host Output: <br /> ** Ex: 66.132.55.12:6346 <br /> * Pong (ping variable response) - was explained below under the topic: variables. <br /> * '''Example Cache Output (Beacon Cache) For urlfile Command''' <br /> ** Example &quot;urlfile Output&quot; URL: Ex: [http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;urlfile=1 http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;urlfile=1] <br /> *** Example URL Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting urls with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | PONG Beacon Cache 0.1.5D Beta[http://gwc.frodoslair.net/skulls/skulls.php http://gwc.frodoslair.net/skulls/skulls.php][http://bbs.robertwoolley.co.uk/GWebCache/gcache.php http://bbs.robertwoolley.co.uk/GWebCache/gcache.php][http://g2.tjtech.org/g2/ http://g2.tjtech.org/g2/][http://g2.tjtech.org/g2/index.php http://g2.tjtech.org/g2/index.php][http://gwc.monnsta.net/ http://gwc.monnsta.net/][http://holograph.uni.cc/other/skulls.php http://holograph.uni.cc/other/skulls.php][http://gwc.nickstallman.net/ http://gwc.nickstallman.net/][http://gwc.eod.cc/skulls.php http://gwc.eod.cc/skulls.php][http://gwc.frodoslair.net/skulls/skulls http://gwc.frodoslair.net/skulls/skulls][http://gwc.werwin.net/skulls.php http://gwc.werwin.net/skulls.php] <br /> <br /> |}<br /> * '''Example Cache Output (Beacon Cache) For hostfile Command''' <br /> ** Example &quot;hostfile Output&quot; URL: Ex: [http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;hostfile=1 http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;hostfile=1] <br /> *** Example Host Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting the hosts with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | PONG Beacon Cache 0.1.5D Beta71.8.84.153:391599.248.214.157:2752969.60.241.55:16369193.253.239.246:3021868.156.175.121:634871.179.7.241:1834474.196.22.241:634812.210.197.194:10531222.150.143.77:1000058.85.231.135:634624.141.199.164:2020572.175.201.195:634869.81.129.228:488097.81.221.63:1321970.15.130.224:7759216.211.188.106:5190375.167.168.156:4866012.214.14.3:3591676.177.244.106:2418098.165.218.139:3963068.112.182.125:368568.117.204.57:2348265.12.154.25:4076069.180.47.169:571175.138.40.173:2498798.201.19.0:3366270.187.2.144:634868.186.209.107:1442969.159.7.61:634876.208.176.196:48199<br /> <br /> |}<br /> * '''For combining a hostfile and urlfile request:''' <br /> ** Warning: This is non-standard. <br /> ** '''Example Cache Output (Beacon Cache) For bfile Command''' <br /> *** Example &quot;bfile Output&quot; URL: Ex: [http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;bfile=1 http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;bfile=1] <br /> **** Example Host and URL Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting the hosts and urls with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | PONG Beacon Cache 0.1.5D Beta71.8.84.153:391599.248.214.157:2752969.60.241.55:16369193.253.239.246:3021868.156.175.121:634871.179.7.241:1834474.196.22.241:634812.210.197.194:10531222.150.143.77:1000058.85.231.135:634624.141.199.164:2020572.175.201.195:634869.81.129.228:488097.81.221.63:1321970.15.130.224:7759216.211.188.106:5190375.167.168.156:4866012.214.14.3:3591676.177.244.106:2418098.165.218.139:3963068.112.182.125:368568.117.204.57:2348265.12.154.25:4076069.180.47.169:571175.138.40.173:2498798.201.19.0:3366270.187.2.144:634868.186.209.107:1442969.159.7.61:634876.208.176.196:48199[http://gwc.frodoslair.net/skulls/skulls.php http://gwc.frodoslair.net/skulls/skulls.php][http://bbs.robertwoolley.co.uk/GWebCache/gcache.php http://bbs.robertwoolley.co.uk/GWebCache/gcache.php][http://g2.tjtech.org/g2/ http://g2.tjtech.org/g2/][http://g2.tjtech.org/g2/index.php http://g2.tjtech.org/g2/index.php][http://gwc.monnsta.net/ http://gwc.monnsta.net/][http://holograph.uni.cc/other/skulls.php http://holograph.uni.cc/other/skulls.php][http://gwc.nickstallman.net/ http://gwc.nickstallman.net/][http://gwc.eod.cc/skulls.php http://gwc.eod.cc/skulls.php][http://gwc.frodoslair.net/skulls/skulls http://gwc.frodoslair.net/skulls/skulls][http://gwc.werwin.net/skulls.php http://gwc.werwin.net/skulls.php] <br /> <br /> |}<br /> '''Variables''' <br /> * '''Mandatory''' <br /> ** ping: <br /> *** Response should have this always: PONG<br /> *** After, put the cache's name. ex: PONG fakecache 0.01<br /> ** client: <br /> *** Four letter code of the client. ex: RAZA <br /> ** version: <br /> *** Version number of the client. <br /> ** urlfile: <br /> *** Used by the client to request alternate cache urls. <br /> ** hostfile: <br /> *** Used by the client to request IPs with port numbers attached. <br /> ** url: <br /> *** Client update giving an alternate cache URL. <br /> *** Formatted with a http:// prefix to each cache. <br /> ** ip: <br /> *** Client update giving one's IP to submit. <br /> ** url1: <br /> *** OLD OUTDATED Client update giving an alternate cache URL. <br /> *** Formatted with a http:// prefix to each cache. <br /> ** ip1: <br /> *** OLD OUTDATED Client update giving one's IP to submit. <br /> * '''Optional''' <br /> ** bfile: <br /> *** For clients to request both URLs and IPs from the cache at the same time. <br /> ** statfile: <br /> *** Statistics of the cache request: <br /> **** First line: Total requests of the cache number. <br /> **** Second line: Requests of the cache an hour number. <br /> **** Third line: Updates of the cache an hour number.<br /> <br /> ==== Specification 2: ====<br /> '''Networks Served''' <br /> * Gnutella, Gnutella2, etc. <br /> '''Format''' <br /> * '''Information Output''' <br /> ** Starts with: I| <br /> *** '''Categories''' <br /> **** '''Pong''' (ping variable response) - Described below under the topic: variables. <br /> **** '''Update Status Response''' <br /> ***** Format: I|update <br /> ***** '''Responses''' <br /> ****** I|update|OK <br /> ******* - Everything went fine. <br /> ****** I|update|OK|WARNING <br /> ******* Small warning. <br /> ****** I|update|WARNING <br /> ******* Severe warning <br /> **** '''Plain Warnings''' <br /> ***** Format: I|WARNING <br /> ****** Append any warning messages after it - Ex: I|WARNING|You came back too early <br /> **** '''Extra Info''' - Described below under the topic: variables. <br /> * '''Host Output''' <br /> ** Starts with: H| <br /> ** Add the IP with its port: <br /> *** Ex: H|0.0.0.0:6346 <br /> ** Add the time, thereafter, of the host's (In seconds*) time in cache: <br /> *** Ex: H|0.0.0.0:6346|45 <br /> ** If cluster exists with cluster=somerandomwords <br /> *** Add the clustered words after the host's age: <br /> **** Ex: H|0.0.0.0:6346|45|somerandomwords <br /> * '''URL Output''' <br /> ** Starts with: U| <br /> ** Add the URL with http:// before it, plus the port (if it's not 80). <br /> *** Ex: U|[http://somerandomcache.com/ http://somerandomcache.com/] <br /> ** Add the time, thereafter, of the URL's time (In seconds*) in cache: <br /> *** Ex: U|[http://somerandomcache.com/%7C45 http://somerandomcache.com/|45] <br /> * '''Example Cache Output (Beacon Cache) For get Command''' <br /> ** Example URL: [http://grantgalitz.com/Beacon/gwc.php?get=1&amp;client=RAZA&amp;version=2.3.1.3&amp;net=gnutella2&amp;ping=1 http://grantgalitz.com/Beacon/gwc.php?get=1&amp;client=RAZA&amp;version=2.3.1.3&amp;net=gnutella2&amp;ping=1] <br /> *** Example &quot;Get&quot; Output: <br /> <br /> <br /> {| class=&quot;prettytable&quot;<br /> | &lt;center&gt;'''Getting the hosts and urls with a pong combined'''&lt;/center&gt;<br /> <br /> |-<br /> | I|pong|Beacon Cache 0.1.5D Beta|gnutella-gnutella2H|65.9.200.243:4968|248261H|68.228.129.75:44599|242678H|98.240.196.122:8206|240719H|76.104.12.133:14921|218273H|69.136.1.12:3924|211610H|81.154.208.71:8595|174402H|97.96.105.51:2076|153610H|74.192.153.212:39340|144203H|72.190.106.57:12584|132984H|78.93.71.132:12334|125668H|82.43.248.184:27560|97974H|196.205.224.97:6357|86763H|74.129.219.30:33172|82005H|76.104.12.133:19185|57182H|69.59.83.131:18442|38628U|[http://www.k33bz.com/g2/bazooka.php%7C248639 http://www.k33bz.com/g2/bazooka.php|248639]U|[http://gwebcache.ns1.net/%7C248592 http://gwebcache.ns1.net/|248592]U|[http://gwc2.wodi.org/skulls.php%7C248384 http://gwc2.wodi.org/skulls.php|248384]U|[http://gwc.guufshop.com/skulls/skulls.php%7C248322 http://gwc.guufshop.com/skulls/skulls.php|248322]U|[http://groovy.syxy.com/up/skulls.php%7C248300 http://groovy.syxy.com/up/skulls.php|248300]U|[http://g2.tjtech.org/g2/index.php%7C247770 http://g2.tjtech.org/g2/index.php|247770]U|[http://midian.jayl.de/g2/bazooka.php%7C240719 http://midian.jayl.de/g2/bazooka.php|240719]U|[http://www.dom2porno.info/skulls/skulls.php%7C207473 http://www.dom2porno.info/skulls/skulls.php|207473]U|[http://gwc.frodoslair.net/skulls/skulls%7C125668 http://gwc.frodoslair.net/skulls/skulls|125668]U|[http://holograph.uni.cc/other/skulls.php%7C9642 http://holograph.uni.cc/other/skulls.php|9642] <br /> <br /> |}<br /> '''Variables''' <br /> * '''Mandatory''' <br /> ** ping: <br /> *** Main Part: I|pong| <br /> *** Then add the cache name and version: I|pong|fakecache 0.01 <br /> *** Then lastly add the network support: <br /> **** I|pong|fakecache 0.01|gnutella <br /> ***** - Gnutella only <br /> **** I|pong|fakecache 0.01|gnutella2 <br /> ***** - Gnutella2 only <br /> **** I|pong|fakecache 0.01|gnutella-gnutella2 <br /> ***** - Gnutella and Gnutella2 served <br /> ** get: <br /> *** Used by clients to requests alternate cache URLs along with IPs and their port numbers. <br /> ** update: <br /> *** url: <br /> **** Client update giving an alternate cache URL. <br /> **** Formatted with a http:// prefix to each cache. <br /> *** ip: <br /> **** Client update giving one's IP to submit. <br /> ** net: <br /> *** Which network to serve the client. <br /> **** Gnutella <br /> ***** Ex: net=gnutella <br /> **** Gnutella2 <br /> ***** Ex: net=gnutella2 <br /> **** '''Should always be lowercase''' <br /> ***** GWCs should automatically convert network name given to lowercase to prevent Net ID mismatches <br /> <br /> solely on case alone. <br /> <br /> <br /> * <br /> ** client: <br /> *** Four letter code of the client. ex: RAZA <br /> ** version: <br /> *** Version number of the client. <br /> * '''Optional''' <br /> ** cluster: <br /> *** To add extra info to an IP update. <br /> **** Output by cache: H|0.0.0.0|AGE OF HOST (Seconds)|clustering some bull**** <br /> ** statfile: <br /> *** Exactly like the specification 1 statfile '''(Same routine and output style)'''. <br /> *** Statistics of the cache request: <br /> **** First line: Total requests of the cache number. <br /> **** Second line: Requests of the cache an hour number. <br /> **** Third line: Updates of the cache an hour number. <br /> <br /> ==== Specification 2.1 ====<br /> '''This is an extension of specification 2, not a separate specification!''' <br /> Pong extension <br /> * Append the networks supported joined by a hyphen '-'. <br /> * Used for client-side validation of networks supported and for network support reporting to other web caches. <br /> * Format: <br /> ** I|pong|cache name|network names joined by '-' <br /> ** Format Examples: <br /> *** I|pong|fakecache 0.01|gnutella <br /> **** - Gnutella only <br /> *** I|pong|fakecache 0.01|gnutella2 <br /> **** - Gnutella2 only <br /> *** I|pong|fakecache 0.01|gnutella-gnutella2 <br /> **** - Gnutella and Gnutella2 served <br /> Host Output <br /> * Just like specification 2, but with more fields supported for host output. <br /> ** H|ip:port|age in cache|clustering|leaves|4 letter vendor code|reported uptime of host|max. leaves possible <br /> *** The host, age, and clustering fields are all still the same as in specification 2. <br /> *** The leaf count of the hub reported is in the 5th field. <br /> *** The vendor code with version number is in the 6th field. <br /> Request Control Variables: <br /> * getleaves <br /> ** Used to obtain leaf counts of hubs given <br /> ** 4th field ultilized for current leaf count. <br /> ** 7th field ultilized for maximum leaf slots possible. <br /> ** Use this as 'getleaves=1' or 'getleaves' to enable. <br /> * getclusters <br /> ** Enables/Disables clustering. <br /> ** Use this as 'getclusters=1'. <br /> ** Using 'getclusters' or 'getclusters=0' disables cluster output. <br /> * getvendors <br /> ** Used to obtain the vendor code w/ version number of the hubs given. <br /> ** Found in the 5th field. <br /> ** Use this as 'getvendors=1' or 'getvendors' to enable. <br /> * getuptime <br /> ** Used to obtain the vendor code w/ version number of the hubs given. <br /> ** Value is static, do not change the value given when time passes. <br /> ** Found in the 6th field. <br /> ** Use this as 'getuptime=1' or 'getuptime' to enable. <br /> * spec <br /> ** To force the specification parameter <br /> ** Currently is only supported by Beacon Cache II <br /> * pv <br /> ** Similar to the 'spec' parameter, except that it does not force, instead it simply negotiates the specification. <br /> Special Data Requests <br /> * info <br /> ** Outputs extra details of your cache. <br /> *** Start with the informational response: I| <br /> **** Ex: I|open-source|1 <br /> * support <br /> ** Outputs USEFUL details of your cache. <br /> *** Start with the informational response: I| <br /> **** Ex: I|support|gnutella2 <br /> * getnetworks <br /> ** Outputs the enabled networks in two formats. <br /> *** Start with the informational response: I| <br /> **** For the 'I|nets|' line <br /> ***** The third field contains the supported networks joined by '-'. <br /> **** For the 'I|networks|' line <br /> ***** Interpret the fields from 3 and beyond as individual network names to challenge against. <br /> *** Examples <br /> **** <br /> ***** I|net|gnutella-gnutella2 <br /> ***** I|networks|gnutella|gnutella2 <br /> Update Extension Variables: <br /> * x_leaves <br /> ** Number of leaves running on a given hub or ultrapeer. <br /> ** '''Value must not be greater than an integer value of 2047.''' <br /> * x_max <br /> ** Maximum number of leaves possible on a given hub or ultrapeer. <br /> ** '''Value must not be greater than an integer value of 2047.''' <br /> * uptime <br /> ** Value submitted must be an integer value of the number of seconds of uptime. <br /> ** '''Value must not be greater than an integer value of 1 year (31536000) and less than 1 hour (60).''' <br /> <br /> === Pinging Caches With Your Cache ===<br /> '''Please follow this standard:''' <br /> * '''Client: TEST''' <br /> * '''Version: Your Cache's Name''' <br /> ** The old value for &quot;version&quot; was 1 <br /> '''Some variables to attach to the ping (compatibility):''' <br /> * '''multi''' <br /> ** Used by some gwcs in their pings to other gwcs. <br /> ** &lt;nowiki&gt;It tells the pinged cache to ignore the &quot;net&quot; parameter (so it should never say network not supported) and outputting the pong using this format, if possible, &quot;I|pong|[cache name] [cache version]|[supported networks list]&quot; - example: I|pong|Skulls 0.2.9|gnutella-gnutella2 &lt;/nowiki&gt;<br /> ** Used by Skulls GWC only, supported by Skulls and Beacon Cache II. <br /> * '''cache''' <br /> ** This is added to every request made by some gwcs, it is for statistical purposes only. <br /> ** It simply tells the remote cache that the client is a GWC. <br /> '''Help''' <br /> * For PHP <br /> ** Use the fsockopen() function to open a connection to a cache. <br /> *** Make sure you &quot;write&quot; to the fsockopen carry value to open the GWC's target file. <br /> **** [http://us.php.net/manual/en/function.fsockopen.php http://us.php.net/manual/en/function.fsockopen.php] <br /> <br /> === Variable Combination Standards ===<br /> '''Net variable decides specification!''' <br /> * There are many ways to determine spec., but going with net is the safe way. <br /> * Skulls GWC does not use the network parameter to determine specification level. <br /> * Beacon Cache (I and II) uses the network parameter to determine the specification level. <br /> '''Your cache needs to be able to process certain combinations of variables.''' <br /> * Update variable <br /> ** Update should not fail if absent if spec. 2. <br /> *** A Specification 2 parameter. <br /> Spec 1 parameters used in Spec 2: <br /> * Should still accept hostfile and urlfile responses for spec. 2. <br /> ** Beacon Cache (I and II) accepts these parameters on spec 2. <br /> The 'spec' paameter can be used to force a specification: <br /> * Only known to exist in Beacon Cache II, it can force the request to be handled as a specification 1 or 2 request. <br /> * Spec 1 = 'spec=1' <br /> * Spec 2 = 'spec=2' <br /> * If 'spec' is not equal to any current spec, then default to the predetermined spec. <br /> '''Multiple variable requests''' <br /> * If for instance a ping and request exist, you should always handle them properly. <br /> ** Same goes with other combos like an update and ping, statfile + ping and info. <br /> * Handle multiple variables as BEST as possible! <br /> ** Some scanners and GWCs like to fit all their requests into one URL send. <br /> <br /> === Further Information: ===<br /> * [http://www.gnucleus.com/gwebcache/ Original GWC] [http://www.gnucleus.com/gwebcache/ site] <br /> ** [http://gnucleus.sourceforge.net/gwebcache/specs.html GWC Spec. 1] <br /> ** [http://gnucleus.sourceforge.net/gwebcache/newgwc.html GWC Spec. 2] <br /> <br /> === Gnutella Web Cache ===<br /> Gnutella requires Gnutella Web Caches (GWC) to get IPs to establish a connection to the network. These are critical to ensuring the health of the network. If you have a dedicated server and can spare some extra bandwidth then please consider running a GWC. People that don't have a dedicated server or are on normal broadband consumer lines should not run a cache from home.<br /> <br /> A GWC is a simple script that can be put on any webserver that supports one of the following scripting languages:<br /> *JSP (Java Servlet)<br /> **[http://web.archive.org/web/20061108091447/http://www.mager.org/GWebCache/ Java Servlet GWebCache Application (Archive.org)]<br /> *C<br /> **[http://ghostwhitecrab.com/crab/ GhostWhiteCrab]<br /> *Perl <br /> **[http://www.jonatkins.com/perlgcache/ Jon Atkins' perlgcache] <br /> **The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache]<br /> *PHP <br /> **[http://gwcii.sourceforge.net/ PHPGnuCacheII] - MySQL<br /> **[http://www.bazookanetworks.com Bazooka G2WC] (recommended) - flat files<br /> **[http://sourceforge.net/projects/skulls/ Skulls! Multi-Network WebCache] - flat files<br /> ====Further Information:====<br /> *[http://www.gnucleus.com/gwebcache/|Original GWC site]<br /> <br /> <br /> {{RecoveredPage|--&gt;Saved in timestamp 20090421202728Retrieved from &quot;[https://www.pantheraproject.net/wiki/index.php?title=GWC This page was last modified on April 18, 2009, at 23:25. &lt;/center&gt;<br /> <br /> &lt;center&gt;Copyright © 2002-2009 Shareaza Development Team. &lt;/center&gt;&lt;center&gt;[[Image:poweredby_mediawiki_88x31.png]] --[[User:Ocexyz|Ocexyz]] 16:20, 27 July 2009 (UTC)}}<br /> <br /> {{RecoveredPage|Warninig: here ends pasted better formatted recovery. Row recovery has been mooved below as I don't know if anybody has made any changes in it. If not then row recovery can be deleted I suppose. Paste starts from == Shareaza Specific Details == and ends at second == Shareaza Specific Details ==, here. I hope it is visible. --[[User:Ocexyz|Ocexyz]] 16:20, 27 July 2009 (UTC) }}<br /> <br /> ==Shareaza Specific Details==<br /> <br /> {{RecoveredPage|Warninig: here ends pasted better formatted recovery. Row recovery has been mooved below as I don't know if anybody has made any changes in it. If not then row recovery can be deleted I suppose. Paste starts from &gt;&gt;Shareaza Specific Details&lt;&lt; and ends at second &gt;&gt; Shareaza Specific Details&lt;&lt;, here. I hope it is visible. --[[User:Ocexyz|Ocexyz]] 23:27, 27 July 2009 (UTC) }}<br /> <br /> * Get String Breakdown:<br /> o Update a leaf<br /> + &quot;?update=1&amp;ip=(ip):(port)&amp;x_leaves=(leaf count) <br /> o Ping Variable<br /> + Appends &amp;ping=1 to identify the cache name in debug messages (for gnutella and gnutella2 in 2.4.0.0, but only for gnutella2 now in 2.4.0.X for spec1 cache compatibility).<br /> + This feature new to Shareaza. <br /> o Network Variable<br /> + Appends &amp;net=gnutella2 on Gnutella2 queries.<br /> + Does NOT append a network variable on Gnutella(1) queries. <br /> o Client Name / Version Format (2.4.0.0 and earlier):<br /> + &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )<br /> + &amp;version=(Shareaza's version) <br /> o Client Name / Version Format (2.4.0.X):<br /> + If Gnutella<br /> # &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )<br /> # &amp;version=(Shareaza's version) <br /> + If Gnutella2<br /> # &amp;client=(Shareaza 4 letter code (RAZA / RAZB) )+(Shareaza's version) <br /> <br /> <br /> <br /> * GWC Response Matching:<br /> o i|<br /> + Informational output alone will not be taken as GWC 'success.' <br /> o i|access|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to make a request to the cache. <br /> o i|update|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to update to the cache. <br /> o i|force|remove and i|update|warning|bad url<br /> + Remove the GWC from the internal list. <br /> o Some Response Matches (added in 2.3.1.X)<br /> + i|NO-URL-NO-HOSTS<br /> # Outputs warning of the cache being totally empty to the system log. <br /> + i|NO-URL<br /> # Outputs warning of the cache having no alternative URLs to the system log. <br /> + i|NO-HOSTS<br /> # Outputs warning of the cache having no hosts to the system log. <br /> + i|warning|<br /> # Outputs warning of the cache to the system log. <br /> + ERROR Something Failed<br /> # Outputs warning of the cache to the system log(Buggy Bazooka GWCs workaround). <br /> + i|warning|You came back too early (2.3.1.X)<br /> + i|warning|client|early (2.3.1.X)<br /> + WARNING: You came back too early (2.3.1.X)<br /> + ERROR: Client returned too early (2.3.1.X)<br /> # Flood detection for the update side.<br /> # Outputs GWebCache(update) Too many connection attempts to the system log. <br /> + too early (2.3.1.X)<br /> + early (2.4.0.X)<br /> # Flood detection for the request side.<br /> # Outputs GWebCache URL: Too many connection attempts to the system log. <br /> + i|update|OK<br /> # Outputs &quot;GWebCache(v2) Update Passed: &quot; to the system log. <br /> + OK<br /> # Outputs &quot;GWebCache(v1) Update Passed: &quot; to the system log. <br /> <br /> <br /> <br /> * GWC Response Matching:<br /> o i|<br /> + Informational output alone will not be taken as GWC 'success.' <br /> o i|access|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to make a request to the cache. <br /> o i|update|period|(time in sec.)<br /> + Time in seconds before Shareaza is allowed to update to the cache. <br /> o i|force|remove and i|update|warning|bad url<br /> + Remove the GWC from the internal list. <br /> o Some Response Matches (added in 2.3.1.X)<br /> + i|NO-URL-NO-HOSTS<br /> # Outputs warning of the cache being totally empty to the system log. <br /> + i|NO-URL<br /> # Outputs warning of the cache having no alternative URLs to the system log. <br /> + i|NO-HOSTS<br /> # Outputs warning of the cache having no hosts to the system log. <br /> + i|warning|<br /> # Outputs warning of the cache to the system log. <br /> + ERROR Something Failed<br /> # Outputs warning of the cache to the system log(Buggy Bazooka GWCs workaround). <br /> + i|warning|You came back too early (2.3.1.X)<br /> + i|warning|client|early (2.3.1.X)<br /> + WARNING: You came back too early (2.3.1.X)<br /> + ERROR: Client returned too early (2.3.1.X)<br /> # Flood detection for the update side.<br /> # Outputs GWebCache(update) Too many connection attempts to the system log. <br /> + too early (2.3.1.X)<br /> + early (2.4.0.X)<br /> # Flood detection for the request side.<br /> # Outputs GWebCache URL: Too many connection attempts to the system log. <br /> + i|update|OK<br /> # Outputs &quot;GWebCache(v2) Update Passed: &quot; to the system log. <br /> + OK<br /> # Outputs &quot;GWebCache(v1) Update Passed: &quot; to the system log. <br /> <br /> <br /> <br /> ==Gnutella Web Cache Specifications==<br /> &lt;end of partial recovery by OCE&gt;<br /> <br /> <br /> <br /> <br /> &lt;end of recovered content&gt;<br /> <br /> &lt;row recovery, start&gt; <br /> Specification 1:<br /> <br /> * Networks Served<br /> o Gnutella <br /> * Format<br /> o Update went fine:<br /> + Ex: OK <br /> o Update Warning (Small prob., not that bad):<br /> + Ex: <br /> <br /> OK<br /> WARNING: Error Message<br /> <br /> * Severe Warning (No 'OK' message sent)<br /> o Ex: <br /> <br /> WARNING: Error Message<br /> <br /> * URL Output:<br /> o Ex: http://somefreakinrandomcache.com/cache/gcache.php<br /> + OR - WITH A PORT NUMBER (If not 80)<br /> # Ex: http://somefreakinrandomcache.com:8080/cache/gcache.php <br /> * Host Output:<br /> o Ex: 66.132.55.12:6346 <br /> * Pong (ping variable response) - was explained below under the topic: variables.<br /> * Example Cache Output (Beacon Cache) For urlfile Command<br /> o Example &quot;urlfile Output&quot; URL: Ex: http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;urlfile=1<br /> + Example URL Output: <br /> <br /> <br /> Getting urls with a pong combined<br /> <br /> PONG Beacon Cache 0.1.5D Beta<br /> http://gwc.frodoslair.net/skulls/skulls.php<br /> http://bbs.robertwoolley.co.uk/GWebCache/gcache.php<br /> http://g2.tjtech.org/g2/<br /> http://g2.tjtech.org/g2/index.php<br /> http://gwc.monnsta.net/<br /> http://holograph.uni.cc/other/skulls.php<br /> http://gwc.nickstallman.net/<br /> http://gwc.eod.cc/skulls.php<br /> http://gwc.frodoslair.net/skulls/skulls<br /> http://gwc.werwin.net/skulls.php<br /> <br /> <br /> * Example Cache Output (Beacon Cache) For hostfile Command<br /> o Example &quot;hostfile Output&quot; URL: Ex: http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;hostfile=1<br /> + Example Host Output: <br /> <br /> <br /> Getting the hosts with a pong combined<br /> <br /> PONG Beacon Cache 0.1.5D Beta<br /> 71.8.84.153:3915<br /> 99.248.214.157:27529<br /> 69.60.241.55:16369<br /> 193.253.239.246:30218<br /> 68.156.175.121:6348<br /> 71.179.7.241:18344<br /> 74.196.22.241:6348<br /> 12.210.197.194:10531<br /> 222.150.143.77:10000<br /> 58.85.231.135:6346<br /> 24.141.199.164:20205<br /> 72.175.201.195:6348<br /> 69.81.129.228:4880<br /> 97.81.221.63:13219<br /> 70.15.130.224:7759<br /> 216.211.188.106:51903<br /> 75.167.168.156:48660<br /> 12.214.14.3:35916<br /> 76.177.244.106:24180<br /> 98.165.218.139:39630<br /> 68.112.182.125:3685<br /> 68.117.204.57:23482<br /> 65.12.154.25:40760<br /> 69.180.47.169:5711<br /> 75.138.40.173:24987<br /> 98.201.19.0:33662<br /> 70.187.2.144:6348<br /> 68.186.209.107:14429<br /> 69.159.7.61:6348<br /> 76.208.176.196:48199<br /> <br /> <br /> * For combining a hostfile and urlfile request:<br /> o Warning: This is non-standard.<br /> o Example Cache Output (Beacon Cache) For bfile Command<br /> + Example &quot;bfile Output&quot; URL: Ex: http://grantgalitz.com/Beacon/gwc.php?ping=1&amp;client=RAZA&amp;version=2.3.1.3&amp;bfile=1<br /> # Example Host and URL Output: <br /> <br /> <br /> Getting the hosts and urls with a pong combined<br /> <br /> PONG Beacon Cache 0.1.5D Beta<br /> 71.8.84.153:3915<br /> 99.248.214.157:27529<br /> 69.60.241.55:16369<br /> 193.253.239.246:30218<br /> 68.156.175.121:6348<br /> 71.179.7.241:18344<br /> 74.196.22.241:6348<br /> 12.210.197.194:10531<br /> 222.150.143.77:10000<br /> 58.85.231.135:6346<br /> 24.141.199.164:20205<br /> 72.175.201.195:6348<br /> 69.81.129.228:4880<br /> 97.81.221.63:13219<br /> 70.15.130.224:7759<br /> 216.211.188.106:51903<br /> 75.167.168.156:48660<br /> 12.214.14.3:35916<br /> 76.177.244.106:24180<br /> 98.165.218.139:39630<br /> 68.112.182.125:3685<br /> 68.117.204.57:23482<br /> 65.12.154.25:40760<br /> 69.180.47.169:5711<br /> 75.138.40.173:24987<br /> 98.201.19.0:33662<br /> 70.187.2.144:6348<br /> 68.186.209.107:14429<br /> 69.159.7.61:6348<br /> 76.208.176.196:48199<br /> http://gwc.frodoslair.net/skulls/skulls.php<br /> http://bbs.robertwoolley.co.uk/GWebCache/gcache.php<br /> http://g2.tjtech.org/g2/<br /> http://g2.tjtech.org/g2/index.php<br /> http://gwc.monnsta.net/<br /> http://holograph.uni.cc/other/skulls.php<br /> http://gwc.nickstallman.net/<br /> http://gwc.eod.cc/skulls.php<br /> http://gwc.frodoslair.net/skulls/skulls<br /> http://gwc.werwin.net/skulls.php<br /> <br /> <br /> * Variables<br /> o Mandatory<br /> + ping:<br /> # Response should have this always: PONG<br /> # After, put the cache's name. ex: PONG fakecache 0.01<br /> + client:<br /> # Four letter code of the client. ex: RAZA <br /> + version:<br /> # Version number of the client. <br /> + urlfile:<br /> # Used by the client to request alternate cache urls. <br /> + hostfile:<br /> # Used by the client to request IPs with port numbers attached. <br /> + url:<br /> # Client update giving an alternate cache URL.<br /> # Formatted with a http:// prefix to each cache. <br /> + ip:<br /> # Client update giving one's IP to submit. <br /> + url1:<br /> # OLD OUTDATED Client update giving an alternate cache URL.<br /> # Formatted with a http:// prefix to each cache. <br /> + ip1:<br /> # OLD OUTDATED Client update giving one's IP to submit. <br /> o Optional<br /> + bfile:<br /> # For clients to request both URLs and IPs from the cache at the same time. <br /> + statfile:<br /> # Statistics of the cache request:<br /> * First line: Total requests of the cache number.<br /> * Second line: Requests of the cache an hour number.<br /> * Third line: Updates of the cache an hour number. <br /> <br /> Specification 2:<br /> <br /> * Networks Served<br /> o Gnutella, Gnutella2, etc. <br /> * Format<br /> o Information Output<br /> + Starts with: I|<br /> # Categories<br /> * Pong (ping variable response) - Described below under the topic: variables.<br /> * Update Status Response<br /> o Format: I|update<br /> o Responses<br /> + I|update|OK<br /> # - Everything went fine. <br /> + I|update|OK|WARNING<br /> # Small warning. <br /> + I|update|WARNING<br /> # Severe warning <br /> * Plain Warnings<br /> o Format: I|WARNING<br /> + Append any warning messages after it - Ex: I|WARNING|You came back too early <br /> * Extra Info - Described below under the topic: variables. <br /> o Host Output<br /> + Starts with: H|<br /> + Add the IP with its port:<br /> # Ex: H|0.0.0.0:6346 <br /> + Add the time, thereafter, of the host's (In seconds*) time in cache:<br /> # Ex: H|0.0.0.0:6346|45 <br /> + If cluster exists with cluster=somerandomwords<br /> # Add the clustered words after the host's age:<br /> * Ex: H|0.0.0.0:6346|45|somerandomwords <br /> o URL Output<br /> + Starts with: U|<br /> + Add the URL with http:// before it, plus the port (if it's not 80).<br /> # Ex: U|http://somerandomcache.com/ <br /> + Add the time, thereafter, of the URL's time (In seconds*) in cache:<br /> # Ex: U|http://somerandomcache.com/|45 <br /> o Example Cache Output (Beacon Cache) For get Command<br /> + Example URL: http://grantgalitz.com/Beacon/gwc.php?get=1&amp;client=RAZA&amp;version=2.3.1.3&amp;net=gnutella2&amp;ping=1<br /> # Example &quot;Get&quot; Output: <br /> <br /> <br /> Getting the hosts and urls with a pong combined<br /> <br /> I|pong|Beacon Cache 0.1.5D Beta|gnutella-gnutella2<br /> H|65.9.200.243:4968|248261<br /> H|68.228.129.75:44599|242678<br /> H|98.240.196.122:8206|240719<br /> H|76.104.12.133:14921|218273<br /> H|69.136.1.12:3924|211610<br /> H|81.154.208.71:8595|174402<br /> H|97.96.105.51:2076|153610<br /> H|74.192.153.212:39340|144203<br /> H|72.190.106.57:12584|132984<br /> H|78.93.71.132:12334|125668<br /> H|82.43.248.184:27560|97974<br /> H|196.205.224.97:6357|86763<br /> H|74.129.219.30:33172|82005<br /> H|76.104.12.133:19185|57182<br /> H|69.59.83.131:18442|38628<br /> U|http://www.k33bz.com/g2/bazooka.php|248639<br /> U|http://gwebcache.ns1.net/|248592<br /> U|http://gwc2.wodi.org/skulls.php|248384<br /> U|http://gwc.guufshop.com/skulls/skulls.php|248322<br /> U|http://groovy.syxy.com/up/skulls.php|248300<br /> U|http://g2.tjtech.org/g2/index.php|247770<br /> U|http://midian.jayl.de/g2/bazooka.php|240719<br /> U|http://www.dom2porno.info/skulls/skulls.php|207473<br /> U|http://gwc.frodoslair.net/skulls/skulls|125668<br /> U|http://holograph.uni.cc/other/skulls.php|9642<br /> <br /> <br /> * Variables<br /> o Mandatory<br /> + ping:<br /> # Main Part: I|pong|<br /> # Then add the cache name and version: I|pong|fakecache 0.01<br /> # Then lastly add the network support:<br /> * I|pong|fakecache 0.01|gnutella<br /> o - Gnutella only <br /> * I|pong|fakecache 0.01|gnutella2<br /> o - Gnutella2 only <br /> * I|pong|fakecache 0.01|gnutella-gnutella2<br /> o - Gnutella and Gnutella2 served <br /> + get:<br /> # Used by clients to requests alternate cache URLs along with IPs and their port numbers. <br /> + update:<br /> # url:<br /> * Client update giving an alternate cache URL.<br /> * Formatted with a http:// prefix to each cache. <br /> # ip:<br /> * Client update giving one's IP to submit. <br /> + net:<br /> # Which network to serve the client.<br /> * Gnutella<br /> o Ex: net=gnutella <br /> * Gnutella2<br /> o Ex: net=gnutella2 <br /> * Should always be lowercase<br /> o GWCs should automatically convert network name given to lowercase to prevent Net ID mismatches <br /> <br /> solely on case alone.<br /> <br /> *<br /> o<br /> + client:<br /> # Four letter code of the client. ex: RAZA <br /> + version:<br /> # Version number of the client. <br /> o Optional<br /> + cluster:<br /> # To add extra info to an IP update.<br /> * Output by cache: H|0.0.0.0|AGE OF HOST (Seconds)|clustering some bull**** <br /> + statfile:<br /> # Exactly like the specification 1 statfile (Same routine and output style).<br /> # Statistics of the cache request:<br /> * First line: Total requests of the cache number.<br /> * Second line: Requests of the cache an hour number.<br /> * Third line: Updates of the cache an hour number. <br /> <br /> Specification 2.1<br /> <br /> * This is an extension of specification 2, not a separate specification!<br /> * Pong extension<br /> o Append the networks supported joined by a hyphen '-'.<br /> o Used for client-side validation of networks supported and for network support reporting to other web caches.<br /> o Format:<br /> + I|pong|cache name|network names joined by '-'<br /> + Format Examples:<br /> # I|pong|fakecache 0.01|gnutella<br /> * - Gnutella only <br /> # I|pong|fakecache 0.01|gnutella2<br /> * - Gnutella2 only <br /> # I|pong|fakecache 0.01|gnutella-gnutella2<br /> * - Gnutella and Gnutella2 served <br /> * Host Output<br /> o Just like specification 2, but with more fields supported for host output.<br /> + H|ip:port|age in cache|clustering|leaves|4 letter vendor code|reported uptime of host|max. leaves possible<br /> # The host, age, and clustering fields are all still the same as in specification 2.<br /> # The leaf count of the hub reported is in the 5th field.<br /> # The vendor code with version number is in the 6th field. <br /> * Request Control Variables:<br /> o getleaves<br /> + Used to obtain leaf counts of hubs given<br /> + 4th field ultilized for current leaf count.<br /> + 7th field ultilized for maximum leaf slots possible.<br /> + Use this as 'getleaves=1' or 'getleaves' to enable. <br /> o getclusters<br /> + Enables/Disables clustering.<br /> + Use this as 'getclusters=1'.<br /> + Using 'getclusters' or 'getclusters=0' disables cluster output. <br /> o getvendors<br /> + Used to obtain the vendor code w/ version number of the hubs given.<br /> + Found in the 5th field.<br /> + Use this as 'getvendors=1' or 'getvendors' to enable. <br /> o getuptime<br /> + Used to obtain the vendor code w/ version number of the hubs given.<br /> + Value is static, do not change the value given when time passes.<br /> + Found in the 6th field.<br /> + Use this as 'getuptime=1' or 'getuptime' to enable. <br /> o spec<br /> + To force the specification parameter<br /> + Currently is only supported by Beacon Cache II <br /> o pv<br /> + Similar to the 'spec' parameter, except that it does not force, instead it simply negotiates the specification. <br /> * Special Data Requests<br /> o info<br /> + Outputs extra details of your cache.<br /> # Start with the informational response: I|<br /> * Ex: I|open-source|1 <br /> o support<br /> + Outputs USEFUL details of your cache.<br /> # Start with the informational response: I|<br /> * Ex: I|support|gnutella2 <br /> o getnetworks<br /> + Outputs the enabled networks in two formats.<br /> # Start with the informational response: I|<br /> * For the 'I|nets|' line<br /> o The third field contains the supported networks joined by '-'. <br /> * For the 'I|networks|' line<br /> o Interpret the fields from 3 and beyond as individual network names to challenge against. <br /> # Examples<br /> *<br /> o I|net|gnutella-gnutella2<br /> o I|networks|gnutella|gnutella2 <br /> * Update Extension Variables:<br /> o x_leaves<br /> + Number of leaves running on a given hub or ultrapeer.<br /> + Value must not be greater than an integer value of 2047. <br /> o x_max<br /> + Maximum number of leaves possible on a given hub or ultrapeer.<br /> + Value must not be greater than an integer value of 2047. <br /> o uptime<br /> + Value submitted must be an integer value of the number of seconds of uptime.<br /> + Value must not be greater than an integer value of 1 year (31536000) and less than 1 hour (60). <br /> <br /> Pinging Caches With Your Cache<br /> <br /> * Please follow this standard:<br /> o Client: TEST<br /> o Version: Your Cache's Name<br /> + The old value for &quot;version&quot; was 1 <br /> * Some variables to attach to the ping (compatibility):<br /> o multi<br /> + Used by some gwcs in their pings to other gwcs.<br /> + It tells the pinged cache to ignore the &quot;net&quot; parameter (so it should never say network not supported) and outputting the pong using this format, if possible, &quot;I|pong|[cache name] [cache version]|[supported networks list]|[url adding is enabled]&quot; - example: I|pong|Skulls 0.2.8a|gnutella-gnutella2|1<br /> + Used by Skulls GWC only. <br /> o cache<br /> + This is added to every request made by some gwcs, it is for statistical purposes only.<br /> + It simply tells the remote cache that the client is a GWC. <br /> * Help<br /> o For PHP<br /> + Use the fsockopen() function to open a connection to a cache.<br /> # Make sure you &quot;write&quot; to the fsockopen carry value to open the GWC's target file.<br /> * http://us.php.net/manual/en/function.fsockopen.php <br /> <br /> Variable Combination Standards<br /> <br /> * Net variable decides specification!<br /> o There are many ways to determine spec., but going with net is the safe way.<br /> o Skulls GWC does not use the network parameter to determine specification level.<br /> o Beacon Cache (I and II) uses the network parameter to determine the specification level. <br /> * Your cache needs to be able to process certain combinations of variables.<br /> o Update variable<br /> + Update should not fail if absent if spec. 2.<br /> # A Specification 2 parameter. <br /> * Spec 1 parameters used in Spec 2:<br /> o Should still accept hostfile and urlfile responses for spec. 2.<br /> + Beacon Cache (I and II) accepts these parameters on spec 2. <br /> * The 'spec' paameter can be used to force a specification:<br /> o Only known to exist in Beacon Cache II, it can force the request to be handled as a specification 1 or 2 request.<br /> o Spec 1 = 'spec=1'<br /> o Spec 2 = 'spec=2'<br /> o If 'spec' is not equal to any current spec, then default to the predetermined spec. <br /> * Multiple variable requests<br /> o If for instance a ping and request exist, you should always handle them properly.<br /> + Same goes with other combos like an update and ping, statfile + ping and info. <br /> o Handle multiple variables as BEST as possible!<br /> + Some scanners and GWCs like to fit all their requests into one URL send. <br /> <br /> &lt;row recovery, end&gt; <br /> <br /> Further Information:<br /> <br /> * [http://www.gnucleus.com/gwebcache/ Original GWC site]<br /> ** [http://gnucleus.sourceforge.net/gwebcache/specs.html GWC Spec. 1]<br /> ** [http://gnucleus.sourceforge.net/gwebcache/newgwc.html GWC Spec. 2] <br /> <br /> <br /> <br /> <br /> <br /> &lt;content recovered from last aviable backup&gt; <br /> <br /> ===Gnutella Web Cache===<br /> Gnutella requires Gnutella Web Caches (GWC) to get IPs to establish a connection to the network. These are critical to ensuring the health of the network. If you have a dedicated server and can spare some extra bandwidth then please consider running a GWC. People that don't have a dedicated server or are on normal broadband consumer lines should not run a cache from home.<br /> <br /> A GWC is a simple script that can be put on any webserver that supports one of the following scripting languages:<br /> *JSP (Java Servlet)<br /> **[http://web.archive.org/web/20061108091447/http://www.mager.org/GWebCache/ Java Servlet GWebCache Application (Archive.org)]<br /> *C<br /> **[http://ghostwhitecrab.com/crab/ GhostWhiteCrab]<br /> *Perl <br /> **[http://www.jonatkins.com/perlgcache/ Jon Atkins' perlgcache] <br /> **The original [http://www.gnucleus.com/gwebcache/dist/ GnuWebCache]<br /> *PHP <br /> **[http://gwcii.sourceforge.net/ PHPGnuCacheII] - MySQL<br /> **[http://www.bazookanetworks.com Bazooka G2WC] (recommended) - flat files<br /> **[http://sourceforge.net/projects/skulls/ Skulls! Multi-Network WebCache] - flat files<br /> === Further Information: ===<br /> * [http://www.gnucleus.com/gwebcache/ Original GWC site]<br /> <br /> [[Category:External Links]]</div>

Ale5000 https://shareaza.sourceforge.net/w/index.php?title=Talk:GWC_specs&diff=11501 2015-03-25T12:22:01Z

<p>Ale5000: Created page with &quot;Note: Beacon Cache II also support multi=1 attached to ping requests.&quot;</p> <hr /> <div>Note: Beacon Cache II also support multi=1 attached to ping requests.</div>

Ale5000