Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
CPU Performance Counters Library Functionscpc_version(3CPC)


NAME

 cpc_version - coordinate CPC library and application versions

SYNOPSIS

 
cc [ flag... ] file... -lcpc [ library... ]
#include <libcpc.h>
uint_t cpc_version(uint_t version);

DESCRIPTION

 

The cpc_version() function takes an interface version as an argument and returns an interface version as a result. Usually, the argument will be the value of CPC_VER_CURRENT bound to the application when it was compiled.

RETURN VALUES

 

If the version requested is still supported by the implementation, cpc_version() returns the requested version number and the application can use the facilities of the library on that platform. If the implementation cannot support the version needed by the application, cpc_version() returns CPC_VER_NONE, indicating that the application will at least need to be recompiled to operate correctly on the new platform, and may require further changes.

If version is CPC_VER_NONE, cpc_version() returns the most current version of the library.

EXAMPLES

 Example 1. Protect an application from using an incompatible library.
 

The following lines of code protect an application from using an incompatible library:

 
if (cpc_version(CPC_VER_CURRENT) == CPC_VER_NONE) {
        /* version mismatch - library cannot translate */
        exit(1);
}

ATTRIBUTES

 

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
MT-LevelUnsafe
AvailabilitySUNWcpcu (32-bit)
 SUNWcpcux (64-bit)
Interface StabilityEvolving

SEE ALSO

 

cpc(3CPC), attributes(5)

NOTES

 

The version number is used only to express incompatible semantic changes in the performance counter interfaces on the given platform within a single instruction set architecture, for example, when a new set of performance counter registers are added to an existing processor family that cannot be specified in the existing cpc_event_t data structure.


SunOS 5.9Go To TopLast Changed 14 Sep 1999

 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.