SocketAddress.h

//
// $Id: SocketAddress.h,v 1.21 2007/03/08 19:59:21 will_mason Exp $
//
// vi: set ft=objc:

/*
 * ObjectiveLib - a library of containers and algorithms for Objective-C
 *
 * Copyright (c) 2004-2007
 * Will Mason
 *
 * Portions:
 *
 * Copyright (c) 1994
 * Hewlett-Packard Company
 *
 * Copyright (c) 1996,1997
 * Silicon Graphics Computer Systems, Inc.
 *
 * Copyright (c) 1997
 * Moscow Center for SPARC Technology
 *
 * Copyright (c) 1999 
 * Boris Fomitchev
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 *
 * You may contact the author at will_mason@users.sourceforge.net.
 */

#if !defined(SOCKETADDRESS_OL_GUARD)
#define SOCKETADDRESS_OL_GUARD

#include <ObjectiveLib/ObjectBase.h>
#if defined(OL_HAVE_INTTYPES_H)
#include <inttypes.h>
#else
#include <stdint.h>
#endif

@class OLText;
@class OLVector;
struct sockaddr;
struct sockaddr_in;
struct sockaddr_in6;
struct sockaddr_un;

@interface OLSocketAddress :
#if defined(OL_NO_OPENSTEP)
    Object
#else
    NSObject <NSCopying>
#endif
{
}

#if defined(OL_NO_OPENSTEP)

- (id) copy;
#else

- (id) copyWithZone: (NSZone*)zone;
#endif

- (OLText*) description;

- (unsigned) hash;

- (const struct sockaddr*) hostRepresentation;

- (unsigned) hostRepresentationLength;

@end

@interface OLInternetAddress : OLSocketAddress
{
@protected
    char*           canonicalName;

    int             socketType;
}

+ (OLInternetAddress*) addressWithCurrentHostAndPort: (uint16_t)port;

+ (OLInternetAddress*) addressWithCurrentHostAndService: (const char*)service;

+ (OLInternetAddress*) addressWithHost: (const char*)name port: (uint16_t)port;

+ (OLInternetAddress*) addressWithHost: (const char*)name service: (const char*)service;

+ (OLVector*) allAddressesWithHost: (const char*)name port: (uint16_t)port;
+ (OLVector*) allAddressesWithHost: (const char*)name service: (const char*)service;

#if defined(OL_NO_OPENSTEP)
+ (id) initialize;
#else
+ (void) initialize;
#endif

+ (OLInternetAddress*) loopbackWithPort: (uint16_t)port;

+ (OLInternetAddress*) loopbackWithService: (const char*)service;

+ (BOOL) preferIPv6Addresses;

+ (void) setPreferIPv6Addresses: (BOOL)state;

/* @{ */
#if defined(OL_NO_OPENSTEP)
- (id) free;
#else
- (void) dealloc;
#endif
/* @} */

- (const char*) canonicalName;

- (BOOL) isLocalWildcard;

- (uint16_t) port;

- (int) socketType;

@end

@interface OLInternet4Address : OLInternetAddress
{
@protected
    struct sockaddr_in* hostRep;
}

/* @{ */
- (id) init;

- (id) initWithPort: (uint16_t)port;
#if defined(OL_NO_OPENSTEP)
- (id) free;
#else
- (void) dealloc;
#endif
/* @} */

#if defined(OL_NO_OPENSTEP)
- (id) copy;
#else
- (id) copyWithZone: (NSZone*)zone;
#endif

- (OLText*) description;
- (const struct sockaddr*) hostRepresentation;
- (unsigned) hostRepresentationLength;

- (BOOL) isEqual: (id)object;
- (BOOL) isLocalWildcard;
- (uint16_t) port;

@end

#if defined(OL_HAVE_INET6_SOCKETS)

@interface OLInternet6Address : OLInternetAddress
{
@protected
    struct sockaddr_in6* hostRep;
}

/* @{ */
- (id) init;

- (id) initWithPort: (uint16_t)port;
#if defined(OL_NO_OPENSTEP)
- (id) free;
#else
- (void) dealloc;
#endif
/* @} */
#if defined(OL_NO_OPENSTEP)
- (id) copy;
#else
- (id) copyWithZone: (NSZone*)zone;
#endif

- (OLText*) description;
- (const struct sockaddr*) hostRepresentation;
- (unsigned) hostRepresentationLength;

- (BOOL) isEqual: (id)object;
- (BOOL) isLocalWildcard;
- (uint16_t) port;

@end

#endif

#if defined(OL_HAVE_UNIX_SOCKETS)

@interface OLUnixAddress : OLSocketAddress
{
@protected
    struct sockaddr_un* hostRep;
}

+ (id) addressWithPath: (const char*)pth;

/* @{ */
- (id) initWithPath: (const char*)pth;

#if defined(OL_NO_OPENSTEP)
- (id) free;
#else
- (void) dealloc;
#endif
/* @} */

#if defined(OL_NO_OPENSTEP)
- (id) copy;
#else
- (id) copyWithZone: (NSZone*)zone;
#endif

- (OLText*) description;
- (const struct sockaddr*) hostRepresentation;
- (unsigned) hostRepresentationLength;

- (BOOL) isEqual: (id)object;

- (const char*) path;

@end

#endif

#endif

---

Generated Sun Apr 22 15:12:39 2007, © 2004-2007 Will Mason