.\" @(#)isc_destroy.3x 1.0 92/02/13 Lysator
.\" ISC - networking library
.\" Copyright (C) 1992, 1999 by Peter Eriksson and Per Cederqvist of the
.\"		       Lysator Academic Computer Association.
.\"
.\"
.\" This program is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2 of the License, or
.\" (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
.\"
.TH ISC_DESTROY 3X "13 February 1992" "Release 1.0" "ISC LIBRARY"
.SH NAME
isc_destroy \- close, remove and destroy an ISC session
.SH SYNOPSIS
.nf
.ft B
#include <isc.h>
.ft
.fi
.LP
.nf
.ft B
int isc_destroy(mcb, scb)
IscMaster *mcb;
IscSession *scb;
.ft R
.fi
.SH DESCRIPTION
This function force the session to be closed, and all queued
data to be lost. It the deallocates the storage for the session
control structure. Also optionally removes the session from the
master control structure if the latter is specified.
.SH ARGUMENTS
The following arguments are passed to the function:
.TP 10
.I mcb
This argument must either point to a master control
structure or be a
.SM NULL
pointer.
.TP 10
.I scb
This argument must be pointer to a session control
structure.
.SH RETURN VALUES
This function returns:
.TP 10
0
on success,
.TP 10
\-1
on failure and sets
.B errno
to indicate the error.
.SH ERRORS
.TP 10
.SM ENOENT
The session specified did not exist in the master control block.
.SH SEE ALSO
.BR isc (3x)