1GENLIB_COPY_UP_REF.3(October 1, 1997)    GENLIB_COPY_UP_REF.3(October 1, 1997)
2
3
4

NAME

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

SYNOPSIS

10       #include <genlib.h>
11       void GENLIB_COPY_UP_REF(refname, insname, newname)
12       char ∗refname, ∗insname, ∗newname;
13

PARAMETERS

15       refname             Name of the reference in the instance
16
17       insname             Name of the instance in the which the reference  is
18                           to be searched for
19
20       newname             Name  to  be  given to the reference in the current
21                           figure
22

DESCRIPTION

24       COPY_UP_REF adds a reference in the current layout cell.  All the  ref‐
25       erence's  attributes  are  copied from the first found reference called
26       refname in the instance insname.  The designer should avoid to give  to
27       several  refences  the same name if he plans to use this function.  The
28       new reference is given the name newname.   The  main  purpose  of  this
29       function  is to copy a reference in the upper hierarchical level, so it
30       can be used as virtual connector, for the data-path router.  See dpr(1)
31       for details.  layout.
32

ERRORS

34       "GENLIB_COPY_UP_REF impossible : missing GENLIB_DEF_PHFIG"
35              No  figure  has been yet specified by a call to DEF_PHFIG. So it
36              isn't possible to place a reference inside it.   you  must  call
37              DEF_PHFIG before any other layout action.
38       "illegal getphins : instance insname does not exist"
39              The  instance  called  insname  does not currently belong to the
40              figure.
41       "GENLIB_COPY_UP_REF impossible : reference refname does not exist"
42              The reference refname  does  not  exist  in  the  model  of  the
43              instance insname.
44

EXAMPLE

46       #include <genlib.h>
47       main()
48       {
49            /∗ Create a figure to work on  ∗/
50            GENLIB_DEF_PHFIG("cell");
51            GENLIB_PLACE("z2l_y", "r1", NOSYM, 23L, 54L);
52            /∗ Put a reference ∗/
53            GENLIB_COPY_UP_REF("mux0_s", "r1", "out_s");
54            /∗ Save that on disk ∗/
55            GENLIB_SAVE_PHFIG();
56       }
57

SEE ALSO

59       dpr(1),   genlib(1),  GENLIB_DEF_PHFIG(3),  GENLIB_SAVE_PHFIG(3),  GEN‐
60       LIB_PHREF(3), GENLIB_COPY_UP_ALL_REF(3), GENLIB_PLACE_CON_REF(3),  GEN‐
61       LIB_PLACE_SEG_REF(3), GENLIB_PLACE_VIA_REF(3).
62
63
64
65
66
67
68PROCEDURAL GENERATION LANGUAGE     ASIM/LIGPE6NLIB_COPY_UP_REF.3(October 1, 1997)
Impressum