NAME

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

SYNOPSYS

       #include <genlib.h>
       void GENLIB_COPY_UP_ALL_REF(reftype, insname, concatenate)
       char ∗reftype, ∗insname;
       char concatenate;

PARAMETERS

       reftype             Type of the references to be duplicated

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

       concatenate         Indicates whether or not to  concatenate  the  instance  name  to  the
                           references names when copying

DESCRIPTION

       COPY_UP_ALL_REF  duplicates  all  the  references  of  type reftype of the instance called
       insname into the current layout cell.  The main purpose of this function is to copy a  set
       references  in  the  upper hierarchical level, so it can be used as virtual connector, for
       the data-path router.  See dpr(1) for details.
       The reftype argument can take two values:

       "ref_con"           for virtual connectors

       "ref_ref"           for any other references

       See the leaf cells design for generators document  for  details  on  reference  types  and
       usage.
       The concatenate argument can take two values:

       AYES                indicates  that  the  name of the copied references is concatenated to
                           the instance name.

       NO                  implies a direct duplication of the reference name

ERRORS

       "GENLIB_COPY_UP_ALL_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_ALL_REF impossible : references of type reftype do not exist"
              No reference of type reftype 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_ALL_REF("ref_con", "r1", NO);
            /∗ 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).