modpath(2) modpath(2)
NAME [Toc] [Back]
modpath - change global search path for dynamically loadable kernel
modules
SYNOPSIS [Toc] [Back]
#include <sys/mod.h>
int modpath(const char *pathname);
DESCRIPTION [Toc] [Back]
modpath allows users with appropriate privilege to modify the global
search path used to locate object files for dynamically loadable
kernel modules. The search path modifications take effect immediately
and affect all subsequent loads for all users on the system.
pathname may be either a colon-separated list of absolute pathnames or
NULL. If the former, these path names represent directories which
should be searched for all autoloads of loadable kernel modules and
for demand loads (see modload(2)) where the module is given by a
simple file name. This list of directories will be prepended to the
existing list of directories and so will be searched before any
directories given in previous calls to modpath and before the default
location which is always searched last. The directories do not have
to exist on the system at the time modpath is called, or when a load
actually takes place. If pathname is equal to NULL, the global search
path is set back to its initial default value, /usr/conf/mod.
Notes [Toc] [Back]
modpath is currently implemented as a macro. Module search path is
not persistent across boots.
RETURN VALUE [Toc] [Back]
On success, modpath returns 0, otherwise it returns -1 and sets errno
to indicate the error.
ERRORS [Toc] [Back]
modpath fails if one or more of the following are true:
[EINVAL] The list of directories specified by pathname is
malformed.
[ENOSYS] The Dynamically Loadable Kernel Module feature is not
initialized.
[ENAMETOOLONG] pathname is more than MAXPATHLEN characters long.
[EPERM] The calling process does not have appropriate
privilege.
SEE ALSO [Toc] [Back]
kcmodule(1M), modload(2).
Hewlett-Packard Company - 1 - HP-UX 11i Version 2: August 2003 [ Back ] |
