.ig
 Copyright (C) 1993,1994 by the author(s).
 
 This software is published in the hope that it will be useful, but
 WITHOUT ANY WARRANTY for any part of this software to work correctly
 or as described in the manuals. See the ShapeTools Public License
 for details.

 Permission is granted to use, copy, modify, or distribute any part of
 this software but only under the conditions described in the ShapeTools 
 Public License. A copy of this license is supposed to have been given
 to you along with ShapeTools in a file named LICENSE. Among other
 things, this copyright notice and the Public License must be
 preserved on all copies.


Author: Andreas Lampen (Andreas.Lampen@cs.tu-berlin.de)

$Header: af_history.3[7.0] Fri Jun 25 14:33:09 1993 andy@cs.tu-berlin.de frozen $
..
.TH af_history 3 "Fri Jun 25 14:33:09 1993" "AtFS-1.71" "Attribute Filesystem (AtFS)"
.SH NAME
af_histories, af_access \- AtFS history functions
.SH SYNOPSIS
#include <atfs.h>
.sp
.ta 1.5c
char**	af_histories (char *path, char *pattern)
.sp
char**	af_cachenames (char *path, char *pattern);
.sp
int	af_access (char *path, char *name, char *type, int mode)
.sp
.SH DESCRIPTION
\fIaf_histories\fP returns a list of source history names from the
directory pointed to by \fIpath\fP, that match the given
\fIpattern\fP. Histories in a directory are represented by at least
one version. The pattern must be ed(1) patterns, processable by
re_comp(3) and re_exec(3). The resulting list of af_histories resides
in allocated memory. Use free(3) to free the memory for further
allocation. af_histories returns an empty list (not a NULL pointer !),
when no histories are found.
.LP
\fIaf_cachenames\fP does the same as af_histories but on derived
object caches.
.LP
\fIaf_access\fP determines the existence of an object history.
If any ASO (any version) with the given \fIpath\fP, \fIname\fP
and \fItype\fP attributes exists, af_access returns zero, otherwise \-1.
The \fImode\fP argument can either be
.TP 2.5c
AF_CLASS_SOURCE
indicating that only source objects shall be searched or
.TP
AF_CLASS_DERIVED
which means that only the derived object cache shall be searched for
existence of a matching ASO.
.SH SEE ALSO
ed(1), re_comp(3), re_exec(3), free(3)
.SH DIAGNOSTICS
Upon error, \-1 or a null pointer (depending on the return type) is returned
and \fIaf_errno\fP is set to the corresponding error number.