Manual Pages for UNIX Operating System command usage for man libmlib_mt

Interface Libraries                              libmlib_mt(3LIB)



NAME
     libmlib_mt - multi-threaded mediaLib

SYNOPSIS
     cc [ flag... ] file... -lmlib_mt  -lmlib  [ library... ]
     #include 


DESCRIPTION
     Interfaces in this library provide functions for  multimedia
     processing. Multi-threaded (MT) mediaLib is a software layer
     developed on top of mediaLib using OpenMP.  When it is  used
     with  a large data set on a multi-processor system, MT medi-
     aLib will partition data into subsets and process  the  sub-
     sets  in  parallel,  thus  greatly  improving performance of
     applications that use mediaLib.

INTERFACES
     The shared object libmlib_mt.so.2 provides the  same  public
     interfaces  as  those defined in libmlib(3LIB). See Intro(3)
     for additional information on shared object interfaces.

USAGE
     There are two ways to use MT mediaLib.

         1.   Pre-load a multi-threaded mediaLib  library  during
              runtime by setting the LD_PRELOAD environment vari-
              able as follows before starting  your  application,
              in Bourne/Korn shell:

                LD_PRELOAD=libmlib_mt.so
                export LD_PRELOAD

              or in C shell:

                setenv LD_PRELOAD libmlib_mt.so

              In this way, you can take advantage of MT  mediaLib
              without rebuilding your application.

         2.   Link your application with a  multi-threaded  medi-
              aLib  library directly as shown under SYNOPSIS.  In
              this way, an MT mediaLib  library  is  always  used
              whenever your application is started.


     The parallelization of MT mediaLib is controlled,  in  part,
     by  the  PARALLEL  environment variable.  You can change its
     setting to  adjust  the  degree  of  parallelization  before
     starting your application,  in Bourne/Korn shell:

       PARALLEL=n



SunOS 5.11          Last change: 15 Oct 2007                    1






Interface Libraries                              libmlib_mt(3LIB)



       export PARALLEL



     or in C shell:

       setenv PARALLEL n



     where n is a positive integer for number  of  threads.  Note
     that other factors also affect the degree of parallelization
     in MT mediaLib.

FILES
     /usr/lib/libmlib_mt.so.2

         shared object


     /usr/lib/64/libmlib_mt.so.2

         64-bit shared object


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | library/medialib            |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|


SEE ALSO
     Intro(3), libmlib(3LIB), attributes(5)


     mediaLib User's Manual










SunOS 5.11          Last change: 15 Oct 2007                    2