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
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162 | ------------------------------------------------------------------------------
-- --
-- GLADE COMPONENTS --
-- --
-- S Y S T E M . G A R L I C . S T R E A M S --
-- --
-- S p e c --
-- --
-- Copyright (C) 1996-2020 Free Software Foundation, Inc. --
-- --
-- GARLIC is free software; you can redistribute it and/or modify it under --
-- terms of the GNU General Public License as published by the Free Soft- --
-- ware Foundation; either version 2, or (at your option) any later ver- --
-- sion. GARLIC is distributed in the hope that it will be useful, but --
-- WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABI- --
-- LITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public --
-- License for more details. You should have received a copy of the GNU --
-- General Public License distributed with GARLIC; see file COPYING. If --
-- not, write to the Free Software Foundation, 59 Temple Place - Suite 330, --
-- Boston, MA 02111-1307, USA. --
-- --
-- As a special exception, if other files instantiate generics from this --
-- unit, or you link this unit with other files to produce an executable, --
-- this unit does not by itself cause the resulting executable to be --
-- covered by the GNU General Public License. This exception does not --
-- however invalidate any other reasons why the executable file might be --
-- covered by the GNU Public License. --
-- --
------------------------------------------------------------------------------
with Ada.Streams;
with Ada.Unchecked_Deallocation;
with System.Garlic.Debug;
with System.Garlic.Storage_Handling;
package System.Garlic.Streams is
pragma Elaborate_Body;
-- This package defines types and utilities related to Stream handling.
-- These types are not defined in System.Garlic.Types because they are
-- way too large to be considered as basic types.
type Node (<>);
type Node_Ptr is access Node;
type Node (Size : Ada.Streams.Stream_Element_Count) is record
Current : Ada.Streams.Stream_Element_Offset := 1;
Last : Ada.Streams.Stream_Element_Offset := 1;
Next : Node_Ptr;
Content : Ada.Streams.Stream_Element_Array (1 .. Size);
end record;
type Params_Stream_Type (Initial_Size : Ada.Streams.Stream_Element_Count) is
new Ada.Streams.Root_Stream_Type with record
First : Node_Ptr;
Current : Node_Ptr;
Insert : Boolean := False;
Count : Ada.Streams.Stream_Element_Count := 0;
end record;
type Params_Stream_Access is access Params_Stream_Type;
procedure Read
(Stream : in out Params_Stream_Type;
Item : out Ada.Streams.Stream_Element_Array;
Last : out Ada.Streams.Stream_Element_Offset);
procedure Write
(Stream : in out Params_Stream_Type;
Item : Ada.Streams.Stream_Element_Array);
pragma Inline (Read);
pragma Inline (Write);
-- ??? Code for storage pools has been commented out at this stage since
-- it causes problem because of the combination of soft-links and
-- elaboration order. See comments in s-gastha.adb.
package Streams_Pools is new Storage_Handling
(Max_Objects => 16,
Static_Object_Size => 16_384);
Streams_Pool : Streams_Pools.Garlic_Storage_Pool;
type Stream_Element_Access is access Ada.Streams.Stream_Element_Array;
for Stream_Element_Access'Storage_Pool use Streams_Pool;
procedure Read
(S : access Ada.Streams.Root_Stream_Type'Class;
X : out Stream_Element_Access);
procedure Write
(S : access Ada.Streams.Root_Stream_Type'Class;
X : Stream_Element_Access);
for Stream_Element_Access'Read use Read;
for Stream_Element_Access'Write use Write;
procedure Copy
(Source : Params_Stream_Type;
Target : in out Params_Stream_Type);
pragma Inline (Copy);
-- Assign an exact copy of Source to Target
procedure Move
(Source : in out Params_Stream_Type;
Target : in out Params_Stream_Type);
pragma Inline (Move);
-- Move Source into Target and read the original packet. This is
-- needed to be able to drop the Params_Stream_Type without losing its
-- content.
procedure Deallocate (Stream : in out Params_Stream_Type);
pragma Inline (Deallocate);
procedure Deallocate (Stream : in out Params_Stream_Access);
pragma Inline (Deallocate);
-- This procedure make sure that unconsumed data has been
-- freed. This may occur in case of cancellation or when a
-- Params_Stream_Type is used to fill a Stream_Element_Array.
procedure Dump
(Stream : access Ada.Streams.Stream_Element_Array;
Key : System.Garlic.Debug.Debug_Key);
-- Same as Print_Debug_info except that this procedure prints
-- Stream content.
function Empty (Params : access Params_Stream_Type) return Boolean;
procedure Free is
new Ada.Unchecked_Deallocation
(Ada.Streams.Stream_Element_Array, Stream_Element_Access);
procedure Initialize;
procedure Insert (Params : in out Params_Stream_Type);
pragma Inline (Insert);
procedure To_Params_Stream_Type
(Content : Ada.Streams.Stream_Element_Array;
Params : access Params_Stream_Type);
pragma Inline (To_Params_Stream_Type);
function To_Stream_Element_Access
(Params : access Params_Stream_Type;
Unused : Ada.Streams.Stream_Element_Count := 0)
return Stream_Element_Access;
function To_Stream_Element_Array
(Params : access Params_Stream_Type;
Unused : Ada.Streams.Stream_Element_Count := 0)
return Ada.Streams.Stream_Element_Array;
pragma Inline (To_Stream_Element_Array);
-- This routine "looks" into the Params structure to extract the
-- Stream_Element_Array which will be sent accross the network. It
-- also let Unused places to store extra information.
procedure Free is
new Ada.Unchecked_Deallocation
(Params_Stream_Type, Params_Stream_Access);
end System.Garlic.Streams;
|