Manpage of MOD_INFO

MOD_INFO

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

NAME

mod_info - provides information on a loadable kernel module to the STREAMS executive

SYNOPSIS

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

int mod_info(struct modlinkage *modlinkage, struct modinfo *modinfo);

ARGUMENTS

modlinkage
modinfo

DESCRIPTION

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

RETURN

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

ERRORS

mod_info() fails when

CONTEXT

mod_info() can be called from non-blocking context. It is intended to be called by a module initialization routine.

MP-STREAMS

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

NOTICES

mod_info() 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 a canonical example of an _info(9) function using mod_info():


int
_info(struct modinfo *modinfop)
{
        return (mod_info(&xxx_modlinkage, modinfop));
}

BUGS

mod_info() has no known bugs.

COMPATIBILITY

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

---
---
---
---: mod_info() 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_info() only provides functionality comparable to Solaris® for use by STREAMS drivers and modules. Any and all functionality provided by mod_info() in support of non-STREAMS devices are not supported.

See STREAMS(9) for additional compatibility information.

CONFORMANCE

Solaris® SUNDDI documentation[2].

HISTORY

mod_info() 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: 05:12:24 GMT, May 19, 2013