NAME

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

SYNOPSYS

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

PARAMETERS

       refname             Name of the reference in the instance

       insname             Name of the instance in the which the reference is to be searched for

       newname             Name to be given to the reference in the current figure

DESCRIPTION

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

ERRORS

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

EXAMPLE

       #include <genlib.h>
       main()
       {
            /∗ Create a figure to work on  ∗/
            GENLIB_DEF_PHFIG("cell");
            GENLIB_PLACE("z2l_y", "r1", NOSYM, 23L, 54L);
            /∗ Put a reference ∗/
            GENLIB_COPY_UP_REF("mux0_s", "r1", "out_s");
            /∗ Save that on disk ∗/
            GENLIB_SAVE_PHFIG();
       }

SEE ALSO

       dpr(1), genlib(1), GENLIB_DEF_PHFIG(3), GENLIB_SAVE_PHFIG(3), GENLIB_PHREF(3), GENLIB_COPY_UP_ALL_REF(3),
       GENLIB_PLACE_CON_REF(3), GENLIB_PLACE_SEG_REF(3), GENLIB_PLACE_VIA_REF(3).

PROCEDURAL GENERATION LANGUAGE                      ASIM/LIP6              GENLIB_COPY_UP_REF.3(October 1, 1997)