enum.h

Go to the documentation of this file.

/*
 * pdns.h
 *
 * PWLib library for ENUM lookup
 *
 * Portable Windows Library
 *
 * Copyright (C) 2004 Post Increment
 *
 * The contents of this file are subject to the Mozilla Public License
 * Version 1.0 (the "License"); you may not use this file except in
 * compliance with the License. You may obtain a copy of the License at
 * http://www.mozilla.org/MPL/
 *
 * Software distributed under the License is distributed on an "AS IS"
 * basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
 * the License for the specific language governing rights and limitations
 * under the License.
 *
 * The Original Code is Portable Windows Library.
 *
 * The Initial Developer of the Original Code is Post Increment
 *
 * Contributor(s): ______________________________________.
 *
 * $Log: enum.h,v $
 * Revision 1.6  2007/06/27 15:26:35  shorne
 * added Uniform Resource Name Resolver Discovery System (URN RDS) lookups
 *
 * Revision 1.5  2005/11/30 12:47:37  csoutheren
 * Removed tabs, reformatted some code, and changed tags for Doxygen
 *
 * Revision 1.4  2005/08/31 23:55:48  csoutheren
 * Fixed typo
 *
 * Revision 1.3  2005/08/31 05:55:03  shorne
 * Reworked ENUM to craigs' exacting requirements
 *
 * Revision 1.2  2005/08/31 04:07:52  shorne
 * added ability to set ENUM Servers at runtime
 *
 * Revision 1.1  2004/05/31 13:56:37  csoutheren
 * Added implementation of ENUM resolution of E.164 numbers by DNS
 *
 */

#if P_DNS

#ifndef _PENUM_H
#define _PENUM_H

#ifdef P_USE_PRAGMA
#pragma interface
#endif

#include <ptclib/pdns.h>

namespace PDNS {

#ifndef NAPTR_SRV
#define NAPTR_SRV 35
#endif


class NAPTRRecord : public PObject
{
  PCLASSINFO(NAPTRRecord, PObject);
  public:
    Comparison Compare(const PObject & obj) const;
    void PrintOn(ostream & strm) const;

    WORD order;
    WORD preference;
    PString flags;
    PString service;
    PString regex;
    PString replacement;
};

PDECLARE_SORTED_LIST(NAPTRRecordList, PDNS::NAPTRRecord)
  public:
    void PrintOn(ostream & strm) const;

    NAPTRRecord * GetFirst(const char * service = NULL);
    NAPTRRecord * GetNext(const char * service = NULL);

    PDNS::NAPTRRecord * HandleDNSRecord(PDNS_RECORD dnsRecord, PDNS_RECORD results);

    void UnlockOrder()
    { orderLocked = FALSE; }

  protected:
    PINDEX     currentPos;
    int        lastOrder;
    BOOL       orderLocked;
};

inline BOOL GetRecords(const PString & domain, NAPTRRecordList & recordList)
{ return Lookup<NAPTR_SRV, NAPTRRecordList, NAPTRRecord>(domain, recordList); }

void SetENUMServers(const PStringArray & serverlist);

BOOL ENUMLookup(
                const PString & dn,             
                const PString & service,        
                const PStringArray & domains,   
                PString & URL                   
);

BOOL ENUMLookup(const PString & dn,             
                const PString & service,        
                PString & URL                   
);   


/* Uniform Resource Name Resolver Discovery System URN RDS
   This can be used to Host URI domains on hosting servers.
    This implementation follows RFC 2915 sect 7.1 Example 2:
    Example
        Question: find h323:me@a.com by looking up mydomain.com
        Query the top most NAPTR record of mydomain.com for h323:me@a.com
          IN NAPTR 100   10   ""  ""  ^h323:(.+)@([a-z0-9\-\.]*);*(.*)$/\2.subs.mydomain.com/i 
           this converts a.com to a.com.subs.mydomain.com
        Query H323+D2U NAPTR record for a.com.subs.mydomain.com
      IN NAPTR 100  50  "s"  "H323+D2U"     ""  _h323ls._udp.host.com
    Query SRV records for host.com
          _h323ls._udp.host.com         172800          IN      SRV     0       0       1719    gk.host.com

        Answer: find h323:me@a.com by LRQ to gk.host.com:1719
*/

void SetRDSServers(const PStringArray & servers);

BOOL RDSLookup(const PURL & url,           
            const PString & service,       
                          PStringList & dn             
);

BOOL RDSLookup(const PURL & url,            
            const PString & service,        
       const PStringArray & naptrSpaces,    
              PStringList & returnStr       
);

}; // namespace PDNS

#endif // _PENUM_H
#endif // P_DNS

// End Of File ///////////////////////////////////////////////////////////////

---