.TH dbconfig-generate-include "1" "March 2005" "sean finney " "dbconfig-common"
.SH NAME
dbconfig-generate-include \- generate custom format db include files

.SH SYNOPSIS
.B dbconfig\-generate\-include [-hv] [-f format] [\-a] [\-d [varname]] [\-u [varname]] [\-p [varname]] [\-s [varname]] [\-P [varname]] [\-t [varname]] [\-O owner[:group]] [\-m mode] [\-U] infile [outfile]
.br
.Xc

.SH DESCRIPTION
.B dbconfig\-generate\-include
is a program to generate custom format include files containing the
information necessary to connect a program to a database resource.

.SH OPTIONS
.TP
infile
use the given dbconfig\-common config file as input
.TP
outfile
use the given file as input (default: stdout)
.TP
\fB\-f\fR|\-\-format
use the given output format (default: sh)
.TP
\fB\-a\fR|\-\-all
include all information in output (default)
.TP
\fB\-d\fR|\-\-dbname
include the dbname in the output
.TP
\fB\-p\fR|\-\-dbpass
include the dbpass in the output
.TP
\fB\-s\fR|\-\-dbserver
include the dbserver in the output
.TP
\fB\-P\fR|\-\-dbport
include the dbport in the output
.TP
\fB\-u\fR|\-\-dbuser
include the dbuser in the output
.TP
\fB\-t\fR|\-\-dbtype
include the dbtype in the output
.TP
\fB\-O\fR|\-\-owner
set the owner:group of the output file
.TP
\fB\-m\fR|\-\-mode
set the permissions on the output file
.TP
\fB\-U\fR|\-\-ucf
register the outputfile with ucf
.TP
\fB\-h\fR|\-\-help
display this helpful message
.TP
\fB\-v\fR|\-\-version
output the version and exit

.PP
format is one of a list of include\-file style formats for various
programming languages.  the current list includes:
.TP
sh 
/bin/sh style include file
.TP
perl
perl parseable include file
.TP
php
php parseable include file
.TP
cpp
c\-style header file, using #define'd constants