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;

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 concatenate 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), GENLIB_THRU_CON_H(3), GENLIB_THRU_CON_V(3).

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