<html><head><title>App::Cmdline::Options::DB</title>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" >
<style type="text/css">
<!--/*--><![CDATA[/*><!--*/
BODY {
background: white;
color: black;
font-family: arial,sans-serif;
margin: 0;
padding: 1ex;
}
A:link, A:visited {
background: transparent;
color: #006699;
}
A[href="#POD_ERRORS"] {
background: transparent;
color: #FF0000;
}
DIV {
border-width: 0;
}
DT {
margin-top: 1em;
margin-left: 1em;
}
.pod { margin-right: 20ex; }
.pod PRE {
background: #eeeeee;
border: 1px solid #888888;
color: black;
padding: 1em;
white-space: pre;
}
.pod H1 {
background: transparent;
color: #006699;
font-size: large;
}
.pod H1 A { text-decoration: none; }
.pod H2 A { text-decoration: none; }
.pod H3 A { text-decoration: none; }
.pod H4 A { text-decoration: none; }
.pod H2 {
background: transparent;
color: #006699;
font-size: medium;
}
.pod H3 {
background: transparent;
color: #006699;
font-size: medium;
font-style: italic;
}
.pod H4 {
background: transparent;
color: #006699;
font-size: medium;
font-weight: normal;
}
.pod IMG {
vertical-align: top;
}
.pod .toc A {
text-decoration: none;
}
.pod .toc LI {
line-height: 1.2em;
list-style-type: none;
}
/*]]>*/-->
</style>
</head>
<body class='pod'>
<!--
generated by Pod::Simple::HTML v3.20,
using Pod::Simple::PullParser v3.20,
under Perl v5.012004 at Sat Apr 21 11:23:35 2012 GMT.
If you want to change this HTML document, you probably shouldn't do that
by changing it directly. Instead, see about changing the calling options
to Pod::Simple::HTML, and/or subclassing Pod::Simple::HTML,
then reconverting this document from the Pod source.
When in doubt, email the author of Pod::Simple::HTML for advice.
See 'perldoc Pod::Simple::HTML' for more info.
-->
<!-- start doc -->
<a name='___top' class='dummyTopAnchor' ></a>
<div class='indexgroup'>
<ul class='indexList indexList1'>
<li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
<li class='indexItem indexItem1'><a href='#VERSION'>VERSION</a>
<li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
<li class='indexItem indexItem1'><a href='#DESCRIPTION'>DESCRIPTION</a>
<li class='indexItem indexItem1'><a href='#OPTIONS'>OPTIONS</a>
<ul class='indexList indexList2'>
<li class='indexItem indexItem2'><a href='#--dbname'>--dbname</a>
<li class='indexItem indexItem2'><a href='#--dbhost'>--dbhost</a>
<li class='indexItem indexItem2'><a href='#--dbport'>--dbport</a>
<li class='indexItem indexItem2'><a href='#--dbuser'>--dbuser</a>
<li class='indexItem indexItem2'><a href='#--dbpasswd'>--dbpasswd</a>
<li class='indexItem indexItem2'><a href='#--dbsocket'>--dbsocket</a>
</ul>
<li class='indexItem indexItem1'><a href='#AUTHOR'>AUTHOR</a>
<li class='indexItem indexItem1'><a href='#COPYRIGHT_AND_LICENSE'>COPYRIGHT AND LICENSE</a>
</ul>
</div>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="NAME"
>NAME</a></h1>
<p>App::Cmdline::Options::DB - set of database-related options for command-line applications</p>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="VERSION"
>VERSION</a></h1>
<p>version 0.1.0</p>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="SYNOPSIS"
>SYNOPSIS</a></h1>
<pre> # In your module that represents a command-line application:
sub opt_spec {
my $self = shift;
return $self->check_for_duplicates (
[ 'check|c' => "only check the configuration" ],
...,
$self->composed_of (
'App::Cmdline::Options::DB', # here are the database options added
'App::Cmdline::Options::Basic', # here may be other options
)
);
}</pre>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="DESCRIPTION"
>DESCRIPTION</a></h1>
<p>This is a kind of a <i>role</i> module, defining a particular set of command-line options and their validation. See more about how to write a module that represents a command-line application and that uses this set of options in <a href="http://search.cpan.org/perldoc?App%3A%3ACmdline" class="podlinkpod"
>App::Cmdline</a>.</p>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="OPTIONS"
>OPTIONS</a></h1>
<p>Particularly, this module specifies the database-related options, allowing to define what database to access and how to authenticate the access. It is particularly well suited for the MySQL DBI access.</p>
<pre> [ 'dbname=s' => "database name" ],
[ 'dbhost=s' => "hostname hosting database", { default => 'localhost' } ],
[ 'dbport=i' => "database port number", { default => 3306 } ],
[ 'dbuser=s' => "user name to access database", { default => 'reader' } ],
[ 'dbpasswd=s' => "password to access database" ],
[ 'dbsocket=s' => "UNIX socket accessing the database" ],</pre>
<h2><a class='u' href='#___top' title='click to go to top of document'
name="--dbname"
>--dbname</a></h2>
<p>It specifies the database name. No default value.</p>
<h2><a class='u' href='#___top' title='click to go to top of document'
name="--dbhost"
>--dbhost</a></h2>
<p>It specifies the computer name (or its IP address) where is the database. Default value is <code>localhost</code>.</p>
<h2><a class='u' href='#___top' title='click to go to top of document'
name="--dbport"
>--dbport</a></h2>
<p>It is an integer, specifying a port number where the database is listening. Default value is 3306 (suited for MySQL).</p>
<h2><a class='u' href='#___top' title='click to go to top of document'
name="--dbuser"
>--dbuser</a></h2>
<p>It specifies a user name to access this database. Default value is <code>reader</code>,</p>
<h2><a class='u' href='#___top' title='click to go to top of document'
name="--dbpasswd"
>--dbpasswd</a></h2>
<p>It specifies a database password for the given user. No default value.</p>
<h2><a class='u' href='#___top' title='click to go to top of document'
name="--dbsocket"
>--dbsocket</a></h2>
<p>It specifies a UNIX socket file name (such as <em>/tmp/mysqld.sock</em>). No default value.</p>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="AUTHOR"
>AUTHOR</a></h1>
<p>Martin Senger <martin.senger@gmail.com></p>
<h1><a class='u' href='#___top' title='click to go to top of document'
name="COPYRIGHT_AND_LICENSE"
>COPYRIGHT AND LICENSE</a></h1>
<p>This software is copyright (c) 2012 by Martin Senger, CBRC - KAUST (Computational Biology Research Center - King Abdullah University of Science and Technology) All Rights Reserved.</p>
<p>This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.</p>
<!-- end doc -->
</body></html>