Added: logging/site/trunk/docs/log4net/release/framework-support.html
URL:
http://svn.apache.org/viewvc/logging/site/trunk/docs/log4net/release/framework-support.html?view=auto&rev=559716
==============================================================================
--- logging/site/trunk/docs/log4net/release/framework-support.html (added)
+++ logging/site/trunk/docs/log4net/release/framework-support.html Wed Jul 25
23:41:40 2007
@@ -0,0 +1,755 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";>
+
+
+
+
+
+
+
+
+
+
+<html>
+ <head>
+ <title>Apache log4net -
+ Apache log4net: Supported Frameworks</title>
+ <style type="text/css" media="all">
+ @import url("../css/maven-base.css");
+ @import url("../css/maven-theme.css");
+ @import url("../css/site.css");
+ </style>
+ <link rel="stylesheet" href="../css/print.css" type="text/css"
media="print" />
+ <meta name="author" content="
+ Nicko Cadell" />
+ <meta http-equiv="Content-Type" content="text/html;
charset=ISO-8859-1" />
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="http://logging.apache.org/"; id="bannerLeft">
+
+ <img src="../images/ls-logo.jpg"
alt="" />
+
+ </a>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+
+
+
+
+
+
+ <div class="xleft">
+ Last Published: 07/26/2007
+ |
+ <a href="http://www.apache.org/";>Apache</a>
+ >
+
+ <a href="http://logging.apache.org/";>Logging Services</a>
+ >
+
+ <a href="../">log4net</a>
+ </div>
+ <div class="xright">
+
+
+
+
+
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+
+
+
+
+
+
+ <h5>Get log4net</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../download.html">Download</a>
+ </li>
+
+ <li class="none">
+ <a href="../changes-report.html">Changes</a>
+ </li>
+
+ <li class="none">
+ <a href="../license.html">License</a>
+ </li>
+ </ul>
+ <h5>About log4net</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../index.html">What is log4net?</a>
+ </li>
+
+ <li class="none">
+ <a href="../faq.html">FAQ</a>
+ </li>
+
+ <li class="none">
+ <a href="../roadmap.html">Roadmap</a>
+ </li>
+ </ul>
+ <h5>Community</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../mail-lists.html">Mailing Lists</a>
+ </li>
+
+ <li class="none">
+ <a href="../issue-tracking.html">Issue Tracking</a>
+ </li>
+ </ul>
+ <h5>Development</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../source-repository.html">Repository</a>
+ </li>
+
+ <li class="none">
+ <a href="../integration.html">Continuous Integration</a>
+ </li>
+ </ul>
+ <h5>Documentation</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../release/manual/introduction.html">Introduction</a>
+ </li>
+ </ul>
+ <h5>Apache</h5>
+ <ul>
+
+ <li class="none">
+ <a href="http://www.apache.org";>Home</a>
+ </li>
+
+ <li class="none">
+ <a
href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a>
+ </li>
+
+ <li class="none">
+ <a href="http://www.apache.org/foundation/thanks.html";>Thanks</a>
+ </li>
+
+ <li class="none">
+ <a href="http://www.apachecon.com";>Conferences</a>
+ </li>
+ </ul>
+ <a href="http://maven.apache.org/";
title="Built by Maven" id="poweredBy">
+ <img alt="Built by Maven"
src="../images/logos/maven-feather.png"></img>
+ </a>
+
+
+
+
+
+
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+
+
+
+
+ <meta name="keywords" content="log4net supported frameworks, mono, sscli,
.net, log4net"></meta>
+
+
+ <a name="log4net Supported Frameworks"></a><div
class="section"><h2>log4net Supported Frameworks</h2>
+
+ <sectionMenu name="Contents"></sectionMenu>
+
+ <a name="Summary of .NET frameworks supported by log4net"></a><div
class="section"><h2>Summary of .NET frameworks supported by log4net</h2>
+ <p>
+ log4net is built on a number of different frameworks. Each
new version of the frameworks add
+ new features. To take advantage of these new features we
must build log4net using the
+ appropriate framework. We also maintain builds compatible
with older versions of the frameworks.
+ </p>
+ <p>
+ It is important to remember that the .NET frameworks
support backward compatibility, that is
+ a new version of the framework will run binary assemblies
that were targeted to previous versions
+ of the framework.
+ </p>
+ <p>
+ While the number of different builds available may seem
confusing, you only need to select the
+ nearest build for your platform that is equal to or
earlier than your chosen deployment framework.
+ If you intend to deploy your application on the Microsoft
.NET Framework 1.0 don't pick the
+ log4net build that is built against the Microsoft .NET
Framework 1.1 because the .NET framework
+ does not guarantee forward compatibility only backward
compatibility.
+ </p>
+ <p>
+ The lowest common denominator build is the CLI 1.0
Compatible build. This build is compatible with
+ the ECMA/ISO CLI 1.0 standard APIs and will run on all
frameworks that support the standard. (Note
+ that the Microsoft .NET Compact Framework does not support
this standard). Use this build if you
+ intend to deploy you application on both the Microsoft
.NET Frameworks and the Mono frameworks.
+ </p>
+ <p>
+ log4net now builds on 6 frameworks:
+ </p>
+
+ <div class="table">
+ <table class="bodyTable">
+ <colgroup>
+ <col style="text-align: left; white-space:
nowrap"></col>
+ <col style="text-align: left;"></col>
+ </colgroup>
+ <tr class="a">
+ <th>Framework</th>
+ <th>Website</th>
+ </tr>
+ <tr class="b">
+ <td>Microsoft .NET Framework 1.0 (1.0.3705)</td>
+ <td><a
href="http://msdn.microsoft.com/net";>http://msdn.microsoft.com/net</a></td>
+ </tr>
+ <tr class="a">
+ <td>Microsoft .NET Framework 1.1 (1.1.4322)</td>
+ <td><a
href="http://msdn.microsoft.com/net";>http://msdn.microsoft.com/net</a></td>
+ </tr>
+ <tr class="b">
+ <td>Microsoft .NET Framework 2.0 (2.0.50727)</td>
+ <td><a
href="http://msdn.microsoft.com/net";>http://msdn.microsoft.com/net</a></td>
+ </tr>
+ <tr class="a">
+ <td>Microsoft .NET Compact Framework 1.0</td>
+ <td><a
href="http://msdn2.microsoft.com/en-us/netframework/aa497273.aspx";>http://msdn2.microsoft.com/en-us/netframework/aa497273.aspx</a></td>
+ </tr>
+
+ <tr class="b">
+ <td>Mono 1.2.3</td>
+ <td><a
href="http://www.mono-project.com";>http://www.mono-project.com</a></td>
+ </tr>
+ <tr class="a">
+ <td>Microsoft Shared Source CLI 1.0</td>
+ <td><a
href="http://msdn.microsoft.com/library/en-us/dndotnet/html/mssharsourcecli.asp";>http://msdn.microsoft.com/library/en-us/dndotnet/html/mssharsourcecli.asp</a></td>
+ </tr>
+ <tr class="b">
+ <td>CLI 1.0 Compatible</td>
+ <td><a
href="http://msdn.microsoft.com/net/ecma/";>http://msdn.microsoft.com/net/ecma/</a></td>
+ </tr>
+ </table>
+ </div>
+ <p>
+ For each of these frameworks a log4net assembly targeting
the framework is supplied. Although it's
+ perfectly possible to use the .NET Framework 1.0 version
of log4net on the .NET Framework 1.1, having
+ an assembly that really targets a specific framework
allows us to use features in that framework that
+ are not available in other frameworks or remove features
from log4net that are not supported in a
+ specific framework.
+ </p>
+ </div>
+
+ <a name="Appenders"></a><div class="section"><h2>Appenders</h2>
+ <p>
+ The appenders available to each framework depend on the
functionality of the
+ framework and the platform it runs on:
+ </p>
+ <div class="table">
+ <table class="bodyTable">
+ <colgroup>
+ <col style="text-align: left;"></col>
+ <col style="text-align: center;"></col>
+ <col style="text-align: center;"></col>
+ <col style="text-align: center;"></col>
+ <col style="text-align: center;"></col>
+ <col style="text-align: center;"></col>
+ <col style="text-align: center;"></col>
+ </colgroup>
+ <tr class="a">
+ <th>Appender</th>
+ <th>.NET Framework 1.0</th>
+ <th>.NET Framework 1.1</th>
+ <th>.NET Framework 2.0</th>
+ <th>.NET CF 1.0</th>
+ <th>Mono 1.2</th>
+ <th>Shared Source CLI 1.0</th>
+ <th>CLI 1.0 Compatible</th>
+ </tr>
+ <tr class="b">
+ <td>AdoNetAppender</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td></td>
+ <td>x</td>
+ </tr>
+ <tr class="a">
+ <td>AnsiColorTerminalAppender</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ </tr>
+ <tr class="b">
+ <td>AspNetTraceAppender</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td></td>
+ <td>x</td>
+ <td></td>
+ <td>x</td>
+ </tr>
+ <tr class="a">
+ <td>BufferingForwardingAppender</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ </tr>
+ <tr class="b">
+ <td>ColoredConsoleAppender</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td></td>
+ <td></td>
+ <td></td>
+ <td></td>
+ </tr>
+ <tr class="a">
+ <td>ConsoleAppender</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ </tr>
+ <tr class="b">
+ <td>DebugAppender</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ </tr>
+ <tr class="a">
+ <td>EventLogAppender</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td></td>
+ <td>x</td>
+ <td></td>
+ <td>x</td>
+ </tr>
+ <tr class="b">
+ <td>FileAppender</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ </tr>
+ <tr class="a">
+ <td>ForwardingAppender</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ </tr>
+ <tr class="b">
+ <td>LocalSyslogAppender</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td></td>
+ <td>x</td>
+ <td></td>
+ <td>x</td>
+ </tr>
+ <tr class="a">
+ <td>MemoryAppender</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ </tr>
+ <tr class="b">
+ <td>NetSendAppender</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td></td>
+ <td></td>
+ <td></td>
+ <td></td>
+ </tr>
+ <tr class="a">
+ <td>OutputDebugStringAppender</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td></td>
+ <td></td>
+ <td></td>
+ </tr>
+ <tr class="b">
+ <td>RemoteSyslogAppender</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ </tr>
+ <tr class="a">
+ <td>RemotingAppender</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td></td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ </tr>
+ <tr class="b">
+ <td>RollingFileAppender</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ </tr>
+ <tr class="a">
+ <td>SmtpAppender</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td></td>
+ <td>x</td>
+ <td></td>
+ <td>x</td>
+ </tr>
+ <tr class="b">
+ <td>SmtpPickupDirAppender</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ </tr>
+ <tr class="a">
+ <td>TelnetAppender</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ </tr>
+ <tr class="b">
+ <td>TraceAppender</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ </tr>
+ <tr class="a">
+ <td>UdpAppender</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ </tr>
+ </table>
+ </div>
+ </div>
+
+ <a name="Framework Specific Notes"></a><div
class="section"><h2>Framework Specific Notes</h2>
+ <a name="Microsoft .NET Framework 1.0 (1.0.3705)"></a><div
class="section"><h2>Microsoft .NET Framework 1.0 (1.0.3705)</h2>
+ <p>
+ none
+ </p>
+ </div>
+
+ <a name="Microsoft .NET Framework 1.1 (1.1.4322)"></a><div
class="section"><h2>Microsoft .NET Framework 1.1 (1.1.4322)</h2>
+ <p>
+ none
+ </p>
+ </div>
+
+ <a name="Microsoft .NET Framework 2.0 (2.0.50727)"></a><div
class="section"><h2>Microsoft .NET Framework 2.0 (2.0.50727)</h2>
+ <p>
+ none
+ </p>
+ </div>
+
+ <a name="Microsoft .NET Compact Framework 1.0"></a><div
class="section"><h2>Microsoft .NET Compact Framework 1.0</h2>
+ <ul>
+ <li>
+ <h4>Assembly attributes</h4>
+
+ The .NET Compact Framework 1.0 does not
support retrieving assembly level
+ attributes, therefore all log4net
configuration attributes were removed from
+ the .NET Compact Framework 1.0 version of
log4net.
+
+ <p>
+ For Smart-device applications, the log4net
system can be configured by passing
+ the location of the log4net configuration file
to the
+ <span
class="code">log4net.Config.XmlConfigurator.Configure(FileInfo)</span>
+ method in the entry point of the application.
+ </p>
+ <p>For example:</p>
+ <p></p>
+ <pre class="code">
+namespace TestApp
+{
+ using System.IO;
+
+ public class EntryPoint
+ {
+ /// <summary>
+ /// Application entry point.
+ /// </summary>
+ public static void Main()
+ {
+ // Uncomment the next line to enable log4net internal debugging
+ // log4net.Util.LogLog.InternalDebugging = true;
+
+ // This will instruct log4net to look for a configuration file
+ // called config.log4net in the root directory of the device
+ log4net.Config.XmlConfigurator.Configure(new
FileInfo(@"\config.log4net"));
+
+ ...
+
+ // This will shutdown the log4net system
+ log4net.LogManager.Shutdown();
+ }
+ }
+}
+ </pre>
+ </li>
+ <li>
+ <h4>Notification events</h4>
+
+ The .NET Compact Framework 1.0 does not
support notification events during the
+ application shutdown, therefore log4net cannot
automatically hook the
+ application shutdown notification.
+
+ <p>
+ Applications will need to programmatically
shutdown the log4net system during
+ the application's shutdown using the
+ <span
class="code">log4net.LogManager.Shutdown()</span>
+ method in order to prevent losing logging
events.
+ See the code above for an example.
+ </p>
+ </li>
+ <li>
+ <h4>FileSystemWatcher</h4>
+
+ The .NET Compact Framework 1.0 does not
support the
+ <span
class="code">System.IO.FileSystemWatcher</span>
+ class. As a result, the
+ <span
class="code">XmlConfiguratorAttribute.Watch</span>
+ property and the
+ <span
class="code">XmlConfigurator.ConfigureAndWatch</span>
+ methods are not available. Watching changes to
the log4net configuration
+ file is not supported on the .NET Compact
Framework 1.0.
+
+ </li>
+ <li>
+ <h4>UserName</h4>
+
+ The .NET Compact Framework 1.0 does not
support the
+ <span
class="code">System.Security.Principal.WindowsIdentity</span> class.
+ This is used to capture the current thread's
user identity. Therefore
+ the <span
class="code">LoggingEvent.UserName</span> property will return the value
+ <span class="code">"NOT
AVAILABLE"</span>.
+
+ </li>
+ <li>
+ <h4>Identity</h4>
+
+ The .NET Compact Framework 1.0 does not
support the
+ <span
class="code">System.Security.Principal.IPrincipal</span> interface.
+ This is used to capture the current thread's
user identity. Therefore
+ the <span
class="code">LoggingEvent.Identity</span> property will return the value
+ <span class="code">"NOT
AVAILABLE"</span>.
+
+ </li>
+ <li>
+ <h4>Environment variables</h4>
+
+ The .NET Compact Framework 1.0 does not
support retrieving environment
+ variables, therefore it's not possible to
substitute environment variables in
+ parameter values when using the .NET Compact
Framework 1.0 version of log4net.
+
+ </li>
+ <li>
+ <h4>Serialization</h4>
+
+ The .NET Compact Framework 1.0 does not
support serialization, therefore none of
+ the log4net classes in the .NET Compact
Framework 1.0 version are serializable.
+
+ </li>
+ <li>
+ <h4>LoggingEvent.Domain</h4>
+
+ The .NET Compact Framework 1.0 does not
support AppDomain functionality. The
+ friendly name for the current AppDomain is
stored in the <span class="code">LoggingEvent.Domain</span>
+ property and is accessed using the <span
class="code">%a</span> pattern of the
+ <span class="code">PatternLayout</span>. On
the .NET Compact Framework 1.0 this
+ value is generated by taking the file name for
the application's primary module.
+
+ </li>
+ </ul>
+ </div>
+
+ <a name="Mono"></a><div class="section"><h2>Mono</h2>
+ <p>
+ There are 2 separate builds of log4net for mono; Mono
1.0, built using the C# compiler in a mode
+ which is compatible with the CLI 1.0 language
specification, and; Mono 2.0, built using the .NET
+ 2.0 extensions to the C# language.
+ </p>
+
+ <a name="Mono 1.0"></a><div class="section"><h2>Mono
1.0</h2>
+ <p>
+ none
+ </p>
+ </div>
+ <a name="Mono 2.0"></a><div class="section"><h2>Mono
2.0</h2>
+ <p>
+ none
+ </p>
+ </div>
+
+ </div>
+
+ <a name="Microsoft Shared Source CLI 1.0"></a><div
class="section"><h2>Microsoft Shared Source CLI 1.0</h2>
+ <ul>
+ <li>
+ <h4>FileSystemWatcher</h4>
+
+ SSCLI 1.0 does not support the
+ <span
class="code">System.IO.FileSystemWatcher</span>
+ class. As a result, the
+ <span
class="code">XmlConfiguratorAttribute.Watch</span>
+ property and the
+ <span
class="code">XmlConfigurator.ConfigureAndWatch</span>
+ methods are not available. Watching changes to
the log4net configuration
+ file is not supported on SSCLI 1.0.
+
+ </li>
+ <li>
+ <h4>UserName</h4>
+
+ SSCLI 1.0 does not support the
+ <span
class="code">System.Security.Principal.WindowsIdentity</span> class.
+ This is used to capture the current thread's
user identity. Therefore
+ the <span
class="code">LoggingEvent.UserName</span> property will return the value
+ <span class="code">"NOT
AVAILABLE"</span>.
+
+ </li>
+ <li>
+ <h4>Identity</h4>
+
+ SSCLI 1.0 does not support the
+ <span
class="code">System.Security.Principal.IPrincipal</span> interface.
+ This is used to capture the current thread's
user identity. Therefore
+ the <span
class="code">LoggingEvent.Identity</span> property will return the value
+ <span class="code">"NOT
AVAILABLE"</span>.
+
+ </li>
+ </ul>
+ </div>
+
+ <a name="CLI 1.0 Compatible"></a><div class="section"><h2>CLI
1.0 Compatible</h2>
+ <p>
+ This build of log4net is designed to run on any ECMA
CLI 1.0 compatible runtime.
+ The assembly does not support any platform specific
features. The build includes
+ the common subset of functionality found in the .NET
1.0 and Mono 1.0 builds.
+ The output assembly is built using the Microsoft .NET
1.0 compiler and library.
+ </p>
+ <p>
+ The log4net CLI 1.0 assembly is runtime compatible
with the following frameworks:
+ </p>
+ <ul>
+ <li>Microsoft .NET Framework 1.0 (and higher)</li>
+ <li>Mono 1.0 (and higher)</li>
+ </ul>
+
+ Only a Release build is generated for this
configuration because the assembly
+ debugging information has not been standardized.
+
+ </div>
+
+ </div>
+
+ </div>
+
+
+
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">©
+ 2007
+
+ Apache Software Foundation
+
+
+
+
+
+
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
Propchange: logging/site/trunk/docs/log4net/release/framework-support.html
------------------------------------------------------------------------------
svn:mime-type = text/html
Added: logging/site/trunk/docs/log4net/release/howto/chainsaw.html
URL:
http://svn.apache.org/viewvc/logging/site/trunk/docs/log4net/release/howto/chainsaw.html?view=auto&rev=559716
==============================================================================
--- logging/site/trunk/docs/log4net/release/howto/chainsaw.html (added)
+++ logging/site/trunk/docs/log4net/release/howto/chainsaw.html Wed Jul 25
23:41:40 2007
@@ -0,0 +1,285 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";>
+
+
+
+
+
+
+
+
+
+
+<html>
+ <head>
+ <title>Apache log4net -
+ Apache log4net: How To view logging events using Apache log4j
Chainsaw</title>
+ <style type="text/css" media="all">
+ @import url("../../css/maven-base.css");
+ @import url("../../css/maven-theme.css");
+ @import url("../../css/site.css");
+ </style>
+ <link rel="stylesheet" href="../../css/print.css" type="text/css"
media="print" />
+ <meta name="author" content="
+ Ron Grabowski" />
+ <meta name="author" content="
+ Nicko Cadell" />
+ <meta http-equiv="Content-Type" content="text/html;
charset=ISO-8859-1" />
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="http://logging.apache.org/"; id="bannerLeft">
+
+ <img
src="../../images/ls-logo.jpg" alt="" />
+
+ </a>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+
+
+
+
+
+
+ <div class="xleft">
+ Last Published: 07/26/2007
+ |
+ <a href="http://www.apache.org/";>Apache</a>
+ >
+
+ <a href="http://logging.apache.org/";>Logging Services</a>
+ >
+
+ <a href="../../">log4net</a>
+ </div>
+ <div class="xright">
+
+
+
+
+
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+
+
+
+
+
+
+ <h5>Get log4net</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../../download.html">Download</a>
+ </li>
+
+ <li class="none">
+ <a href="../../changes-report.html">Changes</a>
+ </li>
+
+ <li class="none">
+ <a href="../../license.html">License</a>
+ </li>
+ </ul>
+ <h5>About log4net</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../../index.html">What is log4net?</a>
+ </li>
+
+ <li class="none">
+ <a href="../../faq.html">FAQ</a>
+ </li>
+
+ <li class="none">
+ <a href="../../roadmap.html">Roadmap</a>
+ </li>
+ </ul>
+ <h5>Community</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../../mail-lists.html">Mailing Lists</a>
+ </li>
+
+ <li class="none">
+ <a href="../../issue-tracking.html">Issue Tracking</a>
+ </li>
+ </ul>
+ <h5>Development</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../../source-repository.html">Repository</a>
+ </li>
+
+ <li class="none">
+ <a href="../../integration.html">Continuous Integration</a>
+ </li>
+ </ul>
+ <h5>Documentation</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../../release/manual/introduction.html">Introduction</a>
+ </li>
+ </ul>
+ <h5>Apache</h5>
+ <ul>
+
+ <li class="none">
+ <a href="http://www.apache.org";>Home</a>
+ </li>
+
+ <li class="none">
+ <a
href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a>
+ </li>
+
+ <li class="none">
+ <a href="http://www.apache.org/foundation/thanks.html";>Thanks</a>
+ </li>
+
+ <li class="none">
+ <a href="http://www.apachecon.com";>Conferences</a>
+ </li>
+ </ul>
+ <a href="http://maven.apache.org/";
title="Built by Maven" id="poweredBy">
+ <img alt="Built by Maven"
src="../../images/logos/maven-feather.png"></img>
+ </a>
+
+
+
+
+
+
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+
+
+
+
+ <meta name="keywords" content="chainsaw log4net, log4net"></meta>
+
+
+ <a name="How To view logging events using Apache log4j
Chainsaw"></a><div class="section"><h2>How To view logging events using Apache
log4j Chainsaw</h2>
+ <sectionMenu name="Contents"></sectionMenu>
+
+ <p>
+ Apache log4j includes <a
href="http://logging.apache.org/log4j/docs/chainsaw.html";>Chainsaw</a>
+ a graphical log viewer.
+ </p>
+ <p>
+ Chainsaw can either receive and display log events in realtime
over
+ the network, or it can load a previously created log file.
+ </p>
+
+ <p>
+ Before Chainsaw can display data, one or more receivers must
be setup.
+ This is usually done by specifying an xml config file when the
program
+ first starts up. <br></br>
+ Save one or more of the sample xml config files to your local
system and
+ load them when Chainsaw starts.
+ </p>
+
+ <a name="Logging via UDP"></a><div class="section"><h2>Logging via
UDP</h2>
+ <p>
+ log4net can be configured to log messages via UDP in such
a way that Chainsaw
+ can receive and display them.
+ </p>
+
+ <a name="log4net UDP Configuration"></a><div
class="section"><h2>log4net UDP Configuration</h2>
+ <p>
+ Configure log4net to use a UdpAppender with the
following config snippet:
+ </p>
+
+ <div class="source"><pre>
+<appender name="UdpAppender"
type="log4net.Appender.UdpAppender">
+ <remoteAddress value="127.0.0.1" />
+ <remotePort value="8080" />
+ <layout type="log4net.Layout.XmlLayoutSchemaLog4j">
+ <locationInfo value="true" />
+ </layout>
+</appender></pre></div>
+ </div>
+
+ <a name="Chainsaw UDP receiver Configuration"></a><div
class="section"><h2>Chainsaw UDP receiver Configuration</h2>
+ <p>
+ Chainsaw should be configured to start a
<c>UDPReceiver</c> using the
+ following configuration document:
+ </p>
+
+ <div class="source"><pre>
+<?xml version="1.0" encoding="UTF-8" ?>
+<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
+<log4j:configuration
xmlns:log4j="http://jakarta.apache.org/log4j/"
debug="true">
+ <plugin name="UDPReceiver"
class="org.apache.log4j.net.UDPReceiver">
+ <param name="Port" value="8080" />
+ </plugin>
+</log4j:configuration></pre></div>
+ </div>
+
+ </div>
+
+ <a name="Logging to XML file"></a><div class="section"><h2>Logging
to XML file</h2>
+ <p>
+ Chainsaw can also load an XML log file if it is formatted
according
+ to the log4j schema. Use the following log4net config to
output
+ to file using the log4j schema:
+ </p>
+
+ <div class="source"><pre>
+<appender name="FileAppender"
type="log4net.Appender.FileAppender">
+ <file value="log-file.txt" />
+ <appendToFile value="true" />
+ <layout type="log4net.Layout.XmlLayoutSchemaLog4j">
+ <locationInfo value="true" />
+ </layout>
+</appender></pre></div>
+
+ <p>
+ To load the file into Chainsaw drag the file into the
Chainsaw
+ app and drop it on the tab labeled <i>Drag & Drop log
files here</i>.
+ </p>
+ </div>
+
+ </div>
+
+
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">©
+ 2007
+
+ Apache Software Foundation
+
+
+
+
+
+
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
Propchange: logging/site/trunk/docs/log4net/release/howto/chainsaw.html
------------------------------------------------------------------------------
svn:mime-type = text/html
Added: logging/site/trunk/docs/log4net/release/howto/index.html
URL:
http://svn.apache.org/viewvc/logging/site/trunk/docs/log4net/release/howto/index.html?view=auto&rev=559716
==============================================================================
--- logging/site/trunk/docs/log4net/release/howto/index.html (added)
+++ logging/site/trunk/docs/log4net/release/howto/index.html Wed Jul 25
23:41:40 2007
@@ -0,0 +1,221 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";>
+
+
+
+
+
+
+
+
+
+
+<html>
+ <head>
+ <title>Apache log4net -
+ Apache log4net: How Tos</title>
+ <style type="text/css" media="all">
+ @import url("../../css/maven-base.css");
+ @import url("../../css/maven-theme.css");
+ @import url("../../css/site.css");
+ </style>
+ <link rel="stylesheet" href="../../css/print.css" type="text/css"
media="print" />
+ <meta name="author" content="
+ Nicko Cadell" />
+ <meta http-equiv="Content-Type" content="text/html;
charset=ISO-8859-1" />
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="http://logging.apache.org/"; id="bannerLeft">
+
+ <img
src="../../images/ls-logo.jpg" alt="" />
+
+ </a>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+
+
+
+
+
+
+ <div class="xleft">
+ Last Published: 07/26/2007
+ |
+ <a href="http://www.apache.org/";>Apache</a>
+ >
+
+ <a href="http://logging.apache.org/";>Logging Services</a>
+ >
+
+ <a href="../../">log4net</a>
+ </div>
+ <div class="xright">
+
+
+
+
+
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+
+
+
+
+
+
+ <h5>Get log4net</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../../download.html">Download</a>
+ </li>
+
+ <li class="none">
+ <a href="../../changes-report.html">Changes</a>
+ </li>
+
+ <li class="none">
+ <a href="../../license.html">License</a>
+ </li>
+ </ul>
+ <h5>About log4net</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../../index.html">What is log4net?</a>
+ </li>
+
+ <li class="none">
+ <a href="../../faq.html">FAQ</a>
+ </li>
+
+ <li class="none">
+ <a href="../../roadmap.html">Roadmap</a>
+ </li>
+ </ul>
+ <h5>Community</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../../mail-lists.html">Mailing Lists</a>
+ </li>
+
+ <li class="none">
+ <a href="../../issue-tracking.html">Issue Tracking</a>
+ </li>
+ </ul>
+ <h5>Development</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../../source-repository.html">Repository</a>
+ </li>
+
+ <li class="none">
+ <a href="../../integration.html">Continuous Integration</a>
+ </li>
+ </ul>
+ <h5>Documentation</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../../release/manual/introduction.html">Introduction</a>
+ </li>
+ </ul>
+ <h5>Apache</h5>
+ <ul>
+
+ <li class="none">
+ <a href="http://www.apache.org";>Home</a>
+ </li>
+
+ <li class="none">
+ <a
href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a>
+ </li>
+
+ <li class="none">
+ <a href="http://www.apache.org/foundation/thanks.html";>Thanks</a>
+ </li>
+
+ <li class="none">
+ <a href="http://www.apachecon.com";>Conferences</a>
+ </li>
+ </ul>
+ <a href="http://maven.apache.org/";
title="Built by Maven" id="poweredBy">
+ <img alt="Built by Maven"
src="../../images/logos/maven-feather.png"></img>
+ </a>
+
+
+
+
+
+
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+
+
+
+
+ <meta name="keywords" content="howto log4net, log4net"></meta>
+
+
+ <a name="log4net How Tos"></a><div class="section"><h2>log4net How
Tos</h2>
+
+ <p>
+ Below are presented, in no particular order, a series of
documents
+ on how to get stuff done.
+ </p>
+ <p>
+ New documents can be contributed via the issue tracking system.
+ See the <a href="../../contributing.html">Contributing</a>
page for
+ details.
+ </p>
+
+ <ul>
+ <li>
+ <a href="chainsaw.html">How To view logging events using
Apache log4j Chainsaw</a>
+ </li>
+
+ </ul>
+
+ </div>
+
+
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">©
+ 2007
+
+ Apache Software Foundation
+
+
+
+
+
+
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
Propchange: logging/site/trunk/docs/log4net/release/howto/index.html
------------------------------------------------------------------------------
svn:mime-type = text/html
