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

NAME

       GENLIB_COPY_UP_ALL_CON - copy all physical connectors of an instance face in the current figure

SYNOPSYS

       #include <genlib.h>
       void GENLIB_COPY_UP_ALL_CON(face, insname, concatenate)
       char face, concatenate;
       char *insname;

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

       face		   Face of the instance

       insname		   Name of the instance the connector belongs to

       concatenate	   Indicates wheter or not to concatenate instance connectors names with instance name

DESCRIPTION

       COPY_UP_ALL_CON copies all instance connectors of the face face of the placed instance called insname into the current  layout.	 The  con-
       catenate argument may take two values:

       YES		   then  the  resulting name of a connector in the current figure is the concatenation of the insname and the conname.	It
			   warranties the unicity of name at the figure level, and is to be used most of the time.

       NO		   implies a direct copy of the connector name.  The user must take care of the unicity of connector name by itself.
			   Two behaviour are expected, depending on each of the instance connectors location regarding the  abutment  box  of  the
			   current figure.

       Connector on the abutment box
			   The figure connector is place right over the instance connector. The single connector is duplicated.

       Connector inside the abutment box
			   The	instance connector face is computed in the figure, and then, the connector is duplicated on the given face, at the
			   right coordinates for this face.  Then a wire is drawn between the instance connector and the figure connector  in  the
			   connector layer.

ERRORS

       "GENLIB_COPY_UP_ALL_CON 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 connector inside it.  you must call
	      DEF_PHFIG before any other layout action.
       "*** genlib error *** GENLIB_COPY_UP_ALL_CON impossible : connector conname face face of instance insname, current figure doesn't exist"
	      No connector matches both the conname and the face arguments.

EXAMPLE

       #include <genlib.h>
       main()
       {
	    /* Create a figure to work on  */
	    GENLIB_DEF_PHFIG("cell");
	    .
	    .
	    GENLIB_PLACE_LEFT("gaer0_f", "insN", SYMXY);
	    .
	    .
	    GENLIB_DEF_AB(0L, 0L, 0L, 0L);
	    /* Copy all connectors */
	    GENLIB_COPY_UP_ALL_CON(NORTH, "insN", YES);
	    /* Save that on disk */
	    GENLIB_SAVE_PHFIG();
       }

SEE ALSO

       genlib(1),   GENLIB_DEF_PHFIG(3),   GENLIB_SAVE_PHFIG(3),   GENLIB_COPY_UP_CON(3),   GENLIB_COPY_UP_CON_FACE(3),   GENLIB_PHCON(3),    GEN-
       LIB_THRU_CON_H(3), GENLIB_THRU_CON_V(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_CON.3(October 1, 1997)