GENLIB_PLACE_VIA_REF(1) put a via on top of a reference belonging to an instance

SYNOPSYS

#include <genlib.h>
void GENLIB_PLACE_VIA_REF(insname, refname, viatype)
char  *insname, *refname;
char viatype;
man2html: unable to open or read file man1/alc_origin.1

PARAMETERS

insname
Name of the instance in the which the reference is to be searched for
refname
Name of the reference to be used as target point
viatype
Type of via to be placed

DESCRIPTION

PLACE_VIA_REF places a via of type viatype on top of the specified reference, refname, in the instance called insname. This function may be used to generate many cells from a single one, in order to "program" decoders for example, or in conjuction with PLACE_SEG_REF(3) or PLACE_CON_REF(3) to translate virtual connectors into fixed ones.
The viatype argument may take the following legal values:
CONT_POLY
links POLY and ALU1
CONT_DIF_N
links NDIF and ALU1
CONT_DIF_P
links PDIF and ALU1
CONT_BODY_N
links NTIE and ALU1
CONT_BODY_P
links PTIE and ALU1
CONT_VIA
links ALU1 and ALU2
CONT_VIA2
links ALU2 and ALU3

ERRORS

"GENLIB_PLACE_VIA_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.
"illegal getphref : references called refname does not exist"
No reference called refname exists in the model of the instance insname.

EXAMPLE

#include <genlib.h>
main()
{
        /* Create a figure to work on  */
        GENLIB_DEF_PHFIG("cell");
        GENLIB_PLACE("gaci0_b", "r1", NOSYM, 23L, 54L);
        /* Put a reference */
        GENLIB_PLACE_VIA_REF("a_0", "r1", CONT_VIA);
        /* Save that on disk */
        GENLIB_SAVE_PHFIG();
}