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,
      ms_bss_size).

      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 */
                         ms_msinfo[MODMAXLINK];
                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
                    initialized.

      [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