arm_stop_application (3) - Linux Manuals
arm_stop_application: stop application
NAMEarm_stop_application - stop application
DESCRIPTIONarm_stop_application() indicates that the application instance has finished making ARM calls. It typically means that the instance is ending, such as just prior to the process exiting or a thread that represents an application instance terminating.
If the arm_start_application() used the system address sub-buffer to indicate that the ARM calls would be about an application instance on a different system, arm_stop_application() indicates that no more calls about that application instance and its transactions will be made.
After executing arm_stop_application(), no further calls should be made for this application, including calls for transactions created by this application, until a new instance "session" is started using arm_start_application(). Data from any other calls that are made will be ignored. This function is the equivalent of the ARM 2.0 function arm_end().
app_handle is a handle returned in an out parameter from an arm_start_application() call in the same process.
buffer4 is a pointer to the user data buffer, if any. If the pointer is null, there is no buffer. No
sub-buffer types are currently valid with this function call, so the pointer should be
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_discard_transaction(3), arm_start_application(3), arm_start_transaction(3), arm_stop_transaction(3)