HP-UX Reference (11i v2 04/09) - 2 System Calls (vol 5)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

181

182

183

184

185

186

187

188

189

190

modstat(2) modstat(2)

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 to get information for dynamically loaded kernel modules. For

modules with appropriate privilege, it ﬁlls in all the elements of the

modstatus structure, speciﬁed by

stbuf , with the information available for the given module identiﬁer module_id . For non-privileged

processes,

modstat ﬁlls in all information except the address and size of the module object ﬁle 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

identiﬁer 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

deﬁnitions 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

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 identiﬁer 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.