#include <grass/dbmi.h>
#include "macros.h"

/*!
 \fn int db_describe_table (dbDriver *driver, dbString *name, dbTable **table)
 \brief 
 \return 
 \param 
*/
int
db_describe_table (dbDriver *driver, dbString *name, dbTable **table)
{
    int ret_code;

/* start the procedure call */
    db__set_protocol_fds (driver->send, driver->recv);
    DB_START_PROCEDURE_CALL(DB_PROC_DESCRIBE_TABLE);

/* send the argument(s) to the procedure */
    DB_SEND_STRING (name);

/* get the return code for the procedure call */
    DB_RECV_RETURN_CODE(&ret_code);

    if (ret_code != DB_OK)
	return ret_code; /* ret_code SHOULD == DB_FAILED */

/* get the results */
    DB_RECV_TABLE_DEFINITION(table);
    return DB_OK;
}