OS Manuals

/opt/ltp/testcases/bin/doio

The Linux Test Project

From ltp 20260930-r1 (enterprise-packages), captured 2026-11-08 by running doio -help (exit 0). permalink

usage:  doio [-aekv] [-m message_interval] [-n nprocs] [-r release_interval] [-w write_log] [-V validation_ftype] [-U upanic_cond] [infile]

	-a                   abort - kill all doio processes on data compare
	                     errors.  Normally only the erroring process exits
	-C data-pattern-type
	                     Available data patterns are:
	                     default - repeating pattern
	-d Operation:Time    Inter-operation delay.
	                     Operations are:
	                         select:time (1 second=1000000)
	                         sleep:time (1 second=1)
	                         alarm:time (1 second=1)
	-e                   Re-exec children before entering the main
	                     loop.  This is useful for spreading
	                     procs around on multi-pe systems.
	-k                   Lock file regions during writes using fcntl()
	-v                   Verify writes - this is done by doing a buffered
	                     read() of the data if file io was done, or
	                     an ssread()of the data if sds io was done
	-M                   Data buffer allocation method
	                     alloc-type[,type]
				    data
				    shmem:shmid:size
				    mmap:flags:filename
				        p - private
				        s - shared (shared file must exist
				            and have needed length)
				        f - fixed address (not used)
				        a - specify address (not used)
				        U - Unlink file when done
				        The default flag is private

	-m message_interval  Generate a message every 'message_interval'
	                     requests.  An interval of 0 suppresses
	                     messages.  The default is 0.
	-N tagname           Tag name, for Monster.
	-n nprocs            # of processes to start up
	-r release_interval  Release all memory and close
	                     files every release_interval operations.
	                     By default procs never release memory
	                     or close fds unless they have to.
	-V validation_ftype  The type of file descriptor to use for doing data
	                     validation.  validation_ftype may be an octal,
	                     hex, or decimal number representing the open()
	                     flags, or may be one of the following strings:
	                     'buffered' - validate using bufferd read
	                     'sync'     - validate using O_SYNC read
	                     By default, 'parallel'
	                     is used if the write was done with O_PARALLEL
	                     or 'buffered' for all other writes.
	-w write_log         File to log file writes to.  The doio_check
	                     program can reconstruct datafiles using the
	                     write_log, and detect if a file is corrupt
	                     after all procs have exited.
	-U upanic_cond       Comma separated list of conditions that will
	                     cause a call to upanic(PA_PANIC).
	                     'corruption' -> upanic on bad data comparisons
	                     'iosw'     ---> upanic on unexpected async iosw
	                     'rval'     ---> upanic on unexpected syscall rvals
	                     'all'      ---> all of the above

	infile               Input stream - default is stdin - must be a list
	                     of io_req structures (see doio.h).  Currently
	                     only the iogen program generates the proper
	                     format
Options (14)
OptionDescriptionSource
-aabort - kill all doio processes on data compare errors.help
-C data-pattern-typeAvailable data patterns are: default - repeating patternhelp
-d Operation:TimeInter-operation delay.help
-eRe-exec children before entering the main loop.help
-kLock file regions during writes using fcntl()help
-vVerify writes - this is done by doing a buffered read() of the data if file io was done, or an ssread()of the data if sds io was donehelp
-MData buffer allocation method alloc-type[,type] data shmem:shmid:size mmap:flags:filename p - private s - shared (shared file must exist and have needed length) f - fixed address (not used) a -…help
-m message_intervalGenerate a message every 'message_interval' requests.help
-N tagnameTag name, for Monster.help
-n nprocs# of processes to start uphelp
-r release_intervalRelease all memory and close files every release_interval operations.help
-V validation_ftypeThe type of file descriptor to use for doing data validation.help
-w write_logFile to log file writes to.help
-U upanic_condComma separated list of conditions that will cause a call to upanic(PA_PANIC).help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.