---
name: "af_note"
section: "3"
platform: "linux"
package: "atfs-dev"
version: "1.4pl6-15+b1"
release: "Debian 12 (Bookworm)"
platforms: ["linux"]
url: "https://new.carta.tech/af_note"
---

# af\_note(3)

read and modify note attribute

## NAME

af\_note - read and modify note attribute

## SYNOPSIS

\#include \<atfs.h\>

in	 af\_snote (Af\_key \*aso, char \*buf)

char	\*af\_rnote (Af\_key \*aso)

## DESCRIPTION

*af\_snote* sets the given text (in *buf*) as change note of the specified ASO. Text must be null terminated. af\_snote requires a lock (see [af\_lock(3)](/af_lock/3.md)) set on the specified ASO.

*Af\_rnote* returns a pointer to the note attribute of the specified ASO. The note text is returned in memory allocated by [malloc(3)](/malloc/3.md). Use [free(3)](/free/3.md) to make the space available for further allocation.

## SEE ALSO

[af\_lock(3)](/af_lock/3.md), [free(3)](/free/3.md)

## DIAGNOSTICS

Upon error, -1 or a nil pointer (depending on the return type) is returned and *af\_errno* is set to the corresponding error number.