1 09/01/83  search_paths_
 2 
 3 
 4 Entry points in search_paths_:
 5    (List is generated by the help command)
 6 
 7 
 8 :Entry:  get:  09/01/83  search_paths_$get
 9 
10 Function: This entry point returns the search paths in a search
11 list.
12 
13 
14 Syntax:
15 declare search_paths_$get entry (char (*), bit (36), char (*), pointer,
16      pointer, fixed binary, pointer, fixed binary (35));
17 call search_paths_$get (sl_name, sl_control, ref_path, search_seg_ptr,
18      sl_info_area_ptr, sl_info_version, sl_info_ptr, code);
19 
20 
21 Arguments:
22 sl_name
23    is the search list name.  (Input)
24 sl_control
25    is an expansion control mask.  See the sl_control_s structure in
26    "Notes" below.  (Input)
27 ref_path
28    is the directory name used for the "-referencing_dir" search path.
29    If ref_path is null, then the "-referencing_dir" search path is
30    skipped.  (Input)
31 search_seg_ptr
32    is a pointer to the search segment.  If this pointer is null, then
33    the process search segment is used.  (Input)
34 sl_info_area_ptr
35    is a pointer to an area in which sl_info can be allocated.  (Input)
36 
37 
38 sl_info_version
39    is the version of the sl_info structure required.  (Input)
40 sl_info_ptr
41    is a pointer to the sl_info structure containing the search paths in
42    the search list.  (See "Notes" below).  (Input)
43 code
44    is a standard status code.  It may be the following:
45    error_table_$no_search_list the search list was not in the search
46    segment.  (Output)
47 
48 
49 Notes:
50 The sl_control argument is defined by the sl_control_s structure
51 contained in sl_control_s.incl.pl1.  Expanding the "-referencing_dir"
52 keyword substitutes the ref_path argument for the keyword.
53 
54 The sl_info structure is contained in sl_info.incl.pl1.
55 
56 
57 Arguments:
58 version
59    is the version of the sl_info structure.
60 num_paths
61    is the number of search paths in this structure.
62 change_index_p
63    is a pointer to the search lists' update count.  The update count is
64    a fixed binary (71) integer, and is incremented each time the search
65    list is modified.  The caller can determine if the search list has
66    been modified by comparing change_index in this structure with the
67    value pointed to by change_index_p.
68 
69 
70 change_index
71    is the current value of the search lists' update count.
72 type
73    specifies the type of the search path.  Keywords in sl_info.incl.pl1
74    define the possible values.
75 code
76    is a standard status code for this search path.
77 pathname
78    is the search path.
79