Virtual Disk API Programming Guide - Documentation - VMware

Virtual Disk Programming Guide
C++ on Linux Systems
Find the sample source in this directory:
/usr/share/doc/vmware-vix-disklib/samples/diskLib
You can copy vixDiskLibSample.cpp and its Makefile to a directory where you have write permission, or
switch user to root. On some Linux systems you need to add #include statements for and
after the #else clause on line 15. Type the make command to compile. Run the application:
make
./vix-disklib-sample
NOTE If this fails, edit /etc/ld.so.conf and run ldconfig as root or change your LD_LIBRARY_PATH
environment to include the library installation path, /usr/lib/vmware-vix-disklib/lib32 (or lib64).
Makefile
The Makefile fetches any packages that are required for compilation but are not installed.
Library Files Required
The virtual disk library comes with dynamic libraries, or shared objects on Linux, to simplify the delivery of
third‐party and open source components.
Windows requires the lib/vixDiskLib.lib file for linking, and the bin/*.dll files at runtime.
Linux uses .so files for both linking and running.
Usage Message
Running the sample application without arguments produces the following usage message:
Usage: vixdisklibsample command [options] diskPath
commands:
-create : creates a sparse virtual disk with capacity specified by -cap
-redo parentPath : creates a redo log 'diskPath' for base disk 'parentPath'
-info : displays information for specified virtual disk
-dump : dumps the contents of specified range of sectors in hexadecimal
-fill : fills specified range of sectors with byte value specified by -val
-wmeta key value : writes (key,value) entry into disk's metadata table
-rmeta key : displays the value of the specified metada entry
-meta : dumps all entries of the disk's metadata
-clone sourcePath : clone source vmdk possibly to a remote site
-readbench blocksize: do read benchmark on a disk using the specified I/O block size in sectors
-writebench blocksize: do write benchmark on disk using the specified I/O block size in sectors
options:
-adapter [ide|scsi] : bus adapter type for 'create' option (default='scsi')
-start n : start sector for 'dump/fill' options (default=0)
-count n : number of sectors for 'dump/fill' options (default=1)
-val byte : byte value to fill with for 'write' option (default=255)
-cap megabytes : capacity in MB for -create option (default=100)
-single : open file as single disk link (default=open entire chain)
-multithread n: start n threads and copy the file to n new files
-host hostname : hostname / IP addresss (ESX 3.x or VC 2.x)
-user userid : user name on host (default = root)
-password password : password on host
-port port : port to use to connect to host (default = 902)
-vm vmPath=/path/to/vm : inventory path to vm that owns the virtual disk
-libdir dir : Directory containing vixDiskLibPlugin library
-initex configfile : Use VixDiskLib_InitEx
-ssmoref moref : Managed object reference of VM snapshot
-mode mode : Mode string to pass into VixDiskLib_ConnectEx
-thumb string : Provides a SSL thumbprint string for validation
The -thumb option is a new security‐related feature in the VDDK 5.1 release. See “SSL Certificate Thumbprint”
on page 48.
44 VMware, Inc.