1Readme file for FS_INOD test 2 3LAWYER STUFF: 4 5 Copyright (c) International Business Machines Corp., 2001 6 7 This program is free software; you can redistribute it and/or modify 8 it under the terms of the GNU General Public License as published by 9 the Free Software Foundation; either version 2 of the License, or 10 (at your option) any later version. 11 12 This program is distributed in the hope that it will be useful, 13 but WITHOUT ANY WARRANTY; without even the implied warranty of 14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See 15 the GNU General Public License for more details. 16 17 You should have received a copy of the GNU General Public License 18 along with this program; if not, write to the Free Software 19 Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA 20 21 22TEST: 23 24 NAME: fs_inod 25 FUNCTIONALITY: File system stress - inode allocation/deallocation 26 DESCRIPTION: Rapidly creates and deletes files through 27 multiple processes running in the background. 28 The user may specify the number of subdirectories 29 to create, the number of files to create (per 30 subdirectory), and the number of times to repeat 31 the creation/deletion cycle. 32USE: 33 FS_INOD is a korn shell script that was originally written as part 34 of a jfs stress test suite for AIX. The command to execute the script 35 is: 36 37 ./fs_inod [volumename] [numsubdirectories] [numfiles] [numloops] 38 39 volumename: name of volume or filesystem to test 40 numsubdirs: number of subdirectories per main directory "dirX" 41 numfiles: number of files per subdirectory 42 numloops: number of loops for the creation/deletion cycle 43 44 FS_INOD will create two directories (dir1 and dir2) in whichever 45 directory it is executed, or you can set environment variable FS 46 to the name of the volume you wish to test. This variable is 47 currently set in function Main in the script, but may be changed. 48 Below dir1 and dir2 it will create numsubdirs, and within each 49 subdir it will create numfiles. Then it will delete the files 50 and subdirs. It will repeat the creation/deletion process for 51 numloops. It should be noted that large values for numsubdirs 52 and numfiles can cause the test to exceed the capacity of a given 53 hard drive. There is no error checking for this, so beware. 54 Additionally, a large value for numloops may cause the test to 55 run for a very long time. 56 57 FS_INOD will completely clean up all files and directories 58 created during the test. 59 60 Currently all FS_INOD output goes to stdout, to preserve ouput 61 redirect to a file. 62 63FUTURE ENHANCEMENTS: 64 65 1. Command line switches for all parameters. -DONE 66 2. Help screen -DONE 67 68 69CHANGE HISTORY: 70DATE AUTHOR REASON 7104/18/98 Dara Morgenstein Project Yeager (AIX) 7202/08/01 Jay Inman Modified to run standalone on Linux 7305/24/01 Jay Inman Added command line args 74