unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



fsx(8)								       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 sys-
  tem, 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)