GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  ELF_NEXT (3)

NAME

elf_next - provide sequential access to the next archive member

CONTENTS

Library
Synopsis
Description
Return Values
Examples
Errors
See Also

LIBRARY


.Lb libelf

SYNOPSIS


.In libelf.h Elf_Cmd elf_next Elf *elf

DESCRIPTION

The elf_next function causes the ELF archive descriptor corresponding to argument elf to be adjusted to provide access to the next member in the archive on a subsequent call to elf_begin.

The return value of elf_next is suitable for use in a loop invoking elf_begin.

RETURN VALUES

If successful, function elf_next returns the value ELF_C_READ. Otherwise, if argument elf was not associated with an archive, or if it was NULL, or if any other error occurred, the value ELF_C_NULL is returned.

EXAMPLES

To process all the members of an archive use:
Elf_Cmd cmd;
Elf *archive, *e;
...
cmd = ELF_C_READ;
archive = elf_begin(fd, cmd, NULL);
while ((e = elf_begin(fd, cmd, archive)) != (Elf *) 0)
{
        ... process ‘e’ here ...

        cmd = elf_next(e);         elf_end(e); } elf_end(archive);

ERRORS

Function elf_next may fail with the following error:
[ELF_E_ARGUMENT] Argument elf was not associated with a containing ar(1) archive.

SEE ALSO

elf(3), elf_begin(3), elf_end(3), elf_rand(3)
Search for    or go to Top of page |  Section 3 |  Main Index


Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.