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

NAME

       GENLIB_PLACE_VIA_REF - put a via on top of a reference belonging to an instance in the current figure

SYNOPSYS

       #include <genlib.h>
       void GENLIB_PLACE_VIA_REF(insname, refname, viatype)
       char  *insname, *refname;
       char viatype;

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

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

       refname		   Name of the reference to be used as target point

       viatype		   Type of via to be placed

DESCRIPTION

       PLACE_VIA_REF places a via of type viatype on top of the specified reference, refname, in the instance called insname.  This  function  may
       be  used  to  generate  many cells from a single one, in order to "program" decoders for example, or in conjuction with PLACE_SEG_REF(3) or
       PLACE_CON_REF(3) to translate virtual connectors into fixed ones.
       The viatype argument may take the following legal values:

       CONT_POLY	   links POLY and ALU1

       CONT_DIF_N	   links NDIF and ALU1

       CONT_DIF_P	   links PDIF and ALU1

       CONT_BODY_N	   links NTIE and ALU1

       CONT_BODY_P	   links PTIE and ALU1

       CONT_VIA 	   links ALU1 and ALU2

       CONT_VIA2	   links ALU2 and ALU3

ERRORS

       "GENLIB_PLACE_VIA_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.
       "illegal getphref : references called refname does not exist"
	      No reference called refname exists in the model of the instance insname.

EXAMPLE

       #include <genlib.h>
       main()
       {
	    /* Create a figure to work on  */
	    GENLIB_DEF_PHFIG("cell");
	    GENLIB_PLACE("gaci0_b", "r1", NOSYM, 23L, 54L);
	    /* Put a reference */
	    GENLIB_PLACE_VIA_REF("a_0", "r1", CONT_VIA);
	    /* 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_PHVIA(3),   GENLIB_COPY_UP_REF(3),   GEN-
       LIB_COPY_UP_ALL_REF(3), GENLIB_PLACE_CON_REF(3), GENLIB_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_PLACE_VIA_REF.3(October 1, 1997)