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
asos 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.