remoteio_1.21805.1_406605ad/src/objects/messaging-fixed-gnat_udp.ads

 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
-- Fixed length message services implementing using GNAT.Sockets UDP
-- Must be instantiated for each message size.

-- Copyright (C)2017-2023, Philip Munts dba Munts Technologies.
--
-- Redistribution and use in source and binary forms, with or without
-- modification, are permitted provided that the following conditions are met:
--
-- * Redistributions of source code must retain the above copyright notice,
--   this list of conditions and the following disclaimer.
--
-- THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-- AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-- IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-- ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
-- LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-- CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
-- SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
-- INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
-- CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
-- ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
-- POSSIBILITY OF SUCH DAMAGE.

PRIVATE WITH GNAT.Sockets;

GENERIC

PACKAGE Messaging.Fixed.GNAT_UDP IS

  TYPE MessengerSubclass IS NEW MessengerInterface WITH PRIVATE;

  -- UDP client (initiator) services

  FUNCTION Create
   (server    : String;
    port      : Positive;
    timeoutms : Integer := 1000) RETURN Messaging.Fixed.Messenger;

  PROCEDURE Send
   (Self : MessengerSubclass;
    msg  : Message);

  PROCEDURE Receive
   (Self : MessengerSubclass;
    msg  : OUT Message);

  -- UDP server (responder) services

  TYPE PeerIdentifier IS PRIVATE;

  PROCEDURE Initialize_Server
   (Self      : IN OUT MessengerSubclass;
    netiface  : String := "0.0.0.0"; -- Bind to all available network interfaces
    port      : Positive;
    timeoutms : Integer := 1000);

  PROCEDURE Send_Server
   (Self : MessengerSubclass;
    dst  : PeerIdentifier;
    msg  : Message);

  PROCEDURE Receive_Server
   (Self : MessengerSubclass;
    src  : OUT PeerIdentifier;
    msg  : OUT Message);

  -- Retrieve the underlying Linux file descriptor

  FUNCTION fd
   (Self : MessengerSubclass) RETURN Integer;

PRIVATE

  TYPE PeerIdentifier IS NEW GNAT.Sockets.Sock_Addr_type;

  TYPE MessengerSubclass IS NEW MessengerInterface WITH RECORD
    socket : GNAT.Sockets.Socket_Type;
    peer   : GNAT.Sockets.Sock_Addr_type;
  END RECORD;

END Messaging.Fixed.GNAT_UDP;