'\" t
.\"     Title: waffle_teardown
.\"    Author: Emil Velikov <emil.l.velikov@gmail.com>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 03/25/2021
.\"    Manual: Waffle Manual
.\"    Source: waffle
.\"  Language: English
.\"
.TH "WAFFLE_TEARDOWN" "3" "03/25/2021" "waffle" "Waffle Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
waffle_teardown \- Teardown waffle\*(Aqs per\-process global state
.SH "SYNOPSIS"
.sp
.ft B
.nf
#include <waffle\&.h>
.fi
.ft
.HP \w'bool\ waffle_teardown('u
.BI "bool waffle_teardown(void);"
.SH "DESCRIPTION"
.PP
Feature test macro:
WAFFLE_API_VERSION >= 0x0106\&. (See
\fBwaffle_feature_test_macros\fR(7))\&.
.PP
\fBwaffle_teardown()\fR
tears down the per\-process global state of the waffle library\&.
.PP
А call to
\fBwaffle_teardown()\fR
can fail\&. In the case it does the caller is advised to use
\fBwaffle_error_get_info\fR,
\fBwaffle_error_get_code\fR
and/or
\fBwaffle_error_to_string\fR
to retrieve the error\&. In case of an error that differs from
\fBWAFFLE_ERROR_NOT_INITIALIZED\fR
the caller should not use the Waffle API as the global state is likely to be in an undetermined/corrupt\&. In the case of
\fBWAFFLE_ERROR_NOT_INITIALIZED\fR
one should call
\fBwaffle_init()\fR
prior to reusing Waffle\&.
.SH "RETURN VALUE"
.PP
Functions whose return type is
\fBbool\fR
return true on success and false on failure\&. Functions whose return type is a pointer return
\fBNULL\fR
on failure\&. Use
\fBwaffle_error_get_info\fR(3)
to get information about any errors\&.
.SH "ERRORS"
.PP
See
\fBwaffle_error\fR(3)
for the complete list of waffle\*(Aqs error codes\&.
.PP
\fBWAFFLE_ERROR_NOT_INITIALIZED\fR
.RS 4
Waffle has not been initialized with a successful call to
\fBwaffle_init()\fR
since the last call to
\fBwaffle_teardown()\fR
or the start of the program\&.
.RE
.SH "ISSUES"
.PP
Please report bugs or and feature requests to
\m[blue]\fB\%https://gitlab.freedesktop.org/mesa/waffle/issues\fR\m[]\&.
.SH "SEE ALSO"
.PP
.RS 4
\fBwaffle_init\fR(3),
.RE
.RS 4
\fBwaffle\fR(7)\&.
.RE
.SH "AUTHOR"
.PP
\fBEmil Velikov\fR <\&emil\&.l\&.velikov@gmail\&.com\&>
.RS 4
Contributor
.RE
.SH "COPYRIGHT"
.br
Copyright \(co 2013 Intel
.br
.PP
This manual page is licensed under the Creative Commons Attribution\-ShareAlike 3\&.0 United States License (CC BY\-SA 3\&.0)\&. To view a copy of this license, visit
\m[blue]\fB\%http://creativecommons.org.license/by-sa/3.0/us\fR\m[]\&.
.sp