Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   16655 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

PUT(9F)								       PUT(9F)

NAME
       put - call a STREAMS put procedure

SYNOPSIS
       #include <sys/stream.h>
       #include <sys/ddi.h>

       void put(queue_t *q, mblk_t *mp);

INTERFACE LEVEL
       Architecture independent level 1 (DDI/DKI).

PARAMETERS
       q
	      Pointer to a STREAMS queue.

       mp
	      Pointer to message block being passed into queue.

DESCRIPTION
       put()  calls  the  put procedure ( put(9E) entry point) for the STREAMS
       queue specified by q, passing it the message block referred to  by  mp.
       It  is  typically used by a driver or module to call its own put proce‐
       dure.

CONTEXT
       put() can be called from a STREAMS module or driver put or service rou‐
       tine,  or  from	an  associated interrupt handler, timeout, bufcall, or
       esballoc call-back. In the latter cases, the calling code must  guaran‐
       tee the validity of the q argument.

       Since put() may cause re-entry of the module (as it is intended to do),
       mutexes or other locks should not be held across calls to  it,  due  to
       the  risk  of  single-party deadlock (put(9E), putnext(9F), putctl(9F),
       qreply(9F)). This function is provided as a DDI/DKI conforming replace‐
       ment for a direct call to a put procedure.

SEE ALSO
       put(9E),	 freezestr(9F),	 putctl(9F),  putctl1(9F),  putnext(9F),  put‐
       nextctl(9F), putnextctl1(9F), qprocson(9F), qreply(9F)

       Writing Device Drivers

	STREAMS Programming Guide

NOTES
       The caller cannot have the stream frozen when  calling  this  function.
       See freezestr(9F).

       DDI/DKI	conforming modules and drivers are no longer permitted to call
       put procedures directly, but must call through the appropriate  STREAMS
       utility	function,  for	example, put(9E), putnext(9F), putctl(9F), and
       qreply(9F). This function is provided as a DDI/DKI conforming  replace‐
       ment for a direct call to a put procedure.

       The  put()  and	putnext() functions should be called only after qproc‐
       son() is finished.

				 Apr 28, 1992			       PUT(9F)

Vote for polarhome