1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
|
/* -*- C++ -*- */
// $Id$
// ===========================================================================
//
// = LIBRARY
// ace
//
// = FILENAME
// SOCK_Dgram.h
//
// = AUTHOR
// Doug Schmidt
//
// ===========================================================================
#if !defined (ACE_SOCK_DGRAM_H)
#define ACE_SOCK_DGRAM_H
#include "ace/SOCK.h"
#include "ace/Addr.h"
#if !defined (ACE_LACKS_PRAGMA_ONCE)
#pragma once
#endif /* ACE_LACKS_PRAGMA_ONCE */
class ACE_Export ACE_SOCK_Dgram : public ACE_SOCK
{
// = TITLE
// Defines the member functions for the ACE_SOCK datagram
// abstraction.
public:
// = Initialization routines.
ACE_SOCK_Dgram (void);
// Default constructor.
ACE_SOCK_Dgram (const ACE_Addr &local,
int protocol_family = PF_INET,
int protocol = 0,
int reuse_addr = 0);
// Initiate a socket dgram.
~ACE_SOCK_Dgram (void);
// Default dtor.
int open (const ACE_Addr &local,
int protocol_family = PF_INET,
int protocol = 0,
int reuse_addr = 0);
// Initiate a socket dgram.
// = Data transfer routines.
ssize_t send (const void *buf,
size_t n,
const ACE_Addr &addr,
int flags = 0) const;
// Send an <n> byte <buf> to the datagram socket (uses sendto(3)).
ssize_t recv (void *buf,
size_t n,
ACE_Addr &addr,
int flags = 0) const;
// Receive an <n> byte <buf> from the datagram socket (uses
// recvfrom(3)).
ssize_t recv (iovec *io_vec,
ACE_Addr &addr,
int flags = 0) const;
// Allows a client to read from a socket without having to provide a
// buffer to read. This method determines how much data is in the
// socket, allocates a buffer of this size, reads in the data, and
// returns the number of bytes read. The caller is responsible for
// deleting the member in the <iov_base> field of <io_vec> using the
// ``delete []'' syntax.
ssize_t send (const iovec iov[],
size_t n,
const ACE_Addr &addr,
int flags = 0) const;
// Send an <iovec> of size <n> to the datagram socket (uses
// sendmsg(3)).
ssize_t recv (iovec iov[],
size_t n,
ACE_Addr &addr,
int flags = 0) const;
// Recv an <iovec> of size <n> to the datagram socket (uses
// recvmsg(3)).
ssize_t recv (void *buf,
size_t n,
ACE_Addr &addr,
int flags,
const ACE_Time_Value *timeout) const;
// Wait up to <timeout> amount of time to receive a datagram into
// <buf>. The <ACE_Time_Value> indicates how long to blocking
// trying to receive. If <timeout> == 0, the caller will block
// until action is possible, else will wait until the relative time
// specified in *<timeout> elapses). If <recv> times out a -1 is
// returned with <errno == ETIME>. If it succeeds the number of
// bytes received is returned.
void dump (void) const;
// Dump the state of an object.
ACE_ALLOC_HOOK_DECLARE;
// Declare the dynamic allocation hooks.
protected:
int shared_open (const ACE_Addr &local,
int protocol_family);
// Open is shared by this and by <LSOCK_Dgram>.
private:
int get_remote_addr (ACE_Addr &) const;
// Do not allow this function to percolate up to this interface...
};
#if !defined (ACE_LACKS_INLINE_FUNCTIONS)
#include "ace/SOCK_Dgram.i"
#endif
#endif /* ACE_SOCK_DGRAM_H */
|
