1 07/30/86  match_star_name_
 2 
 3 Function: implements the Multics star convention by comparing an
 4 entryname with a name which may contain stars or question marks, called
 5 a starname.
 6 
 7 
 8 Syntax:
 9 declare match_star_name_ entry (char(*), char(*), fixed bin(35));
10 call match_star_name_ (entryname, starname, code);
11 
12 
13 Arguments:
14 entryname
15    (Input) is the string to be compared with the starname.  Trailing
16    spaces in this string are ignored.
17 starname
18    (Input) is the string with which the entryname is compared.
19    Trailing spaces in this string are ignored.
20 code
21    (Output) is one of the standard status codes listed below.
22 
23 
24 List of status codes:
25 0
26    the entryname matches the starname.
27 error_table_$nomatch
28    the entryname does not match the starname.
29 error_table_$badstar
30    the starname does not have an acceptable format.
31 
32 
33 Notes: see the description of the hcs_$star_ entrypoint in hcs_.info to
34 find how to list the directory entries that match a given starname.
35 See check_star_name_.info to find how to validate a starname.  See
36 starname.gi.info for the rules governing the formation and
37 interpretation of starnames.