---
name: "xosd_destroy"
section: "3"
platform: "linux"
package: "xosd"
version: "2.2.14-12"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/xosd_destroy"
---

# xosd\_destroy(3)

Destroy an XOSD object

## NAME

xosd\_destroy - Destroy an XOSD object

## SYNOPSIS

\#include \<xosd.h\>

int **xosd\_destroy** (xosd \**osd*);

## DESCRIPTION

**xosd\_destroy** destroys an XOSD object freeing up any memory used. The *osd* object must have been created by **xosd\_create**(3xosd).

## ARGUMENTS

- *osd*

  The object to destroy.

## RETURN VALUE

On success 1 is returned, otherwise 0 is returned and *xosd\_error* is set to indicate the reason for the error.

## ENVIRONMENT

- *char \*xosd\_error*

  A string to a text string describing the error, if one occurred.

## HISTORY

The **xosd\_destroy** function first appeared in version 2.0 of the XOSD library, replacing the now depricated **xosd\_uninit** function.

## AUTHORS

The XOSD library was originally written by André Renaud, and is currenly maintained by Tim Wright. This document was written by Michael JasonSmith.

## BUGS

There are no known bugs with **xosd\_destroy**. Bug reports can be sent to \<xosd@ignavus.net\>.

## SEE ALSO

 [**xosd\_create**(3)](/xosd_create/3.md).
