.TH GDI_GET_DATABASE 3 "8/19/93 (v16.3)"
.ig
% ptroff -man gdi_get_database.3
SccsID=@(#)gdi_get_database.3	16.3 8/19/93
..
.SH NAME
.PP
gdi_get_database \- get database name from database connector
.SH SYNOPSIS
.PP
.nf
.ta 8 16
.B #include "libgdi.h"
.sp
.B int
.B gdi_get_database (conn, database, len)
\fBdbConn	*conn;\fP	/* (i) database connection */
\fBchar	*database;\fP	/* (o) database name */
\fBint	len;\fP	/* (i) length of database argument */
.fi
.SH DESCRIPTION
.PP
gdi_get_database() gets the database name from the database connector.
.SH ARGUMENTS
.PP
.TP 12
.B conn
The database connector.
.TP 12
.B database
Database name is filled in by this routine.
.TP 12
.B len
Length of the \fIdatabase\fP argument.
.SH DIAGNOSTICS
gdi_get_database() returns one of the following status values.
.PP
.TP 12
.B GDI_SUCCESS
Routine succeeded.
.TP 12
.B GDI_FAILURE
Not connected to database.
.SH FILE
.PP
gdi_conn.c
.SH SEE ALSO
.PP
.BR gdi_get_account (3),
.BR gdi_get_node (3)
.SH AUTHOR
.PP
B. MacRitchie, SAIC Geophysical Systems Operation, Open Systems Division