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

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



NAME    [Toc]    [Back]

       ldr_inq_region  - Return module information about a region
       in a loaded module

SYNOPSIS    [Toc]    [Back]

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

       int ldr_inq_region(
               ldr_process_t process,
               ldr_module_t mod_id,
               ldr_region_t region,
               ldr_region_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  the  region  information  is required.
       Identifies the module.  The module ID is returned when the
       module is first loaded.  Identifies the region.  Points to
       a ldr_region_info_t buffer in which the information  about
       the  loaded region is returned.  Specifies the size of the
       allocated ldr_region_info_t structure, in  bytes.   Specifies
 the number of types actually returned into the buffer
       pointed to by the info parameter.

DESCRIPTION    [Toc]    [Back]

       The ldr_inq_region() function returns information about  a
       specified  region within a specified module. The module is
       contained within the address space of the  specified  process.
  The  returned  information  includes the number and
       name of the region, its protection attributes,  its  size,
       and  address  information about the region in the process'
       address space.

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

       ldr_process_t ldr_my_process();

       To  obtain  the  unique identifier for the kernel, use the

       ldr_process_t ldr_kernel_process();

       The ldr_region_t values are unique  identifiers  for  each
       loaded  region  for  a particular module. The value of the
       region parameter ranges from 0 (zero) to  (maximum  number
       of regions) -1.

NOTES    [Toc]    [Back]

       The loader assumes that each object module contains one or
       more regions.  A region is a separately relocated,  virtually
  contiguous range within a module.  A region can contain
 text or data.

       This function is currently implemented only 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 errno is set to indicate the

ERRORS    [Toc]    [Back]

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

       Additional  errors may be returned from the underlying IPC
       mechanism (for kernel/cross-process loading).

SEE ALSO    [Toc]    [Back]

       Functions: ldr_inq_module(3), ldr_next_module(3)

[ Back ]
 Similar pages
Name OS Title
ldr_inq_module Tru64 Return information about a loaded module
modstat HP-UX get information for a dynamically loaded kernel module
ldr_next_module Tru64 Return the next module ID for a process
kldfirstmod FreeBSD return first module id from the kld file specified
modfnext FreeBSD return the modid of the next kernel module
modnext FreeBSD return the modid of the next kernel module
pam_set_data FreeBSD set module information
pam_get_data FreeBSD get module information
cssm_GetModuleInfo Tru64 Get the module handle state information
modinfo Linux display information about a kernel module
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service