Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
GENLIB_COPY_UP_REF.3(October 1,	1997)	 GENLIB_COPY_UP_REF.3(October 1, 1997)

NAME
       GENLIB_COPY_UP_REF  - copy a physical reference from an instance	in the
       current figure

SYNOPSIS
       #include	<genlib.h>
       void GENLIB_COPY_UP_REF(refname,	insname, newname)
       char *refname, *insname,	*newname;

PARAMETERS
       refname		   Name	of the reference in the	instance

       insname		   Name	of the instance	in the which the reference  is
			   to be searched for

       newname		   Name	 to  be	 given to the reference	in the current
			   figure

DESCRIPTION
       COPY_UP_REF adds	a reference in the current layout cell.	 All the  ref-
       erence's	 attributes  are  copied from the first	found reference	called
       refname in the instance insname.	 The designer should avoid to give  to
       several	refences  the same name	if he plans to use this	function.  The
       new reference is	given the name newname.	  The  main  purpose  of  this
       function	 is to copy a reference	in the upper hierarchical level, so it
       can be used as virtual connector, for the data-path router.  See	dpr(1)
       for details.  layout.

ERRORS
       "GENLIB_COPY_UP_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_REF impossible :	reference refname does not exist"
	      The  reference  refname  does  not exist in the model of the in-
	      stance 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_REF("mux0_s", "r1", "out_s");
	    /* Save that on disk */
	    GENLIB_SAVE_PHFIG();
       }

SEE ALSO
       dpr(1),	genlib(1),  GENLIB_DEF_PHFIG(3),  GENLIB_SAVE_PHFIG(3),	  GEN-
       LIB_PHREF(3),  GENLIB_COPY_UP_ALL_REF(3), GENLIB_PLACE_CON_REF(3), GEN-
       LIB_PLACE_SEG_REF(3), GENLIB_PLACE_VIA_REF(3).

PROCEDURAL GENERATION LANGUAGE	   ASIM/LGENLIB_COPY_UP_REF.3(October 1, 1997)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=GENLIB_COPY_UP_REF&sektion=3&manpath=FreeBSD+Ports+15.0>

home | help