.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: atcache.3[7.0] Fri Jun 25 16:39:33 1993 andy@cs.tu-berlin.de frozen $
..
.TH atcache 3 "Fri Jun 25 16:39:33 1993" "AtFStk-1.12" "AtFS Toolkit Library"
.SH NAME
atSaveCache, atCacheKey \- derived object cache handling
.SH SYNOPSIS
#include <atfs.h>
.br
#include <atfstk.h>
.sp
.ta 1.2c
int	atSaveCache (Af_key *aso, Af_key *cachedAso, char *uniqAttribute, int storeType);
.sp
char*	atCacheKey (Af_key *aso);
.sp
.SH DESCRIPTION
\fIatSaveCache\fP adds the given busy object \fIaso\fP to the current
derived object cache. It does this by calling af_savecache (manual
page af_cache(3)). Prior to that, atSaveCache attaches a key attribute
with the name \fI__CacheKey__\fP to \fIaso\fP, by which the resulting
cached object can be uniquely identified within the cache. Return
values are the same as from af_savecache (manual page af_cache(3)).
.LP
\fIatCacheKey\fP returns an attribute string consisting of the
attribute name \fI__CacheKey__\fP and an attribute value built of the
\fIaso\fP modification date, the process number and a (per process
unique) serial number. This attribute can (and will) be used to
uniquely identify attributed software objects in derived object
caches.
.SH SEE ALSO
af_cache(3)