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

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



NAME    [Toc]    [Back]

       ldr_next_module - Return the next module ID for a process

SYNOPSIS    [Toc]    [Back]

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

       int ldr_next_module(
               ldr_process_t process,
               ldr_module_t *mod_id_ptr );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc)

PARAMETERS    [Toc]    [Back]

       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    [Toc]    [Back]

       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_procesd();

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       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.

SEE ALSO    [Toc]    [Back]

       Functions: ldr_inq_module(3), ldr_inq_region(3)

[ Back ]
 Similar pages
Name OS Title
ldr_inq_region Tru64 Return module information about a region in a loaded module
kldfirstmod FreeBSD return first module id from the kld file specified
modfnext FreeBSD return the modid of the next kernel module
ldr_inq_module Tru64 Return information about a loaded module
modnext FreeBSD return the modid of the next kernel module
tt_open HP-UX return the process identifier for the calling process
nsg_get_pids Tru64 Return a list of a NUMA Scheduling Group's process identifiers (libnuma library)
getpid IRIX get process, process group, and parent process IDs
getppid Tru64 Get the process ID, process group ID, or parent process ID
getpgid HP-UX get process, process group and parent process ID.
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service