mirror of
https://git.openafs.org/openafs.git
synced 2025-01-19 07:20:11 +00:00
e3dfba8e6c
This is the initial conversion of the AFS Adminstrators Reference into POD for use as man pages. The man pages are now generated via pod2man from regen.sh so that only those working from CVS have to have pod2man available. The Makefile only installs. The pages have also been sorted out into pod1, pod5, and pod8 directories, making conversion to the right section of man page easier without maintaining a separate list and allowing for names to be duplicated between pod5 and pod1 or pod8 (which will likely be needed in a few cases). This reconversion is done with a new script based on work by Chas Williams. In some cases, the output is worse than the previous POD pages, but this is a more comprehensive conversion. This is only the first step, and this initial conversion has various problems. In addition, the file man pages that didn't have simple names have not been converted in this pass and will be added later. Some of the man pages have syntax problems and all of them have formatting errors. The next editing pass, coming shortly, will clean up most of the remaining mess.
84 lines
2.6 KiB
Plaintext
84 lines
2.6 KiB
Plaintext
=head1 NAME
|
|
|
|
fms.log - Records output from the fms command
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
The fms.log file records the output generated by the
|
|
B<fms> command. The output includes two numbers that can appear
|
|
in a tape device's entry in the B</usr/afs/backup/tapeconfig>
|
|
file on the Tape Coordinator machine to which the tape device is
|
|
attached:
|
|
|
|
=over 4
|
|
|
|
=item *
|
|
|
|
The capacity in bytes of the tape in the device
|
|
|
|
|
|
=item *
|
|
|
|
The size in bytes of the end-of-file (EOF) marks (often referred to simply
|
|
as I<filemarks>) that the tape device writes
|
|
|
|
|
|
=back
|
|
|
|
When transferring the numbers recorded in this file to the
|
|
B<tapeconfig> file, adjust them as specified on the reference page for
|
|
the B<tapeconfig> file, to improve Tape Coordinator performance during
|
|
dump operations.
|
|
|
|
If the fms.log file does not already exist in the current
|
|
working directory, the B<fms> command interpreter creates it.
|
|
In this case, the directory's mode bits must grant the B<rwx>
|
|
(B<read>, B<write>, and B<execute>) permissions to the
|
|
issuer of the command. If there is an existing file, the command
|
|
interpreter overwrites it, so the file's mode bits need to grant only the
|
|
B<w> permission to the issuer of the B<fms> command.
|
|
The B<fms> command interpreter also writes similar information to the
|
|
standard output stream as it runs.
|
|
|
|
The file is in ASCII format. To display its contents, log onto the
|
|
client machine and use a text editor or a file display command such as the
|
|
UNIX B<cat> command. By default, the mode bits on the
|
|
B<fms.log> file grant the required B<r> permission only
|
|
to the owner (which is the local superuser B<root> by default).
|
|
|
|
=head1 OUTPUT
|
|
|
|
The first few lines of the file provide a simple trace of the
|
|
B<fms> command interpreter's actions, specifying (for example)
|
|
how many blocks it wrote on the tape. The final two lines in the file
|
|
specify tape capacity and filemark size in bytes, using the following
|
|
format:
|
|
|
|
Tape capacity is I<tape_size> bytes
|
|
File marks are I<filemark_size> bytes
|
|
|
|
=head1 EXAMPLES
|
|
|
|
The following example of the fms.log file specifies that
|
|
the tape used during the execution of the B<fms> command had a
|
|
capacity of 2,136,604,672 bytes, and that the tape device writes filemarks of
|
|
size 1,910,220 bytes.
|
|
|
|
fms test started
|
|
wrote 130408 blocks
|
|
Tape capacity is 2136604672 bytes
|
|
File marks are 1910220 bytes
|
|
|
|
=head1 SEE ALSO
|
|
|
|
L<tapeconfig(1)>,
|
|
L<fms(1)>
|
|
|
|
=head1 COPYRIGHT
|
|
|
|
IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
|
|
|
|
This documentation is covered by the IBM Public License Version 1.0. It was
|
|
converted from HTML to POD by software written by Chas Williams and Russ
|
|
Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.
|