1
# IVLE - Informatics Virtual Learning Environment
2
# Copyright (C) 2007-2008 The University of Melbourne
4
# This program is free software; you can redistribute it and/or modify
5
# it under the terms of the GNU General Public License as published by
6
# the Free Software Foundation; either version 2 of the License, or
7
# (at your option) any later version.
9
# This program is distributed in the hope that it will be useful,
10
# but WITHOUT ANY WARRANTY; without even the implied warranty of
11
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12
# GNU General Public License for more details.
14
# You should have received a copy of the GNU General Public License
15
# along with this program; if not, write to the Free Software
16
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
19
# Author: Thomas Conway
33
class Terminate(Exception):
34
"""Exception thrown when server is to be shut down. It will attempt to
35
send the final_response to the client and then exits"""
36
def __init__(self, final_response=None):
37
self.final_response = final_response
40
return repr(self.final_response)
42
class ProtocolError(Exception):
43
"""Exception thrown when client violates the the chat protocol"""
46
def start_server(port, magic, daemon_mode, handler, initializer = None):
47
# Attempt to open the socket.
48
s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
52
# Excellent! It worked. Let's turn ourself into a daemon,
53
# then get on with the job of being a python interpreter.
55
if os.fork(): # launch child and...
56
os._exit(0) # kill off parent
58
if os.fork(): # launch child and...
59
os._exit(0) # kill off parent again.
63
MAXFD = os.sysconf("SC_OPEN_MAX")
67
# Close all file descriptors, except the socket.
68
for i in xrange(MAXFD):
76
si = os.open(os.devnull, os.O_RDONLY)
77
os.dup2(si, sys.stdin.fileno())
79
so = os.open(os.devnull, os.O_WRONLY)
80
os.dup2(so, sys.stdout.fileno())
82
se = os.open(os.devnull, os.O_WRONLY)
83
os.dup2(se, sys.stderr.fileno())
89
(conn, addr) = s.accept()
90
conn.settimeout(SOCKETTIMEOUT)
93
inp = recv_netstring(conn)
94
env = cjson.decode(inp)
96
# Check that the message is
97
digest = hashlib.md5(env['content'] + magic).hexdigest()
98
if env['digest'] != digest:
102
content = cjson.decode(env['content'])
104
response = handler(content)
106
send_netstring(conn, cjson.encode(response))
111
# Try and send final response and then terminate
113
send_netstring(conn, cjson.encode(t.final_response))
117
# Make a JSON object full of exceptional goodness
118
tb_dump = cStringIO.StringIO()
119
e_type, e_val, e_tb = sys.exc_info()
120
traceback.print_tb(e_tb, file=tb_dump)
122
"type": e_type.__name__,
124
"traceback": tb_dump.getvalue()
126
send_netstring(conn, cjson.encode(json_exc))
130
def chat(host, port, msg, magic, decode = True):
131
sok = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
132
sok.connect((host, port))
133
sok.settimeout(SOCKETTIMEOUT)
134
content = cjson.encode(msg)
135
digest = hashlib.md5(content + magic).hexdigest()
136
env = {'digest':digest,'content':content}
137
json = cjson.encode(env)
139
send_netstring(sok, json)
140
inp = recv_netstring(sok)
145
return cjson.decode(inp)
150
def send_netstring(sok, data):
151
netstring = "%d:%s,"%(len(data),data)
152
sok.sendall(netstring)
155
def recv_netstring(sok):
160
# Limit the Netstring to less than 10^10 bytes (~1GB).
161
if len(size_buffer) >= 10:
163
"Could not read Netstring size in first 9 bytes: '%s'"%(
164
''.join(size_buffer)))
165
size_buffer.append(c)
168
# Message should be length plus ',' terminator
169
recv_expected = int(''.join(size_buffer)) + 1
170
except ValueError, e:
171
raise ProtocolError("Could not decode Netstring size as int: '%s'"%(
172
''.join(size_buffer)))
176
recv_data = sok.recv(min(recv_expected, BLOCKSIZE))
177
recv_size = len(recv_data)
178
while recv_size < recv_expected:
179
buf.append(recv_data)
180
recv_data = sok.recv(min(recv_expected-recv_size, 1024))
181
recv_size = recv_size + len(recv_data)
182
assert(recv_size == recv_expected)
184
# Did we receive the correct amount?
185
if recv_data[-1] != ',':
186
raise ProtocolError("Netstring did not end with ','")
187
buf.append(recv_data[:-1])