1 |
149 |
jeremybenn |
-- CA11010.A
|
2 |
|
|
--
|
3 |
|
|
-- Grant of Unlimited Rights
|
4 |
|
|
--
|
5 |
|
|
-- Under contracts F33600-87-D-0337, F33600-84-D-0280, MDA903-79-C-0687,
|
6 |
|
|
-- F08630-91-C-0015, and DCA100-97-D-0025, the U.S. Government obtained
|
7 |
|
|
-- unlimited rights in the software and documentation contained herein.
|
8 |
|
|
-- Unlimited rights are defined in DFAR 252.227-7013(a)(19). By making
|
9 |
|
|
-- this public release, the Government intends to confer upon all
|
10 |
|
|
-- recipients unlimited rights equal to those held by the Government.
|
11 |
|
|
-- These rights include rights to use, duplicate, release or disclose the
|
12 |
|
|
-- released technical data and computer software in whole or in part, in
|
13 |
|
|
-- any manner and for any purpose whatsoever, and to have or permit others
|
14 |
|
|
-- to do so.
|
15 |
|
|
--
|
16 |
|
|
-- DISCLAIMER
|
17 |
|
|
--
|
18 |
|
|
-- ALL MATERIALS OR INFORMATION HEREIN RELEASED, MADE AVAILABLE OR
|
19 |
|
|
-- DISCLOSED ARE AS IS. THE GOVERNMENT MAKES NO EXPRESS OR IMPLIED
|
20 |
|
|
-- WARRANTY AS TO ANY MATTER WHATSOEVER, INCLUDING THE CONDITIONS OF THE
|
21 |
|
|
-- SOFTWARE, DOCUMENTATION OR OTHER INFORMATION RELEASED, MADE AVAILABLE
|
22 |
|
|
-- OR DISCLOSED, OR THE OWNERSHIP, MERCHANTABILITY, OR FITNESS FOR A
|
23 |
|
|
-- PARTICULAR PURPOSE OF SAID MATERIAL.
|
24 |
|
|
--*
|
25 |
|
|
--
|
26 |
|
|
-- OBJECTIVE:
|
27 |
|
|
-- Check that a private child package can use entities declared in the
|
28 |
|
|
-- private part of its parent unit.
|
29 |
|
|
--
|
30 |
|
|
-- TEST DESCRIPTION:
|
31 |
|
|
-- Declare a parent package containing private types, objects,
|
32 |
|
|
-- and functions used by the system. Declare a private child package that
|
33 |
|
|
-- uses the parent components to provide functionality to the system.
|
34 |
|
|
--
|
35 |
|
|
-- Declare an array of files with default values for all
|
36 |
|
|
-- component fields of the files (records). Check the initial state of
|
37 |
|
|
-- a specified file for proper default values. Perform the file "creation"
|
38 |
|
|
-- (initialization), which will modify the fields of the record object.
|
39 |
|
|
-- Again verify the file object to determine whether the fields have been
|
40 |
|
|
-- reset properly.
|
41 |
|
|
--
|
42 |
|
|
--
|
43 |
|
|
-- CHANGE HISTORY:
|
44 |
|
|
-- 06 Dec 94 SAIC ACVC 2.0
|
45 |
|
|
--
|
46 |
|
|
|
47 |
|
|
package CA11010_0 is -- Package OS.
|
48 |
|
|
|
49 |
|
|
type File_Descriptor_Type is private;
|
50 |
|
|
|
51 |
|
|
Default_Descriptor : constant File_Descriptor_Type;
|
52 |
|
|
|
53 |
|
|
function Initialize_File return File_Descriptor_Type;
|
54 |
|
|
procedure Verify_Initial_Conditions (Status : out Boolean);
|
55 |
|
|
function Final_Conditions_Valid return Boolean;
|
56 |
|
|
|
57 |
|
|
private
|
58 |
|
|
|
59 |
|
|
type File_Descriptor_Type is new Integer;
|
60 |
|
|
type File_Name_Type is new String (1 .. 11);
|
61 |
|
|
type Permission_Type is (None, User, System);
|
62 |
|
|
type File_Mode_Type is (Read_Only, Write_Only, Read_Write);
|
63 |
|
|
type File_Status_Type is (Open, Closed);
|
64 |
|
|
|
65 |
|
|
Default_Descriptor : constant File_Descriptor_Type := 0;
|
66 |
|
|
Default_Permission : constant Permission_Type := None;
|
67 |
|
|
Default_Mode : constant File_Mode_Type := Read_Only;
|
68 |
|
|
Default_Status : constant File_Status_Type := Closed;
|
69 |
|
|
Default_Filename : constant File_Name_Type := " ";
|
70 |
|
|
An_Ada_File_Name : constant File_Name_Type := "AdaFileName";
|
71 |
|
|
Max_Files : constant File_Descriptor_Type := 100;
|
72 |
|
|
|
73 |
|
|
type File_Type is tagged
|
74 |
|
|
record
|
75 |
|
|
Descriptor : File_Descriptor_Type := Default_Descriptor;
|
76 |
|
|
Name : File_Name_Type := Default_Filename;
|
77 |
|
|
Acct_Access : Permission_Type := Default_Permission;
|
78 |
|
|
Mode : File_Mode_Type := Default_Mode;
|
79 |
|
|
Current_Status : File_Status_Type := Default_Status;
|
80 |
|
|
end record;
|
81 |
|
|
|
82 |
|
|
type File_Array_Type is array (1 .. Max_Files) of File_Type;
|
83 |
|
|
|
84 |
|
|
File_Table : File_Array_Type;
|
85 |
|
|
File_Counter : Integer := 0;
|
86 |
|
|
|
87 |
|
|
--
|
88 |
|
|
|
89 |
|
|
function Get_File_Name return File_Name_Type;
|
90 |
|
|
|
91 |
|
|
end CA11010_0; -- Package OS.
|
92 |
|
|
|
93 |
|
|
--=================================================================--
|
94 |
|
|
|
95 |
|
|
-- Subprograms that perform the actual file operations are contained in a
|
96 |
|
|
-- private package so that they are not accessible to any client.
|
97 |
|
|
|
98 |
|
|
private package CA11010_0.CA11010_1 is -- Package OS.Internals
|
99 |
|
|
|
100 |
|
|
Private_File_Counter : Integer renames File_Counter; -- Parent priv. object.
|
101 |
|
|
|
102 |
|
|
function Initialize
|
103 |
|
|
(File_Name : File_Name_Type := Get_File_Name; -- Parent priv. function.
|
104 |
|
|
File_Mode : File_Mode_Type := Read_Write) -- Parent priv. literal.
|
105 |
|
|
return File_Descriptor_Type; -- Parent type.
|
106 |
|
|
|
107 |
|
|
end CA11010_0.CA11010_1; -- Package OS.Internals
|
108 |
|
|
|
109 |
|
|
--=================================================================--
|
110 |
|
|
|
111 |
|
|
package body CA11010_0.CA11010_1 is -- Package body OS.Internals
|
112 |
|
|
|
113 |
|
|
function Next_Available_File return File_Descriptor_Type is
|
114 |
|
|
begin
|
115 |
|
|
Private_File_Counter := Private_File_Counter + 1;
|
116 |
|
|
return (File_Descriptor_Type(File_Counter));
|
117 |
|
|
end Next_Available_File;
|
118 |
|
|
----------------------------------------------------------------
|
119 |
|
|
function Initialize
|
120 |
|
|
(File_Name : File_Name_Type := Get_File_Name; -- Parent priv. function
|
121 |
|
|
File_Mode : File_Mode_Type := Read_Write) -- Parent priv. literal
|
122 |
|
|
return File_Descriptor_Type is -- Parent type
|
123 |
|
|
Number : File_Descriptor_Type;
|
124 |
|
|
begin
|
125 |
|
|
Number := Next_Available_File;
|
126 |
|
|
File_Table(Number).Descriptor := Number; -- Parent priv. object
|
127 |
|
|
File_Table(Number).Name := File_Name; -- Default parameter value
|
128 |
|
|
File_Table(Number).Mode := File_Mode; -- Default parameter value
|
129 |
|
|
File_Table(Number).Acct_Access := User;
|
130 |
|
|
File_Table(Number).Current_Status := Open;
|
131 |
|
|
return (Number);
|
132 |
|
|
end Initialize;
|
133 |
|
|
|
134 |
|
|
end CA11010_0.CA11010_1; -- Package body OS.Internals
|
135 |
|
|
|
136 |
|
|
--=================================================================--
|
137 |
|
|
|
138 |
|
|
with CA11010_0.CA11010_1; -- Private child package "withed" by
|
139 |
|
|
-- parent body.
|
140 |
|
|
|
141 |
|
|
package body CA11010_0 is -- Package body OS
|
142 |
|
|
|
143 |
|
|
function Get_File_Name return File_Name_Type is
|
144 |
|
|
begin
|
145 |
|
|
return (An_Ada_File_Name); -- If this was a real function, the user
|
146 |
|
|
end Get_File_Name; -- would be asked to input a name, or there
|
147 |
|
|
-- would be some type of similar processing.
|
148 |
|
|
|
149 |
|
|
-- This subprogram utilizes a call to a subprogram contained in a private
|
150 |
|
|
-- child to perform the actual processing.
|
151 |
|
|
|
152 |
|
|
function Initialize_File return File_Descriptor_Type is
|
153 |
|
|
begin
|
154 |
|
|
return (CA11010_0.CA11010_1.Initialize); -- No parameters are needed,
|
155 |
|
|
-- since defaults have been
|
156 |
|
|
-- provided.
|
157 |
|
|
end Initialize_File;
|
158 |
|
|
|
159 |
|
|
--
|
160 |
|
|
-- Separate subunits.
|
161 |
|
|
--
|
162 |
|
|
|
163 |
|
|
procedure Verify_Initial_Conditions (Status : out Boolean) is separate;
|
164 |
|
|
|
165 |
|
|
function Final_Conditions_Valid return Boolean is separate;
|
166 |
|
|
|
167 |
|
|
end CA11010_0; -- Package body OS
|
168 |
|
|
|
169 |
|
|
--=================================================================--
|
170 |
|
|
|
171 |
|
|
separate (CA11010_0)
|
172 |
|
|
procedure Verify_Initial_Conditions (Status : out Boolean) is
|
173 |
|
|
begin
|
174 |
|
|
Status := False;
|
175 |
|
|
if (File_Table(1).Descriptor = Default_Descriptor) and then
|
176 |
|
|
(File_Table(1).Name = Default_Filename) and then
|
177 |
|
|
(File_Table(1).Acct_Access = Default_Permission) and then
|
178 |
|
|
(File_Table(1).Mode = Default_Mode) and then
|
179 |
|
|
(File_Table(1).Current_Status = Default_Status)
|
180 |
|
|
then
|
181 |
|
|
Status := True;
|
182 |
|
|
end if;
|
183 |
|
|
end Verify_Initial_Conditions;
|
184 |
|
|
|
185 |
|
|
--=================================================================--
|
186 |
|
|
|
187 |
|
|
separate (CA11010_0)
|
188 |
|
|
function Final_Conditions_Valid return Boolean is
|
189 |
|
|
begin
|
190 |
|
|
if ((File_Table(1).Descriptor /= Default_Descriptor) and then
|
191 |
|
|
(File_Table(1).Name = An_Ada_File_Name) and then
|
192 |
|
|
(File_Table(1).Acct_Access = User) and then
|
193 |
|
|
not ((File_Table(1).Mode = Default_Mode) or else
|
194 |
|
|
(File_Table(1).Current_Status = Default_Status)))
|
195 |
|
|
then
|
196 |
|
|
return (True);
|
197 |
|
|
else
|
198 |
|
|
return (False);
|
199 |
|
|
end if;
|
200 |
|
|
end Final_Conditions_Valid;
|
201 |
|
|
|
202 |
|
|
--=================================================================--
|
203 |
|
|
|
204 |
|
|
with CA11010_0; -- with Package OS.
|
205 |
|
|
with Report;
|
206 |
|
|
|
207 |
|
|
procedure CA11010 is
|
208 |
|
|
|
209 |
|
|
package OS renames CA11010_0;
|
210 |
|
|
|
211 |
|
|
Ada_File_Key : OS.File_Descriptor_Type := OS.Default_Descriptor;
|
212 |
|
|
Initialization_Status : Boolean := False;
|
213 |
|
|
|
214 |
|
|
begin
|
215 |
|
|
|
216 |
|
|
-- This test indicates one approach to a file management operation.
|
217 |
|
|
-- It is not intended to demonstrate full functionality, but rather
|
218 |
|
|
-- that the use of a private child package can provide a solution
|
219 |
|
|
-- to a user situation, that being the implementation of certain functions
|
220 |
|
|
-- being provided in a child package, with the parent package body
|
221 |
|
|
-- utilizing these implementations.
|
222 |
|
|
|
223 |
|
|
Report.Test ("CA11010", "Check that a private child package can use " &
|
224 |
|
|
"entities declared in the private part of its " &
|
225 |
|
|
"parent unit");
|
226 |
|
|
|
227 |
|
|
-- Check initial conditions of the first entry in the file table.
|
228 |
|
|
-- These are all default values provided in the declaration of the
|
229 |
|
|
-- type File_Type.
|
230 |
|
|
|
231 |
|
|
OS.Verify_Initial_Conditions (Initialization_Status);
|
232 |
|
|
|
233 |
|
|
if not Initialization_Status then
|
234 |
|
|
Report.Failed ("Initial condition failure");
|
235 |
|
|
end if;
|
236 |
|
|
|
237 |
|
|
-- Call the initialization function. This will result in the resetting
|
238 |
|
|
-- of the fields associated with the first entry in the File_Table (this
|
239 |
|
|
-- is the first/only call of Initialize_File).
|
240 |
|
|
-- No parameters are necessary for this call, due to the default values
|
241 |
|
|
-- provided in the private child package routine Initialize.
|
242 |
|
|
|
243 |
|
|
Ada_File_Key := OS.Initialize_File;
|
244 |
|
|
|
245 |
|
|
-- Verify that the initial conditions of the file table component have
|
246 |
|
|
-- been properly modified by the initialization function.
|
247 |
|
|
|
248 |
|
|
if not OS.Final_Conditions_Valid then
|
249 |
|
|
Report.Failed ("Initialization processing failure");
|
250 |
|
|
end if;
|
251 |
|
|
|
252 |
|
|
Report.Result;
|
253 |
|
|
|
254 |
|
|
end CA11010;
|