xref: /illumos-gate/usr/src/man/man3dlpi/dlpi_unbind.3dlpi (revision 14b24e2b79293068c8e016a69ef1d872fb5e2fd5)
te
Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved
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]
DLPI_UNBIND 3DLPI "Aug 22, 2007"
NAME
dlpi_unbind - unbind DLPI handle
SYNOPSIS

cc [ flag ... ] file ... -ldlpi [ library ... ]
#include <libdlpi.h>

int dlpi_unbind(dlpi_handle_t dh);
DESCRIPTION

The dlpi_unbind() function unbinds to bind the DLPI handle dh from the bound SAP. The handle must be in the DL_IDLE DLPI state and upon success, the handle transitions to the DL_UNBOUND state.

Upon success, the caller will no longer be able to send or receive data using the DLPI link associated with dh.

RETURN VALUES

Upon success, DLPI_SUCCESS is returned. If DL_SYSERR is returned, errno contains the specific UNIX system error value. Otherwise, a DLPI error value defined in <sys/dlpi.h> or an error value DLPI_ETIMEDOUT will be returned.

ERRORS
DLPI_EBADMSG

Bad DLPI message

DLPI_EINHANDLE

Invalid DLPI handle

DLPI_ETIMEDOUT

DLPI operation timed out

ATTRIBUTES

See attributes(5) for description of the following attributes:

ATTRIBUTE TYPE ATTRIBUTE VALUE
Interface Stability Committed
MT-Level Safe
SEE ALSO

dlpi_bind(3DLPI), libdlpi(3LIB), attributes(5)