ELF_KIND(3ELF) ELF Library Functions ELF_KIND(3ELF)

NAME

elf_kind - determine file type

SYNOPSIS

cc [ flag ... ] file ... -lelf [ library ... ]
#include <libelf.h>

Elf_Kind elf_kind(Elf *elf);

DESCRIPTION

This function returns a value identifying the kind of file associated
with an ELF descriptor (elf). Defined values are below:

ELF_K_AR
The file is an archive [see ar.h(3HEAD)]. An ELF descriptor
may also be associated with an archive member, not the
archive itself, and then elf_kind() identifies the member's
type.


ELF_K_COFF
The file is a COFF object file. elf_begin(3ELF) describes
the library's handling for COFF files.


ELF_K_ELF
The file is an ELF file. The program may use elf_getident()
to determine the class. Other functions, such as
elf32_getehdr(), are available to retrieve other file
information.


ELF_K_NONE
This indicates a kind of file unknown to the library.


Other values are reserved, to be assigned as needed to new kinds of
files. elf should be a value previously returned by elf_begin(). A null
pointer is allowed, to simplify error handling, and causes elf_kind() to
return ELF_K_NONE.

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Stable |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+

SEE ALSO

elf(3ELF), elf32_getehdr(3ELF), elf_begin(3ELF), elf_getident(3ELF),
ar.h(3HEAD), libelf(3LIB), attributes(7)

July 11, 2001 ELF_KIND(3ELF)