1 03/15/85  cv_ptr_
 2 
 3 
 4 Entry points in cv_ptr_:
 5    (List is generated by the help command)
 6 
 7 
 8 :Entry:  cv_ptr_:  03/15/85  cv_ptr_
 9 
10 
11 Function:
12 The cv_ptr_ function converts a virtual pointer to a pointer value.  A
13 virtual pointer is a character-string representation of a pointer
14 value.
15 
16 
17 Syntax:
18 declare cv_ptr_ entry (char(*), fixed bin(35)) returns (ptr);
19 ptr_value = cv_ptr_ (vptr, code);
20 
21 
22 Arguments:
23 vptr
24    is the virtual pointer to be converted.  (Input)
25 code
26    is a standard status code.  (Output)
27 ptr_value
28    is the pointer that results from the conversion.  (Output)
29 
30 
31 :Entry:  terminate:  03/15/85 cv_ptr_$terminate
32 
33 
34 Function:  This entry point is called to terminate the segment that has
35 been initiated by a previous call to cv_ptr_.
36 
37 
38 Syntax:
39 declare cv_ptr_$terminate (ptr);
40 call cv_ptr_$terminate (ptr_value);
41 
42 
43 Arguments:
44 ptr_value
45    is the pointer returned by the previous call to cv_ptr_.  (Input)
46 
47 
48 Notes:  Pointers returned by the cv_ptr_ function cannot be used as
49 entry pointers.  The cv_ptr_ function constructs the returned pointer
50 to a segment in a way that avoids copying of the segment's linkage and
51 internal static data into the combined linkage area.  The cv_entry_
52 function is used to convert virtual entries to an entry value.
53 
54 The segment pointed to by the returned ptr_value is initiated with a
55 null reference name.  The cv_ptr_$terminate entry point should be
56 called to terminate this null reference name.
57 
58 
59 Virtual pointers:
60 The cv_ptr_ function converts virtual pointers that contain one or two
61 components -- a segment identifier and an optional offset into the
62 segment.  Altogether, seventeen forms are accepted.  A description of
63 virtual pointers can be found in "virtual_pointers.gi.info".