SCO OpenServer 5

getadmin(D3str)

getadmin -- return given module identifier to administration function

Synopsis (Not in DDI)

#include <sys/types.h>
#include <sys/stream.h>

int (*getadmin(ushort_t mid))();

Description

The getadmin function returns a pointer to the administration function as indicated by the qi_qadmin member of the qinit(D4str) structure for the module.

Arguments

mid: Module identifier.

Return values

Returns a pointer to the administration function for that module, or a 0 (NULL) pointer if no driver or module has the given identifier.

Usage

The function first searches the character device table for a STREAM device with the same module identifier, then the pushable STREAM module table.

The module identifier is held in the mi_idnum member of the module_info structure pointed to by qi_minfo of the qinit structure, which is usually hard coded for each driver or module. The module identifier should be a unique number for each device or module.

Context and synchronization

context

Hardware applicability

All

Version applicability

oddi: 1, 2, 2mp, 3, 3mp, 4, 4mp, 5, 5mp, 6, 6mp

SVR5 DDI compatibility

Calls to getadmin( ) can be deleted when porting drivers to DDI; it is not necessary to replace it with anything.

References

getmid(D3str)