ACE/ace/ICMP_Socket.h

   1 // -*- C++ -*-
   2
   3 //=============================================================================
   4 /**
   5  *  @file    ICMP_Socket.h
   6  *
   7  *  @author Robert S. Iakobashvili <coroberti@gmail.com> <coroberti@walla.co.il>
   8  *  @author Gonzalo A. Diethelm <gonzalo.diethelm@aditiva.com>
   9  */
  10 //=============================================================================
  11
  12 #ifndef ACE_ICMP_SOCKET_H
  13 #define ACE_ICMP_SOCKET_H
  14
  15 #include /**/ "ace/pre.h"
  16
  17 #include /**/ "ace/ACE_export.h"
  18
  19 #if !defined (ACE_LACKS_PRAGMA_ONCE)
  20 # pragma once
  21 #endif /* ACE_LACKS_PRAGMA_ONCE */
  22
  23 #if defined (ACE_HAS_ICMP_SUPPORT) && (ACE_HAS_ICMP_SUPPORT == 1)
  24
  25 #include "ace/SOCK.h"
  26 #include "ace/Time_Value.h"
  27 #include "ace/os_include/netinet/os_in.h"
  28
  29 ACE_BEGIN_VERSIONED_NAMESPACE_DECL
  30
  31 /**
  32  * @class ACE_ICMP_Socket
  33  *
  34  * @brief An abstract class that forms the basis for usage of the ICMP
  35  * protocol (that is, support for things such as ping).
  36  */
  37 class ACE_Export ACE_ICMP_Socket : public ACE_SOCK
  38 {
  39 public:
  40   /**
  41    * @name Data transfer routines.
  42    *
  43    * Data transfer routines.
  44    */
  45   //@{
  46
  47   /// Send an @a n byte @a buf to the datagram socket (uses
  48   /// @c sendto(3) ).
  49   ssize_t send (void const * buf,
  50                 size_t n,
  51                 ACE_Addr const & addr,
  52                 int flags = 0) const;
  53
  54   /// Receive an @a n byte @a buf from the datagram socket
  55   /// (uses @c recvfrom(3) ).
  56   ssize_t recv (void * buf,
  57                 size_t n,
  58                 ACE_Addr & addr,
  59                 int flags = 0) const;
  60
  61   /// TODO: comment
  62   ssize_t recv (void * buf,
  63                 size_t n,
  64                 int flags,
  65                 ACE_Time_Value const * timeout) const;
  66
  67   //@}
  68
  69   /// Wrapper around the BSD-style @c socket system call (no QoS).
  70   int open (ACE_Addr const & local = ACE_Addr::sap_any,
  71             int protocol = IPPROTO_ICMP,
  72             int reuse_addr = 0);
  73
  74   /// Dump the state of object.
  75   void dump (void) const;
  76
  77   /// Declare the dynamic allocation hooks.
  78   ACE_ALLOC_HOOK_DECLARE;
  79
  80 protected:
  81
  82   // Protected constructors, so the class can only be derived from.
  83
  84   /// Default constructor.
  85   ACE_ICMP_Socket (void);
  86
  87   /// Constructor that takes a local listening address.
  88   ACE_ICMP_Socket (ACE_Addr const & local,
  89                    int protocol = IPPROTO_ICMP,
  90                    int reuse_addr = 0);
  91
  92   /// Wrapper around BSD-style @c bind system call.
  93   int shared_open (ACE_Addr const & local);
  94
  95   /// Calculates check-sum.
  96   unsigned short calculate_checksum (unsigned short* paddress,
  97                                      int len);
  98 };
  99
 100 ACE_END_VERSIONED_NAMESPACE_DECL
 101
 102 #endif  /* ACE_HAS_ICMP_SUPPORT == 1 */
 103
 104 #include /**/ "ace/post.h"
 105
 106 #endif /* ACE_ICMP_SOCKET_H */