3 * Copyright (c) 2007 - 2008, Blue Static <http://www.bluestatic.org>
5 * This program is free software; you can redistribute it and/or modify it under the terms of the GNU
6 * General Public License as published by the Free Software Foundation; either version 2 of the
7 * License, or (at your option) any later version.
9 * This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without
10 * even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
11 * General Public License for more details.
13 * You should have received a copy of the GNU General Public License along with this program; if not,
14 * write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
17 #import "SocketWrapper.h"
18 #include <sys/types.h>
19 #include <sys/socket.h>
20 #include <netinet/in.h>
21 #include <arpa/inet.h>
24 @interface SocketWrapper (Private
)
26 - (void)error
:(NSString
*)msg
;
28 @property (copy
, readwrite
, getter
=remoteHost
, setter
=setHostname
:) NSString
*hostname
;
31 @implementation SocketWrapper
34 * Initializes the socket wrapper with a host and port
36 - (id)initWithConnection
:(DebuggerConnection
*)cnx
38 if (self = [super init
])
40 connection
= [cnx retain
];
41 port
= [connection port
];
57 * Close our socket and clean up anything else
65 * Returns the delegate
73 * Sets the delegate but does *not* retain it
75 - (void)setDelegate
:(id)aDelegate
83 * Connects to a socket on the port specified during init. This will dispatch another thread to do the
84 * actual waiting. Delegate notifications are posted along the way to let the client know what is going on.
88 [NSThread detachNewThreadSelector
:@selector(connect
:) toTarget
:self withObject
:nil];
92 * This does the actual dirty work (in a separate thread) of connecting to a socket
94 - (void)connect
:(id)obj
96 NSAutoreleasePool
*pool
= [[NSAutoreleasePool alloc
] init
];
98 // create an INET socket that we'll be listen()ing on
99 int socketOpen
= socket(PF_INET
, SOCK_STREAM
, 0);
101 // create our address given the port
102 struct sockaddr_in address
;
103 address.sin_family
= AF_INET
;
104 address.sin_port
= htons(port
);
105 address.sin_addr.s_addr
= htonl(INADDR_ANY
);
106 memset(address.sin_zero
, '\0', sizeof(address.sin_zero
));
108 // allow an already-opened socket to be reused
110 setsockopt(socketOpen
, SOL_SOCKET
, SO_REUSEADDR
, &yes
, sizeof(int));
112 // bind the socket... and don't give up until we've tried for a while
114 while (bind(socketOpen
, (struct sockaddr
*)&address
, sizeof(address
)) < 0)
119 [self error
:@
"Could not bind to socket"];
123 NSLog(@
"couldn't bind to the socket... trying again in 5");
128 // now we just have to keep our ears open
129 if (listen(socketOpen
, 0) == -1)
131 [self error
:@
"Could not use bound socket for listening"];
134 // accept a connection
135 struct sockaddr_in remoteAddress
;
136 socklen_t remoteAddressLen
= sizeof(remoteAddress
);
137 sock
= accept(socketOpen
, (struct sockaddr
*)&remoteAddress
, &remoteAddressLen
);
141 [self error
:@
"Client failed to accept remote socket"];
146 // we're done listening now that we have a connection
149 struct sockaddr_in addr
;
150 socklen_t addrLength
;
151 if (getpeername(sock
, (struct sockaddr
*)&addr
, &addrLength
) < 0)
153 [self error
:@
"Could not get remote hostname."];
155 char *name
= inet_ntoa(addr.sin_addr
);
156 [self setHostname
:[NSString stringWithUTF8String
:name
]];
158 [connection performSelectorOnMainThread
:@selector(socketDidAccept
:) withObject
:nil waitUntilDone
:NO
];
164 * Reads from the socket and returns the result as a NSString (because it's always going to be XML). Be aware
165 * that the underlying socket recv() call will *wait* for the server to send a message, so be sure that this
166 * is used either in a threaded environment so the interface does not hang, or when you *know* the server
167 * will return something (which we almost always do). Returns the data that was received from the socket.
169 - (NSString
*)receive
174 // do our initial recv() call to get (hopefully) all the data and the lengh of the packet
175 int recvd
= recv(sock
, &buffer
, sizeof(buffer
), 0);
177 // take the received data and put it into an NSData
178 NSMutableString
*str
= [NSMutableString string
];
180 // strip the length from the packet, and clear the null byte then add it to the NSData
181 char packetLength
[8];
182 memset(packetLength
, '\0', sizeof(packetLength
));
184 while (buffer
[i
] != '\0')
186 packetLength
[i
] = buffer
[i
];
190 // we also want the null byte, so move us up 1
193 // the total length of the full transmission
194 int length
= atoi(packetLength
);
196 // move the packet part of the received data into it's own char[]
197 char packet
[sizeof(buffer
)];
198 memset(packet
, '\0', sizeof(packet
));
199 memmove(packet
, &buffer
[i
], recvd
- i
);
201 // convert bytes to NSString
202 [str appendString
:[NSString stringWithCString
:packet length
:recvd
- i
]];
204 // check if we have a partial packet
205 if (length
+ i
> sizeof(buffer
))
207 while (recvd
< length
+ i
)
209 int latest
= recv(sock
, &buffer
, sizeof(buffer
), 0);
212 [self error
:@
"Socket closed or could not be read"];
215 [str appendString
:[NSString stringWithCString
:buffer length
:latest
]];
220 NSString
*tmp
= [str stringByTrimmingCharactersInSet
:[NSCharacterSet whitespaceAndNewlineCharacterSet
]]; // strip whitespace
221 tmp
= [tmp substringToIndex
:[tmp length
] - 1]; // don't want the null byte
223 NSAssert([tmp UTF8String
][[tmp length
] - 1] == '>', @
"-[SocketWrapper receive] buffer is incomplete");
229 * Sends a given NSString over the socket. Returns YES on complete submission.
231 - (BOOL)send
:(NSString
*)data
233 data
= [NSString stringWithFormat
:@
"%@\0", data
];
234 int sent
= send(sock
, [data UTF8String
], [data length
], 0);
237 [self error
:@
"Failed to write data to socket"];
240 if (sent
< [data length
])
242 // TODO - do we really need to worry about partial sends with the lenght of our commands?
243 NSLog(@
"FAIL: only partial packet was sent; sent %d bytes", sent
);
251 * Helper method that just calls -[DebuggerWindowController setError:] on the main thread
253 - (void)error
:(NSString
*)msg
255 [delegate performSelectorOnMainThread
:@selector(errorEncountered
:) withObject
:msg waitUntilDone
:NO
];