.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: mkatfs.1[7.2] Mon Aug  8 13:28:26 1994 andy@cs.tu-berlin.de frozen $
..
.TH mkatfs 1 "Mon Aug  8 13:28:26 1994" "AtFS-1.71" "ShapeTools"
.SH NAME
mkatfs \- create and configure AtFS object repository and derived
object cache
.SH SYNOPSIS
.B mkatfs
.RB [ \-cA \fImax_cached_per_cacheattr\fP ]
.RB [ \-cN \fImax_cached_per_name\fP ]
.RB [ \-cT \fImax_total_cached\fP ]
.RB [ \-cQ ]
.RB [ \-g \fIgroup\fP ]
.RB [ \-h ]
.RB [ \-l \fIpath\fP ]
.RB [ \-m \fImode\fP ]
.RB [ \-v ]
.I pathnames
.SH DESCRIPTION
\fImkatfs\fP may be used to create an AtFS object repository, to link
an existing repository, to configure a repository, or to set the
size attributes of an derived object cache. It applies to
all directories occurring in the \fIpathnames\fP list. If the list is
empty, mkatfs performs its action in the current directory.
.LP
Creating an AtFS object repository makes a directory named
\fIAtFS\fP with several files and subdirectories in it.
.LP
The \fI-l\fP option causes mkatfs to link an existing AtFS repository
to the current directory (or the directories in the pathnames list).
The -l option expects a pathname to a directory containing an AtFS
repository or a link to an AtFS repository (links may be chained) as
argument. When linking a repository, mkatfs either creates a symbolic
link or, if symbolic links are not available on your system, a file
containing the name of the target directory. The latter will be
interpreted by AtFS like a symbolic link.
.LP
Configuring an AtFS repository means, that the group and the
protection may be changed. These operations perform a chgrp(1)
and a chmod(1) operation on the AtFS directory and all its
subdirectories.
.LP
The \fI-cT\fP, \fI-cN\fP, and \fI-cA\fP options set the size of the
derived object cache in the created AtFS object repository. You may
set the maximum total number (cT) of derived files to be stored, the
maximum number of derived files per name (cN) and the maximum number
of derived files with the same name and the same caching attribute
(cA). The relationship of the three values must always be
cT\ >=\ cN\ >=\ cA. For more information on that topic check the
cacheadm(1) manual page. The \fI-cQ\fP option queries the actual
settings for the derived object cache size.
.SH OPTIONS
.TP 2c
\fB-cA\fP \fImax_cached_per_cacheattr\fP
Set the maximum number of derived files with the same name and the
same caching attribute to be stored. Default is 1.
.TP
\fB-cN\fP \fImax_cached_per_name\fP
Set the maximum number of derived files with the same name to be
stored. Default is 3.
.TP
\fB-cT\fP \fImax_total_cached\fP
Set the total maximum number of derived files to be stored in the
derived object cache. Default is 64.
\fB-g\fP \fIgroup\fP
Set the group id of the generated directory to \fIgroup\fP (see
chgrp(1)).
\fB-h\fP
Display help message.
.TP
\fB-l\fP \fIpath\fP
Create an AtFS directory entry by setting a symbolic link to an
existing AtFS object repository, rather than creating a new (empty) one.
On System V machines, a file containing the target directory name
will be generated. The AtFS functions will interpret this as surrogate
for a symbolic link.
.TP
\fB-m\fP \fImode\fP
Set the mode of all generated directories to \fImode\fP (see chmod(1)).
.TP
\fB-v\fP
Output version identification string.
.SH SEE ALSO
chgrp(1), chmod(1), atfsrepair(1), af_cache(3)
.SH AUTHOR
Andreas.Lampen@cs.tu-berlin.de