---
name: "GENLIB_COPY_UP_CON"
section: "3"
platform: "linux"
package: "alliance"
version: "5.1.1-3"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/GENLIB_COPY_UP_CON"
---

# GENLIB\_COPY\_UP\_CON(3)

copy a physical connector from an instance in the current figure

## NAME

GENLIB\_COPY\_UP\_CON - copy a physical connector from an instance in the current figure

## SYNOPSYS

```
#include <genlib.h>
void GENLIB_COPY_UP_CON(index, conname, insname, newname)
long index;
char ∗insname;
char ∗conname;
char ∗newname;
```

## PARAMETERS

- *index*

  Connector index in the instance

- *conname*

  Name of the connector in the instance model

- *insname*

  Name of the instance the connector belongs to

- *newname*

  Name to be given to the connector in the current figure

## DESCRIPTION

**COPY\_UP\_CON** copies a instance connector into the current layout figure, and gives to the new connector the name *newname*. The instance connector is identified by its name, *conname*, and index, *index*.\
 Two behaviour are expected, depending on the instance connector 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.

If *newname* is **NULL**, then not connector is copied up, on the segment is drawn to the side of the *abutment* box.

## ERRORS

**"GENLIB\_COPY\_UP\_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\_CON impossible : connector** *conname* **index** *index* **of instance** *insname***,** *current* **figure doesn't exist"**

The given connector does not exist in the current figure.

## 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);
	/∗ Put a connector ∗/
	GENLIB_COPY_UP_CON("i0", 1, "insN", "inz0");
	/∗ Save that on disk ∗/
	GENLIB_SAVE_PHFIG();
}
```

## SEE ALSO

[**genlib**(1)](/genlib/1.md), [**GENLIB\_DEF\_PHFIG**(3)](/GENLIB_DEF_PHFIG/3.md), [**GENLIB\_SAVE\_PHFIG**(3)](/GENLIB_SAVE_PHFIG/3.md), [**GENLIB\_COPY\_UP\_ALL\_CON**(3)](/GENLIB_COPY_UP_ALL_CON/3.md), [**GENLIB\_COPY\_UP\_CON\_FACE**(3)](/GENLIB_COPY_UP_CON_FACE/3.md), [**GENLIB\_PHCON**(3)](/GENLIB_PHCON/3.md), **GENLIB\_THRU\_CON\_H**(3), **GENLIB\_THRU\_CON\_V**(3).