NAME    [Toc]    [Back]

       ldr_inq_module - Return information about a loaded module

SYNOPSIS    [Toc]    [Back]

       #include <sys/types.h> #include <loader.h>

       int ldr_inq_module(
               ldr_process_t process,
               ldr_module_t mod_id,
               ldr_module_info_t *info,
               size_t info_size,
               size_t *ret_size );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc)

PARAMETERS    [Toc]    [Back]

       Specifies  the  process  whose  address space contains the
       module for which information is required.  Identifies  the
       module.   The  module  ID  is  returned when the module is
       first loaded.  Points to a buffer into which the  information
  is returned.  Specifies the size of the info buffer,
       in bytes.  Specifies the number of bytes returned into the
       info buffer.

DESCRIPTION    [Toc]    [Back]

       The  ldr_inq_module() function returns information about a
       specified module contained within the address space of the
       specified process into the variable pointed to by the info
       parameter. The info_size parameter  is  the  size  of  the
       buffer  provided.  The number of bytes filled in (that is,
       the returned structure size) is  returned  in  the  buffer
       pointed to by the ret_size parameter.

       To  obtain  the  unique process identifier for the current
       process, use the call:

       ldr_process_t ldr_my_process();

       To obtain the unique process identifier  for  the  kernel,
       use the call:

       ldr_process_t ldr_kernel_process();

NOTES    [Toc]    [Back]

       This  function  is currently only implemented for the current
 process and the kernel.

RETURN VALUES    [Toc]    [Back]

       Upon successful completion, the function returns  a  value
       of 0 (zero).  If the operation fails, the function returns
       a negative error value and  sets  errno  to  indicate  the
       error.

ERRORS    [Toc]    [Back]

       If  the  ldr_inq_module() function fails, errno may be set
       to one of the following values: The specified module ID is
       not valid.  The process identifier is not valid.

       In addition, errors pertaining to the IPC mechanism can be
       returned.

SEE ALSO    [Toc]    [Back]

       Functions: ldr_inq_region(3), ldr_next_module(3)



                                                ldr_inq_module(3)