guest_xfer_flags

Flags for the state read and write requests

Synopsis:

#include <qvm/guest.h>
enum guest_xfer_flags {
    GXF_NONE = 0x00000000,
    GXF_PAUSE = 0x00000001,
    GXF_UNPAUSE = 0x00000002,
    GXF_ASYNC = 0x00000004,
    GXF_GDB = 0x00000008,
    GXF_FLUSH = 0x00000010
};

Data:

GXF_NONE

No flag set.

GXF_PAUSE

Pause the CPU before the transaction.

GXF_UNPAUSE

Unpause the CPU after the transaction.

GXF_ASYNC

A transaction may be performed asynchronously. Use with caution.

GXF_GDB

For internal use.

GXF_FLUSH

Flush the data cache after an operation.

Library:

Provided by qvm; no external library is required.

Description:

The default is GXF_NONE. Use the other values with caution.

For example, if you specify GXF_PAUSE and GXF_UNPAUSE, the target CPU is paused before the transaction and resumed after the transaction, which impacts performance.

If you specify GXF_ASYNC, however, the transaction is performed without pausing the CPU. Asynchronous transactions have less impact on performance than transactions that pause the target CPU. However, inappropriate use of asynchronous transactions may lead to undefined behavior, and should be used with caution.

If you aren't sure about how to use these flags, contact your QNX representative.