Product Documentation

c-treeACE V11.0 Release Notes

Previous Topic

Next Topic

Corrected Error Handling for ctVERIFYidx and ctVerifyFile APIs

The following issues were addressed:

  1. When ctVERIFYidx was canceled by the callback returning an error, it failed with VRFY_ERR rather than the documented VFYTRM_ERR.
  2. ctVERIFYidx reported false errors on an index. Repeating the call eventually showed no errors.
  3. The ctvfyidx utility failed with LERR_ERR when the ‑excl option was set.

These issues were corrected. As a result, ctVERIFYidx now requires the file to be open in ctEXCLUSIVE mode or in ctREADFIL (read only) mode to ensure it does not incorrectly report errors if other users make changes while the verification is running. Opening with ctSHARED will fail with LERR_ERR.

Note: A call is made to CTFLUSH on the index prior to leaf verification to ensure all changes are on disk. In some cases, such as for SUPERFILE members, CTFLUSH can fail. An error message is logged, but the verification will continue. In this case, a VRFY_ERR could indicate the existence of updated index nodes in cache. The application should ensure that the data has been properly flushed.

The ctvfyidx utility now defaults to ctREADFIL. It uses ctEXCLUSIVE when the ‑excl option is specified.

Older versions of ctvfyidx will only work with the ‑excl option when connecting to newer servers.

TOCIndex