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

# phref(3)

mbk physical reference

## NAME

phref - mbk physical reference

## DESCRIPTION

The **phref** structure is used to describe a reference belonging to a symbolic layout model, see [**phfig**(3)](/phfig/3.md) for details. A reference allows to name a point anywhere in a given model. It may then be seen as a name, and not anymore as a couple of coordinates. References are mostly used for cell programming and multi-access connector representation.

The declarations needed to work on **phref** are available in the header file *"/labo/include/mph402.h"*, where '*402*' is the actual mbk version.

The following C structure supports the description of the reference :

```
typedef struct phref {
	struct phref	∗NEXT;
	char	∗FIGNAME;
	char	∗NAME;
	long	XREF,YREF;
	struct ptype	∗USER;
} phref_list;
```

- *NEXT*

  Pointer to the next reference in the list.

- *FIGNAME*

  Kind of reference. Gives information about the possible uses of the object. Some *FIGNAME* are in use today :

  - **"ref\_con"**

    for multi-access connectors

  - **"ref\_ref"**

    for all other uses

- *NAME*

  Name of the reference. The refence is identified by its name, so it should be unique at a given hierarchical level.

- *XREF, YREF*

  Coordinates of the point beeing referenced.

- *USER*

  Pointer to a ptype list, see [**ptype**(3)](/ptype/3.md) for details, that is a general purpose pointer used to share informations on the reference.

## SEE ALSO

**mbk**(1), [**addphref**(3)](/addphref/3.md), [**getphref**(3)](/getphref/3.md), [**delphref**(3)](/delphref/3.md), [**phfig**(3)](/phfig/3.md), [**ptype**(3)](/ptype/3.md).