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

  man pages->HP-UX 11i man pages -> modstat (2)              


 modstat(2)                                                       modstat(2)

 NAME    [Toc]    [Back]
      modstat - get information for a dynamically loaded kernel module

 SYNOPSIS    [Toc]    [Back]
      #include <sys/mod.h>
      int modstat(int module_id, struct modstatus *stbuf,
                  int get_next_module);

 DESCRIPTION    [Toc]    [Back]
      The modstat function allows processes to get information for
      dynamically loaded kernel modules.  For modules with appropriate
      privilege, it fills in all the elements of the modstatus structure,
      specified by stbuf, with the information available for the given
      module identifier module_id.  For non-privileged processes, modstat
      fills in all information except the address and size of the module
      object file sections in memory (ms_base, ms_size, ms_bss,

      If the value of get_next_module is TRUE, modstat returns the
      information for the next module whose identifier is greater than or
      equal to module_id.  Any module_id associated with a registered module
      may be queried by modstat.

      The struct modstatus and struct modspecific_stat definitions are:

           struct modstatus {
                int32_t  ms_id;               /* numeric id of module */
                uint64_t ms_base;             /* base address of module */
                uint32_t ms_size;             /* amount of memory of module
                                              when loaded */
                uint64_t ms_bss;              /* base address of BSS */
                uint32_t ms_bss_size;         /* memory size of BSS */
                int32_t  ms_rev;              /* version number */
                char     ms_path[MAXPATHLEN]; /* loaded module path */
                time_t   ms_unload_delay;     /* unload delay */
                int32_t  ms_holdcnt;          /* hold count */
                int32_t  ms_depcnt;           /* dependent count */
                struct modspecific_stat       /* module type specific info */
                int      ms_reg;
                char     ms_version[MODMAXVERLEN]; /* Version string */
           struct modspecific_stat {
               char     mss_linkinfo[MODMAXLINKINFOLEN]; /* informational */
               int32_t  mss_type;                 /* type of module */
               int32_t  mss_p0[2];                /* type specific info */
               int32_t  mss_p1[2];                /* type specific info */

    Notes    [Toc]    [Back]

 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003

 modstat(2)                                                       modstat(2)

      modstat is currently implemented as a macro.

 RETURN VALUE    [Toc]    [Back]
      On success, modstat returns 0, otherwise it returns -1 and sets errno
      to indicate the error.

 ERRORS    [Toc]    [Back]
      modstat fails if one or more of the following are true:

      [EINVAL]      module_id does not match any loaded or registered module
                    when get_next_module is FALSE or module_id is greater
                    than the identifier for any loaded module when
                    get_next_module is TRUE.

      [ENOSYS]      The Dynamically Loadable Kernel Module feature is not

      [EPERM]       The calling process does not have appropriate privilege.

 SEE ALSO    [Toc]    [Back]
      kcmodule(1M), modload(2).

 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003
[ Back ]
 Similar pages
Name OS Title
dlinfo FreeBSD information about dynamically loaded object
ldr_inq_region Tru64 Return module information about a region in a loaded module
ldr_inq_module Tru64 Return information about a loaded module
modinfo Linux display information about a kernel module
mload IRIX dynamically loadable kernel modules
modstat OpenBSD display status of loaded kernel modules
modpath HP-UX change global search path for dynamically loadable kernel modules
MODULE_VERSION FreeBSD set kernel module version
MODULE_DEPEND FreeBSD set kernel module dependencies
modload OpenBSD load a kernel module
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service