The OpenNET Project / Index page

[ новости /+++ | форум | теги | ]

Интерактивная система просмотра системных руководств (man-ов)

 ТемаНаборКатегория 
 
 [Cписок руководств | Печать]

elf_newscn (3)
  • >> elf_newscn (3) ( FreeBSD man: Библиотечные вызовы )

  • BSD mandoc
     

    NAME

    elf_getscn
    
     
    elf_ndxscn
    
     
    elf_newscn
    
     
    elf_nextscn
    
     - get/allocate section information for an ELF object
    
     
    

    LIBRARY

    Lb libelf
    
     
    

    SYNOPSIS

       #include <libelf.h>
    Elf_Scn * elf_getscn (Elf *elf size_t index);
    size_t elf_ndxscn (Elf_Scn *scn);
    Elf_Scn * elf_newscn (Elf *elf);
    Elf_Scn * elf_nextscn (Elf *elf Elf_Scn *scn);
     

    DESCRIPTION

    These functions are used to iterate through the sections associated with an ELF descriptor.

    Function elf_getscn ();
    will return a section descriptor for the section at index index in the object denoted by ELF descriptor elf An error will be signalled if the specified section does not exist.

    Function elf_ndxscn ();
    returns the section table index associated with section descriptor scn

    Function elf_newscn ();
    creates a new section and appends it to the list of sections associated with descriptor elf The library will automatically increment the e_shnum field of the ELF header associated with descriptor elf and will set the ELF_F_DIRTY bit for the new section. For ELF descriptors opened for writing, the ELF library will automatically create an empty section at index zero ( SHN_UNDEF on the first call to elf_newscn (.);

    Function elf_nextscn ();
    takes a section descriptor scn and returns a pointer to the section descriptor at the next higher index. Argument scn is allowed to be NULL, in which case this function will return a pointer to the section descriptor at index 1. If no further sections are present, function elf_nextscn ();
    will return a NULL pointer.  

    RETURN VALUES

    Functions elf_getscn (,);
    elf_newscn ();
    and elf_nextscn ();
    return a valid pointer to a section descriptor if successful, or NULL if an error occurs.

    Function elf_ndxscn ();
    returns a valid section table index if successful, or SHN_UNDEF if an error occurs.  

    ERRORS

    These functions may fail with the following errors:

    Bq Er ELF_E_ARGUMENT
    Arguments elf or scn were NULL.
    Bq Er ELF_E_ARGUMENT
    Argument index exceeded the current number of sections in the ELF object.
    Bq Er ELF_E_ARGUMENT
    Argument elf was not a descriptor for an ELF file.
    Bq Er ELF_E_ARGUMENT
    Section descriptor scn was not associated with ELF descriptor elf
    Bq Er ELF_E_CLASS
    Descriptor elf was of an unknown ELF class.
    Bq Er ELF_E_SECTION
    Argument elf specified extended section numbering in the ELF header with the section header at index SHN_UNDEF not being of type SHT_NULL

     

    SEE ALSO

    elf(3), elf_flagdata3, elf_flagscn3, elf_getdata3, elf_getshdr3, gelf(3)


     

    Index

    NAME
    LIBRARY
    SYNOPSIS
    DESCRIPTION
    RETURN VALUES
    ERRORS
    SEE ALSO


    Поиск по тексту MAN-ов: 




    Партнёры:
    PostgresPro
    Inferno Solutions
    Hosting by Hoster.ru
    Хостинг:

    Закладки на сайте
    Проследить за страницей
    Created 1996-2024 by Maxim Chirkov
    Добавить, Поддержать, Вебмастеру