.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 .\" .\" Standard preamble: .\" ======================================================================== .de Sh \" Subsection heading .br .if t .Sp .ne 5 .PP \fB\\$1\fR .PP .. .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. | will give a .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to .\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' .\" expand to `' in nroff, nothing in troff, for use with C<>. .tr \(*W-|\(bv\*(Tr .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' 'br\} .\" .\" If the F register is turned on, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . nr % 0 . rr F .\} .\" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .hy 0 .if n .na .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "Bigtop::Backend::CGI::Gantry 3" .TH Bigtop::Backend::CGI::Gantry 3 "2008-01-18" "perl v5.8.8" "User Contributed Perl Documentation" .SH "NAME" app.server \- A generated server for the [% app_name %] app .SH "SYNOPSIS" .IX Header "SYNOPSIS" .Vb 1 \& usage: app.server [options] [port] .Ve .PP port defaults to 8080 .SH "DESCRIPTION" .IX Header "DESCRIPTION" This is a Gantry::Server based stand alone server for the [% app_name +%] app. It was built to use the [% instance %] Gantry::Conf instance in the docs directory. .PP To override the database connection information in your conf file, see \*(L"Changing Databases without Changing Conf\*(R" below. .PP To change instances or master conf files, use these flags (they all require values): .IP "\-\-instance (or \-i)" 4 .IX Item "--instance (or -i)" (Incompatible with \-\-type) .Sp The full name of your conf instance, defaults to [% instance %]. .IP "\-\-type (or \-t)" 4 .IX Item "--type (or -t)" (Incompatible with \-\-instance) .Sp Use this if you use named config blocks in your Bigtop file. Use the name of the config block as the value for \-\-type. This will build the corresponding instance name as [% instance %]_TYPE, where \s-1TYPE\s0 is the value of this flag. .Sp If you don't neither \-\-instance nor \-\-type, the instance you get will be [% instance %]. .IP "\-\-file (or \-f)" 4 .IX Item "--file (or -f)" The name of your master Gantry::Conf file, defaults to docs/app.gantry.conf. .SH "Changing Databases without Changing Conf" .IX Header "Changing Databases without Changing Conf" You may use the following flags to control database connections. If you supply these flags, they will take precedence over your Gantry::Conf instance. All of them require values. .IP "\-\-dbd (or \-d)" 4 .IX Item "--dbd (or -d)" The name of your \s-1DBD\s0 module (like SQLite, Pg, or mysql). If you use dbname, this defaults to SQLite. .IP "\-\-dbname (or \-n)" 4 .IX Item "--dbname (or -n)" The name of your database. .IP "\-\-dbuser (or \-u)" 4 .IX Item "--dbuser (or -u)" Your database user name. .IP "\-\-dbpass (or \-p)" 4 .IX Item "--dbpass (or -p)" Your database password. .SH "NAME" Bigtop::CGI::Backend::Gantry \- CGI dispatch script generator for the Gantry framework .SH "SYNOPSIS" .IX Header "SYNOPSIS" If your bigtop file includes: .PP .Vb 9 \& config { \& CGI Gantry { \& # optional statements: \& # to get a stand alone server: \& with_server 1; \& # to use FastCGI instead of regular CGI: \& fast_cgi 1; \& } \& } .Ve .PP and there are controllers in your app section, this module will generate app.cgi when you type: .PP .Vb 1 \& bigtop app.bigtop CGI .Ve .PP or .PP .Vb 1 \& bigtop app.bigtop all .Ve .PP You can then directly point your httpd.conf directly to the generated app.cgi. .SH "DESCRIPTION" .IX Header "DESCRIPTION" This is a Bigtop backend which generates cgi dispatching scripts for Gantry supported apps. .SH "KEYWORDS" .IX Header "KEYWORDS" This module does not register any keywords. See Bigtop::CGI for a list of allowed keywords (think app and controller level 'location' and controller level 'rel_location' statements). .SH "METHODS" .IX Header "METHODS" To keep podcoverage tests happy. .IP "backend_block_keywords" 4 .IX Item "backend_block_keywords" Tells tentmaker that I understand these config section backend block keywords: .Sp .Vb 7 \& no_gen \& fast_cgi \& with_server \& server_port \& flex_db \& gantry_conf \& template .Ve .Sp .Vb 2 \& instance \& conffile .Ve .Sp Note that instance and conffile are now deprecated in favor of setting gantry_conf to true, which draws the values from the Conf Gantry backend. You may still use them if you like, but that may change in the future. .IP "what_do_you_make" 4 .IX Item "what_do_you_make" Tells tentmaker what this module makes. Summary: app.server and app.cgi. .IP "gen_CGI" 4 .IX Item "gen_CGI" Called by Bigtop::Parser to get me to do my thing. .IP "output_cgi" 4 .IX Item "output_cgi" What I call on the various \s-1AST\s0 packages to do my thing. .IP "setup_template" 4 .IX Item "setup_template" Called by Bigtop::Parser so the user can substitute an alternate template for the hard coded one here. .SH "AUTHOR" .IX Header "AUTHOR" Phil Crow .SH "COPYRIGHT and LICENSE" .IX Header "COPYRIGHT and LICENSE" Copyright (C) 2005 by Phil Crow .PP This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.6 or, at your option, any later version of Perl 5 you may have available.