*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> ldgetaux (3)              



NAME    [Toc]    [Back]

       ldgetaux - retrieves an auxiliary entry

SYNOPSIS    [Toc]    [Back]

       #include  <stdio.h>  #include <filehdr.h> #include <sym.h>
       #include <ldfcn.h>

       pAUXU ldgetaux(
               LDFILE ldptr,
               long iaux );

DESCRIPTION    [Toc]    [Back]

       The ldgetaux() routine returns a pointer to the  auxiliary
       table  entry  (AUXU)  indexed  by iaux.  The entry is contained
 in a static buffer. Because the buffer can be overwritten
  by  later  calls to ldgetaux(), the entry must be
       copied by the caller if it is to be saved or changed.

       Note that auxiliary table  entries  are  not  swapped.  If
       LDAUXSWAP(ldptr,ldf)   is   nonzero,  a  further  call  to
       swap_aux() is required. Before calling the swap_aux() routine,
 the caller should copy the entry.

       If   the   auxiliary  table  entry  cannot  be  retrieved,
       ldgetaux() returns NULL. This occurs when:  The  auxiliary
       table  cannot  be found The iaux offset into the auxiliary
       table is beyond the end of the table

       The ltdbread()  routine  returns  a  local  symbol  (SYMR)
       structure  that  may  contain  an index into the auxiliary
       table.  If so, ldgetaux() can be called with this index to
       retrieve  data  type  information for the local symbol. If
       the data type information for a  symbol  is  not  present,
       ldgetaux() should not be called.

       The  program  must  be  loaded with the object file access
       routine library libmld.a.

SEE ALSO    [Toc]    [Back]

       ldclose(3), ldopen(3), ldtbseek(3), ldtbread(3), ldfcn(4)

[ Back ]
 Similar pages
Name OS Title
ldgetaux IRIX retrieve an auxiliary entry, given an index
DXmSvnGetEntryNumber Tru64 Retrieves (returns) an entry number for a specified entry tag value.
acl_get_tag_type Tru64 Retrieves the entry tag type identifier for an ACL entry
acl_get_qualifier Tru64 Retrieves the tag qualifier (ID) for an ACL entry
acl_get_permset Tru64 Retrieves a pointer to the permissions for a given ACL entry
DXmSvnGetEntryTag Tru64 Retrieves (returns) an entry's tag for a specified entry number.
DXmSvnGetEntrySensitivity Tru64 Retrieves (returns) the sensitivity of an entry in the display.
DXmSvnGetEntryPosition Tru64 Retrieves (returns) the position of an entry in the display.
DXmSvnGetEntryLevel Tru64 Retrieves (returns) the level of an entry in the display.
DXmSvnGetSelections Tru64 Retrieves (returns) a list of selected entry numbers.
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service