1c0b9f4feSDoug Rabson.\" -*- nroff -*- 2c0b9f4feSDoug Rabson.\" 3c0b9f4feSDoug Rabson.\" Copyright (c) 2005 Doug Rabson 4c0b9f4feSDoug Rabson.\" All rights reserved. 5c0b9f4feSDoug Rabson.\" 6c0b9f4feSDoug Rabson.\" Redistribution and use in source and binary forms, with or without 7c0b9f4feSDoug Rabson.\" modification, are permitted provided that the following conditions 8c0b9f4feSDoug Rabson.\" are met: 9c0b9f4feSDoug Rabson.\" 1. Redistributions of source code must retain the above copyright 10c0b9f4feSDoug Rabson.\" notice, this list of conditions and the following disclaimer. 11c0b9f4feSDoug Rabson.\" 2. Redistributions in binary form must reproduce the above copyright 12c0b9f4feSDoug Rabson.\" notice, this list of conditions and the following disclaimer in the 13c0b9f4feSDoug Rabson.\" documentation and/or other materials provided with the distribution. 14c0b9f4feSDoug Rabson.\" 15c0b9f4feSDoug Rabson.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 16c0b9f4feSDoug Rabson.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 17c0b9f4feSDoug Rabson.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 18c0b9f4feSDoug Rabson.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 19c0b9f4feSDoug Rabson.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 20c0b9f4feSDoug Rabson.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 21c0b9f4feSDoug Rabson.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 22c0b9f4feSDoug Rabson.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 23c0b9f4feSDoug Rabson.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 24c0b9f4feSDoug Rabson.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 25c0b9f4feSDoug Rabson.\" SUCH DAMAGE. 26c0b9f4feSDoug Rabson.\" 27c0b9f4feSDoug Rabson.\" $FreeBSD$ 28c0b9f4feSDoug Rabson.\" 29c0b9f4feSDoug Rabson.\" The following commands are required for all man pages. 30c0b9f4feSDoug Rabson.Dd November 12, 2005 31c0b9f4feSDoug Rabson.Os 32c0b9f4feSDoug Rabson.Dt GSS_RELEASE_BUFFER 3 PRM 33c0b9f4feSDoug Rabson.Sh NAME 34c0b9f4feSDoug Rabson.Nm gss_release_buffer 35c0b9f4feSDoug Rabson.Nd Discard a buffer 36c0b9f4feSDoug Rabson.\" This next command is for sections 2 and 3 only. 37c0b9f4feSDoug Rabson.\" .Sh LIBRARY 38c0b9f4feSDoug Rabson.Sh SYNOPSIS 39c0b9f4feSDoug Rabson.In "gssapi/gssapi.h" 40c0b9f4feSDoug Rabson.Ft OM_uint32 41c0b9f4feSDoug Rabson.Fo gss_release_buffer 42c0b9f4feSDoug Rabson.Fa "OM_uint32 *minor_status" 43c0b9f4feSDoug Rabson.Fa "gss_buffer_t buffer" 44c0b9f4feSDoug Rabson.Fc 45c0b9f4feSDoug Rabson.Sh DESCRIPTION 46c0b9f4feSDoug RabsonFree storage associated with a buffer. 47c0b9f4feSDoug RabsonThe storage must have been allocated by a GSS-API routine. 48c0b9f4feSDoug RabsonIn addition to freeing the associated storage, 49c0b9f4feSDoug Rabsonthe routine will zero the length field in the descriptor to which the 50c0b9f4feSDoug Rabsonbuffer parameter refers, 51c0b9f4feSDoug Rabsonand implementations are encouraged to additionally set the pointer 52c0b9f4feSDoug Rabsonfield in the descriptor to 53c0b9f4feSDoug Rabson.Dv NULL . 54c0b9f4feSDoug RabsonAny buffer object returned by a GSS-API routine may be passed to 55c0b9f4feSDoug Rabson.Fn gss_release_buffer 56c0b9f4feSDoug Rabson(even if there is no storage associated with the buffer). 57c0b9f4feSDoug Rabson.Sh PARAMETERS 58c0b9f4feSDoug Rabson.Bl -tag 59c0b9f4feSDoug Rabson.It minor_status 60c0b9f4feSDoug RabsonMechanism specific status code. 61c0b9f4feSDoug Rabson.It buffer 62c0b9f4feSDoug RabsonThe storage associated with the buffer will be deleted. 63c0b9f4feSDoug RabsonThe gss_buffer_desc object will not be freed, 64c0b9f4feSDoug Rabsonbut its length field will be zeroed. 65c0b9f4feSDoug Rabson.El 66c0b9f4feSDoug Rabson.Sh RETURN VALUES 67c0b9f4feSDoug Rabson.Bl -tag 68c0b9f4feSDoug Rabson.It GSS_S_COMPLETE 69c0b9f4feSDoug RabsonSuccessful completion 70c0b9f4feSDoug Rabson.El 71c0b9f4feSDoug Rabson.Sh STANDARDS 72c0b9f4feSDoug Rabson.Bl -tag 73c0b9f4feSDoug Rabson.It RFC 2743 74c0b9f4feSDoug RabsonGeneric Security Service Application Program Interface Version 2, Update 1 75c0b9f4feSDoug Rabson.It RFC 2744 76c0b9f4feSDoug RabsonGeneric Security Service API Version 2 : C-bindings 77c0b9f4feSDoug Rabson.\" .Sh HISTORY 78c0b9f4feSDoug Rabson.El 79c0b9f4feSDoug Rabson.Sh HISTORY 80c0b9f4feSDoug RabsonThe 81c0b9f4feSDoug Rabson.Nm 82c0b9f4feSDoug Rabsonmanual page example first appeared in 83c0b9f4feSDoug Rabson.Fx 7.0 . 84c0b9f4feSDoug Rabson.Sh AUTHORS 85c0b9f4feSDoug RabsonJohn Wray, Iris Associates 8660b9f20aSDoug Rabson.Sh COPYRIGHT 8760b9f20aSDoug RabsonCopyright (C) The Internet Society (2000). All Rights Reserved. 8860b9f20aSDoug Rabson.Pp 8960b9f20aSDoug RabsonThis document and translations of it may be copied and furnished to 9060b9f20aSDoug Rabsonothers, and derivative works that comment on or otherwise explain it 9160b9f20aSDoug Rabsonor assist in its implementation may be prepared, copied, published 9260b9f20aSDoug Rabsonand distributed, in whole or in part, without restriction of any 9360b9f20aSDoug Rabsonkind, provided that the above copyright notice and this paragraph are 9460b9f20aSDoug Rabsonincluded on all such copies and derivative works. However, this 9560b9f20aSDoug Rabsondocument itself may not be modified in any way, such as by removing 9660b9f20aSDoug Rabsonthe copyright notice or references to the Internet Society or other 9760b9f20aSDoug RabsonInternet organizations, except as needed for the purpose of 9860b9f20aSDoug Rabsondeveloping Internet standards in which case the procedures for 9960b9f20aSDoug Rabsoncopyrights defined in the Internet Standards process must be 10060b9f20aSDoug Rabsonfollowed, or as required to translate it into languages other than 10160b9f20aSDoug RabsonEnglish. 10260b9f20aSDoug Rabson.Pp 10360b9f20aSDoug RabsonThe limited permissions granted above are perpetual and will not be 10460b9f20aSDoug Rabsonrevoked by the Internet Society or its successors or assigns. 10560b9f20aSDoug Rabson.Pp 10660b9f20aSDoug RabsonThis document and the information contained herein is provided on an 10760b9f20aSDoug Rabson"AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING 10860b9f20aSDoug RabsonTASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING 10960b9f20aSDoug RabsonBUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION 11060b9f20aSDoug RabsonHEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF 11160b9f20aSDoug RabsonMERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. 112