File: db.c

package info (click to toggle)
grass 8.4.2-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 277,040 kB
  • sloc: ansic: 460,798; python: 227,732; cpp: 42,026; sh: 11,262; makefile: 7,007; xml: 3,637; sql: 968; lex: 520; javascript: 484; yacc: 450; asm: 387; perl: 157; sed: 25; objc: 6; ruby: 4
file content (75 lines) | stat: -rw-r--r-- 1,789 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
/*!
 * \file db/dbmi_client/db.c
 *
 * \brief DBMI Library (client) - open/close driver/database connection
 *
 * (C) 1999-2009 by the GRASS Development Team
 *
 * This program is free software under the GNU General Public
 * License (>=v2). Read the file COPYING that comes with GRASS
 * for details.
 *
 * \author Joel Jones (CERL/UIUC), Radim Blazek
 */

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

/*!
   \brief Open driver/database connection

   \param drvname driver name
   \param dbname database name

   \return pointer to dbDriver structure
   \return NULL on failure
 */
dbDriver *db_start_driver_open_database(const char *drvname, const char *dbname)
{
    dbHandle handle;
    dbDriver *driver;

    G_debug(3, "db_start_driver_open_database(): drvname='%s', dbname='%s'",
            drvname, dbname);

    db_init_handle(&handle);

    driver = db_start_driver(drvname);
    if (driver == NULL) {
        G_warning(_("Unable to start driver <%s>"), drvname);
        return NULL;
    }
    db_set_handle(&handle, dbname, NULL);
    if (db_open_database(driver, &handle) != DB_OK) {
        G_warning(_("Unable to open database <%s> by driver <%s>"), dbname,
                  drvname);
        db_shutdown_driver(driver);
        return NULL;
    }

    return driver;
}

/*!
   \brief Close driver/database connection

   \param driver db driver

   \return DB_OK or DB_FAILED
 */
int db_close_database_shutdown_driver(dbDriver *driver)
{
    int status;

    status = db_close_database(driver);
    G_debug(2, "db_close_database() result: %d  (%d means success)", status,
            DB_OK);

    if (db_shutdown_driver(driver) != 0) {
        status = DB_FAILED;
        G_debug(2, "db_shutdown_driver() failed");
    }

    return status;
}