TCP/TCPListener.m
author jim@Baldrick.local
Tue May 05 23:24:50 2009 -0700 (2009-05-05)
changeset 43 aab592ac36fc
parent 26 cb9cdf247239
child 44 d8a559a39284
permissions -rwxr-xr-x
bug fixes and improvements to new bonjour classes and tcplistener, also added a static library target
jens@0
     1
//
jens@0
     2
//  TCPListener.m
jens@0
     3
//  MYNetwork
jens@0
     4
//
jens@0
     5
//  Created by Jens Alfke on 5/10/08.
jens@0
     6
//  Copyright 2008 Jens Alfke. All rights reserved.
jens@0
     7
//  Portions based on TCPServer class from Apple's "CocoaEcho" sample code.
jens@0
     8
jens@0
     9
#import "TCPListener.h"
jens@0
    10
#import "TCPConnection.h"
jens@0
    11
jens@1
    12
#import "Logging.h"
jens@1
    13
#import "Test.h"
jens@0
    14
#import "ExceptionUtils.h"
jens@0
    15
#import "IPAddress.h"
jens@1
    16
jens@0
    17
#include <sys/socket.h>
jens@0
    18
#include <netinet/in.h>
jens@0
    19
#include <unistd.h>
jens@0
    20
jens@0
    21
jens@0
    22
static void TCPListenerAcceptCallBack(CFSocketRef socket, CFSocketCallBackType type, 
jens@0
    23
                                      CFDataRef address, const void *data, void *info);
jens@0
    24
jens@0
    25
@interface TCPListener()
jens@22
    26
- (void) _openBonjour;
jim@43
    27
- (void) _publishBonjour;
jens@22
    28
- (void) _closeBonjour;
jens@0
    29
@property BOOL bonjourPublished;
jens@0
    30
@property NSInteger bonjourError;
jens@0
    31
- (void) _updateTXTRecord;
jens@0
    32
@end
jens@0
    33
jens@0
    34
jens@0
    35
@implementation TCPListener
jens@0
    36
jens@0
    37
jens@0
    38
- (id) initWithPort: (UInt16)port
jens@0
    39
{
jens@0
    40
    self = [super init];
jens@0
    41
    if (self != nil) {
jens@0
    42
        _port = port;
jens@0
    43
    }
jens@0
    44
    return self;
jens@0
    45
}
jens@0
    46
jens@0
    47
jens@0
    48
- (void) dealloc 
jens@0
    49
{
jens@0
    50
    [self close];
jens@0
    51
    LogTo(TCP,@"DEALLOC %@",self);
jens@0
    52
    [super dealloc];
jens@0
    53
}
jens@0
    54
jens@0
    55
jens@0
    56
@synthesize delegate=_delegate, port=_port, useIPv6=_useIPv6,
jens@22
    57
            bonjourServiceType=_bonjourServiceType,
jens@0
    58
            bonjourPublished=_bonjourPublished, bonjourError=_bonjourError,
jens@22
    59
            bonjourService=_netService,
jens@0
    60
            pickAvailablePort=_pickAvailablePort;
jens@0
    61
jens@0
    62
jens@0
    63
- (NSString*) description
jens@0
    64
{
jens@0
    65
    return $sprintf(@"%@[port %hu]",self.class,_port);
jens@0
    66
}
jens@0
    67
jens@0
    68
jens@22
    69
// Stores the last error from CFSocketCreate or CFSocketSetAddress into *outError.
jens@0
    70
static void* getLastCFSocketError( NSError **outError ) {
jens@0
    71
    if( outError )
jens@0
    72
        *outError = [NSError errorWithDomain: NSPOSIXErrorDomain code: errno userInfo: nil];
jens@0
    73
    return NULL;
jens@0
    74
}
jens@0
    75
jens@0
    76
// Closes a socket (if it's not already NULL), and returns NULL to assign to it.
jens@0
    77
static CFSocketRef closeSocket( CFSocketRef socket ) {
jens@0
    78
    if( socket ) {
jens@0
    79
        CFSocketInvalidate(socket);
jens@0
    80
        CFRelease(socket);
jens@0
    81
    }
jens@0
    82
    return NULL;
jens@0
    83
}
jens@0
    84
jens@0
    85
// opens a socket of a given protocol, either ipv4 or ipv6.
jens@0
    86
- (CFSocketRef) _openProtocol: (SInt32) protocolFamily 
jens@0
    87
                      address: (struct sockaddr*)address
jens@0
    88
                        error: (NSError**)error
jens@0
    89
{
jens@0
    90
    CFSocketContext socketCtxt = {0, self, NULL, NULL, NULL};
jens@0
    91
    CFSocketRef socket = CFSocketCreate(kCFAllocatorDefault, PF_INET, SOCK_STREAM, IPPROTO_TCP,
jens@0
    92
                                        kCFSocketAcceptCallBack, &TCPListenerAcceptCallBack, &socketCtxt);
jens@0
    93
    if( ! socket ) 
jens@0
    94
        return getLastCFSocketError(error);   // CFSocketCreate leaves error code in errno
jens@0
    95
    
jens@0
    96
    int yes = 1;
jens@0
    97
    setsockopt(CFSocketGetNative(socket), SOL_SOCKET, SO_REUSEADDR, (void *)&yes, sizeof(yes));
jens@0
    98
    
jens@0
    99
    NSData *addressData = [NSData dataWithBytes:address length:address->sa_len];
jens@0
   100
    if (kCFSocketSuccess != CFSocketSetAddress(socket, (CFDataRef)addressData)) {
jens@0
   101
        getLastCFSocketError(error);
jens@0
   102
        return closeSocket(socket);
jens@0
   103
    }
jens@0
   104
    // set up the run loop source for the socket
jens@0
   105
    CFRunLoopRef cfrl = CFRunLoopGetCurrent();
jens@0
   106
    CFRunLoopSourceRef source = CFSocketCreateRunLoopSource(kCFAllocatorDefault, socket, 0);
jens@0
   107
    CFRunLoopAddSource(cfrl, source, kCFRunLoopCommonModes);
jens@0
   108
    CFRelease(source);
jens@0
   109
    return socket;
jens@0
   110
}
jens@0
   111
jens@0
   112
- (BOOL) _failedToOpen: (NSError*)error
jens@0
   113
{
jens@0
   114
    LogTo(TCP,@"%@ failed to open: %@",self,error);
jens@0
   115
    [self tellDelegate: @selector(listener:failedToOpen:) withObject: error];
jens@0
   116
    return NO;
jens@0
   117
}
jens@0
   118
jens@0
   119
jens@0
   120
- (BOOL) open: (NSError**)outError 
jens@0
   121
{
jens@0
   122
    // set up the IPv4 endpoint; if port is 0, this will cause the kernel to choose a port for us
jens@0
   123
    do{
jens@0
   124
        struct sockaddr_in addr4;
jens@0
   125
        memset(&addr4, 0, sizeof(addr4));
jens@0
   126
        addr4.sin_len = sizeof(addr4);
jens@0
   127
        addr4.sin_family = AF_INET;
jens@0
   128
        addr4.sin_port = htons(_port);
jens@0
   129
        addr4.sin_addr.s_addr = htonl(INADDR_ANY);
jens@0
   130
jens@0
   131
        NSError *error;
jens@0
   132
        _ipv4socket = [self _openProtocol: PF_INET address: (struct sockaddr*)&addr4 error: &error];
jens@0
   133
        if( ! _ipv4socket ) {
jens@0
   134
            if( error.code==EADDRINUSE && _pickAvailablePort && _port<0xFFFF ) {
jens@0
   135
                LogTo(BLIPVerbose,@"%@: port busy, trying %hu...",self,_port+1);
jens@8
   136
                self.port += 1;        // try the next port
jens@0
   137
            } else {
jens@0
   138
                if( outError ) *outError = error;
jens@0
   139
                return [self _failedToOpen: error];
jens@0
   140
            }
jens@0
   141
        }
jens@0
   142
    }while( ! _ipv4socket );
jens@0
   143
    
jens@0
   144
    if (0 == _port) {
jens@0
   145
        // now that the binding was successful, we get the port number 
jens@0
   146
        NSData *addr = [(NSData *)CFSocketCopyAddress(_ipv4socket) autorelease];
jens@0
   147
        const struct sockaddr_in *addr4 = addr.bytes;
jens@0
   148
        self.port = ntohs(addr4->sin_port);
jens@0
   149
    }
jens@0
   150
    
jens@0
   151
    if( _useIPv6 ) {
jens@0
   152
        // set up the IPv6 endpoint
jens@0
   153
        struct sockaddr_in6 addr6;
jens@0
   154
        memset(&addr6, 0, sizeof(addr6));
jens@0
   155
        addr6.sin6_len = sizeof(addr6);
jens@0
   156
        addr6.sin6_family = AF_INET6;
jens@0
   157
        addr6.sin6_port = htons(_port);
jens@0
   158
        memcpy(&(addr6.sin6_addr), &in6addr_any, sizeof(addr6.sin6_addr));
jens@0
   159
        
jens@26
   160
        NSError *error;
jens@26
   161
        _ipv6socket = [self _openProtocol: PF_INET6 address: (struct sockaddr*)&addr6 error: &error];
jens@0
   162
        if( ! _ipv6socket ) {
jens@0
   163
            _ipv4socket = closeSocket(_ipv4socket);
jens@26
   164
            [self _failedToOpen: error];
jens@26
   165
            if (outError) *outError = error;
jens@26
   166
            return NO;
jens@0
   167
        }
jens@0
   168
    }
jens@0
   169
    
jens@22
   170
    [self _openBonjour];
jens@0
   171
jens@0
   172
    LogTo(TCP,@"%@ is open",self);
jens@0
   173
    [self tellDelegate: @selector(listenerDidOpen:) withObject: nil];
jens@0
   174
    return YES;
jens@0
   175
}
jens@0
   176
jens@0
   177
- (BOOL) open
jens@0
   178
{
jens@0
   179
    return [self open: nil];
jens@0
   180
}
jens@0
   181
    
jens@0
   182
jens@0
   183
- (void) close 
jens@0
   184
{
jens@0
   185
    if( _ipv4socket ) {
jens@22
   186
        [self _closeBonjour];
jens@0
   187
        _ipv4socket = closeSocket(_ipv4socket);
jens@0
   188
        _ipv6socket = closeSocket(_ipv6socket);
jens@0
   189
jens@0
   190
        LogTo(BLIP,@"%@ is closed",self);
jens@0
   191
        [self tellDelegate: @selector(listenerDidClose:) withObject: nil];
jens@0
   192
    }
jens@0
   193
}
jens@0
   194
jens@0
   195
jens@0
   196
- (BOOL) isOpen
jens@0
   197
{
jens@0
   198
    return _ipv4socket != NULL;
jens@0
   199
}
jens@0
   200
jens@0
   201
jens@0
   202
#pragma mark -
jens@0
   203
#pragma mark ACCEPTING CONNECTIONS:
jens@0
   204
jens@0
   205
jens@0
   206
@synthesize connectionClass = _connectionClass;
jens@0
   207
jens@0
   208
jens@0
   209
- (BOOL) acceptConnection: (CFSocketNativeHandle)socket
jens@0
   210
{
jens@0
   211
    IPAddress *addr = [IPAddress addressOfSocket: socket];
jens@0
   212
    if( ! addr )
jens@0
   213
        return NO;
jens@0
   214
    if( [_delegate respondsToSelector: @selector(listener:shouldAcceptConnectionFrom:)]
jens@0
   215
       && ! [_delegate listener: self shouldAcceptConnectionFrom: addr] )
jens@0
   216
        return NO;
jens@0
   217
    
jens@0
   218
    Assert(_connectionClass);
jens@0
   219
    TCPConnection *conn = [[self.connectionClass alloc] initIncomingFromSocket: socket
jens@0
   220
                                                                      listener: self];
jens@0
   221
    if( ! conn )
jens@0
   222
        return NO;
jens@0
   223
    
jens@0
   224
    if( _sslProperties ) {
jens@0
   225
        conn.SSLProperties = _sslProperties;
jens@0
   226
        [conn setSSLProperty: $true forKey: (id)kCFStreamSSLIsServer];
jens@0
   227
    }
jens@0
   228
    [conn open];
jens@0
   229
    [self tellDelegate: @selector(listener:didAcceptConnection:) withObject: conn];
jens@0
   230
    return YES;
jens@0
   231
}
jens@0
   232
jens@0
   233
jens@0
   234
static void TCPListenerAcceptCallBack(CFSocketRef socket, CFSocketCallBackType type, CFDataRef address, const void *data, void *info) 
jens@0
   235
{
jens@0
   236
    TCPListener *server = (TCPListener *)info;
jens@0
   237
    if (kCFSocketAcceptCallBack == type) { 
jens@0
   238
        CFSocketNativeHandle nativeSocketHandle = *(CFSocketNativeHandle *)data;
jens@0
   239
        BOOL accepted = NO;
jens@0
   240
        @try{
jens@0
   241
            accepted = [server acceptConnection: nativeSocketHandle];
jens@0
   242
        }catchAndReport(@"TCPListenerAcceptCallBack");
jens@0
   243
        if( ! accepted )
jens@0
   244
            close(nativeSocketHandle);
jens@0
   245
    }
jens@0
   246
}
jens@0
   247
jens@0
   248
jens@0
   249
#pragma mark -
jens@0
   250
#pragma mark BONJOUR:
jens@0
   251
jim@43
   252
// subclasses can override if they want to call publishWithOptions: instead of publish
jim@43
   253
- (void) _publishBonjour
jim@43
   254
{
jim@43
   255
	[_netService publish];
jim@43
   256
}
jens@0
   257
jens@22
   258
- (void) _openBonjour
jens@22
   259
{
jens@22
   260
    if( self.isOpen && _bonjourServiceType && !_netService) {
jens@22
   261
        // instantiate the NSNetService object that will advertise on our behalf.
jens@22
   262
        _netService = [[NSNetService alloc] initWithDomain: @"local." 
jens@22
   263
                                                      type: _bonjourServiceType
jens@22
   264
                                                      name: _bonjourServiceName ?:@""
jens@22
   265
                                                      port: _port];
jens@22
   266
        if( _netService ) {
jens@22
   267
            [_netService setDelegate:self];
jens@22
   268
            if( _bonjourTXTRecord )
jens@22
   269
                [self _updateTXTRecord];
jim@43
   270
			[self _publishBonjour];
jens@22
   271
        } else {
jens@22
   272
            self.bonjourError = -1;
jens@22
   273
            Warn(@"%@: Failed to create NSNetService",self);
jens@22
   274
        }
jens@22
   275
    }
jens@22
   276
}
jens@22
   277
jens@22
   278
- (void) _closeBonjour
jens@22
   279
{
jens@22
   280
    if( _netService ) {
jens@22
   281
        [_netService stop];
jens@22
   282
        [_netService release];
jens@22
   283
        _netService = nil;
jens@22
   284
        self.bonjourPublished = NO;
jens@22
   285
    }
jens@22
   286
    if( self.bonjourError )
jens@22
   287
        self.bonjourError = 0;
jens@22
   288
}
jens@22
   289
jens@22
   290
jens@22
   291
- (NSString*) bonjourServiceName {return _bonjourServiceName;}
jens@22
   292
jens@22
   293
- (void) setBonjourServiceName: (NSString*)name
jens@22
   294
{
jens@22
   295
    if( ! $equal(name,_bonjourServiceName) ) {
jens@22
   296
        [self _closeBonjour];
jens@22
   297
        setObj(&_bonjourServiceName,name);
jens@22
   298
        [self _openBonjour];
jens@22
   299
    }
jens@22
   300
}
jens@22
   301
jens@22
   302
jens@0
   303
- (NSDictionary*) bonjourTXTRecord
jens@0
   304
{
jens@0
   305
    return _bonjourTXTRecord;
jens@0
   306
}
jens@0
   307
jens@0
   308
- (void) setBonjourTXTRecord: (NSDictionary*)txt
jens@0
   309
{
jens@0
   310
    if( ifSetObj(&_bonjourTXTRecord,txt) )
jens@0
   311
        [self _updateTXTRecord];
jens@0
   312
}
jens@0
   313
jens@0
   314
- (void) _updateTXTRecord
jens@0
   315
{
jens@0
   316
    if( _netService ) {
jens@0
   317
        NSData *data;
jens@0
   318
        if( _bonjourTXTRecord ) {
jens@0
   319
            data = [NSNetService dataFromTXTRecordDictionary: _bonjourTXTRecord];
jens@0
   320
            if( data )
jens@0
   321
                LogTo(BLIP,@"%@: Set %u-byte TXT record", self,data.length);
jens@0
   322
            else
jens@0
   323
                Warn(@"TCPListener: Couldn't convert txt dict to data: %@",_bonjourTXTRecord);
jens@0
   324
        } else
jens@0
   325
            data = nil;
jens@0
   326
        [_netService setTXTRecordData: data];
jens@0
   327
    }
jens@0
   328
}
jens@0
   329
jens@0
   330
jim@43
   331
- (void)netServiceDidPublish:(NSNetService *)sender
jens@0
   332
{
jens@0
   333
    LogTo(BLIP,@"%@: Advertising %@",self,sender);
jens@0
   334
    self.bonjourPublished = YES;
jens@0
   335
}
jens@0
   336
jens@0
   337
- (void)netService:(NSNetService *)sender didNotPublish:(NSDictionary *)errorDict
jens@0
   338
{
jens@0
   339
    self.bonjourError = [[errorDict objectForKey:NSNetServicesErrorCode] intValue];
jens@0
   340
    LogTo(BLIP,@"%@: Failed to advertise %@: error %i",self,sender,self.bonjourError);
jens@0
   341
    [_netService release];
jens@0
   342
    _netService = nil;
jens@0
   343
}
jens@0
   344
jens@0
   345
- (void)netServiceDidStop:(NSNetService *)sender
jens@0
   346
{
jens@0
   347
    LogTo(BLIP,@"%@: Stopped advertising %@",self,sender);
jens@0
   348
    self.bonjourPublished = NO;
jens@0
   349
    [_netService release];
jens@0
   350
    _netService = nil;
jens@0
   351
}
jens@0
   352
jens@0
   353
jens@0
   354
@end
jens@0
   355
jens@0
   356
jens@0
   357
jens@0
   358
/*
jens@0
   359
 Copyright (c) 2008, Jens Alfke <jens@mooseyard.com>. All rights reserved.
jens@0
   360
 
jens@0
   361
 Redistribution and use in source and binary forms, with or without modification, are permitted
jens@0
   362
 provided that the following conditions are met:
jens@0
   363
 
jens@0
   364
 * Redistributions of source code must retain the above copyright notice, this list of conditions
jens@0
   365
 and the following disclaimer.
jens@0
   366
 * Redistributions in binary form must reproduce the above copyright notice, this list of conditions
jens@0
   367
 and the following disclaimer in the documentation and/or other materials provided with the
jens@0
   368
 distribution.
jens@0
   369
 
jens@0
   370
 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR
jens@0
   371
 IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND 
jens@0
   372
 FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRI-
jens@0
   373
 BUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
jens@0
   374
 (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 
jens@0
   375
  PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 
jens@0
   376
 CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF 
jens@0
   377
 THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
jens@0
   378
 */