af_error(3)

af_error3

Atfs error handling

Usage

#include <atfs.h>

int af_errno

void af_perror (char *string)

char* af_errmsg (char *string)

int af_cleanup (void)

Overview

af_errno is the global AtFS error number variable. If an AtFS functions returns with an error, af_errno is set to indicate the appropriate error number. It is not cleared upon successful calls. The af_intro(3) manual page gives an overview of all error codes.

af_perror produces a short error message of the form described in perror(3). This message will be written to standard error. If the last error encountered during an AtFS application was an AtFS-specific error, a corresponding message is generated, otherwise af_perror calls perror(3).

af_errmsg does the same as af_perror but returns the message rather than writing to standard error. The result string resides in static memory and hence will be overwritten on subsequent calls of af_errmsg.

Af_cleanup serves as cleanup routine upon premature termination of an AtFS application. It removes temporary files and frees all allocated memory.

Releases

Unchanged in 13 releases since Debian 2.1 (Slink).

  1. 2.1–12

From atfs-dev 1.4pl6-15+b1 in Debian 12 (Bookworm). Parsed by carta from the page's man source.