You are viewing a plain text version of this content. The canonical link for it is here.
Posted to general@logging.apache.org by ca...@apache.org on 2007/07/26 08:41:52 UTC
svn commit: r559716 [6/20] - in /logging/site/trunk/docs/log4net: ./ css/
images/ images/logos/ release/ release/howto/ release/manual/ src/
src/release/ src/release/howto/ src/release/manual/ src/stylesheets/
stylesheets/
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