ldr_next_module(3) Library Functions Manual ldr_next_module(3)
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
ldr_next_module(3)