strmod_del(2) [osf1 man page]

strmod_del(2)							System Calls Manual						     strmod_del(2)

NAME

       strmod_del - Deletes STREAMS modules and drivers

SYNOPSIS

       #include <sys/stream.h> int strmod_del (      dev_t devno,      struct streamtab *streamtab,	 struct streamadm *streamadm);

PARAMETERS

       The  device number (cdevsw slot) to use when removing a STREAMS driver.	This parameter is ignored for modules.	A pointer to the streamtab
       structure that contains the entry points.  The actual streamtab structure has to be allocated permanently in the driver's  data	space  (as
       specified  by System V Release 3.2).  A pointer to the streamadm structure that contains the administration parameters for the STREAMS mod-
       ule or driver.  The actual streamadm structure is needed only for the duration of the call.  It does not have to be  allocated  permanently
       by  the	caller.  The sa_version field must be either OSF_STREAMS_10 or OSF_STREAMS_11, and the sa_flags field must be either STR_IS_DEVICE
       or STR_IS_MODULE.

DESCRIPTION

       The strmod_del() interface is used to remove configured STREAMS modules and drivers from the kernel.  Specifically, it allows STREAMS driv-
       ers to remove entry points in character device switch tables.  Modules are removed from the STREAMS modules switch.

       When removing a driver only, strmod_del() takes a device number, which is used to determine the device switch slot for the entry points.

       The streamtab parameter is a pointer to a traditional (System V Release 3.2) streamtab structure.  The structure contains pointers to entry
       points for the module's read and write queue routines.

       The streamadm parameter points to a streamadm structure.  The streamadm structure provides additional information that  is  required  under
       Tru64 UNIX.

NOTES

       The device number can be constructed from the major number through the makedev macro, which is defined in /usr/include/sys/types.h.

RETURN VALUES

       Upon  successful  completion, strmod_del() returns 0.  Otherwise, it returns one of the following values: The sa_version or sa_flags fields
       in the streamadm structure are not set correctly.  The entry is in use and cannot be removed.  The entry to be removed is not  found.   The
       devno is out of range, or the devsw entry was not in use.

RELATED INFORMATION

       Data Structures: streamadm(4).

       Routines: strmod_add(2).  delim off

																     strmod_del(2)

Check Out this Related Man Page

queue(9S)						    Data Structures for Drivers 						 queue(9S)

NAME

       queue - STREAMS queue structure

SYNOPSIS

       #include <sys/stream.h>

INTERFACE LEVEL

       Architecture independent level 1 (DDI/DKI)

DESCRIPTION

       A   STREAMS  driver  or	module	consists  of  two   queue structures, one for upstream processing (read) and one for downstream processing
       (write). This structure is the major building block of a stream. It contains pointers to the processing procedures, pointers  to  the  next
       and  previous  queues in the stream, flow control parameters, and a pointer defining the position of its messages on the  STREAMS scheduler
       list.

       The  queue structure is defined as type	queue_t.

STRUCTURE MEMBERS

       struct	   qinit*q_qinfo;      /* module or driver entry points */
       struct	   msgb*q_first;       /* first message in queue */
       struct	   msgb*q_last;        /* last message in queue */
       struct	   queue*q_next;       /* next queue in stream */
       struct	   queue*q_link;       /* to next queue for scheduling*/
       void	   *q_ptr;	       /* pointer to private data structure */
       size_t	   q_count;	       /* approximate size of message queue */
       uint_t	   q_flag;	       /* status of queue */
       ssize_t	   q_minpsz;	       /* smallest packet accepted by QUEUE*/
       ssize_t	   q_maxpsz;	       /*largest packet accepted by QUEUE */
       size_t	   q_hiwat;	       /* high water mark */
       size_t	   q_lowat;	       /* low water mark */

       Valid flags are as follows:

       QENAB	       Queue is already enabled to run.

       QWANTR	       Someone wants to read queue.

       QWANTW	       Someone wants to write to queue.

       QFULL	       Queue is considered full.

       QREADR	       This is the reader (first) queue.

       QUSE	       This queue is in use (allocation).

       QNOENB	       Do not enable queue by way of putq().

SEE ALSO

       strqget(9F), strqset(9F), module_info(9S), msgb(9S), qinit(9S), streamtab(9S)

       Writing Device Drivers

       STREAMS Programming Guide

SunOS 5.10							    12 Nov 1996 							 queue(9S)

Linux and UNIX Man Pages

strmod_del(2) [osf1 man page]

Check Out this Related Man Page