NAME

       GENLIB_LOSIGMERGE - merge two logical signals

SYNOPSYS

       #include <genlib.h>
       void GENLIB_LOSIGMERGE(signal1, signal2)
       char ∗signal1, ∗signal2;

PARAMETERS

       signal1             Name of a signal to be merged

       signal2             Name of a signal to be merged

DESCRIPTION

       LOSIGMERGE merges the two signals, signal1 and signal2.  This function can be used anywhere in the genlib
       program, but its resultings actions must be known by the user.

       1)        If signal1 and signal2 have not been used yet, then  the  corresponding  signal  can  be  later
                 accessed through any of these aliases.

       2)        If  one  of  signal1  or  signal2  has not been used yet, then all further reference to the not
                 defined name will be made on the same signal than the defined signal.

       3)        If both signals exist, then they are merged, and both can be used for  reference  to  the  same
                 signal later on.

       Since most of the file formats do not allow multiple name for a single signal, the choice is made to keep
       for disk usage the name that appears in the cell interface, if any.  Otherwise, the  choice  is  randomly
       made by LOSIGMERGE.

       Warning   This  function  allows  the  user to internally connect two external connectors.  This is not a
                 valid disk representation for netlist generated by genlib.  The SAVE_LOFIG function  will  exit
                 if encountering such a situation.
                 In order to avoid it, either take care not to link such signals, or build all your hierarchy in
                 memory, make sure your block does not have such signals, and call FLATTEN_LOFIG(3) just  before
                 saving.

EXAMPLE

       #include <genlib.h>
       main()
       {
            /∗ Create a figure to work on  ∗/
            GENLIB_DEF_LOFIG("cell");
            /∗ Define interface ∗
            GENLIB_LOCON(...
            /∗ Place an instance ∗/
            GENLIB_LOINS("no2_y" ,"no3" ,"a8_s" ,"a9_s" ,"new_no3_s" ,"vdd" ,"vss" ,0);
            GENLIB_LOINS("no2_y" ,"no4" ,"a12_s" ,"a15_s" ,"no4_s" ,"vdd" ,"vss" ,0);
            GENLIB_LOINS("a2_y" ,"a22" ,"no3_s" ,"no4_s" ,"a22_s" ,"vdd" ,"vss" ,0);
            GENLIB_LOSIGMERGE("new_no3_s", "no3_s");
            /∗ Save all that on disk ∗/
            GENLIB_SAVE_LOFIG();
       }

SEE ALSO

       genlib(1), GENLIB_LOINS(3), GENLIB_LOCON(3), GENLIB_FLATTEN_LOFIG(3), GENLIB_SAVE_PHFIG(3).