1GENLIB_COPY_UP_ALL_REF.3(October 1, 19G9E7N)LIB_COPY_UP_ALL_REF.3(October 1, 1997)
2
3
4

NAME

6       GENLIB_COPY_UP_ALL_REF  -  copy  a  several  physical reference from an
7       instance in the current figure
8

SYNOPSIS

10       #include <genlib.h>
11       void GENLIB_COPY_UP_ALL_REF(reftype, insname, concatenate)
12       char ∗reftype, ∗insname;
13       char concatenate;
14

PARAMETERS

16       reftype             Type of the references to be duplicated
17
18       insname             Name of the instance in the which the references is
19                           to be searched for
20
21       concatenate         Indicates   whether   or  not  to  concatenate  the
22                           instance name to the references names when copying
23

DESCRIPTION

25       COPY_UP_ALL_REF duplicates all the references of type  reftype  of  the
26       instance called insname into the current layout cell.  The main purpose
27       of this function is to copy a set references in the upper  hierarchical
28       level,  so  it  can  be  used  as  virtual connector, for the data-path
29       router.  See dpr(1) for details.
30       The reftype argument can take two values:
31
32       "ref_con"           for virtual connectors
33
34       "ref_ref"           for any other references
35
36       See the leaf cells design for generators document for details on refer‐
37       ence types and usage.
38       The concatenate argument can take two values:
39
40       AYES                indicates that the name of the copied references is
41                           concatenated to the instance name.
42
43       NO                  implies a direct duplication of the reference name
44

ERRORS

46       "GENLIB_COPY_UP_ALL_REF impossible : missing GENLIB_DEF_PHFIG"
47              No figure has been yet specified by a call to DEF_PHFIG.  So  it
48              isn't  possible  to  place a reference inside it.  you must call
49              DEF_PHFIG before any other layout action.
50       "illegal getphins : instance insname does not exist"
51              The instance called insname does not  currently  belong  to  the
52              figure.
53       "GENLIB_COPY_UP_ALL_REF  impossible : references of type reftype do not
54       exist"
55              No reference of type reftype exist in the model of the  instance
56              insname.
57

EXAMPLE

59       #include <genlib.h>
60       main()
61       {
62            /∗ Create a figure to work on  ∗/
63            GENLIB_DEF_PHFIG("cell");
64            GENLIB_PLACE("z2l_y", "r1", NOSYM, 23L, 54L);
65            /∗ Put a reference ∗/
66            GENLIB_COPY_UP_ALL_REF("ref_con", "r1", NO);
67            /∗ Save that on disk ∗/
68            GENLIB_SAVE_PHFIG();
69       }
70

SEE ALSO

72       dpr(1),   genlib(1),  GENLIB_DEF_PHFIG(3),  GENLIB_SAVE_PHFIG(3),  GEN‐
73       LIB_PHREF(3), GENLIB_COPY_UP_ALL_REF(3), GENLIB_PLACE_CON_REF(3),  GEN‐
74       LIB_PLACE_SEG_REF(3), GENLIB_PLACE_VIA_REF(3).
75
76
77
78
79
80
81PROCEDURAL GENERATION LANGUAGE     ASIGME/NLLIIPB6_COPY_UP_ALL_REF.3(October 1, 1997)
Impressum