Manager: Multiprocessing Services


Carbon supports the entire Multiprocessing Services 2.1 programming interface. Some debugging functions from older versions are not supported; under Mac OS 9 you can use MPRegisterDebugger to register a debugger instead. Under Mac OS X, use the mach APIs provided by the system to implement debugging services.

Note that under Mac OS X, the opaque notification IDs (MPOpaqueIDs) returned by functions such as MPCreateCriticalRegion are local to your process; they are not globally addressible across processes. Furthermore, global memory allocation is not supported under Mac OS X.

Unsupported  _MPAllocateSys

Use MPAllocateAligned instead. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  _MPDebugStr

For an example of how to debug MP tasks, see the MPDebugStr sample code in the Multiprocessing SDK at:

ftp://ftp.apple.com/developer/Development_Kits/Multiprocessing_2.1v2_SDK.sit.bin Not available in CarbonLib. Not available in Mac OS X.

Unsupported  _MPInitializePrintf

For an example of how to debug MP tasks, see the MPDebugStr sample code in the Multiprocessing SDK at:

ftp://ftp.apple.com/developer/Development_Kits/Multiprocessing_2.1v2_SDK.sit.bin

Supported  _MPIsFullyInitialized

Available in CarbonLib 1.0 and later when MultiprocessingLib 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  _MPLibraryIsCompatible

Available in CarbonLib 1.0 and later when MultiprocessingLib 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  _MPLibraryVersion

Available in CarbonLib 1.0 and later when MultiprocessingLib 1.0 or later is present. Available in Mac OS X 10.0 and later.

Unsupported  _MPPrintf

For an example of how to debug MP tasks, see the MPDebugStr sample code in the Multiprocessing SDK at:

ftp://ftp.apple.com/developer/Development_Kits/Multiprocessing_2.1v2_SDK.sit.bin

Unsupported  _MPRPC

Use MPRemoteCall instead. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  _MPStatusCString

For an example of how to debug MP tasks, see the MPDebugStr sample code in the Multiprocessing SDK at:

ftp://ftp.apple.com/developer/Development_Kits/Multiprocessing_2.1v2_SDK.sit.bin Not available in CarbonLib. Not available in Mac OS X.

Unsupported  _MPStatusPString

For an example of how to debug MP tasks, see the MPDebugStr sample code in the Multiprocessing SDK at:

ftp://ftp.apple.com/developer/Development_Kits/Multiprocessing_2.1v2_SDK.sit.bin Not available in CarbonLib. Not available in Mac OS X.

Unsupported  _MPTaskIsToolboxSafe

You should query MPTaskIsPreemptive instead (where a false result indicates a nonreentrant cooperative task) Not available in CarbonLib. Not available in Mac OS X.

Not Recommended  MPAllocate

Use MPAllocateAligned instead. Available in CarbonLib 1.0 and later when MultiprocessingLib 1.0 or later is present. Available in Mac OS X 10.0 and later.

Modified  MPAllocateAligned

Mac OS X does not support allocation of global (cross address space) or resident memory with this function. In addition, passing the kMPAllocateNoGrowthMask constant in the options parameter has no effect under Mac OS X, since memory allocation is done with sparse heaps. Available in CarbonLib 1.0 and later when MultiprocessingLib 2.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPAllocateTaskStorageIndex

Available in CarbonLib 1.0 and later when MultiprocessingLib 2.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPArmTimer

Available in CarbonLib 1.0 and later when MultiprocessingLib 2.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPBlockClear

Available in CarbonLib 1.0 and later when MultiprocessingLib 2.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPBlockCopy

Available in CarbonLib 1.0 and later when MultiprocessingLib 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPCancelTimer

Available in CarbonLib 1.0 and later when MultiprocessingLib 2.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPCauseNotification

Available in CarbonLib 1.0 and later when MultiprocessingLib 2.1 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPCreateCriticalRegion

Available in CarbonLib 1.0 and later when MultiprocessingLib 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPCreateEvent

Available in CarbonLib 1.0 and later when MultiprocessingLib 2.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPCreateNotification

Available in CarbonLib 1.0 and later when MultiprocessingLib 2.1 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPCreateQueue

Available in CarbonLib 1.0 and later when MultiprocessingLib 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPCreateSemaphore

Available in CarbonLib 1.0 and later when MultiprocessingLib 1.0 or later is present. Available in Mac OS X 10.0 and later.

Modified  MPCreateTask

In Mac OS X prior to version 10.1, the stackSize parameter is ignored, and all stacks have the default size of 512 KB. Versions 10.1 and later do not have this limitation. Available in CarbonLib 1.0 and later when MultiprocessingLib 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPCreateTimer

Available in CarbonLib 1.0 and later when MultiprocessingLib 2.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPCurrentTaskID

Available in CarbonLib 1.0 and later when MultiprocessingLib 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPDataToCode

Available in CarbonLib 1.0 and later when MultiprocessingLib 2.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPDeallocateTaskStorageIndex

Available in CarbonLib 1.0 and later when MultiprocessingLib 2.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPDelayUntil

Available in CarbonLib 1.0 and later when MultiprocessingLib 2.0 or later is present. Available in Mac OS X 10.0 and later.

Unsupported  MPDelayUntilSys

Use MPDelayUntil instead. Not available in CarbonLib. Not available in Mac OS X.

Supported  MPDeleteCriticalRegion

Available in CarbonLib 1.0 and later when MultiprocessingLib 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPDeleteEvent

Available in CarbonLib 1.0 and later when MultiprocessingLib 2.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPDeleteNotification

Available in CarbonLib 1.0 and later when MultiprocessingLib 2.1 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPDeleteQueue

Available in CarbonLib 1.0 and later when MultiprocessingLib 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPDeleteSemaphore

Available in CarbonLib 1.0 and later when MultiprocessingLib 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPDeleteTimer

Available in CarbonLib 1.0 and later when MultiprocessingLib 2.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPDisposeTaskException

Available in CarbonLib 1.0 and later when MultiprocessingLib 2.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPEnterCriticalRegion

Available in CarbonLib 1.0 and later when MultiprocessingLib 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPExit

Available in CarbonLib 1.0 and later when MultiprocessingLib 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPExitCriticalRegion

Available in CarbonLib 1.0 and later when MultiprocessingLib 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPExtractTaskState

Available in CarbonLib 1.0 and later when MultiprocessingLib 2.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPFree

Available in CarbonLib 1.0 and later when MultiprocessingLib 1.0 or later is present. Available in Mac OS X 10.0 and later.

Unsupported  MPGetAddressSpaceInfo

The informational calls used to report on system usage are not supported in Carbon. If you wish to report on system usage on Mac OS X,this is best done at the OS level using the provided mach APIs. Not available in CarbonLib. Not available in Mac OS X.

Supported  MPGetAllocatedBlockSize

Available in CarbonLib 1.0 and later when MultiprocessingLib 2.0 or later is present. Available in Mac OS X 10.0 and later.

Unsupported  MPGetCriticalRegionInfo

The informational calls used to report on system usage are not supported in Carbon. If you wish to report on system usage on Mac OS X,this is best done at the OS level using the provided mach APIs. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  MPGetEventInfo

The informational calls used to report on system usage are not supported in Carbon. If you wish to report on system usage on Mac OS X,this is best done at the OS level using the provided mach APIs. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  MPGetNextAddressSpaceID

The informational calls used to report on system usage are not supported in Carbon. If you wish to report on system usage on Mac OS X,this is best done at the OS level using the provided mach APIs. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  MPGetNextAreaID

The informational calls used to report on system usage are not supported in Carbon. If you wish to report on system usage on Mac OS X,this is best done at the OS level using the provided mach APIs. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  MPGetNextCoherenceID

The informational calls used to report on system usage are not supported in Carbon. If you wish to report on system usage on Mac OS X,this is best done at the OS level using the provided mach APIs. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  MPGetNextConsoleID

The informational calls used to report on system usage are not supported in Carbon. If you wish to report on system usage on Mac OS X,this is best done at the OS level using the provided mach APIs. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  MPGetNextCpuID

Not available in CarbonLib. Not available in Mac OS X.

Unsupported  MPGetNextCriticalRegionID

The informational calls used to report on system usage are not supported in Carbon. If you wish to report on system usage on Mac OS X,this is best done at the OS level using the provided mach APIs. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  MPGetNextEventID

The informational calls used to report on system usage are not supported in Carbon. If you wish to report on system usage on Mac OS X,this is best done at the OS level using the provided mach APIs. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  MPGetNextID

The informational calls used to report on system usage are not supported in Carbon. If you wish to report on system usage on Mac OS X,this is best done at the OS level using the provided mach APIs. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  MPGetNextNotificationID

The informational calls used to report on system usage are not supported in Carbon. If you wish to report on system usage on Mac OS X,this is best done at the OS level using the provided mach APIs. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  MPGetNextProcessID

The informational calls used to report on system usage are not supported in Carbon. If you wish to report on system usage on Mac OS X,this is best done at the OS level using the provided mach APIs. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  MPGetNextQueueID

The informational calls used to report on system usage are not supported in Carbon. If you wish to report on system usage on Mac OS X,this is best done at the OS level using the provided mach APIs. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  MPGetNextSemaphoreID

The informational calls used to report on system usage are not supported in Carbon. If you wish to report on system usage on Mac OS X,this is best done at the OS level using the provided mach APIs. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  MPGetNextTaskID

Not available in CarbonLib. Not available in Mac OS X.

Unsupported  MPGetNextTimerID

The informational calls used to report on system usage are not supported in Carbon. If you wish to report on system usage on Mac OS X,this is best done at the OS level using the provided mach APIs. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  MPGetNotificationInfo

The informational calls used to report on system usage are not supported in Carbon. If you wish to report on system usage on Mac OS X,this is best done at the OS level using the provided mach APIs. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  MPGetPageSize

The informational calls used to report on system usage are not supported in Carbon. If you wish to report on system usage on Mac OS X,this is best done at the OS level using the provided mach APIs. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  MPGetPageSizeClasses

The informational calls used to report on system usage are not supported in Carbon. If you wish to report on system usage on Mac OS X,this is best done at the OS level using the provided mach APIs. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  MPGetQueueInfo

The informational calls used to report on system usage are not supported in Carbon. If you wish to report on system usage on Mac OS X,this is best done at the OS level using the provided mach APIs. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  MPGetSemaphoreInfo

The informational calls used to report on system usage are not supported in Carbon. If you wish to report on system usage on Mac OS X,this is best done at the OS level using the provided mach APIs. Not available in CarbonLib. Not available in Mac OS X.

Supported  MPGetTaskStorageValue

Available in CarbonLib 1.0 and later when MultiprocessingLib 2.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPModifyNotification

Available in CarbonLib 1.0 and later when MultiprocessingLib 2.1 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPModifyNotificationParameters

Available in CarbonLib 1.0 and later when MultiprocessingLib 2.3 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPNotifyQueue

Available in CarbonLib 1.0 and later when MultiprocessingLib 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPProcessors

Available in CarbonLib 1.0 and later when MultiprocessingLib 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPProcessorsScheduled

Available in CarbonLib 1.0 and later when MultiprocessingLib 2.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPRegisterDebugger

Under Mac OS X, this function is available but is not implemented. Use system debugging services to write a debugger for Mac OS X. Available in CarbonLib 1.0 and later when MultiprocessingLib 2.0 or later is present. Available in Mac OS X 10.0 and later.

Modified  MPRemoteCall

In Mac OS X, you can only execute a remote call within your application's process. That is, the only allowable constant to pass in the context parameter is kMPOwningProcessRemoteContext. Available in CarbonLib 1.0 and later when MultiprocessingLib 2.0 or later is present. Available in Mac OS X 10.0 and later.

Unsupported  MPRPC

Use MPRemoteCall instead.

Supported  MPSetEvent

Available in CarbonLib 1.0 and later when MultiprocessingLib 2.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPSetExceptionHandler

Available in CarbonLib 1.0 and later when MultiprocessingLib 2.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPSetQueueReserve

Available in CarbonLib 1.0 and later when MultiprocessingLib 2.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPSetTaskState

Available in CarbonLib 1.0 and later when MultiprocessingLib 2.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPSetTaskStorageValue

Available in CarbonLib 1.0 and later when MultiprocessingLib 2.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPSetTaskType

Available in CarbonLib 1.0 and later when MultiprocessingLib 2.3 or later is present. Available in Mac OS X 10.0 and later.

Modified  MPSetTaskWeight

MPSetTaskWeight will set task priorities on Mac OS X. Available in CarbonLib 1.0 and later when MultiprocessingLib 2.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPSetTimerNotify

Available in CarbonLib 1.0 and later when MultiprocessingLib 2.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPSignalSemaphore

Available in CarbonLib 1.0 and later when MultiprocessingLib 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPTaskIsPreemptive

Available in CarbonLib 1.0 and later when MultiprocessingLib 2.0 or later is present. Available in Mac OS X 10.0 and later.

Unsupported  MPTaskIsToolboxSafe

You should query MPTaskIsPreemptive instead (where a false result indicates a nonreentrant cooperative task)

Supported  MPTerminateTask

Available in CarbonLib 1.0 and later when MultiprocessingLib 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPThrowException

This function is available under Mac OS X, but is not implemented. Available in CarbonLib 1.0 and later when MultiprocessingLib 2.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPUnregisterDebugger

Under Mac OS X, this function is available but is not implemented. Use system debugging services to write a debugger for Mac OS X. Available in CarbonLib 1.0 and later when MultiprocessingLib 2.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPWaitForEvent

Available in CarbonLib 1.0 and later when MultiprocessingLib 2.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPWaitOnQueue

Available in CarbonLib 1.0 and later when MultiprocessingLib 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPWaitOnSemaphore

Available in CarbonLib 1.0 and later when MultiprocessingLib 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  MPYield

Available in CarbonLib 1.0 and later when MultiprocessingLib 1.0 or later is present. Available in Mac OS X 10.0 and later.

[Table of Contents] [Manager Index] [Function Index]

Generated on: 12/12/2001. Copyright © 1999-2001 Apple Computer, Inc. All rights reserved.