GENLIB_COPY_UP_ALL_REF.3alc man page

GENLIB_COPY_UP_ALL_REF

GENLIB_COPY_UP_ALL_REF — copy a several physical reference from an instance in the current figure

Synopsis

#include <genlib.h>
void GENLIB_COPY_UP_ALL_REF(reftype, insname, concatenate)
char ∗reftype, ∗insname;
char concatenate;

Parameters

reftype

Type of the references to be duplicated

insname

Name of the instance in the which the references is to be searched for

concatenate

Indicates whether or not to concatenate the instance name to the references names when copying

Description

COPY_UP_ALL_REF duplicates all the references of type reftype of the instance called insname into the current layout cell. The main purpose of this function is to copy a set references in the upper hierarchical level, so it can be used as virtual connector, for the data-path router. See dpr(1) for details.
The reftype argument can take two values:

"ref_con"

for virtual connectors

"ref_ref"

for any other references

See the leaf cells design for generators document for details on reference types and usage.
The concatenate argument can take two values:

AYES

indicates that the name of the copied references is concatenated to the instance name.

NO

implies a direct duplication of the reference name

Errors

"GENLIB_COPY_UP_ALL_REF 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 reference inside it. you must call DEF_PHFIG before any other layout action.

"illegal getphins : instance insname does not exist"

The instance called insname does not currently belong to the figure.

"GENLIB_COPY_UP_ALL_REF impossible : references of type reftype do not exist"

No reference of type reftype exist in the model of the instance insname.

Example

#include <genlib.h>
main()
{
	/∗ Create a figure to work on  ∗/
	GENLIB_DEF_PHFIG("cell");
	GENLIB_PLACE("z2l_y", "r1", NOSYM, 23L, 54L);
	/∗ Put a reference ∗/
	GENLIB_COPY_UP_ALL_REF("ref_con", "r1", NO);
	/∗ Save that on disk ∗/
	GENLIB_SAVE_PHFIG();
}

See Also

dpr(1), genlib(1), GENLIB_DEF_PHFIG(3), GENLIB_SAVE_PHFIG(3), GENLIB_PHREF(3), GENLIB_COPY_UP_ALL_REF(3), GENLIB_PLACE_CON_REF(3), GENLIB_PLACE_SEG_REF(3), GENLIB_PLACE_VIA_REF(3).

Referenced By

genlib.1alc(1), GENLIB_COPY_UP_REF.3alc(3), GENLIB_GET_REF_X.3alc(3), GENLIB_GET_REF_Y.3alc(3), GENLIB_PLACE_CON_REF.3alc(3), GENLIB_PLACE_SEG_REF.3alc(3), GENLIB_PLACE_VIA_REF.3alc(3).

ASIM/LIP6 PROCEDURAL GENERATION LANGUAGE