af_cleanup(3) [debian man page]

af_error(3)						    Attribute Filesystem (AtFS) 					       af_error(3)

NAME

       af_errno, af_perror, af_errmsg, af_cleanup - AtFS error handling

SYNOPSIS

       #include <atfs.h>

       int  af_errno

       void af_perror (char *string)

       char*af_errmsg (char *string)

       int  af_cleanup (void)

DESCRIPTION

       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.

SEE ALSO

       intro(2), af_intro(3), perror(3)

AtFS-1.71						     Fri Jun 25 14:33:06 1993						       af_error(3)

af_transact(3)						    Attribute Filesystem (AtFS) 					    af_transact(3)

NAME

       af_transaction, af_commit, af_abort - a simple transaction mechanism for AtFS

SYNOPSIS

       #include <atfs.h>

       int af_transaction (void)

       int af_commit (void)

       int af_abort (void)

DESCRIPTION

       These functions implement a simple transaction mechanism for AtFS.  A transaction starts with calling af_transaction. All changes to exist-
       ing ASOs performed hereafter have no immediate permanent effect.  They rather get into effect, when  the  transaction  is  ended.   Calling
       af_commit  ends	the  transactions  and causes all changes to be saved to disk. af_abort aborts the transaction without saving the changes.
       These will then be discarded.

       Only modification of the state of existing source ASOs will be deferred. Creation or deletion of ASOs have immediate effect, regardless	if
       a  transaction  is  in  effect  or  not.  Additionally, all operations on derived ASOs (all operations on the derived object cache) are not
       affected by the transaction.

       All archive files that are to be changed when the transaction is finished are locked until the end of the transaction.  The  lock  prevents
       all  other  applications  to perform any modifications on the archive file. You should make sure, that ending a transaction should never be
       dependent on the successful termination of another application (deadlock danger).

DIAGNOSTICS

       Upon error, -1 is returned and af_errno is set to the corresponding error number.

BUGS

       Changes to the contents of busy versions have immediate effect.

AtFS-1.71						     Fri Jun 25 14:33:21 1993						    af_transact(3)