arm_stop_transaction (3) - Linux Manuals
arm_stop_transaction: stop transaction
NAMEarm_stop_transaction - stop transaction
DESCRIPTIONarm_stop_transaction() signals the end of a transaction.
buffer4 is a pointer to the user data buffer, if any. If the pointer is null (ARM_BUF4_NONE),
there is no buffer. The sub-buffers that may be used are
arm_subbuffer_diag_detail_t and arm_subbuffer_metric_values_t.
tran_handle is a handle returned in an out parameter from an arm_start_transaction() call in the same process.
tran_status indicates the status of the transaction. The following values are allowed:
- (ARM_STATUS_GOOD) = transaction completed successfully
- (ARM_STATUS_ABORTED) = transaction was aborted before it completed. For example, the user might have pressed "Stop" or "Back" on a browser while a transaction was in process, causing the transaction, as measured at the browser, to be aborted.
- (ARM_STATUS_FAILED) = transaction completed in error
- (ARM_STATUS_UNKNOWN) = transaction completed but the status was unknown. This would most likely occur if middleware or some other form of proxy instrumentation measured the transaction. This instrumentation may know enough to know when the transaction starts and stops, but does not understand the application-specific semantics sufficiently well to know whether the transaction was successful.
RETURN VALUEOn success, the function returns ARM_SUCCESS. A non-zero value indicates an error.
ERRORSIf the return code is negative, an error occurred. If the return code is not negative, an error may or may not have occurred - the determination of what is an error and whether an error code is returned is at the discretion of the ARM implementation. The application can test the return code if it wants to provide its own error logging.
The following errors are recognized by this implementation, but may not be portable to other implementations:
- An internal error has occurred that prevented the operation from completing. Check your system log for more details.
CONFORMING TOARM Issue 4.0 C Language Bindings, Version 2
SEE ALSOarm_bind_thread(3), arm_block_transaction(3), arm_start_transaction(3), arm_unbind_thread(3), arm_unblock_transaction(3)