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

# atversion(3)

version handling

## NAME

atSetVersAlias, atDelVersAlias, atVno, atGen, atRev - version handling

## SYNOPSIS

\#include \<atfs.h\>\
 \#include \<atfstk.h\>

int     atSetVersAlias (Af\_key \*aso; char \*aliasName);

int     atDelVersAlias (Af\_key \*aso; char \*aliasName);

int     atVno (Af\_key \*aso);

void    atGen (int versionNumber)

void    atRev (int versionNumber)

## DESCRIPTION

*atSetVersAlias* sets a version number alias (a unique symbolic name for a version) for *aso*. The function checks, whether *aliasName* is unique within the ASOs history and complains, if not. It returns TRUE on success and FALSE otherwise. The case that the version already had the alias name is considered as success.

*atDelVersAlias* deletes the given *aliasName* from the list of version aliases attached to *aso*. It returns TRUE on success and FALSE otherwise. It also returns TRUE, when the alias name did not exist.

*atVno* returns a compact representation of *aso*s generation and revision number, packed into a single integer. *atGen* extracts the generation number, and *atRev* the revision number from a *versionNumber* in compact representation.

## DIAGNOSTICS

On error, the *atError* variable is set to an appropriate error code, and *atErrMsg* holds a diagnostic message.