Content-type: text/html Man page of ldr_inq_module

ldr_inq_module

Section: C Library Functions (3)
Index Return to Main Contents
 

NAME

ldr_inq_module - Returns information about a loaded module  

LIBRARY

Standard C Library (libc.a)  

SYNOPSIS

#include <sys/types.h> #include <loader.h> int ldr_inq_module(        ldr_process_tprocess,
ldr_module_tmod_id, ldr_module_info_t*info, size_tinfo_size, size_t*ret_size);  

PARAMETERS

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

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

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

RETURN VALUES

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

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.  

RELATED INFORMATION

Functions: ldr_inq_region(3), ldr_next_module(3) delim off


 

Index

NAME
LIBRARY
SYNOPSIS
PARAMETERS
DESCRIPTION
NOTES
RETURN VALUES
ERRORS
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:42:01 GMT, October 02, 2010