GRASS GIS 8 Programmer's Manual  8.2.2dev(2023)-3d2c704037
c_opendb.c
Go to the documentation of this file.
1 /*!
2  * \file db/dbmi_client/c_opendb.c
3  *
4  * \brief DBMI Library (client) - open database connection
5  *
6  * (C) 1999-2008 by the GRASS Development Team
7  *
8  * This program is free software under the GNU General Public
9  * License (>=v2). Read the file COPYING that comes with GRASS
10  * for details.
11  *
12  * \author Joel Jones (CERL/UIUC), Radim Blazek
13  */
14 
15 #include <grass/dbmi.h>
16 #include "macros.h"
17 
18 /*!
19  \brief Open database connection
20 
21  \param driver db driver
22  \param handle handle info (database and schema name)
23 
24  \return DB_OK on success
25  \return DB_FAILED on failure
26  */
28 {
29  int ret_code;
30 
31  /* start the procedure call */
32  db__set_protocol_fds(driver->send, driver->recv);
34 
35  /* send the arguments to the procedure */
36  DB_SEND_HANDLE(handle);
37 
38  /* get the return code for the procedure call */
39  DB_RECV_RETURN_CODE(&ret_code);
40 
41  if (ret_code != DB_OK)
42  return ret_code; /* ret_code SHOULD == DB_FAILED */
43 
44  /* no results */
45  return DB_OK;
46 }
#define DB_SEND_HANDLE(x)
Definition: macros.h:57
#define DB_PROC_OPEN_DATABASE
Definition: dbmi.h:34
#define DB_START_PROCEDURE_CALL(x)
Definition: macros.h:2
#define DB_RECV_RETURN_CODE(x)
Definition: macros.h:4
Definition: driver.h:22
FILE * recv
Definition: dbmi.h:171
int db_open_database(dbDriver *driver, dbHandle *handle)
Open database connection.
Definition: c_opendb.c:27
void db__set_protocol_fds(FILE *, FILE *)
?
FILE * send
Definition: dbmi.h:171
#define DB_OK
Definition: dbmi.h:71