VDSF
Menu

vdsErrors.h File Reference

This graph shows which files directly or indirectly include this file:


Enumerations

enum  vdsErrors {
  VDS_OK = 0,
  VDS_INTERNAL_ERROR = 666,
  VDS_ENGINE_BUSY = 1,
  VDS_NOT_ENOUGH_VDS_MEMORY = 2,
  VDS_NOT_ENOUGH_HEAP_MEMORY = 3,
  VDS_NOT_ENOUGH_RESOURCES = 4,
  VDS_WRONG_TYPE_HANDLE = 5,
  VDS_NULL_HANDLE = 6,
  VDS_NULL_POINTER = 7,
  VDS_INVALID_LENGTH = 8,
  VDS_PROCESS_ALREADY_INITIALIZED = 21,
  VDS_PROCESS_NOT_INITIALIZED = 22,
  VDS_INVALID_WATCHDOG_ADDRESS = 23,
  VDS_INCOMPATIBLE_VERSIONS = 24,
  VDS_SOCKET_ERROR = 25,
  VDS_CONNECT_ERROR = 26,
  VDS_SEND_ERROR = 27,
  VDS_RECEIVE_ERROR = 28,
  VDS_BACKSTORE_FILE_MISSING = 29,
  VDS_ERROR_OPENING_VDS = 30,
  VDS_LOGFILE_ERROR = 41,
  VDS_SESSION_CANNOT_GET_LOCK = 42,
  VDS_SESSION_IS_TERMINATED = 43,
  VDS_INVALID_OBJECT_NAME = 51,
  VDS_NO_SUCH_OBJECT = 52,
  VDS_NO_SUCH_FOLDER = 53,
  VDS_OBJECT_ALREADY_PRESENT = 54,
  VDS_IS_EMPTY = 55,
  VDS_WRONG_OBJECT_TYPE = 56,
  VDS_OBJECT_CANNOT_GET_LOCK = 57,
  VDS_REACHED_THE_END = 58,
  VDS_INVALID_ITERATOR = 59,
  VDS_OBJECT_NAME_TOO_LONG = 60,
  VDS_FOLDER_IS_NOT_EMPTY = 61,
  VDS_ITEM_ALREADY_PRESENT = 62,
  VDS_NO_SUCH_ITEM = 63,
  VDS_OBJECT_IS_DELETED = 64,
  VDS_OBJECT_NOT_INITIALIZED = 65,
  VDS_ITEM_IS_IN_USE = 66,
  VDS_ITEM_IS_DELETED = 67,
  VDS_I18N_CONVERSION_ERROR = 68,
  VDS_OBJECT_IS_IN_USE = 69
}

Enumeration Type Documentation

enum vdsErrors

Enumerator:
VDS_OK  No error.

..

VDS_INTERNAL_ERROR  Abnormal internal error - it should not happen!
VDS_ENGINE_BUSY  Cannot get a lock on a system object, the engine is "busy".

This might be the result of either a very busy system where unused cpu cycles are rare or a lock might be held by a crashed process.

VDS_NOT_ENOUGH_VDS_MEMORY  Not enough memory in the VDS.
VDS_NOT_ENOUGH_HEAP_MEMORY  Not enough heap memory (non-VDS memory).
VDS_NOT_ENOUGH_RESOURCES  There are not enough resources to correctly process the call.

This might be due to a lack of POSIX semaphores on systems where locks are implemented that way or a failure in initializing a pthread_mutex (or on Windows, a critical section).

VDS_WRONG_TYPE_HANDLE  The provided handle is of the wrong type.
VDS_NULL_HANDLE  The provided handle is NULL (zero).
VDS_NULL_POINTER  One of the arguments of an API function is an invalid NULL pointer.
VDS_INVALID_LENGTH  An invalid length was provided (it will usually indicate that the length value is set to zero.
VDS_PROCESS_ALREADY_INITIALIZED  The process was already initialized.

Was vdsInit() called for a second time?

VDS_PROCESS_NOT_INITIALIZED  The process was not properly initialized.

Was vdsInit() called?

VDS_INVALID_WATCHDOG_ADDRESS  The watchdog address is invalid (empty string, NULL pointer, etc.

)

VDS_INCOMPATIBLE_VERSIONS  API - memory-file version mismatch.
VDS_SOCKET_ERROR  Generic socket error.
VDS_CONNECT_ERROR  Socket error when trying to connect to the watchdog.
VDS_SEND_ERROR  Socket error when trying to send a request to the watchdog.
VDS_RECEIVE_ERROR  Socket error when trying to receive a reply from the watchdog.
VDS_BACKSTORE_FILE_MISSING  The vds backstore file is missing (the name of this file is provided by the watchdog).
VDS_ERROR_OPENING_VDS  Generic i/o error when attempting to open the vds.
VDS_LOGFILE_ERROR  Error accessing the directory for the log files or error opening the log file itself.
VDS_SESSION_CANNOT_GET_LOCK  Cannot get a lock on the session (a pthread_mutex or a critical section on Windows).
VDS_SESSION_IS_TERMINATED  An attempt was made to use a session object (a session handle) after this session was terminated.
VDS_INVALID_OBJECT_NAME  Permitted characters for names are alphanumerics, spaces (' '), dashes ('-') and underlines ('_').

The first character must be alphanumeric.

VDS_NO_SUCH_OBJECT  The object was not found (but its folder does exist).
VDS_NO_SUCH_FOLDER  One of the parent folder of an object does not exist.
VDS_OBJECT_ALREADY_PRESENT  Attempt to create an object which already exists.
VDS_IS_EMPTY  The object (data container) is empty.
VDS_WRONG_OBJECT_TYPE  Attempt to create an object of an unknown object type or to open an object of the wrong type.
VDS_OBJECT_CANNOT_GET_LOCK  Cannot get lock on the object.

This might be the result of either a very busy system where unused cpu cycles are rare or a lock might be held by a crashed process.

VDS_REACHED_THE_END  The search/iteration reached the end without finding a new item/record.
VDS_INVALID_ITERATOR  An invalid value was used for a vdsIteratorType parameter.
VDS_OBJECT_NAME_TOO_LONG  The name of the object is too long.

The maximum length of a name cannot be more than VDS_MAX_NAME_LENGTH (or VDS_MAX_FULL_NAME_LENGTH for the fully qualified name).

VDS_FOLDER_IS_NOT_EMPTY  You cannot delete a folder if there are still undeleted objects in it.

Technical: a folder does not need to be empty to be deleted but all objects in it must be "marked as deleted" by the current session. This enables writing recursive deletions

VDS_ITEM_ALREADY_PRESENT  An item with the same key was found.
VDS_NO_SUCH_ITEM  The item was not found in the hash map.
VDS_OBJECT_IS_DELETED  The object is scheduled to be deleted soon.

Operations on this data container are not permitted at this time.

VDS_OBJECT_NOT_INITIALIZED  Object must be open first before you can access them.
VDS_ITEM_IS_IN_USE  The data item is scheduled to be deleted soon or was just created and is not committed.

Operations on this data item are not permitted at this time.

VDS_ITEM_IS_DELETED  The data item is scheduled to be deleted soon.

Operations on this data container are not permitted at this time.

VDS_I18N_CONVERSION_ERROR  i18n string conversion error.

In other words, the name of the object cannot be converted to/frm your current locale.

VDS_OBJECT_IS_IN_USE  The object is scheduled to be deleted soon or was just created and is not committed.

Operations on this object are not permitted at this time.

Last updated on April 07, 2008.