Locality Group Library Functions              lgrpversion(3LGRP)



NAME
     lgrpversion - coordinate library and application versions

SYNOPSIS
     cc [ flag ... ] file... -llgrp [ library ... ]
     #include 

     int lgrpversion(const int version);


DESCRIPTION
     The  lgrpversion()  function  takes  an  interface  version
     number, version, as an argument and returns an lgroup inter-
     face version.  The version argument should be the  value  of
     LGRPVERCURENT  bound  to the application when it was com-
     piled or LGRPVERNONE to find out the current lgroup inter-
     face version on the running system.

RETURN VALUES
     If version is still supported by  the  implementation,  then
     lgrpversion()    returns    the   requested   version.   If
     LGRPVERNONE is returned, the implementation cannot support
     the  requested version. The application should be recompiled
     and might require further changes.


     If version  is  LGRPVERNONE,  lgrpversion()  returns  the
     current version of the library.

EXAMPLES
     Example 1 Test whether the version of the interface used  by
     the caller is supported.


     The following example  tests  whether  the  version  of  the
     interface used by the caller is supported:


       #include 

       if (lgrpversion(LGRPVERCURENT) != LGRPVERCURENT) {
           fprintf(stderr, "Built with unsupported lgroup interface %d\n",
               LGRPVERCURENT);
           exit (1);
       }


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





SunOS 5.11          Last change: 16 Apr 2003                    1






Locality Group Library Functions              lgrpversion(3LGRP)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Evolving                    
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     lgrpinit(3LGRP), liblgrp(3LIB), attributes(5)












































SunOS 5.11          Last change: 16 Apr 2003                    2