/[meteor]/googlecode.com/svn/trunk/Meteor/Socket.pm
This is repository of my old source code which isn't updated any more. Go to git.rot13.org for current projects!
ViewVC logotype

Annotation of /googlecode.com/svn/trunk/Meteor/Socket.pm

Parent Directory Parent Directory | Revision Log Revision Log


Revision 62 - (hide annotations)
Thu Nov 27 00:33:21 2008 UTC (15 years, 4 months ago) by andrew.betts
File size: 6544 byte(s)
1 Fixed: Added SIGPIPE handler.  We noticed that under heavy load
Meteor receives SIGPIPEs from the OS, suspected to relate to clients
that have just disconnected the moment Meteor attempts to write to the
socket.  This caused Meteor to crash.
2 Fixed: Long polling multiple channels no longer causes the loop to
die and restart when some channels have messages queued for delivery.
3 Fixed: Over time, Meteor 'collected' connections from clients that
never got disconnected even if MaxTime was set.  This happened if the
client concerned sent a header with no terminating blank line.  Meteor
kept waiting for the rest of the header, which never arrived, and
therefore the client remained in limbo, never subjected to the MaxTime
time limit because it had not yet become a subscriber.  Clients are
now allowed 30 seconds to send a valid request header.
4 Fixed: If only one message existed on the server, the JS client
would continue to request it again and again, because it has message
ID 0, and the JS client considered this an invalid message ID.
5 Fixed: Corrected some comments in file headers

6 Changed: MaxMessages has been renamed to CloseOnEvent and functions
in a similar, but not quite identical way.  Thanks to Matthew Haak,
who pointed out the extreme confusingness of MaxMessages and a bug
that has resulted in Fix 2 above.  Setting CloseOnEvent to any value
that evaluates to true will cause Meteor to close subscriber
connections after at least one message has been sent and there are no
further messages pending.  This is identical to MaxMessages for values
of 0 and 1, but where MaxMessages is set to a value higher than one,
replacing it with CloseOnEvent with the same value will act as though
it were set to one.  The intent of MaxMessages was to enable long-
polling (and it is used by the JS client in that way), and
CloseonEvent is a drop in replacement for that behaviour.
7 Changed: Meteor JS client now uses dynamic <SCRIPT> tags for all
polling behaviours, rather than XHR.  This enables it to make poll
requests cross-domain (see 13)
8 Changed: Meteor JS client now abstracts timestamp lookups to a
dedicated method.
9 Changed: Default HeaderTemplates no longer include cache busting
headers, since all meteor requests contain a millisecond timestamp and
so no client makes the same request twice.  These were therefore
simply chewing up bandwidth.
10 Changed: Date strings used for logging debug messages are cached to
avoid numerous expensive lookups to localtime().
11 Changed: Channel info is only sent in a response if the client does
not request a restart from a specified ID.  The logic being that if
the client knows the ID they want to start from, they have already
made previous requests and have the channel information they need.
Bandwidth saving measure.

12 Added: JS client now has a Meteor.isSupportedBrowser() method,
which you can call to detemine whether Meteor will run in the user's
browser version.
13 Added: JS client can now use different hosts for polling and
streaming.  This is only really useful if your website is on a domain
that has a lot of cookies, and you don't want to send them in every
poll request.  Removing cookies from request headers can reduce the
size of the request significantly.  We find that with cookies included
Meteor poll requests are usually larger than the responses.  To use,
set Meteor.pollhost.  Meteor.pollhost can be any domain, while
Meteor.host must be a subdomain of your website hostname.
14 Added: Config file now supports new 'FooterTemplate' parameter, for
a string to send just before the connection to the subscriber is
closed.  This is in support of change 7.
15 Added: Better inline documentation for ChannelInfoTemplate config
parameter
16 Added: Log output includes connection IDs corresponding to the file
inode for each connection
17 Added: New controller command LISTCONNECTIONS, produces a newline
delimited list of all currently connected clients, and for each one
displaying "ConnectionID IPAddress ClientType [SubscriberID]"
18 Added: New controller command DESCRIBE, takes a ConnectionID as a
parameter, and outputs numerous statistics about that particular
client, including number of messages sent/received, user agent, IP
address, time connected, time remaining until MaxTime etc.
19 Added: New controller comment LISTSUBSCRIBERS, produces a newline
delimited list of all currently connected streaming subscribers, and
for each one displaying "SubscriberID IPAddress Starttime TimeLimit
TimeRemaining MessageCount UserAgent"
20 Added: SHOWSTATS command produces the following additional stats:
connection_count: total current connections, real_subscribers: total
of number of currently connected streaming subscribers plus the number
of unique polling connections seen in the last 60 seconds.
21 Added: STDERR outputs prior to every exit() for debugging purposes
22 Added: The UDP server is now considered stable, and is the best way
of broadcasting messages to lots of Meteor nodes simultaneously and
efficiently. 


1 knops.gerd 11 #!/usr/bin/perl -w
2     ###############################################################################
3     # Meteor
4     # An HTTP server for the 2.0 web
5     # Copyright (c) 2006 contributing authors
6     #
7     # Subscriber.pm
8     #
9     # Description:
10     # Meteor socket additions
11     #
12     ###############################################################################
13     #
14     # This program is free software; you can redistribute it and/or modify it
15     # under the terms of the GNU General Public License as published by the Free
16     # Software Foundation; either version 2 of the License, or (at your option)
17     # any later version.
18     #
19     # This program is distributed in the hope that it will be useful, but WITHOUT
20     # ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
21     # FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
22     # more details.
23     #
24     # You should have received a copy of the GNU General Public License along
25     # with this program; if not, write to the Free Software Foundation, Inc.,
26     # 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
27     #
28     # For more information visit www.meteorserver.org
29     #
30     ###############################################################################
31    
32     package Meteor::Socket;
33     ###############################################################################
34     # Configuration
35     ###############################################################################
36    
37     use strict;
38    
39     use Socket;
40     use Fcntl qw(F_GETFL F_SETFL O_NONBLOCK);
41     use Errno qw(EINTR);
42    
43     BEGIN {
44     $Meteor::Socket::handleNum=0;
45    
46     # Cache getprotobyname result as on some systems it is slow.
47     $Meteor::Socket::TCP_PROTO_NAME=getprotobyname('tcp');
48 knops.gerd 48 $Meteor::Socket::UDP_PROTO_NAME=getprotobyname('udp');
49 knops.gerd 11 }
50    
51     ###############################################################################
52     # Factory methods
53     ###############################################################################
54     sub new {
55     my $class=shift;
56    
57     my $self=$class;
58    
59     unless(ref($class))
60     {
61     $self={};
62     bless($self,$class);
63     }
64 andrew.betts 62
65 knops.gerd 11 $self->{'timeout'}=0;
66     $self->{'buffer'}='';
67    
68     return $self;
69     }
70    
71     sub newWithHandle {
72     my $class=shift;
73    
74     my $self=$class->new;
75     $self->{'handle'}=shift;
76    
77     my $vec='';
78     vec($vec,CORE::fileno($self->{'handle'}),1)=1;
79     $self->{'handleVec'}=$vec;
80    
81     my $timeout=shift;
82     ($timeout) && ($self->{'timeout'}=$timeout);
83    
84     return $self;
85     }
86    
87     sub newServer {
88     my($class,$port,$queueSize,$srcIP)=@_;
89    
90     ($port) || die("$class: port undefined!");
91    
92     $queueSize||=5;
93    
94     my $self=$class->new;
95    
96     my $localAdr=INADDR_ANY;
97     $localAdr=inet_aton($srcIP) if(defined($srcIP) && $srcIP ne '');
98    
99     my $local;
100     my $sockType=AF_INET;
101     my $proto=$Meteor::Socket::TCP_PROTO_NAME;
102    
103     $self->{'port'}=$port;
104     ($local=sockaddr_in($port,$localAdr))
105     || die("$class: sockaddr_in for port '$port' failed");
106    
107     $self->{'handle'}=$self->nextHandle();
108     $self->{'socketType'}=$sockType;
109    
110     socket($self->{'handle'},$sockType,SOCK_STREAM,$proto)
111     || die("$class socket: $!");
112    
113     setsockopt($self->{'handle'},SOL_SOCKET,SO_REUSEADDR,1);
114    
115     bind($self->{'handle'},$local)
116     || die("$class bind: $!");
117     listen($self->{'handle'},$queueSize)
118     || die("$class listen: $!");
119    
120     select((select($self->{'handle'}),$|=1)[0]);
121    
122     my $vec='';
123     vec($vec,CORE::fileno($self->{'handle'}),1)=1;
124     $self->{'handleVec'}=$vec;
125    
126     return $self;
127     }
128    
129 knops.gerd 48 sub newUDPServer {
130     my($class,$port,$srcIP)=@_;
131    
132     ($port) || die("$class: port undefined!");
133    
134     my $self=$class->new;
135    
136     my $localAdr=INADDR_ANY;
137     $localAdr=inet_aton($srcIP) if(defined($srcIP) && $srcIP ne '');
138    
139     my $local;
140     my $sockType=PF_INET;
141     my $proto=$Meteor::Socket::UDP_PROTO_NAME;
142    
143     $self->{'port'}=$port;
144     ($local=sockaddr_in($port,$localAdr))
145     || die("$class: sockaddr_in for port '$port' failed");
146    
147     $self->{'handle'}=$self->nextHandle();
148     $self->{'socketType'}=$sockType;
149    
150     socket($self->{'handle'},$sockType,SOCK_DGRAM,$proto)
151     || die("$class socket: $!");
152    
153     setsockopt($self->{'handle'},SOL_SOCKET,SO_REUSEADDR,pack("l", 1))
154     || die("setsockopt: $!");
155    
156     bind($self->{'handle'},$local)
157     || die("$class bind: $!");
158    
159     select((select($self->{'handle'}),$|=1)[0]);
160    
161     my $vec='';
162     vec($vec,CORE::fileno($self->{'handle'}),1)=1;
163     $self->{'handleVec'}=$vec;
164    
165     return $self;
166     }
167    
168 knops.gerd 11 ###############################################################################
169     # Instance methods
170     ###############################################################################
171     sub DESTROY {
172     my $self=shift;
173    
174     if(exists($self->{'handle'}))
175     {
176     warn("$self->DESTROY caught unclosed socket")
177     unless($Meteor::Socket::NO_WARN_ON_CLOSE);
178     $self->close();
179     }
180     }
181    
182     sub conSocket {
183     my $self=shift;
184    
185     my $handle=$self->nextHandle();
186    
187     my $paddr;
188     $paddr=&saccept($handle,$self->{'handle'}) || die($!);
189    
190     select((select($handle),$|=1)[0]);
191    
192     my $newSock=Meteor::Socket->newWithHandle($handle,20);
193     $newSock->{'socketType'}=$self->{'socketType'};
194     if($self->{'socketType'}==AF_INET)
195     {
196     my($port,$iaddr)=unpack_sockaddr_in($paddr);
197    
198     $newSock->{'connection'}->{'port'}=$port;
199     $newSock->{'connection'}->{'remoteIP'}=inet_ntoa($iaddr);
200     }
201    
202     return $newSock;
203     }
204    
205     sub setNonBlocking {
206     my $self=shift;
207    
208     my $flags=fcntl($self->{'handle'},F_GETFL,0)
209     or die("Can't get flags for the socket: $!");
210     fcntl($self->{'handle'},F_SETFL,$flags|O_NONBLOCK)
211     or die("Can't set flags for the socket: $!");
212     }
213    
214     sub close {
215     my $self=shift;
216    
217     if(exists($self->{'handle'}))
218     {
219     close($self->{'handle'});
220     delete($self->{'handle'});
221     }
222     }
223    
224     ###############################################################################
225     # Utility functions
226     ###############################################################################
227     sub nextHandle {
228     no strict 'refs';
229    
230     my $name='MSHandle'.$Meteor::Socket::handleNum++;
231     my $pack='Meteor::Socket::';
232     my $handle=\*{$pack.$name};
233     delete $$pack{$name};
234    
235     $handle;
236     }
237    
238     sub sselect {
239     my $result;
240     my $to=$_[3];
241     my $time=time;
242     while(1)
243     {
244     $result=CORE::select($_[0],$_[1],$_[2],$to);
245     if($result<0)
246     {
247     last unless(${!}==EINTR);
248     return 0 if($::HUP || $::TERM || $::USR1 || $::USR2);
249     my $tn=time;
250     $to-=($tn-$time);
251     $time=$tn;
252     $to=1 if($to<1);
253     }
254     else
255     {
256     last;
257     }
258     }
259    
260     $result;
261     }
262    
263     sub saccept {
264     my($dhandle,$shandle)=@_;
265    
266     my $result;
267     while(1)
268     {
269     $result=CORE::accept($dhandle,$shandle);
270     unless($result)
271     {
272     last unless(${!}==EINTR);
273     return 0 if($::HUP || $::TERM || $::USR1 || $::USR2);
274     }
275     else
276     {
277     last;
278     }
279     }
280    
281     $result;
282     }
283    
284     sub fileno {
285     CORE::fileno(shift->{'handle'});
286     }
287    
288     1;
289 andrew.betts 62 ############################################################################EOF

  ViewVC Help
Powered by ViewVC 1.1.26