Geografic-Information-System/lib/db/dbmi_client/shutdown.c

/*!
 * \file db/dbmi_client/shutdown.c
 * 
 * \brief DBMI Library (client) - shutdown database connection
 *
 * (C) 1999-2008 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 <stdlib.h>

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

/*!
  \brief Closedown the driver, and free the driver structure

  <b>Note:</b> the management of the memory for the driver structure
  probably should be handled differently.
 
  db_start_driver() could take a pointer to driver structure as an
  argument, instead of returning the pointer to allocated then there
  would be no hidden free required

  \param driver pointer to dbDriver to be freed

  \return 0 on success
  \return -1 on error
*/
int db_shutdown_driver(dbDriver * driver)
{
    int status;

    db__set_protocol_fds(driver->send, driver->recv);
    DB_START_PROCEDURE_CALL(DB_PROC_SHUTDOWN_DRIVER);

    /* close the communication FILEs */
    fclose(driver->send);
    fclose(driver->recv);

    driver->send = NULL;
    driver->recv = NULL;

    /* wait for the driver to finish */
    status = -1;

    /* convert status according to return code of G_wait() */
    status = G_wait(driver->pid) == -1 ? -1 : 0;

    driver->pid = 0;

    /* remove also error handler if defined */
    db_unset_error_handler_driver(driver);
    
    /* free the driver structure. THIS IS GOOFY */
    db_free(driver);

    return status;
}