Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ELF_GETARHDR(3)		 BSD Library Functions Manual	       ELF_GETARHDR(3)

NAME
     elf_getarhdr -- retrieve ar(1) header for an archive member

LIBRARY
     ELF Access	Library	(libelf, -lelf)

SYNOPSIS
     #include <libelf.h>

     Elf_Arhdr *
     elf_getarhdr(Elf *elf);

DESCRIPTION
     The elf_getarhdr()	function returns a pointer to an archive member	header
     for a descriptor elf.  This descriptor must have been returned by a prior
     call to elf_begin(3), and must be a descriptor for	a member inside	an
     ar(1) archive.

     Structure Elf_Arhdr includes the following	members:

     char * ar_name
	     A pointer to a null terminated string containing the translated
	     name of the archive member.

     char * ar_rawname
	     A pointer to a null terminated string containing the untranslated
	     name for the archive member, including all	ar(1) formatting char-
	     acters and	trailing white space.

     time_t ar_date
	     The timestamp associated with the member.

     uid_t ar_uid
	     The uid of	the creator of the member.

     gid_t ar_gid
	     The gid of	the creator of the member.

     mode_t ar_mode
	     The file mode of the member.

     size_t ar_size
	     The size of the member in bytes.

RETURN VALUES
     This function returns a valid pointer to an Elf_Arhdr structure if	suc-
     cessful, or NULL if an error is encountered.

ERRORS
     Function elf_getarhdr() may fail with the following errors:

     [ELF_E_ARGUMENT]  Argument	elf was	NULL.

     [ELF_E_ARGUMENT]  Argument	elf was	not a descriptor for a member of an
		       ar(1) archive.

SEE ALSO
     elf(3), elf_begin(3), elf_getarsym(3), elf_memory(3)

BSD				August 15, 2006				   BSD

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=elf_getarhdr&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help