DC_FlushAll

Syntax

#include <nitro/os.h>
void DC_FlushAll( void );

void DC_CleanAndInvalidateAll( void );

Arguments

None.

Return Values

None.

Description

Flushes all data in all data cache regions.

Specifically, this function performs a cache writeback in a dirty state (state when a write to data cache is not reflected in main memory), discards all data in cache, and places it in an invalid state.

Call this function when completing data transmission data blocks that use the main memory of other devices, such as when performing DMA transfers or creating graphics commands.

DC_CleanAndInvalidateAll is another name for DC_FlushAll and operates exactly the same way. DC_Clean*/DC_CleanAndInvalidate* were prepared for porting from the prototype SDK version. In most cases, use DC_Store*/DC_Flush*.


Note

The official documentation for the ARM processor sometimes describes Flush as the operation that invalidates the data cache, Clean as the operation that writes back the data cache and puts it into a clean state, and Clean and Flush as the operation that writes back and then invalidates. However, this SDK follows the conventions of the Nintendo GameCube and Nintendo64 by using Invalidate for invalidation, Store for writeback, and Flush for writeback and invalidate operations.  

Internal Operation

Operates register 7 of the system control coprocessor.

See Also

IC_InvalidateAll IC_InvalidateRange
DC_InvalidateAll DC_InvalidateRange
DC_StoreAll DC_StoreRange
DC_FlushRange

Revision History

2003/12/22 Initial version.


CONFIDENTIAL