apache2::build(3) [osx man page]

Apache2::Build(3)					User Contributed Perl Documentation					 Apache2::Build(3)

NAME

       Apache2::Build - Methods for locating and parsing bits of Apache source code

SYNOPSIS

	use Apache2::Build ();
	my $build = Apache2::Build->new;

	# rebuild mod_perl with build opts from the previous build
	% cd modperl-2.0
	% perl -MApache2::Build -e rebuild

DESCRIPTION

       This module provides methods for locating and parsing bits of Apache source code.

       Since mod_perl remembers what build options were used to build it, you can use this knowledge to rebuild it using the same options. Simply
       chdir to the mod_perl source directory and run:

	 % cd modperl-2.0
	 % perl -MApache2::Build -e rebuild

       If you want to rebuild not yet installed, but already built mod_perl, run from its root directory:

	 % perl -Ilib -MApache2::Build -e rebuild

METHODS

       new Create an object blessed into the Apache2::Build class.

	    my $build = Apache2::Build->new;

       dir Top level directory where source files are located.

	    my $dir = $build->dir;
	    -d $dir or die "can't stat $dir $!
";

       find
	   Searches for apache source directories, return a list of those found.

	   Example:

	    for my $dir ($build->find) {
	       my $yn = prompt "Configure with $dir ?", "y";
	       ...
	    }

       inc Print include paths for MakeMaker's INC argument to "WriteMakefile".

	   Example:

	    use ExtUtils::MakeMaker;

	    use Apache2::Build ();

	    WriteMakefile(
		'NAME'	  => 'Apache2::Module',
		'VERSION' => '0.01',
		'INC'	  => Apache2::Build->new->inc,
	    );

       module_magic_number
	   Return the MODULE_MAGIC_NUMBER defined in the apache source.

	   Example:

	    my $mmn = $build->module_magic_number;

       httpd_version
	   Return the server version.

	   Example:

	    my $v = $build->httpd_version;

       otherldflags
	   Return other ld flags for MakeMaker's dynamic_lib argument to "WriteMakefile". This might be needed on systems like AIX that need
	   special flags to the linker to be able to reference mod_perl or httpd symbols.

	   Example:

	    use ExtUtils::MakeMaker;

	    use Apache2::Build ();

	    WriteMakefile(
		'NAME'	      => 'Apache2::Module',
		'VERSION'     => '0.01',
		'INC'	      => Apache2::Build->new->inc,
		'dynamic_lib' => {
		    'OTHERLDFLAGS' => Apache2::Build->new->otherldflags,
		},
	    );

AUTHOR

       Doug MacEachern

perl v5.16.2							    2011-12-25							 Apache2::Build(3)

apache_mod_perl-108~358::mod_perl-2.0.7::docs::api::ApacUser:Contributed Peapache_mod_perl-108~358::mod_perl-2.0.7::docs::api::Apache2::Command(3)

NAME

       Apache2::Command - Perl API for accessing Apache module command information

Synopsis
	 use Apache2::Module ();
	 use Apache2::Command ();
	 my $module = Apache2::Module::find_linked_module('mod_perl.c');

	 for (my $cmd = $module->cmds; $cmd; $cmd = $cmd->next) {
	     $cmd->args_how();
	     $cmd->errmsg();
	     $cmd->name();
	     $cmd->req_override();
	 }

Description
       "Apache2::Command" provides the Perl API for accessing Apache module command information

API

       "Apache2::Command" provides the following functions and/or methods:

   "args_how"
       What the command expects as arguments:

	 $how = $cmd->args_how();

       obj: $cmd ( "Apache2::Command object" )
       ret: $how ( "Apache2::Const :cmd_how constant" )
	   The flag value representing the type of this command (i.e. "Apache2::Const::ITERATE", "Apache2::Const::TAKE2").

       since: 2.0.00

   "errmsg"
       Get usage message for that command, in case of syntax errors:

	 $error = $cmd->errmsg();

       obj: $cmd ( "Apache2::Command object" )
       ret: $error ( string )
	   The error message

       since: 2.0.00

   "name"
       Get the name of this command:

	 $name = $cmd->name();

       obj: $cmd ( "Apache2::Command object" )
       ret: $name ( string )
	   The command name

       since: 2.0.00

   "next"
       Get the next command in the chain of commands for this module:

	 $next = $cmd->next();

       obj: $cmd ( "Apache2::Command object" )
       ret: $next ( "Apache2::Command object" )
	   Returns the next command in the chain for this module, "undef" for the last command.

       since: 2.0.00

   "req_override"
       What overrides need to be allowed to enable this command:

	 $override = $cmd->req_override

       obj: $cmd ( "Apache2::Command object" )
       ret: $override ( "Apache2::Const :override constant" )
	   The bit mask representing the overrides this command is allowed in (i.e "Apache2::Const::OR_ALL"/"Apache2::Const::ACCESS_CONF").

       since: 2.0.00

       For example:

	 use Apache2::Const -compile => qw(:override);
	 $cmd->req_override() & Apache2::Const::OR_AUTHCFG;
	 $cmd->req_override() & Apache2::Const::OR_LIMIT;

See Also
       mod_perl 2.0 documentation.

Copyright
       mod_perl 2.0 and its core modules are copyrighted under The Apache Software License, Version 2.0.

Authors
       The mod_perl development team and numerous contributors.

perl v5.16.2							    2011-02apache_mod_perl-108~358::mod_perl-2.0.7::docs::api::Apache2::Command(3)