]> git.saurik.com Git - wxWidgets.git/blob - src/common/socket.cpp
Some doc tweaks
[wxWidgets.git] / src / common / socket.cpp
1 /////////////////////////////////////////////////////////////////////////////
2 // Name: socket.cpp
3 // Purpose: Socket handler classes
4 // Authors: Guilhem Lavaux, Guillermo Rodriguez Garcia
5 // Created: April 1997
6 // Copyright: (C) 1999-1997, Guilhem Lavaux
7 // (C) 2000-1999, Guillermo Rodriguez Garcia
8 // RCS_ID: $Id$
9 // License: see wxWindows license
10 /////////////////////////////////////////////////////////////////////////////
11
12 // ==========================================================================
13 // Declarations
14 // ==========================================================================
15
16 #ifdef __GNUG__
17 #pragma implementation "socket.h"
18 #endif
19
20 // For compilers that support precompilation, includes "wx.h".
21 #include "wx/wxprec.h"
22
23 #ifdef __BORLANDC__
24 #pragma hdrstop
25 #endif
26
27 #if wxUSE_SOCKETS
28
29 #include "wx/app.h"
30 #include "wx/defs.h"
31 #include "wx/object.h"
32 #include "wx/string.h"
33 #include "wx/timer.h"
34 #include "wx/utils.h"
35 #include "wx/module.h"
36 #include "wx/log.h"
37 #include "wx/intl.h"
38 #include "wx/event.h"
39
40 #if wxUSE_GUI
41 #include "wx/gdicmn.h" // for wxPendingDelete
42 #endif // wxUSE_GUI
43
44 #include "wx/sckaddr.h"
45 #include "wx/socket.h"
46
47 // --------------------------------------------------------------------------
48 // macros and constants
49 // --------------------------------------------------------------------------
50
51 // discard buffer
52 #define MAX_DISCARD_SIZE (10 * 1024)
53
54 // what to do within waits: in wxBase we don't do anything as we don't have
55 // the event loop anyhow (for now). In GUI apps we have 2 cases: from the main
56 // thread itself we have to call wxYield() to let the events (including the
57 // GUI events and the low-level (not wxWindows) events from GSocket) be
58 // processed. From another thread it is enough to just call wxThread::Yield()
59 // which will give away the rest of our time slice: the explanation is that
60 // the events will be processed by the main thread anyhow, without calling
61 // wxYield(), but we don't want to eat the CPU time uselessly while sitting
62 // in the loop waiting for the data
63 #if wxUSE_GUI
64 #if wxUSE_THREADS
65 #define PROCESS_EVENTS() \
66 { \
67 if ( wxThread::IsMain() ) \
68 wxYield(); \
69 else \
70 wxThread::Yield(); \
71 }
72 #else // !wxUSE_THREADS
73 #define PROCESS_EVENTS() wxYield()
74 #endif // wxUSE_THREADS/!wxUSE_THREADS
75 #else // !wxUSE_GUI
76 #define PROCESS_EVENTS()
77 #endif // wxUSE_GUI/!wxUSE_GUI
78
79 // --------------------------------------------------------------------------
80 // wxWin macros
81 // --------------------------------------------------------------------------
82
83 IMPLEMENT_CLASS(wxSocketBase, wxObject)
84 IMPLEMENT_CLASS(wxSocketServer, wxSocketBase)
85 IMPLEMENT_CLASS(wxSocketClient, wxSocketBase)
86 IMPLEMENT_CLASS(wxDatagramSocket, wxSocketBase)
87 IMPLEMENT_DYNAMIC_CLASS(wxSocketEvent, wxEvent)
88
89 // --------------------------------------------------------------------------
90 // private classes
91 // --------------------------------------------------------------------------
92
93 class wxSocketState : public wxObject
94 {
95 public:
96 wxSocketFlags m_flags;
97 wxSocketEventFlags m_eventmask;
98 bool m_notify;
99 void *m_clientData;
100 #if WXWIN_COMPATIBILITY
101 wxSocketBase::wxSockCbk m_cbk;
102 char *m_cdata;
103 #endif // WXWIN_COMPATIBILITY
104
105 public:
106 wxSocketState() : wxObject() {}
107 };
108
109 // ==========================================================================
110 // wxSocketBase
111 // ==========================================================================
112
113 // --------------------------------------------------------------------------
114 // Ctor and dtor
115 // --------------------------------------------------------------------------
116
117 void wxSocketBase::Init()
118 {
119 m_socket = NULL;
120 m_type = wxSOCKET_UNINIT;
121
122 // state
123 m_flags = 0;
124 m_connected =
125 m_establishing =
126 m_reading =
127 m_writing =
128 m_error = FALSE;
129 m_lcount = 0;
130 m_timeout = 600;
131 m_beingDeleted = FALSE;
132
133 // pushback buffer
134 m_unread = NULL;
135 m_unrd_size = 0;
136 m_unrd_cur = 0;
137
138 // events
139 m_id = -1;
140 m_handler = NULL;
141 m_clientData = NULL;
142 m_notify = FALSE;
143 m_eventmask = 0;
144 #if WXWIN_COMPATIBILITY
145 m_cbk = NULL;
146 m_cdata = NULL;
147 #endif // WXWIN_COMPATIBILITY
148 }
149
150 wxSocketBase::wxSocketBase()
151 {
152 Init();
153 }
154
155 wxSocketBase::wxSocketBase(wxSocketFlags flags, wxSocketType type)
156 {
157 Init();
158
159 m_flags = flags;
160 m_type = type;
161 }
162
163 wxSocketBase::~wxSocketBase()
164 {
165 // Just in case the app called Destroy() *and* then deleted
166 // the socket immediately: don't leave dangling pointers.
167 #if wxUSE_GUI
168 wxPendingDelete.DeleteObject(this);
169 #endif
170
171 // Shutdown and close the socket
172 if (!m_beingDeleted)
173 Close();
174
175 // Destroy the GSocket object
176 if (m_socket)
177 GSocket_destroy(m_socket);
178
179 // Free the pushback buffer
180 if (m_unread)
181 free(m_unread);
182 }
183
184 bool wxSocketBase::Destroy()
185 {
186 // Delayed destruction: the socket will be deleted during the next
187 // idle loop iteration. This ensures that all pending events have
188 // been processed.
189 m_beingDeleted = TRUE;
190
191 // Shutdown and close the socket
192 Close();
193
194 // Supress events from now on
195 Notify(FALSE);
196
197 #if wxUSE_GUI
198 if ( !wxPendingDelete.Member(this) )
199 wxPendingDelete.Append(this);
200 #else
201 delete this;
202 #endif
203
204 return TRUE;
205 }
206
207 // --------------------------------------------------------------------------
208 // Basic IO calls
209 // --------------------------------------------------------------------------
210
211 // The following IO operations update m_error and m_lcount:
212 // {Read, Write, ReadMsg, WriteMsg, Peek, Unread, Discard}
213 //
214 // TODO: Should Connect, Accept and AcceptWith update m_error?
215
216 bool wxSocketBase::Close()
217 {
218 // Interrupt pending waits
219 InterruptWait();
220
221 if (m_socket)
222 {
223 // Disable callbacks
224 GSocket_UnsetCallback(m_socket, GSOCK_INPUT_FLAG | GSOCK_OUTPUT_FLAG |
225 GSOCK_LOST_FLAG | GSOCK_CONNECTION_FLAG);
226
227 // Shutdown the connection
228 GSocket_Shutdown(m_socket);
229 }
230
231 m_connected = FALSE;
232 m_establishing = FALSE;
233 return TRUE;
234 }
235
236 wxSocketBase& wxSocketBase::Read(void* buffer, wxUint32 nbytes)
237 {
238 // Mask read events
239 m_reading = TRUE;
240
241 m_lcount = _Read(buffer, nbytes);
242
243 // If in wxSOCKET_WAITALL mode, all bytes should have been read.
244 if (m_flags & wxSOCKET_WAITALL)
245 m_error = (m_lcount != nbytes);
246 else
247 m_error = (m_lcount == 0);
248
249 // Allow read events from now on
250 m_reading = FALSE;
251
252 return *this;
253 }
254
255 wxUint32 wxSocketBase::_Read(void* buffer, wxUint32 nbytes)
256 {
257 int total;
258 int ret = 1;
259
260 // Try the pushback buffer first
261 total = GetPushback(buffer, nbytes, FALSE);
262 nbytes -= total;
263 buffer = (char *)buffer + total;
264
265 // Return now in one of the following cases:
266 // - the socket is invalid,
267 // - we got all the data,
268 // - we got *some* data and we are not using wxSOCKET_WAITALL.
269 if ( !m_socket ||
270 !nbytes ||
271 ((total != 0) && !(m_flags & wxSOCKET_WAITALL)) )
272 return total;
273
274 // Possible combinations (they are checked in this order)
275 // wxSOCKET_NOWAIT
276 // wxSOCKET_WAITALL (with or without wxSOCKET_BLOCK)
277 // wxSOCKET_BLOCK
278 // wxSOCKET_NONE
279 //
280 if (m_flags & wxSOCKET_NOWAIT)
281 {
282 GSocket_SetNonBlocking(m_socket, 1);
283 ret = GSocket_Read(m_socket, (char *)buffer, nbytes);
284 GSocket_SetNonBlocking(m_socket, 0);
285
286 if (ret > 0)
287 total += ret;
288 }
289 else
290 {
291 bool more = TRUE;
292
293 while (more)
294 {
295 if ( !(m_flags & wxSOCKET_BLOCK) && !WaitForRead() )
296 break;
297
298 ret = GSocket_Read(m_socket, (char *)buffer, nbytes);
299
300 if (ret > 0)
301 {
302 total += ret;
303 nbytes -= ret;
304 buffer = (char *)buffer + ret;
305 }
306
307 // If we got here and wxSOCKET_WAITALL is not set, we can leave
308 // now. Otherwise, wait until we recv all the data or until there
309 // is an error.
310 //
311 more = (ret > 0 && nbytes > 0 && (m_flags & wxSOCKET_WAITALL));
312 }
313 }
314
315 return total;
316 }
317
318 wxSocketBase& wxSocketBase::ReadMsg(void* buffer, wxUint32 nbytes)
319 {
320 wxUint32 len, len2, sig, total;
321 bool error;
322 int old_flags;
323 struct
324 {
325 unsigned char sig[4];
326 unsigned char len[4];
327 } msg;
328
329 // Mask read events
330 m_reading = TRUE;
331
332 total = 0;
333 error = TRUE;
334 old_flags = m_flags;
335 SetFlags((m_flags & wxSOCKET_BLOCK) | wxSOCKET_WAITALL);
336
337 if (_Read(&msg, sizeof(msg)) != sizeof(msg))
338 goto exit;
339
340 sig = (wxUint32)msg.sig[0];
341 sig |= (wxUint32)(msg.sig[1] << 8);
342 sig |= (wxUint32)(msg.sig[2] << 16);
343 sig |= (wxUint32)(msg.sig[3] << 24);
344
345 if (sig != 0xfeeddead)
346 {
347 wxLogWarning(_("wxSocket: invalid signature in ReadMsg."));
348 goto exit;
349 }
350
351 len = (wxUint32)msg.len[0];
352 len |= (wxUint32)(msg.len[1] << 8);
353 len |= (wxUint32)(msg.len[2] << 16);
354 len |= (wxUint32)(msg.len[3] << 24);
355
356 if (len > nbytes)
357 {
358 len2 = len - nbytes;
359 len = nbytes;
360 }
361 else
362 len2 = 0;
363
364 // Don't attemp to read if the msg was zero bytes long.
365 if (len)
366 {
367 total = _Read(buffer, len);
368
369 if (total != len)
370 goto exit;
371 }
372 if (len2)
373 {
374 char *discard_buffer = new char[MAX_DISCARD_SIZE];
375 long discard_len;
376
377 // NOTE: discarded bytes don't add to m_lcount.
378 do
379 {
380 discard_len = ((len2 > MAX_DISCARD_SIZE)? MAX_DISCARD_SIZE : len2);
381 discard_len = _Read(discard_buffer, (wxUint32)discard_len);
382 len2 -= (wxUint32)discard_len;
383 }
384 while ((discard_len > 0) && len2);
385
386 delete [] discard_buffer;
387
388 if (len2 != 0)
389 goto exit;
390 }
391 if (_Read(&msg, sizeof(msg)) != sizeof(msg))
392 goto exit;
393
394 sig = (wxUint32)msg.sig[0];
395 sig |= (wxUint32)(msg.sig[1] << 8);
396 sig |= (wxUint32)(msg.sig[2] << 16);
397 sig |= (wxUint32)(msg.sig[3] << 24);
398
399 if (sig != 0xdeadfeed)
400 {
401 wxLogWarning(_("wxSocket: invalid signature in ReadMsg."));
402 goto exit;
403 }
404
405 // everything was OK
406 error = FALSE;
407
408 exit:
409 m_error = error;
410 m_lcount = total;
411 m_reading = FALSE;
412 SetFlags(old_flags);
413
414 return *this;
415 }
416
417 wxSocketBase& wxSocketBase::Peek(void* buffer, wxUint32 nbytes)
418 {
419 // Mask read events
420 m_reading = TRUE;
421
422 m_lcount = _Read(buffer, nbytes);
423 Pushback(buffer, m_lcount);
424
425 // If in wxSOCKET_WAITALL mode, all bytes should have been read.
426 if (m_flags & wxSOCKET_WAITALL)
427 m_error = (m_lcount != nbytes);
428 else
429 m_error = (m_lcount == 0);
430
431 // Allow read events again
432 m_reading = FALSE;
433
434 return *this;
435 }
436
437 wxSocketBase& wxSocketBase::Write(const void *buffer, wxUint32 nbytes)
438 {
439 // Mask write events
440 m_writing = TRUE;
441
442 m_lcount = _Write(buffer, nbytes);
443
444 // If in wxSOCKET_WAITALL mode, all bytes should have been written.
445 if (m_flags & wxSOCKET_WAITALL)
446 m_error = (m_lcount != nbytes);
447 else
448 m_error = (m_lcount == 0);
449
450 // Allow write events again
451 m_writing = FALSE;
452
453 return *this;
454 }
455
456 wxUint32 wxSocketBase::_Write(const void *buffer, wxUint32 nbytes)
457 {
458 wxUint32 total = 0;
459 int ret = 1;
460
461 // If the socket is invalid or parameters are ill, return immediately
462 if (!m_socket || !buffer || !nbytes)
463 return 0;
464
465 // Possible combinations (they are checked in this order)
466 // wxSOCKET_NOWAIT
467 // wxSOCKET_WAITALL (with or without wxSOCKET_BLOCK)
468 // wxSOCKET_BLOCK
469 // wxSOCKET_NONE
470 //
471 if (m_flags & wxSOCKET_NOWAIT)
472 {
473 GSocket_SetNonBlocking(m_socket, 1);
474 ret = GSocket_Write(m_socket, (const char *)buffer, nbytes);
475 GSocket_SetNonBlocking(m_socket, 0);
476
477 if (ret > 0)
478 total = ret;
479 }
480 else
481 {
482 bool more = TRUE;
483
484 while (more)
485 {
486 if ( !(m_flags & wxSOCKET_BLOCK) && !WaitForWrite() )
487 break;
488
489 ret = GSocket_Write(m_socket, (const char *)buffer, nbytes);
490
491 if (ret > 0)
492 {
493 total += ret;
494 nbytes -= ret;
495 buffer = (const char *)buffer + ret;
496 }
497
498 // If we got here and wxSOCKET_WAITALL is not set, we can leave
499 // now. Otherwise, wait until we send all the data or until there
500 // is an error.
501 //
502 more = (ret > 0 && nbytes > 0 && (m_flags & wxSOCKET_WAITALL));
503 }
504 }
505
506 return total;
507 }
508
509 wxSocketBase& wxSocketBase::WriteMsg(const void *buffer, wxUint32 nbytes)
510 {
511 wxUint32 total;
512 bool error;
513 int old_flags;
514 struct
515 {
516 unsigned char sig[4];
517 unsigned char len[4];
518 } msg;
519
520 // Mask write events
521 m_writing = TRUE;
522
523 error = TRUE;
524 total = 0;
525 old_flags = m_flags;
526 SetFlags((m_flags & wxSOCKET_BLOCK) | wxSOCKET_WAITALL);
527
528 msg.sig[0] = (unsigned char) 0xad;
529 msg.sig[1] = (unsigned char) 0xde;
530 msg.sig[2] = (unsigned char) 0xed;
531 msg.sig[3] = (unsigned char) 0xfe;
532
533 msg.len[0] = (unsigned char) (nbytes & 0xff);
534 msg.len[1] = (unsigned char) ((nbytes >> 8) & 0xff);
535 msg.len[2] = (unsigned char) ((nbytes >> 16) & 0xff);
536 msg.len[3] = (unsigned char) ((nbytes >> 24) & 0xff);
537
538 if (_Write(&msg, sizeof(msg)) < sizeof(msg))
539 goto exit;
540
541 total = _Write(buffer, nbytes);
542
543 if (total < nbytes)
544 goto exit;
545
546 msg.sig[0] = (unsigned char) 0xed;
547 msg.sig[1] = (unsigned char) 0xfe;
548 msg.sig[2] = (unsigned char) 0xad;
549 msg.sig[3] = (unsigned char) 0xde;
550 msg.len[0] = msg.len[1] = msg.len[2] = msg.len[3] = (char) 0;
551
552 if ((_Write(&msg, sizeof(msg))) < sizeof(msg))
553 goto exit;
554
555 // everything was OK
556 error = FALSE;
557
558 exit:
559 m_error = error;
560 m_lcount = total;
561 m_writing = FALSE;
562
563 return *this;
564 }
565
566 wxSocketBase& wxSocketBase::Unread(const void *buffer, wxUint32 nbytes)
567 {
568 if (nbytes != 0)
569 Pushback(buffer, nbytes);
570
571 m_error = FALSE;
572 m_lcount = nbytes;
573
574 return *this;
575 }
576
577 wxSocketBase& wxSocketBase::Discard()
578 {
579 int old_flags;
580 char *buffer = new char[MAX_DISCARD_SIZE];
581 wxUint32 ret;
582 wxUint32 total = 0;
583
584 // Mask read events
585 m_reading = TRUE;
586
587 old_flags = m_flags;
588 SetFlags(wxSOCKET_NOWAIT);
589
590 do
591 {
592 ret = _Read(buffer, MAX_DISCARD_SIZE);
593 total += ret;
594 }
595 while (ret == MAX_DISCARD_SIZE);
596
597 delete[] buffer;
598 m_lcount = total;
599 m_error = FALSE;
600
601 // Allow read events again
602 m_reading = FALSE;
603
604 return *this;
605 }
606
607 // --------------------------------------------------------------------------
608 // Wait functions
609 // --------------------------------------------------------------------------
610
611 // All Wait functions poll the socket using GSocket_Select() to
612 // check for the specified combination of conditions, until one
613 // of these conditions become true, an error occurs, or the
614 // timeout elapses. The polling loop calls PROCESS_EVENTS(), so
615 // this won't block the GUI.
616
617 bool wxSocketBase::_Wait(long seconds,
618 long milliseconds,
619 wxSocketEventFlags flags)
620 {
621 GSocketEventFlags result;
622 long timeout;
623
624 // Set this to TRUE to interrupt ongoing waits
625 m_interrupt = FALSE;
626
627 // Check for valid socket
628 if (!m_socket)
629 return FALSE;
630
631 // Check for valid timeout value.
632 if (seconds != -1)
633 timeout = seconds * 1000 + milliseconds;
634 else
635 timeout = m_timeout * 1000;
636
637 // Wait in an active polling loop.
638 //
639 // NOTE: We duplicate some of the code in OnRequest, but this doesn't
640 // hurt. It has to be here because the (GSocket) event might arrive
641 // a bit delayed, and it has to be in OnRequest as well because we
642 // don't know whether the Wait functions are being used.
643 //
644 // Do this at least once (important if timeout == 0, when
645 // we are just polling). Also, if just polling, do not yield.
646
647 wxStopWatch chrono;
648 bool done = FALSE;
649
650 while (!done)
651 {
652 result = GSocket_Select(m_socket, flags | GSOCK_LOST_FLAG);
653
654 // Incoming connection (server) or connection established (client)
655 if (result & GSOCK_CONNECTION_FLAG)
656 {
657 m_connected = TRUE;
658 m_establishing = FALSE;
659 return TRUE;
660 }
661
662 // Data available or output buffer ready
663 if ((result & GSOCK_INPUT_FLAG) || (result & GSOCK_OUTPUT_FLAG))
664 {
665 return TRUE;
666 }
667
668 // Connection lost
669 if (result & GSOCK_LOST_FLAG)
670 {
671 m_connected = FALSE;
672 m_establishing = FALSE;
673 return (flags & GSOCK_LOST_FLAG) != 0;
674 }
675
676 // Wait more?
677 if ((!timeout) || (chrono.Time() > timeout) || (m_interrupt))
678 done = TRUE;
679 else
680 PROCESS_EVENTS();
681 }
682
683 return FALSE;
684 }
685
686 bool wxSocketBase::Wait(long seconds, long milliseconds)
687 {
688 return _Wait(seconds, milliseconds, GSOCK_INPUT_FLAG |
689 GSOCK_OUTPUT_FLAG |
690 GSOCK_CONNECTION_FLAG |
691 GSOCK_LOST_FLAG);
692 }
693
694 bool wxSocketBase::WaitForRead(long seconds, long milliseconds)
695 {
696 // Check pushback buffer before entering _Wait
697 if (m_unread)
698 return TRUE;
699
700 // Note that GSOCK_INPUT_LOST has to be explicitly passed to
701 // _Wait becuase of the semantics of WaitForRead: a return
702 // value of TRUE means that a GSocket_Read call will return
703 // immediately, not that there is actually data to read.
704
705 return _Wait(seconds, milliseconds, GSOCK_INPUT_FLAG |
706 GSOCK_LOST_FLAG);
707 }
708
709 bool wxSocketBase::WaitForWrite(long seconds, long milliseconds)
710 {
711 return _Wait(seconds, milliseconds, GSOCK_OUTPUT_FLAG);
712 }
713
714 bool wxSocketBase::WaitForLost(long seconds, long milliseconds)
715 {
716 return _Wait(seconds, milliseconds, GSOCK_LOST_FLAG);
717 }
718
719 // --------------------------------------------------------------------------
720 // Miscellaneous
721 // --------------------------------------------------------------------------
722
723 //
724 // Get local or peer address
725 //
726
727 bool wxSocketBase::GetPeer(wxSockAddress& addr_man) const
728 {
729 GAddress *peer;
730
731 if (!m_socket)
732 return FALSE;
733
734 peer = GSocket_GetPeer(m_socket);
735 addr_man.SetAddress(peer);
736 GAddress_destroy(peer);
737
738 return TRUE;
739 }
740
741 bool wxSocketBase::GetLocal(wxSockAddress& addr_man) const
742 {
743 GAddress *local;
744
745 if (!m_socket)
746 return FALSE;
747
748 local = GSocket_GetLocal(m_socket);
749 addr_man.SetAddress(local);
750 GAddress_destroy(local);
751
752 return TRUE;
753 }
754
755 //
756 // Save and restore socket state
757 //
758
759 void wxSocketBase::SaveState()
760 {
761 wxSocketState *state;
762
763 state = new wxSocketState();
764
765 state->m_flags = m_flags;
766 state->m_notify = m_notify;
767 state->m_eventmask = m_eventmask;
768 state->m_clientData = m_clientData;
769 #if WXWIN_COMPATIBILITY
770 state->m_cbk = m_cbk;
771 state->m_cdata = m_cdata;
772 #endif // WXWIN_COMPATIBILITY
773
774 m_states.Append(state);
775 }
776
777 void wxSocketBase::RestoreState()
778 {
779 wxNode *node;
780 wxSocketState *state;
781
782 node = m_states.Last();
783 if (!node)
784 return;
785
786 state = (wxSocketState *)node->Data();
787
788 m_flags = state->m_flags;
789 m_notify = state->m_notify;
790 m_eventmask = state->m_eventmask;
791 m_clientData = state->m_clientData;
792 #if WXWIN_COMPATIBILITY
793 m_cbk = state->m_cbk;
794 m_cdata = state->m_cdata;
795 #endif // WXWIN_COMPATIBILITY
796
797 delete node;
798 delete state;
799 }
800
801 //
802 // Timeout and flags
803 //
804
805 void wxSocketBase::SetTimeout(long seconds)
806 {
807 m_timeout = seconds;
808
809 if (m_socket)
810 GSocket_SetTimeout(m_socket, m_timeout * 1000);
811 }
812
813 void wxSocketBase::SetFlags(wxSocketFlags flags)
814 {
815 m_flags = flags;
816 }
817
818
819 // --------------------------------------------------------------------------
820 // Callbacks (now obsolete - use events instead)
821 // --------------------------------------------------------------------------
822
823 #if WXWIN_COMPATIBILITY
824
825 wxSocketBase::wxSockCbk wxSocketBase::Callback(wxSockCbk cbk_)
826 {
827 wxSockCbk old_cbk = cbk_;
828
829 m_cbk = cbk_;
830 return old_cbk;
831 }
832
833 char *wxSocketBase::CallbackData(char *data)
834 {
835 char *old_data = m_cdata;
836
837 m_cdata = data;
838 return old_data;
839 }
840
841 #endif // WXWIN_COMPATIBILITY
842
843 // --------------------------------------------------------------------------
844 // Event handling
845 // --------------------------------------------------------------------------
846
847 // A note on how events are processed, which is probably the most
848 // difficult thing to get working right while keeping the same API
849 // and functionality for all platforms.
850 //
851 // When GSocket detects an event, it calls wx_socket_callback, which in
852 // turn just calls wxSocketBase::OnRequest in the corresponding wxSocket
853 // object. OnRequest does some housekeeping, and if the event is to be
854 // propagated to the user, it creates a new wxSocketEvent object and
855 // posts it. The event is not processed immediately, but delayed with
856 // AddPendingEvent instead. This is necessary in order to decouple the
857 // event processing from wx_socket_callback; otherwise, subsequent IO
858 // calls made from the user event handler would fail, as gtk callbacks
859 // are not reentrant.
860 //
861 // Note that, unlike events, user callbacks (now deprecated) are _not_
862 // decoupled from wx_socket_callback and thus they suffer from a variety
863 // of problems. Avoid them where possible and use events instead.
864
865 extern "C"
866 void LINKAGEMODE wx_socket_callback(GSocket * WXUNUSED(socket),
867 GSocketEvent notification,
868 char *cdata)
869 {
870 wxSocketBase *sckobj = (wxSocketBase *)cdata;
871
872 sckobj->OnRequest((wxSocketNotify) notification);
873 }
874
875 void wxSocketBase::OnRequest(wxSocketNotify notification)
876 {
877 // NOTE: We duplicate some of the code in _Wait, but this doesn't
878 // hurt. It has to be here because the (GSocket) event might arrive
879 // a bit delayed, and it has to be in _Wait as well because we don't
880 // know whether the Wait functions are being used.
881
882 switch(notification)
883 {
884 case wxSOCKET_CONNECTION:
885 m_establishing = FALSE;
886 m_connected = TRUE;
887 break;
888
889 // If we are in the middle of a R/W operation, do not
890 // propagate events to users. Also, filter 'late' events
891 // which are no longer valid.
892
893 case wxSOCKET_INPUT:
894 if (m_reading || !GSocket_Select(m_socket, GSOCK_INPUT_FLAG))
895 return;
896 break;
897
898 case wxSOCKET_OUTPUT:
899 if (m_writing || !GSocket_Select(m_socket, GSOCK_OUTPUT_FLAG))
900 return;
901 break;
902
903 case wxSOCKET_LOST:
904 m_connected = FALSE;
905 m_establishing = FALSE;
906 break;
907
908 default:
909 break;
910 }
911
912 // Schedule the event
913
914 wxSocketEventFlags flag = 0;
915 switch (notification)
916 {
917 case GSOCK_INPUT: flag = GSOCK_INPUT_FLAG; break;
918 case GSOCK_OUTPUT: flag = GSOCK_OUTPUT_FLAG; break;
919 case GSOCK_CONNECTION: flag = GSOCK_CONNECTION_FLAG; break;
920 case GSOCK_LOST: flag = GSOCK_LOST_FLAG; break;
921 default:
922 wxLogWarning(_("wxSocket: unknown event!."));
923 return;
924 }
925
926 if (((m_eventmask & flag) == flag) && m_notify)
927 {
928 if (m_handler)
929 {
930 wxSocketEvent event(m_id);
931 event.m_event = notification;
932 event.m_clientData = m_clientData;
933 event.SetEventObject(this);
934
935 m_handler->AddPendingEvent(event);
936 }
937
938 #if WXWIN_COMPATIBILITY
939 if (m_cbk)
940 m_cbk(*this, notification, m_cdata);
941 #endif // WXWIN_COMPATIBILITY
942 }
943 }
944
945 void wxSocketBase::Notify(bool notify)
946 {
947 m_notify = notify;
948 }
949
950 void wxSocketBase::SetNotify(wxSocketEventFlags flags)
951 {
952 m_eventmask = flags;
953 }
954
955 void wxSocketBase::SetEventHandler(wxEvtHandler& handler, int id)
956 {
957 m_handler = &handler;
958 m_id = id;
959 }
960
961 // --------------------------------------------------------------------------
962 // Pushback buffer
963 // --------------------------------------------------------------------------
964
965 void wxSocketBase::Pushback(const void *buffer, wxUint32 size)
966 {
967 if (!size) return;
968
969 if (m_unread == NULL)
970 m_unread = malloc(size);
971 else
972 {
973 void *tmp;
974
975 tmp = malloc(m_unrd_size + size);
976 memcpy((char *)tmp + size, m_unread, m_unrd_size);
977 free(m_unread);
978
979 m_unread = tmp;
980 }
981
982 m_unrd_size += size;
983
984 memcpy(m_unread, buffer, size);
985 }
986
987 wxUint32 wxSocketBase::GetPushback(void *buffer, wxUint32 size, bool peek)
988 {
989 if (!m_unrd_size)
990 return 0;
991
992 if (size > (m_unrd_size-m_unrd_cur))
993 size = m_unrd_size-m_unrd_cur;
994
995 memcpy(buffer, (char *)m_unread + m_unrd_cur, size);
996
997 if (!peek)
998 {
999 m_unrd_cur += size;
1000 if (m_unrd_size == m_unrd_cur)
1001 {
1002 free(m_unread);
1003 m_unread = NULL;
1004 m_unrd_size = 0;
1005 m_unrd_cur = 0;
1006 }
1007 }
1008
1009 return size;
1010 }
1011
1012
1013 // ==========================================================================
1014 // wxSocketServer
1015 // ==========================================================================
1016
1017 // --------------------------------------------------------------------------
1018 // Ctor
1019 // --------------------------------------------------------------------------
1020
1021 wxSocketServer::wxSocketServer(wxSockAddress& addr_man,
1022 wxSocketFlags flags)
1023 : wxSocketBase(flags, wxSOCKET_SERVER)
1024 {
1025 // Create the socket
1026 m_socket = GSocket_new();
1027
1028 if (!m_socket)
1029 return;
1030
1031 // Setup the socket as server
1032 GSocket_SetLocal(m_socket, addr_man.GetAddress());
1033 if (GSocket_SetServer(m_socket) != GSOCK_NOERROR)
1034 {
1035 GSocket_destroy(m_socket);
1036 m_socket = NULL;
1037 return;
1038 }
1039
1040 GSocket_SetTimeout(m_socket, m_timeout * 1000);
1041 GSocket_SetCallback(m_socket, GSOCK_INPUT_FLAG | GSOCK_OUTPUT_FLAG |
1042 GSOCK_LOST_FLAG | GSOCK_CONNECTION_FLAG,
1043 wx_socket_callback, (char *)this);
1044
1045 }
1046
1047 // --------------------------------------------------------------------------
1048 // Accept
1049 // --------------------------------------------------------------------------
1050
1051 bool wxSocketServer::AcceptWith(wxSocketBase& sock, bool wait)
1052 {
1053 GSocket *child_socket;
1054
1055 if (!m_socket)
1056 return FALSE;
1057
1058 // If wait == FALSE, then the call should be nonblocking.
1059 // When we are finished, we put the socket to blocking mode
1060 // again.
1061
1062 if (!wait)
1063 GSocket_SetNonBlocking(m_socket, 1);
1064
1065 child_socket = GSocket_WaitConnection(m_socket);
1066
1067 if (!wait)
1068 GSocket_SetNonBlocking(m_socket, 0);
1069
1070 if (!child_socket)
1071 return FALSE;
1072
1073 sock.m_type = wxSOCKET_BASE;
1074 sock.m_socket = child_socket;
1075 sock.m_connected = TRUE;
1076
1077 GSocket_SetTimeout(sock.m_socket, sock.m_timeout * 1000);
1078 GSocket_SetCallback(sock.m_socket, GSOCK_INPUT_FLAG | GSOCK_OUTPUT_FLAG |
1079 GSOCK_LOST_FLAG | GSOCK_CONNECTION_FLAG,
1080 wx_socket_callback, (char *)&sock);
1081
1082 return TRUE;
1083 }
1084
1085 wxSocketBase *wxSocketServer::Accept(bool wait)
1086 {
1087 wxSocketBase* sock = new wxSocketBase();
1088
1089 sock->SetFlags(m_flags);
1090
1091 if (!AcceptWith(*sock, wait))
1092 {
1093 sock->Destroy();
1094 sock = NULL;
1095 }
1096
1097 return sock;
1098 }
1099
1100 bool wxSocketServer::WaitForAccept(long seconds, long milliseconds)
1101 {
1102 return _Wait(seconds, milliseconds, GSOCK_CONNECTION_FLAG);
1103 }
1104
1105 // ==========================================================================
1106 // wxSocketClient
1107 // ==========================================================================
1108
1109 // --------------------------------------------------------------------------
1110 // Ctor and dtor
1111 // --------------------------------------------------------------------------
1112
1113 wxSocketClient::wxSocketClient(wxSocketFlags flags)
1114 : wxSocketBase(flags, wxSOCKET_CLIENT)
1115 {
1116 }
1117
1118 wxSocketClient::~wxSocketClient()
1119 {
1120 }
1121
1122 // --------------------------------------------------------------------------
1123 // Connect
1124 // --------------------------------------------------------------------------
1125
1126 bool wxSocketClient::Connect(wxSockAddress& addr_man, bool wait)
1127 {
1128 GSocketError err;
1129
1130 if (m_socket)
1131 {
1132 // Shutdown and destroy the socket
1133 Close();
1134 GSocket_destroy(m_socket);
1135 }
1136
1137 m_socket = GSocket_new();
1138 m_connected = FALSE;
1139 m_establishing = FALSE;
1140
1141 if (!m_socket)
1142 return FALSE;
1143
1144 GSocket_SetTimeout(m_socket, m_timeout * 1000);
1145 GSocket_SetCallback(m_socket, GSOCK_INPUT_FLAG | GSOCK_OUTPUT_FLAG |
1146 GSOCK_LOST_FLAG | GSOCK_CONNECTION_FLAG,
1147 wx_socket_callback, (char *)this);
1148
1149 // If wait == FALSE, then the call should be nonblocking.
1150 // When we are finished, we put the socket to blocking mode
1151 // again.
1152
1153 if (!wait)
1154 GSocket_SetNonBlocking(m_socket, 1);
1155
1156 GSocket_SetPeer(m_socket, addr_man.GetAddress());
1157 err = GSocket_Connect(m_socket, GSOCK_STREAMED);
1158
1159 if (!wait)
1160 GSocket_SetNonBlocking(m_socket, 0);
1161
1162 if (err != GSOCK_NOERROR)
1163 {
1164 if (err == GSOCK_WOULDBLOCK)
1165 m_establishing = TRUE;
1166
1167 return FALSE;
1168 }
1169
1170 m_connected = TRUE;
1171 return TRUE;
1172 }
1173
1174 bool wxSocketClient::WaitOnConnect(long seconds, long milliseconds)
1175 {
1176 if (m_connected) // Already connected
1177 return TRUE;
1178
1179 if (!m_establishing || !m_socket) // No connection in progress
1180 return FALSE;
1181
1182 return _Wait(seconds, milliseconds, GSOCK_CONNECTION_FLAG |
1183 GSOCK_LOST_FLAG);
1184 }
1185
1186 // ==========================================================================
1187 // wxDatagramSocket
1188 // ==========================================================================
1189
1190 /* NOTE: experimental stuff - might change */
1191
1192 wxDatagramSocket::wxDatagramSocket( wxSockAddress& addr,
1193 wxSocketFlags flags )
1194 : wxSocketBase( flags, wxSOCKET_DATAGRAM )
1195 {
1196 // Create the socket
1197 m_socket = GSocket_new();
1198
1199 if(!m_socket)
1200 return;
1201
1202 // Setup the socket as non connection oriented
1203 GSocket_SetLocal(m_socket, addr.GetAddress());
1204 if( GSocket_SetNonOriented(m_socket) != GSOCK_NOERROR )
1205 {
1206 GSocket_destroy(m_socket);
1207 m_socket = NULL;
1208 return;
1209 }
1210
1211 // Initialize all stuff
1212 m_connected = FALSE;
1213 m_establishing = FALSE;
1214 GSocket_SetTimeout( m_socket, m_timeout );
1215 GSocket_SetCallback( m_socket, GSOCK_INPUT_FLAG | GSOCK_OUTPUT_FLAG |
1216 GSOCK_LOST_FLAG | GSOCK_CONNECTION_FLAG,
1217 wx_socket_callback, (char*)this );
1218
1219 }
1220
1221 wxDatagramSocket& wxDatagramSocket::RecvFrom( wxSockAddress& addr,
1222 void* buf,
1223 wxUint32 nBytes )
1224 {
1225 Read(buf, nBytes);
1226 GetPeer(addr);
1227 return (*this);
1228 }
1229
1230 wxDatagramSocket& wxDatagramSocket::SendTo( wxSockAddress& addr,
1231 const void* buf,
1232 wxUint32 nBytes )
1233 {
1234 GSocket_SetPeer(m_socket, addr.GetAddress());
1235 Write(buf, nBytes);
1236 return (*this);
1237 }
1238
1239 // ==========================================================================
1240 // wxSocketModule
1241 // ==========================================================================
1242
1243 class WXDLLEXPORT wxSocketModule : public wxModule
1244 {
1245 DECLARE_DYNAMIC_CLASS(wxSocketModule)
1246
1247 public:
1248 bool OnInit() { return GSocket_Init() != 0; }
1249 void OnExit() { GSocket_Cleanup(); }
1250 };
1251
1252 IMPLEMENT_DYNAMIC_CLASS(wxSocketModule, wxModule)
1253
1254 #endif
1255 // wxUSE_SOCKETS