posix man page for genlib_copy_up_ref

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

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;

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
       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),  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_REF.3(October 1, 1997)