Download Virtual Disk API Programming Guide

Virtual Disk API Programming Guide
Table A-1. NFC Session Connection Limits
Host Platform
When Connecting
Limits You To
ESX 4
Directly
9 connections
ESX 4
Through vCenter Server
27 connections
ESXi 4
Directly
11 connections
ESXi 4
Through vCenter Server
23 connections
APIs to Select Transport Methods
This section summarizes the new APIs for selecting transport method.
Initialize Virtual Disk API
VixDiskLib_InitEx() initializes new releases of the library, replacing VixDiskLib_Init(). Parameters are similar, except you should specify an actual libDir, and the new configFile parameter. For multithreaded programming, you should write your own logFunc, because the default logging function is not thread‐safe.
VixError vixError = VixDiskLib_InitEx(1, 1, &logFunc, &warnFunc, &panicFunc, *libDir,
*configFile);
On Windows *libDir could be C:\Program Files\VMware\VMware Virtual Disk Development Kit. On Linux *libDir is probably /usr/lib/vmware-vix-disklib.
Logged messages appear in C:\Documents and Settings\<user>\Local Settings\Temp\vmware-<user> on Windows and in /var/log on Linux, for this and many other VMware products. The currently supported entries in the configFile are listed below. The correct way to specify a value is name=value.

tmpDirectory = "<TempDirectoryForLogging>"

vixDiskLib.transport.LogLevel – Overrides the default logging for vixDiskLib transport functions (not including NFC). The default value for this option is 6. Its range is 0 to 6, where 6 is most verbose and 0 is quiet.

vixDiskLib.disklib.EnableCache – Caching by vixDiskLib is off by default. This variable turns caching on. The disadvantage of caching is that although you get some performance improvement, you risk getting stale data if programs go directly to the disk. Acceptable values are 0 for Off and 1 for On.
The following NFC related options override the default numbers provided to the various NFC functions.

vixDiskLib.nfc.AcceptTimeoutMs – Overrides the default value (default is no timeout) for NFC accept operations. This timeout is specifed in milliseconds.

vixDiskLib.nfc.RequestTimeoutMs – Overrides the default value (default is no timeout) for NFC request operations. This timeout is specifed in milliseconds.

vixDiskLib.nfc.ReadTimeoutMs – Overrides the default value (default is no timeout) for NFC read operations. This timeout is specifed in milliseconds.

vixDiskLib.nfc.WriteTimeoutMs – Overrides the default value (default is no timeout) for NFC write operations. This timeout is specifed in milliseconds.

vixDiskLib.nfcFssrvr.TimeoutMs – Overrides the default value (default is 0, indefinite waiting) for NFC file system operations. This timeout is specifed in milliseconds. If you specify a value, then a timeout occurs if the file system is idle for the indicated period of time. The hazard of using the default value is that in a rare case of catastrophic communications failure, the file system will remain locked.

vixDiskLib.nfcFssrvrWrite.TimeoutMs – Overrides the default value (default is no timeout) for NFC file system write operations. This timeout is specifed in milliseconds. If you specify a value, it will timeout when a write operation fails to complete in the specified time interval.
Timeout values are stored in a 32‐bit field, so the maximum timeout you may specify is 2G (2,147,483,648).
46
VMware, Inc.