GENLIB_COPY_UP_ALL_REF.3(October 1, 1997)								 GENLIB_COPY_UP_ALL_REF.3(October 1, 1997)

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;

ORIGIN

       This  software  belongs	to  the  ALLIANCE CAD SYSTEM developed by the ASIM team at LIP6 laboratory of Universite Pierre et Marie CURIE, in
       Paris, France.

       Web : http://asim.lip6.fr/recherche/alliance/
       E-mail : alliance-users@asim.lip6.fr

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  pur-
       pose  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), GEN-
       LIB_PLACE_SEG_REF(3), GENLIB_PLACE_VIA_REF(3).

BUG REPORT

       This tool is under development at the ASIM department of the LIP6 laboratory.
       We need your feedback to improve documentation and tools.

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