atsetcomment(3) [debian man page]

atlog(3)						       AtFS Toolkit Library							  atlog(3)

NAME

       atSetComment, atUnlock - log and lock handling

SYNOPSIS

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

       int atSetComment (Af_key *aso, int commentType, char *commentText, int mode);

       int atUnlock (Af_key *aso);

DESCRIPTION

       atSetComment sets a comment attribute for the attributed software object aso. Valid commentTypes are

       AT_COMMENT_INTENT
		   for expressing a change intent describing planned modifications.

       AT_COMMENT_DESCR
		   for issuing a descriptive text expressing the purpose of the document.

       AT_COMMENT_LOG
		   for writing a change log describing the changes made.

       With  the  argument  commentText,  a default text may be given.	According to the mode (see below), the user will be asked for entering the
       comment attribute value. When a default text is given, this will be offered for modification. With an commentText argument, the previous of
       the according comment attribute is taken as default text.

       With the mode field, the behavior of atSetComment can be influenced. Three flags may me set:

       AT_FROMSTDIN
		   advises atSetComment to read the user input from standard input, otherwise an editor will be started.

       AT_REUSE    causes reuse of the comment text expressed during the previous invocation of atSetComment, if there was any.

       AT_CONFIRM  lets  the  user  confirm,  that an comment shall be expressed.  Otherwise, atSetComment asks for the comment text without prior
		   confirmation. This flag is ignored, when AT_FROMSTDIN is set and the change comment is taken from standard input.

       atUnlock unlocks aso by calling af_unlock (manual page af_lock(3)). If a change intent was previously set for aso, this will be eliminated.

DIAGNOSTICS

       atSetComment and atUnlock return FALSE (zero) on error. Additionally, the atError variable is set and afErrMsg holds a diagnostic message.

ENVIRONMENT

       EDITOR - the default editor to be called.

SEE ALSO

       af_lock(3)

AtFStk-1.12						     Fri Jun 25 16:39:38 1993							  atlog(3)

af_lock(3)						    Attribute Filesystem (AtFS) 						af_lock(3)

NAME

       af_lock, af_unlock, af_testlock - mechanism for reserving update rights in AtFS

SYNOPSIS

       #include <atfs.h>

       Af_user *af_lock (Af_key *aso, Af_user *locker)

       Af_user *af_unlock (Af_key *aso)

       Af_user *af_testlock (Af_key *aso)

DESCRIPTION

       This  manual page describes the interface to the AtFS locking mechanism. Locks are used to avoid conflicting updates to one object history.
       After a user has reserved the update rights, no other user may add new versions to the reserved history.  Reserving the update rights  hap-
       pens  by  locking the most recent version of the history.  As AtFS allows adding new versions to each generation in a history, each genera-
       tion may be locked separately. Reserving update rights for old generations (with generation numbers smaller than the newest generation) are
       performed by locking the most recent version of the corresponding generation.  Removing an ASO (af_rm - manual page af_files(3)) and chang-
       ing an ASO's version number (af_svnum - manual page af_version(3)) also requires a lock on the corresponding ASO.

       af_lock reserves the update permission for the user identified by locker. On  successful  completion,  a  buffer  identical  to	locker	is
       returned, a NULL pointer otherwise.

       af_unlock  cancels  a  formerly established reservation of update rights. Only the owner or the locker of an ASO (identified by the Af_user
       structure that was given to the corresponding call of af_lock) are allowed to do this. On successful completion, af_unlock returns a buffer
       containing the identification of the former locker. This may be empty, if the ASO was not locked.  Upon error, a NULL pointer is returned.

       af_testlock  returns  a	buffer	containing an identification of the current locker of the specified ASO. It returns an empty buffer, if no
       lock is set.

SEE ALSO

       af_version(3), af_files(3)

DIAGNOSTICS

       af_lock and af_unlock return -1 on error and af_errno is set to indicate the error number.

AtFS-1.71						     Fri Jun 25 14:33:11 1993							af_lock(3)