DCZeroRange

Syntax

#include <cafe/os.h>
    
void DCZeroRange( void* addr, u32 nBytes );

Parameters

addr Data address for operation.
nBytes Number of bytes for operation.

Return Values

None.

Description

Executes the PowerPC Data Cache Block Zero (dcbz) instruction on given address range. nBytes is rounded up to the closest 32-byte boundary. Data cache blocks in the referenced range are initialized to zero. The operation proceeds even if the cache is disabled or locked.

IMPORTANT:
This function is reentrant and thread-safe. However, the function does not execute atomically and its operation could be interrupted by higher priority threads.

Do Not Call From

None.

See Also

IBM Espresso RISC Microprocessor Developer's User Manual, Version 2 on your local Nintendo developer support group website.
DCFlushRange
DCFlushRangeNoSync
DCInvalidateRange
DCStoreRange
DCStoreRangeNoSync
DCTouchRange

Revision History

2013/05/08 Automated cleanup pass.
2012/07/30 Cleanup Pass.
2011/03/15 Initial version.


CONFIDENTIAL