manpagez: man pages & more
man vidio(1)
Home | html | info | man
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
© manpagez.com 2000-2021
Individual documents may contain additional copyright information.