src/Network/Address.hh
author terom
Wed, 17 Dec 2008 00:44:46 +0000
changeset 382 190f81d30624
parent 381 src/Network/SockAddr.hh@9b35bc329d23
child 383 2a57f0a871b0
permissions -rw-r--r--
rename files: Address -> Endpoint, SockAddr -> Address
382
190f81d30624 rename files: Address -> Endpoint, SockAddr -> Address
terom
parents: 381
diff changeset
     1
#ifndef NETWORK_ADDRESS_H
190f81d30624 rename files: Address -> Endpoint, SockAddr -> Address
terom
parents: 381
diff changeset
     2
#define NETWORK_ADDRESS_H
381
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
     3
382
190f81d30624 rename files: Address -> Endpoint, SockAddr -> Address
terom
parents: 381
diff changeset
     4
#include "Endpoint.hh"
381
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
     5
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
     6
/*
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
     7
 * Platform-specific includes
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
     8
 */
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
     9
#ifndef WIN32
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    10
    // linux
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    11
    #include <netinet/in.h>
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    12
#else
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    13
    #error "This network code won't compile on win32 :)"
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    14
#endif
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    15
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    16
/**
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    17
 * This represents a `struct sockaddr` as used by the socket API.
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    18
 *
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    19
 * It can be used like a NetworkEndpoint, but it's also suitable for use with recvfrom/sendto
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    20
 */
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    21
class NetworkAddress : public NetworkEndpoint {
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    22
    protected:
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    23
        /**
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    24
         * The machine-readable address
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    25
         */
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    26
        sockaddr_storage address;
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    27
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    28
        /**
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    29
         * The address length
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    30
         */
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    31
        socklen_t address_length;
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    32
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    33
    public:
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    34
        /**
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    35
         * Construct an empty SockAddr for later update()
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    36
         */
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    37
        NetworkAddress (void);
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    38
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    39
        /**
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    40
         * Construct a NetworkAddress from a machine-readable address of the given length
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    41
         */
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    42
        NetworkAddress (const sockaddr *addr, socklen_t len);
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    43
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    44
        /**
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    45
         * Get a const sockaddr* in this address
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    46
         *
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    47
         * @return read-only sockaddr pointer
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    48
         */
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    49
        const sockaddr* get_sockaddr (void) const { return (const sockaddr *) &address; }
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    50
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    51
        /**
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    52
         * Get a mutable sockaddr* in this address
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    53
         *
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    54
         * @return writeable sockaddr pointer
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    55
         */
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    56
        sockaddr* get_sockaddr (void) { return (sockaddr *) &address; }
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    57
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    58
        /**
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    59
         * Get the current address length
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    60
         *
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    61
         * @return address length
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    62
         */
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    63
        socklen_t get_socklen (void) const { return address_length; }
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    64
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    65
        /**
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    66
         * Get a the address length pointer, initialized to the size of our sockaddr_storage.
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    67
         *
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    68
         * @return address length pointer
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    69
         */
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    70
        socklen_t* get_socklen_ptr (void) { address_length = sizeof(address); return &address_length; }
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    71
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    72
        /**
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    73
         * Copy given sockaddr/len + update
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    74
         */
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    75
        void set_sockaddr (const sockaddr *addr, socklen_t len);
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    76
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    77
        /**
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    78
         * Update internal state for NetworkAddress after sockaddr/socklen_ptr have been modified.
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    79
         */
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    80
        void update (void);
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    81
        
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    82
        /**
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    83
         * Returns a "fake" addrinfo
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    84
         */
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    85
        virtual addrinfo* get_addrinfo (int family, int socktype, int protocol = 0, int flags = 0) const;
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    86
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    87
        /**
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    88
         * Free an addrinfo returned by get_addrinfo
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    89
         */
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    90
        virtual void free_addrinfo (addrinfo *info) const;
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    91
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    92
        /**
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    93
         * Equal-to comparison operator. Invalid addresses compare equal and are always smaller
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    94
         */
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    95
        bool operator== (const NetworkAddress &other) const {
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    96
            return (address_length == other.address_length) && memcmp(&address, &other.address, address_length) == 0;
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    97
        }
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    98
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
    99
        /**
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
   100
         * Not-equal-to comparison operator. Invalid addresses compare equal and are always smaller
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
   101
         */
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
   102
        bool operator!= (const NetworkAddress &other) const {
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
   103
            return (address_length != other.address_length) || memcmp(&address, &other.address, address_length) != 0;
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
   104
        }
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
   105
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
   106
        /**
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
   107
         * Less-than comparison operator. Smaller addresses are always lesser.
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
   108
         */
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
   109
        bool operator< (const NetworkAddress &other) const {
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
   110
            return (address_length < other.address_length) || memcmp(&address, &other.address, other.address_length) < 0;
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
   111
        }
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
   112
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
   113
        /**
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
   114
         * Greater-than comparison operator. Bigger addresses are always greater.
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
   115
         */
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
   116
        bool operator> (const NetworkAddress &other) const {
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
   117
            return (address_length > other.address_length) || memcmp(&address, &other.address, address_length) > 0;
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
   118
        }
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
   119
};
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
   120
9b35bc329d23 separate sockaddr stuff out of NetworkAddress... now called NetworkEndpoint
terom
parents:
diff changeset
   121
#endif