mason(1) [debian man page]

MASON(1)																  MASON(1)

NAME

       mason - interactively create a firewall

SYNOPSIS

       mason < logfile > rulefile

DESCRIPTION

       This manual page briefly documents the mason command.

       mason interactively generates a set of firewall rules for a Linux-based firewall.  This is done by turning on full IP logging, watching the
       logs for connections, and generating rules describing the connections seen.  mason is familiar with most of the quirks of  various  connec-
       tion types (such as ftp and IRC), and can output rules for 2.0.x ipfwadm, 2.2.x ipchains, and Cisco packet filters.

       mason  operates by reading in log file information from standard input and writing firewall rules to standard output.  This allows mason to
       work offline or on a separate system.  Real-time firewall generation can be achieved with a command like tail(1).

       Most users will want to run mason with a user-friendly interface such as mason-gui-text(1).

ENVIRONMENT

       mason is configured using the following environment variables.

       ECHOCOMMAND
	      Sets the type of firewall rules that mason should output to standard out.  Allowed values  include  "ipfwadm"  and  "ipchains".	By
	      default, mason outputs whatever kind of rules are supported by the currently running Linux kernel.

       DOCOMMAND
	      Sets  the  type  of firewall rules that mason should run immediately when a rule is generated.  Allowed values include "ipfwadm" and
	      "ipchains".  By default, mason outputs whatever kind of rules are supported by the currently running Linux kernel.

       HEARTBEAT
	      If set to "yes", mason will output a "+" or "-" to standard error whenever a rule generated by mason has been triggered.

       DYNIP  Set this to the list of interfaces that have dynamically assigned addresses, separated by spaces.

SEE ALSO

       mason-gui-text(1)

AUTHOR

       This manual page was written by Jeff Licquia <jeff@luci.org>, for the Debian GNU/Linux system (but may be used by others).

																	  MASON(1)

MicroMason::LineNumbers(3pm)				User Contributed Perl Documentation			      MicroMason::LineNumbers(3pm)

NAME

       Text::MicroMason::LineNumbers - Report errors at correct source code line numbers

DESCRIPTION

       This mixin class associates each token in a template with the line number on which it was found, and then inserts special comments in the
       generated Perl code that preserve that original source file and line number information.

       This should facilitate debugging, by making it easier to match up run- time errors with the template code that produced them.

       To turn this behavior on, just add "-LineNumbers" to your MicroMason creation call:

	 my $mason = Text::MicroMason->new( qw( -LineNumbers ) );

   Public Methods
       These methods are called from within the normal flow of MicroMason functionality, and you do not need to invoke them directly.

       read()
	   Clears the variables used to store the file name and first line of a template, so that they can be set by the methods below.

       read_file()
	   Saves the source file name before invoking the standard behavior for this method.

	     $mason->compile( file => $filename );

       read_handle()
	   Saves the caller's file name before invoking the standard behavior for this method.

	     $mason->compile( handle => $filename );

       read_text()
	   Saves the caller's file name before invoking the standard behavior for this method.

	     $mason->compile( text => $filename );

       read_inline()
	   This is similar to read_text, except it adjusts the line numbering to reflect a template that's embdded as a literal text in the Perl
	   code.

	     $mason->compile( inline => q{
		     My template text goes here.
	     } );

       lex()
	   Identical to the lex() method provided by the Base class, except that it also inserts a stream of line-number-setting comments into the
	   to-be- compiled Perl code that attempt to re-synchronize the

       assembler_rules()
	   Maps the "line_num" token to a perl line number comment.

   Private Methods
       _get_external_caller()
	   Returns the source file and line number of the first item in the function call stack that is not a Text::MicroMason package.

SEE ALSO

       For an overview of this templating framework, see Text::MicroMason.

       This is a mixin class intended for use with Text::MicroMason::Base.

       For distribution, installation, support, copyright and license information, see Text::MicroMason::Docs::ReadMe.

perl v5.10.1							    2009-11-11					      MicroMason::LineNumbers(3pm)