mbkenv

MBKENV(3)                    MBK UTILITY FUNCTIONS                   MBKENV(3)



NAME
       mbkenv - set user preferences


ORIGIN
       This software belongs to the  ALLIANCE CAD SYSTEM developed by the ASIM
       team at LIP6 laboratory of Université Pierre et Marie CURIE, in Paris,
       France.

       Web : http://asim.lip6.fr/recherche/alliance/
       E-mail : alliance-users@asim.lip6.fr


SYNOPSYS
       #include "mut.h"
       void mbkenv();

DESCRIPTION
       The mbkenv function set the user preferences through unix environment
       variables. if all the variables are not defined, default values are
       used.

       MBK_WORK_LIB                  internally char ∗WORK_LIB, sets the
                                     working directory for reading and
                                     writting, result of a savephfig for
                                     example. Its value is "." by default.

       MBK_CATA_LIB                  internally char ∗∗CATA_LIB, sets the
                                     working directories for reading only.
                                     This is a set of pathes, like the unix
                                     PATH variable.  It is used in loadlofig
                                     for example. Its value is "." by default.

       MBK_CATAL_NAME                internally char ∗CATAL_NAME, sets the
                                     name of the catalog file, needed to know
                                     where to stop a flatten, and so on. Set
                                     to "CATAL" by default.

       MBK_SEPAR                     internally char SEPAR, sets the character
                                     used for string concatenation.  Used for
                                     example in concatname.  By default it is
                                     ".".

       MBK_VDD                       internally char *VDD, sets the name to be
                                     used as power level recognition pattern
                                     by the tools based upon mbk that needs to
                                     identify supplies.  The default is "vdd".

       MBK_VSS                       internally char *VSS, sets the name to be
                                     used as ground level recognition pattern
                                     by the tools based upon mbk that needs to
                                     identify supplies.  The default is "vss".

       MBK_TRACE_MODE                internally char TRACE_MODE, output
                                     information in each mbk access function
                                     it enters.  Used for debugging purposes.
                                     By default it is 'N'.

       MBK_DEBUG_MODE                internally char DEBUG_MODE, output
                                     information in function that makes a
                                     check on its values : mostly parsers for
                                     debug. It is very verbose, and mostly
                                     unusable. No mbk function take care of
                                     it.  By default it is 'N'.

       MBK_FAST_MODE                 internally char FAST_MODE. If set to 'Y',
                                     no consistency checked are performed on
                                     many mbk functions. This can work only on
                                     a program that is warrantied to be
                                     bugless, else undefined results would
                                     occur.  By default it is 'N'.

       MBK_IN_LO                     internally char IN_LO[5]. Defines the
                                     logical input format demanded by the
                                     user. See MBK_IN_LO(1) for a list of
                                     valid formats.  By default its value is
                                     "al".

       MBK_OUT_LO                    internally char OUT_LO[5]. Defines the
                                     logical input format demanded by the
                                     user. See MBK_OUT_LO(1) for a list of
                                     valid formats.  By default its value is
                                     "al".

       MBK_IN_PH                     internally char IN_PH[5]. Defines the
                                     logical input format demanded by the
                                     user. See MBK_IN_PH(1) for a list of
                                     valid formats.  By default its value is
                                     "ap".

       MBK_OUT_PH                    internally char OUT_PH[5]. Defines the
                                     logical input format demanded by the
                                     user. See MBK_OUT_PH(1) for a list of
                                     valid formats.  By default its value is
                                     "ap".

       MBK_SCALE_X                   internally long SCALE_X. Defines a scale
                                     factor for all coordinates, in order to
                                     be able to use files that works with half
                                     lambda rules for example.  Parsers,
                                     drivers and genlib's macros use it
                                     extensivly.  Its value is ten by default.

       MBK_IN_FILTER                 internaly IN_FILTER. Filter string for
                                     reading compressed Alliance files.  It
                                     has no value by default, means no filter
                                     is used.

       MBK_OUT_FILTER                internaly OUT_FILTER. Filter string for
                                     writing compressed Alliance files.  It
                                     has no value by default, means no filter
                                     is used.

       MBK_FILTER_SFX                internaly FILTER_SFX. Extention of
                                     compressed files.  It has no value by
                                     default, means no filter is used.

EXAMPLE
       #include "mut.h"
       #include "mlo.h"
       lofig_list ∗load_fig(name)
       char ∗name;
       {
          mbkenv(); /∗ make sure the good environnement is used ∗/
          return getlofig(name, 'A');
       }

SEE ALSO
       mbk(1), genlib(1), loadlofig(3), loadphfig(3), savelofig(3),
       savephfig(3), isvdd(3), isvss(3), concatname(3), nameindex(3).




BUG REPORT
       This tool is under development at the ASIM department of the LIP6
       laboratory.
       We need your feedback to improve documentation and tools.






ASIM/LIP6                       October 1, 1997                      MBKENV(3)