84faac558d66e186119f6f5d019c2d755d49c3ef
[openafs.git] / doc / man-pages / pod5 / fms.log.pod
1 =head1 NAME
2
3 fms.log - Records output from the fms command
4
5 =head1 DESCRIPTION
6
7 The fms.log file records the output generated by the
8 B<fms> command. The output includes two numbers that can appear
9 in a tape device's entry in the B</usr/afs/backup/tapeconfig>
10 file on the Tape Coordinator machine to which the tape device is
11 attached:
12
13 =over 4
14
15 =item *
16
17 The capacity in bytes of the tape in the device
18
19
20 =item *
21
22 The size in bytes of the end-of-file (EOF) marks (often referred to simply
23 as I<filemarks>) that the tape device writes
24
25
26 =back
27
28 When transferring the numbers recorded in this file to the
29 B<tapeconfig> file, adjust them as specified on the reference page for
30 the B<tapeconfig> file, to improve Tape Coordinator performance during
31 dump operations.
32
33 If the fms.log file does not already exist in the current
34 working directory, the B<fms> command interpreter creates it.
35 In this case, the directory's mode bits must grant the B<rwx>
36 (B<read>, B<write>, and B<execute>) permissions to the
37 issuer of the command. If there is an existing file, the command
38 interpreter overwrites it, so the file's mode bits need to grant only the
39 B<w> permission to the issuer of the B<fms> command.
40 The B<fms> command interpreter also writes similar information to the
41 standard output stream as it runs.
42
43 The file is in ASCII format. To display its contents, log onto the
44 client machine and use a text editor or a file display command such as the
45 UNIX B<cat> command. By default, the mode bits on the
46 B<fms.log> file grant the required B<r> permission only
47 to the owner (which is the local superuser B<root> by default).
48
49 =head1 OUTPUT
50
51 The first few lines of the file provide a simple trace of the
52 B<fms> command interpreter's actions, specifying (for example)
53 how many blocks it wrote on the tape. The final two lines in the file
54 specify tape capacity and filemark size in bytes, using the following
55 format:
56
57    Tape capacity is I<tape_size> bytes
58    File marks are I<filemark_size> bytes
59
60 =head1 EXAMPLES
61
62 The following example of the fms.log file specifies that
63 the tape used during the execution of the B<fms> command had a
64 capacity of 2,136,604,672 bytes, and that the tape device writes filemarks of
65 size 1,910,220 bytes.
66
67    fms test started
68    wrote 130408 blocks
69    Tape capacity is 2136604672 bytes
70    File marks are 1910220 bytes
71
72 =head1 SEE ALSO
73
74 L<tapeconfig(1)>,
75 L<fms(1)>
76
77 =head1 COPYRIGHT
78
79 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
80
81 This documentation is covered by the IBM Public License Version 1.0.  It was
82 converted from HTML to POD by software written by Chas Williams and Russ
83 Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.