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

  
 
  

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 cur-
     rent 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  refer-
     ence'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	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_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/LIGENLIB_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.1.quarterly>

home | help