View source for $GET SYS ALIGN FAULT DATA

'''$GET_SYS_ALIGN_FAULT_DATA''' is a [[System Service|system service]] that obtains data from the system alignment fault buffer on [[Alpha]] and [[Itanium|I64]] systems if
buffered system alignment fault data reporting has been enabled.
This service accepts 64-bit addresses.
When buffered system alignment fault data reporting is enabled, the operating
system writes each alignment fault into a system-allocated buffer. The user must poll this buffer periodically to read the data.
The user must call the $INIT_SYS_ALIGN_FAULT_REPORT service to enable buffered system alignment fault data reporting. For more information, see the [[$INIT_SYS_ALIGN_FAULT_REPORT]] service.

=Format=
 <nowiki>SYS$GET_SYS_ALIGN_FAULT_DATA </nowiki>[[#buffer|buffer]]<nowiki> ,</nowiki>[[#buffer_size|buffer_size]]<nowiki> ,</nowiki>[[#return_size|return_size]]

C Prototype:
 int sys$get_sys_align_fault_data (void *buffer, int buffer_size, int *return_size);

=Arguments=
==buffer==
{{SyservArgument|address|longword (unsigned)|read/write|by 32- or 64-bit reference}}

The user buffer in which the alignment fault data is to be stored. The buffer
argument is the 32- or 64-bit virtual address of this buffer.

==buffer_size==
{{SyservArgument|byte count|longword (signed)|read|by value}}

The size, in bytes, of the buffer specified by the buffer argument.

==return_size==
{{SyservArgument|rights_id|longword (unsigned)|write|by 32- or 64-bit reference}}

The amount of data, in bytes, stored in the buffer. The return_size argument is
the 32- or 64-bit virtual address of a naturally aligned longword into which the service returns the amount of data, in bytes, stored in the buffer. The return_size argument is set to 0 if there is no data in the buffer.

=Condition Values Returned=
{| class="wikitable"
! colspan="col" | Value
! colspan="col" | Description
|-
| SS$_NORMAL
| The service completed successfully.
|-
| SS$_ACCVIO
| The buffer named in the buffer argument is not accessible.
|-
| SS$_AFR_NOT_ENABLED
| Alignment fault reporting has not been enabled.
|-
| SS$_BADPARAM
| The buffer size is smaller than the minimum defined by the AFR$K_VMS_LENGTH or the AFR$K_EXTENDED_LENGTH symbol.
|}
=Privileges Required=
CMKRNL privilege is required.

=Quota Required=
None

=See also=
* [[$GET_ALIGN_FAULT_DATA]]
* [[$INIT_SYS_ALIGN_FAULT_REPORT]]
* [[$PERM_DIS_ALIGN_FAULT_REPORT]]
* [[$PERM_REPORT_ALIGN_FAULT]]
* [[$START_ALIGN_FAULT_REPORT]]
* [[$STOP_ALIGN_FAULT_REPORT]]
* [[$STOP_SYS_ALIGN_FAULT_REPORT]]