qdb_data_source()

Extract the data source for a database

Synopsis:

#include <qdb/qdb.h>

int qdb_data_source( qdb_hdl_t *hdl,
                     char *buffer,
                     int buflen );


Arguments:

hdl
A pointer to the database handle.
buffer
A buffer to hold the resulting source path information. You can set this parameter to NULL to make the function return the required buffer size. The buffer is managed by the client application, not by QDB.
buflen
The length of buffer; this argument is relevant only when the buffer is not NULL.

Library:

qdb

Description:

This function provides a description of the source used to initialize the database. This source may be one of several paths, or a list of the schema creation and data population files, depending on the state of the specified database when the qdb utility is started and on how the database is initialized:

If you don't know the buffer size required to hold the data source string, call qdb_data_source() with buffer set to NULL and use the function's return value for the amount of memory to allocate for the buffer. Then, call qdb_data_source() again, passing in the address of the created buffer in buffer, to get the data source.

Returns:

>=0
Depending on the arguments, either the required size of the buffer to store the data source or the length of the string stored in buffer (both size values include the null-terminator).
-1
An error occurred (errno is set).

Classification:

QNX Neutrino

Safety:  
Interrupt handler No
Signal handler No
Thread Yes