12
12
You should have received a copy of the GNU General Public License
13
13
along with this program; if not, write to the Free Software
14
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA */
14
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA */
17
* Virtual I/O layer, only used with TCP/IP sockets at the moment.
17
20
#ifndef PLUGIN_MYSQL_PROTOCOL_VIO_H
18
21
#define PLUGIN_MYSQL_PROTOCOL_VIO_H
20
23
#include <sys/socket.h>
23
namespace drizzle_plugin
27
*@brief Virtual I/O layer, only used with TCP/IP sockets at the moment.
34
* @param[in] sd Descriptor to use.
40
*Close the connection.
41
*@returns 0 on success.
46
* Read some data from the remote end.
47
*@param[out] buf A buffer to write the new data to.
48
*@param[in] size The size of the buffer
49
*@returns The number of bytes read.
51
size_t read(unsigned char* buf, size_t size);
54
* Write some data to the remote end.
55
*@param[in] buf A buffer that contains the data to send.
56
*@param[in] size The size of the buffer
57
*@returns The number of bytes written.
59
size_t write(const unsigned char* buf, size_t size);
62
* Set device blocking mode.
63
*@param[in] set_blocking_mode Whether the device should block. true sets blocking mode, false clears it.
64
*@param[out] old_mode This will be set to the previous blocking mode.
65
*@returns 0 on success.
67
int blocking(bool set_blocking_mode, bool *old_mode);
70
* Enables fast sending.
71
* Setting this sets the TCP_NODELAY socket option.
72
*@returns 0 on succcess.
77
* Sets or clears the keepalive option.
78
*@param[in] set_keep_alive Whether to set or clear the flag. True Sets keepalive, false clears it.
79
*@returns 0 on success.
81
int32_t keepalive(bool set_keep_alive);
84
*@returns true if the caller should retry the last operation.
86
bool should_retry() const;
89
*@returns true if the last operation was interrupted.
91
bool was_interrupted() const;
94
*Gets the address details of the peer.
95
@param[out] buf Buffer that will recieve the peer address.
96
@param[out] port Port of remote end.
97
@param[in] buflen Size of buf.
98
@returns True on success, false otherwise.
100
bool peer_addr(char *buf, uint16_t *port, size_t buflen) const;
103
* Sets either the send, or recieve timeouts for the socket.
104
*@param[in] is_sndtimeo Set to true to change the send timeout, false to change the recieve timeout.
105
*@param[in] timeout The new timeout to set, in seconds.
107
void timeout(bool is_sndtimeo, int32_t timeout);
110
* Returns the last error code.
111
*@returns the last error code, as described in errno.h
113
int get_errno() const;
116
* Get the underlying descriptor this class is using.
117
*@returns The descriptor passed in to the constructor of this class.
122
* Returns the current read position.
124
char *get_read_pos() const;
127
* Returns the current write position.
129
char *get_read_end() const;
26
typedef struct st_vio Vio;
134
32
int fcntl_mode; /* Buffered fcntl(sd,F_GETFL) */
135
33
struct sockaddr_storage local; /* Local internet address */
136
34
struct sockaddr_storage remote; /* Remote internet address */
35
int addrLen; /* Length of remote address */
137
36
char *read_pos; /* start of unfetched data in the read buffer */
138
37
char *read_end; /* end of unfetched data */
39
/* function pointers. They are similar for socket/SSL/whatever */
40
void (*viodelete)(Vio*);
41
int32_t (*vioerrno)(Vio*);
42
size_t (*read)(Vio*, unsigned char *, size_t);
43
size_t (*write)(Vio*, const unsigned char *, size_t);
44
int32_t (*vioblocking)(Vio*, bool, bool *);
45
int32_t (*viokeepalive)(Vio*, bool);
46
int32_t (*fastsend)(Vio*);
47
bool (*peer_addr)(Vio*, char *, uint16_t *, size_t);
48
void (*in_addr)(Vio*, struct sockaddr_storage*);
49
bool (*should_retry)(Vio*);
50
bool (*was_interrupted)(Vio*);
51
int32_t (*vioclose)(Vio*);
52
void (*timeout)(Vio*, bool is_sndtimeo, int32_t timeout);
142
} /* namespace drizzle_plugin */
55
Vio* mysql_protocol_vio_new(int sd);
57
#define vio_fd(vio) (vio)->sd
58
#define vio_delete(vio) (vio)->viodelete(vio)
59
#define vio_errno(vio) (vio)->vioerrno(vio)
60
#define vio_read(vio, buf, size) ((vio)->read)(vio,buf,size)
61
#define vio_write(vio, buf, size) ((vio)->write)(vio, buf, size)
62
#define vio_blocking(vio, set_blocking_mode, old_mode) (vio)->vioblocking(vio, set_blocking_mode, old_mode)
63
#define vio_fastsend(vio) (vio)->fastsend(vio)
64
#define vio_keepalive(vio, set_keep_alive) (vio)->viokeepalive(vio, set_keep_alive)
65
#define vio_should_retry(vio) (vio)->should_retry(vio)
66
#define vio_was_interrupted(vio) (vio)->was_interrupted(vio)
67
#define vio_close(vio) ((vio)->vioclose)(vio)
68
#define vio_peer_addr(vio, buf, prt, buflen) (vio)->peer_addr(vio, buf, prt, buflen)
69
#define vio_timeout(vio, which, seconds) (vio)->timeout(vio, which, seconds)
144
71
#endif /* PLUGIN_MYSQL_PROTOCOL_VIO_H */