version 1.4, 2021/03/08 20:55:06 |
version 1.5, 2022/03/12 21:37:55 |
|
|
.\" out of the use of this software, even if advised of the possibility of |
.\" out of the use of this software, even if advised of the possibility of |
.\" such damage. |
.\" such damage. |
.\" |
.\" |
.\" Id: gelf_getmove.3 3928 2021-03-07 19:47:55Z jkoshy |
.\" Id: gelf_getmove.3 3958 2022-03-12 14:31:32Z jkoshy |
.\" |
.\" |
.Dd April 22, 2019 |
.Dd April 22, 2019 |
.Dt GELF_GETMOVE 3 |
.Dt GELF_GETMOVE 3 |
|
|
structures in an ELF object. |
structures in an ELF object. |
.Pp |
.Pp |
Argument |
Argument |
.Ar data |
.Fa data |
is an |
is an |
.Vt Elf_Data |
.Vt Elf_Data |
descriptor associated with a section of type |
descriptor associated with a section of type |
.Dv SHT_SUNW_move . |
.Dv SHT_SUNW_move . |
Argument |
Argument |
.Ar ndx |
.Fa ndx |
is the index of the move record being retrieved or updated. |
is the index of the move record being retrieved or updated. |
The class-independent |
The class-independent |
.Vt GElf_Move |
.Vt GElf_Move |
Line 64 structure is described in |
|
Line 64 structure is described in |
|
Function |
Function |
.Fn gelf_getmove |
.Fn gelf_getmove |
retrieves class-dependent move record at index |
retrieves class-dependent move record at index |
.Ar ndx |
.Fa ndx |
in data buffer |
in data buffer |
.Ar data |
.Fa data |
and copies it to the destination pointed to by argument |
and copies it to the destination pointed to by argument |
.Ar move |
.Fa move |
after translation to class-independent form. |
after translation to class-independent form. |
.Pp |
.Pp |
Function |
Function |
.Fn gelf_update_move |
.Fn gelf_update_move |
converts the class-independent move information pointed to |
converts the class-independent move information pointed to |
by argument |
by argument |
.Ar move |
.Fa move |
to class-dependent form, and writes it to the move record at index |
to class-dependent form, and writes it to the move record at index |
.Ar ndx |
.Fa ndx |
in the data buffer described by argument |
in the data buffer described by argument |
.Ar data . |
.Fa data . |
Function |
Function |
.Fn gelf_update_move |
.Fn gelf_update_move |
signals an error if any of the values in the class-independent |
signals an error if any of the values in the class-independent |
|
|
Function |
Function |
.Fn gelf_getmove |
.Fn gelf_getmove |
returns the value of argument |
returns the value of argument |
.Ar move |
.Fa move |
if successful, or |
if successful, or |
.Dv NULL |
.Dv NULL |
in case of an error. |
in case of an error. |
Line 101 These functions may fail with the follow |
|
Line 101 These functions may fail with the follow |
|
.Bl -tag -width "[ELF_E_RESOURCE]" |
.Bl -tag -width "[ELF_E_RESOURCE]" |
.It Bq Er ELF_E_ARGUMENT |
.It Bq Er ELF_E_ARGUMENT |
Arguments |
Arguments |
.Ar data |
.Fa data |
or |
or |
.Ar move |
.Fa move |
were |
were |
.Dv NULL . |
.Dv NULL . |
.It Bq Er ELF_E_ARGUMENT |
.It Bq Er ELF_E_ARGUMENT |
Argument |
Argument |
.Ar ndx |
.Fa ndx |
was less than zero or larger than the number of records in the data |
was less than zero or larger than the number of records in the data |
descriptor. |
descriptor. |
.It Bq Er ELF_E_ARGUMENT |
.It Bq Er ELF_E_ARGUMENT |
Data descriptor |
Data descriptor |
.Ar data |
.Fa data |
was not associated with a section containing move information. |
was not associated with a section containing move information. |
.It Bq Er ELF_E_RANGE |
.It Bq Er ELF_E_RANGE |
A value was not representable in the target type. |
A value was not representable in the target type. |
Line 121 A value was not representable in the tar |
|
Line 121 A value was not representable in the tar |
|
The |
The |
.Vt Elf_Data |
.Vt Elf_Data |
descriptor denoted by argument |
descriptor denoted by argument |
.Ar data |
.Fa data |
is associated with an ELF object with an unsupported version. |
is associated with an ELF object with an unsupported version. |
.El |
.El |
.Sh SEE ALSO |
.Sh SEE ALSO |