.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: atfsrepair.1[7.0] Thu Jan 20 12:06:00 1994 andy@cs.tu-berlin.de frozen $
..
.TH atfsrepair 1 "Thu Jan 20 12:06:00 1994" "AtFS-1.71" "ShapeTools"
.SH NAME
atfsrepair \- repair corrupted AtFS repository, or convert old
repository to new format.
.SH SYNOPSIS
.B atfsrepair
.RB [ \-Ceinqv ]
file1 ...
.SH DESCRIPTION
\fIAtfsrepair\fR checks the AtFS repository for inconsistencies in the
a given file history. If a corrupted archive file is found in the
repository, atfsrepair tries to repair it by reconstructing missing
parts and eliminating inconsistencies. Without a \fIfile\fP argument,
atfsrepair handles the complete repository. Atfsrepair is
interactive and (hopefully) self explanatory.
.LP
If you have permission problems, e.g. your AtFS repository grants
group write permission but another user from your group can still not
save data to the repository, atfsrepair is also the right thing to do.
The programs straightens permission bits within the repository.
.LP
Atfsrepair automatically updates archive files, when the archive
file format or the arrangement of archive files within the AtFS
subdirectory was changed. Before taking any permanent action,
atfsrepair asks the user for a confirmation. This behaviour can be
switched off by either the -n or the -q option (see below).
.LP
Atfsrepair shall not be called concurrently with other applications on
an AtFS repository. Make sure, that nobody else works on the
repository to be repaired as atfsrepair may ignore existing archive
locks and does not set own locks.
.SH OPTIONS
.TP
\f(BI\-C\fR
This option causes atfsrepair to try it's hand at a derived
object cache.
.TP
\f(BI\-e\fR
Edit Mode. Invoking atfsrepair with this option rather serves for
manipulating archive files than for repairing them.
It shall only be used by \fIvery experienced\fR users.
For nearly every item in the archive file, \fIatfsrepair\fR asks the caller
for confirmation or modification. Beware, this level of verbosity can be
very annoying when the archive file is big.
.TP
\f(BI\-i\fR
Interactive mode (default).
.TP
\f(BI\-n\fR
Non-interactive mode. In this mode, atfsrepair tries to repair
corrupted archive files without human assistance. It does not perform any user
interaction and behaves as if the user would always choose the default
decision in interactive mode.
.TP
\f(BI\-q\fR
Quiet mode. Same as \fI-n\fP but also supresses all informative messages.
Only error messages will be displayed.
.TP
\f(BI\-v\fR
Print current version number. No file processing is done.
.SH SEE ALSO
afarchive(5)
.SH BUGS
Dates appear in internal form (seconds since 1970) rather than in human
readable form.
.SH AUTHOR
Andreas.Lampen@cs.tu-berlin.de