Manpage of MOD_REMOVE

MOD_REMOVE

Section: OpenSS7 STREAMS Compatibility DDI/DKI (9)
Updated: 2008-10-31
Index Return to Main Contents

NAME

mod_remove - removes a loadable kernel module from the STREAMS executive

SYNOPSIS

#define _SUN_SOURCE
#include <sys/modctl.h>

int mod_remove(struct modlinkage *modlinkage);

ARGUMENTS

modlinkage

DESCRIPTION

mod_remove() must be called from a module _fini(9) routine. The same modlinkage structure as was referenced in the mod_install(9) call from _init(9) must be referenced in the mod_remove() call in _fini(9).

RETURN

When mod_remove() succeeds, it returns zero (0); when it fails, it returns non-zero.

ERRORS

mod_remove() fails when

CONTEXT

mod_remove() can be called from a non-blocking context. It is intended on being called by a module initialization routine and should not be called directly.

MP-STREAMS

mod_remove() is MP-safe when called from the correct context.

NOTICES

mod_remove() is a Solaris®-specific function: _SUN_SOURCE must be defined before including DDI/DKI include files to expose this symbol. OpenSS7 STREAMS Compatibility must also have been compiled with CONFIG_STREAMS_COMPAT_SUN or CONFIG_STREAMS_COMPAT_SUN_MODULE defined.

EXAMPLE

Following is an example of the canonical _fini(9) function using mod_remove():


int
_fini(void)
{
    int result;
result = mod_remove(&xxx_modlinkage);
    if (result != 0) {
        return (result);
    }
ddi_soft_state_fini(&xxx_statep);
return (0);
}

BUGS

mod_remove() has no known bugs.

COMPATIBILITY

mod_remove() is compatible with Solaris® with the following portability considerations:

---
---
---
---: mod_remove() is provided for source level compatibility with Solaris® for the purpose of porting Solaris® drivers to Linux. Because internal structures and definitions for OpenSS7 STREAMS Compatibility[1] differ from that of Solaris®, binaries are incompatible.
---: mod_remove() only provides functionality comparable to Solaris® for use by STREAMS drivers and modules. Any and all functionality provided by mod_remove() in support of non-STREAMS devices are not supported.

See STREAMS(9) for additional compatibility information.

CONFORMANCE

Solaris® SUNDDI documentation[2].

HISTORY

mod_remove() first appeared in Solaris® 2.5.

REFERENCES

[1]: strcompat-0.9.2, STREAMS Compatibility Modules (strcompat) 0.9.2 Source Code, Brian Bidulock, ed., OpenSS7 Corporation. <http://www.openss7.org/>
[2]: Solaris® 8, Solaris 8 Docmentation, 2001, (Santa Clara, California), Sun Microsystems, Inc., Sun. <http://docs.sun.com/>

TRADEMARKS

OpenSS7tm: is a trademark of OpenSS7 Corporation.
Linux®: is a registered trademark of Linus Torvalds.
UNIX®: is a registered trademark of The Open Group.
Solaris®: is a registered trademark of Sun Microsystems.

Other trademarks are the property of their respective owners.

IDENTIFICATION

OpenSS7 STREAMS Compatibility: Package strcompat version 0.9.2.7 released 2008-10-31.

Index

NAME
SYNOPSIS
ARGUMENTS
DESCRIPTION
RETURN
ERRORS
CONTEXT
MP-STREAMS
NOTICES
EXAMPLE
SEE ALSO
BUGS
COMPATIBILITY
CONFORMANCE
HISTORY
REFERENCES
TRADEMARKS
IDENTIFICATION

This document was created by man2html, using the manual pages.
Time: 23:54:57 GMT, May 19, 2013