Content-type: text/html Man page of ldr_next_module

ldr_next_module

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

NAME

ldr_next_module - Returns the next module ID for a process  

LIBRARY

Standard C Library (libc.a)  

SYNOPSIS

#include <sys/types.h> #include <loader.h> int ldr_next_module()(        ldr_process_tprocess,
       ldr_module_t *mod_id_ptr);
 

PARAMETERS

Specifies the process for which the next module ID is required. Points to a buffer in which the module ID of a loaded module will be returned.

 

DESCRIPTION

The ldr_next_module() function returns the next module ID for the specified process, given a specified module ID. It iterates through the module IDs of all modules currently loaded in a specified process.

To get the first module ID for the process, specify LDR_NULL_MODULE for the initial module ID. Repeated calls to the ldr_next_module() function will return all the module IDs for the process. The function returns LDR_NULL_MODULE after returning the last module ID.

To obtain the unique identifier for the current process, use the following call:        ldr_process_t ldr_my_process();
To obtain the unique identifier for the kernel, use the following call:        ldr_process_t ldr_kernel_process();
To return the IDs for kernel modules, specify the returned identifier for the process parameter.  

RETURN VALUES

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

ERRORS

If the ldr_next_module() function fails, errno may be set to the following value: The module ID specified by mod_id_ptr is not valid.  

RELATED INFORMATION

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


 

Index

NAME
LIBRARY
SYNOPSIS
PARAMETERS
DESCRIPTION
RETURN VALUES
ERRORS
RELATED INFORMATION

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