xref: /titanic_41/usr/src/man/man9f/unbufcall.9f (revision ead9bb4b1be81d7bbf8ed86ee41d6c1e58b069a3)
te
Copyright 2006 Sun Microsystems, Inc All rights reserved
Copyright 1989 AT&T
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
unbufcall 9F "16 Jan 2006" "SunOS 5.11" "Kernel Functions for Drivers"
NAME
unbufcall - cancel a pending bufcall request
SYNOPSIS

#include <sys/stream.h>



void unbufcall(bufcall_id_t id);
INTERFACE LEVEL

Architecture independent level 1 (DDI/DKI).

PARAMETERS

id

Identifier returned from bufcall(9F) or esbbcall(9F).

DESCRIPTION

The unbufcall function cancels a pending bufcall() or esbbcall() request. The argument id is a non-zero identifier for the request to be cancelled. id is returned from the bufcall() or esbbcall() function used to issue the request. unbufcall() will not return until the pending callback is cancelled or has run. Because of this, locks acquired by the callback routine should not be held across the call to unbufcall() or deadlock may result.

RETURN VALUES

None.

CONTEXT

The unbufcall function can be called from user, interrupt, or kernel context.

SEE ALSO

bufcall(9F), esbbcall(9F)

Writing Device Drivers

STREAMS Programming Guide