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).