vidio(1) vidio(1)
NAME
vidio - Video frame producer consumer performance test
SYNOPSIS
vidio [options] dir_path [dir_path...]
DESCRIPTION
vidio can emulate a producer or a consumer of video frames. When run
as a producer (write mode), vidio generates video frames and writes
them to files that are created in the specified directory. When vidio
is run as a consumer (read mode), it reads frames from the files in
the specified directory that were previously created and written. By
default, vidio runs in producer mode and creates one file for each
frame.
Optionally, more than one directory can be named. In this case, vidio
will start an identical I/O stream in each specified directory.
vidio will then write performance information to the standard output.
The verbosity of the performance data can be controlled using the -v
option. A realtime updating curses based display is optionally avail-
able via the -c option.
OPTIONS
-? Display usage.
-c Display important statistics via a curses based continuously up-
dating display.
-d[dd] Run in debug mode. The more "d's" specified, the more debug in-
formation is printed.
-D Use direct I/O.
-f framesize
Specify the framesize or the frame type. Various type of video
frame types may be specified. The default frame type is "hdtv".
Currently this results in a frame size of 8,294,400 bytes. Use
the -? option to get a list of currently supported frame types.
The framesize can also be specified in bytes. Optionally, the
suffixes k, m, g, K, M or G can be added to the numeric frame
size value to represent kilobytes, megabytes, gigabytes, kilobi-
nary, megabinary or gigabinary values, respectively. The lower-
case letters represent base 10 units (e.g. 1k = 1000) and the
uppercase letters represent base 2 units (e.g. 1K = 1024.)
-F framerate
Emulate a frame producing or consuming device by limiting the
number of frames produced or consumed per second to the speci-
fied frame rate. This option is only valid for asynchronous op-
eration, i.e. when the queue depth (the -q option) is set to a
non-zero value. If the file file system cannot keep up to the
specified frame rate, the "Dropped frames" stat is incremented.
-i iosize
The size of the reads or writes in bytes. By default, this is
framesize. Like framesize, the iosize may be suffixed by a k,
m, g, K, M, or G. The -i option is available only in synchro-
nous mode. In asynchronous mode, (-q option) the iosize is set
to be one frame.
-n nframes
The number of frames to read or write. The default is currently
60 frames.
-N nframes
The number of frames per file. The default is one.
-p prefix
Frame file names use the given prefix instead of the default of
"vidio". Vidio then appends '_NNNNNNN' as the frame number to
the prefix.
-P Preallocate the file. This option is supported only on the
StorNext file system.
-q qdepth
Do asynchronous I/O by queuing requests qdepth deep.
-r Consumer mode. Read frames of previously created using the -w
option.
-v[vv] Print performance output in a more verbose fashion. The more
"v's" specified, the more performance information is printed.
-w Producer mode. Create files and write frames. Create and write
is the default test mode.
FILES
/System/Library/Filesystems/acfs.fs/Contents/bin/Mio
SEE ALSO
cvfs(8)
StorNext File System June 2014 vidio(1)
Mac OS X 10.12.3 - Generated Sat Feb 4 18:21:18 CST 2017