NAME
modstat — get information for a dynamically loaded kernel module
SYNOPSIS
#include <sys/mod.h>
int modstat(int module_id, struct modstatus *stbuf,
int get_next_module);
DESCRIPTION
The
modstat
function allows processes with appropriate privilege to get information
for dynamically loaded kernel modules. It fills in the elements of the
modstatus
structure, specified by
stbuf,
with the information available for the
given module identifier
module_id.
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 (see
kmadmin(1M))
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];
};
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
modstat
is currently implemented as a macro.
RETURN VALUE
On success,
modstat
returns 0, otherwise it returns -1 and sets
errno
to indicate the error.
ERRORS
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.
