Index for Section 8

Alphabetical listing for F

Bottom of page

fsx(8)
NAME
  fsx - file system exerciser

SYNOPSIS
  /usr/field/fsx [-h] [-ofile] [-tn] [-fpath] [-pm]

OPTIONS
  The fsx options are:

  -h  Prints the help messages for the fsx command.

  -ofile
      Saves the output diagnostics in file.

  -tn Run time in minutes (n).	The default is to run until the process
      receives a Ctrl/C or a kill -15 pid command.

  -pm Number (m) of fsx processes to spawn. The maximum is 250; the default
      is 20.

  -fpath
      Path name of directory on file system you wish to test. For example,
      /mnt or /usr. The default is /usr/field.

DESCRIPTION
  The fsx exerciser spawns the background process fsxr, and these two
  processes exercise a file system by creating, opening, writing, opening,
  reading, validating, closing, and unlinking a test file.  These test files
  are created in the /usr/field directory (the default) unless the -fpath
  option is used.

  You can spawn up to 250 (default is 20) fsx processes (fsxr1, fsxr2, ...
  fsxrn where n is the number of processes spawned). The exerciser will run
  until a Ctrl/C or kill -15 pid command is sent to the process.

  A logfile for you to examine and then remove is created in the current
  working directory. If there are errors in the logfile, make sure you check
  the syslog file where the driver and kernel error messages are saved.

RESTRICTIONS
  If you must run a system exerciser over an NFS link or on a diskless
  system, there are some restrictions.	For exercisers such as fsx(8), which
  must write into a file system, the target file system must be writable by
  root. Also, the directory in which any of the exercisers are executed must
  be writable by root because temporary files are written into the current
  directory.  These latter restrictions are sometimes difficult to overcome
  because often NFS file systems are mounted in a way that prevents root from
  writing into them.  Some of the restrictions may be overcome by copying fsx
  and fsxr to another directory and then executing it.	Avoid using the fsx
  exerciser over an NFS or diskless file system.

  Each time you run fsx, it creates a log file.	 The exerciser allows you to
  accumulate up to 9 log files.	 If you run fsx to create a tenth log file,
  it exits and displays the following error messages:

       fsx: Remove old log files
       fsx: Can not start report generator, test aborted

  When this situation occurs, remove at least one log file and run fsx again.

EXAMPLES
   1.  The following example runs 10 fsx processes on /mnt until the process
       receives a Ctrl/C or kill -15 pid command:
	    % /usr/field/fsx -p10 -f/mnt

   2.  The following example runs 20 fsx processes on /usr/field for 120
       minutes in the background:
	    % /usr/field/fsx -t120 &

SEE ALSO
  Commands: cmx(8), diskx(8), memx(8), shmx(8), tapex(8)

Index for Section 8

Alphabetical listing for F

Top of page