You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@logging.apache.org by bo...@apache.org on 2013/11/10 09:25:14 UTC
svn commit: r886052 [8/28] - in
/websites/production/logging/content/log4net/log4net-1.2.13: ./ css/
images/ images/logos/ release/ release/howto/ release/manual/ release/sdk/
release/sdk/ndoc_msdn_temp/ release/sdk/ndoc_resources/
Added: websites/production/logging/content/log4net/log4net-1.2.13/release/features.html
==============================================================================
--- websites/production/logging/content/log4net/log4net-1.2.13/release/features.html (added)
+++ websites/production/logging/content/log4net/log4net-1.2.13/release/features.html Sun Nov 10 08:24:41 2013
@@ -0,0 +1,490 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!-- Generated by Apache Maven Doxia at Nov 10, 2013 -->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+ <title>
+ Apache log4net: Features</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 name="Date-Revision-yyyymmdd" content="20131110" />
+ <meta http-equiv="Content-Language" content="en" />
+ <meta name="keywords" content="log4net features, log4net" />
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="../../" id="bannerLeft">
+ <img src="../images/ls-logo.jpg" alt="Apache Logging Services Project" />
+ </a>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+
+ <div class="xleft">
+ <span id="publishDate">Last Published: 2013-11-10</span>
+ | <span id="projectVersion">Version: 1.2.13</span>
+ | <a href="http://www.apache.org/" class="externalLink" title="Apache">Apache</a>
+ >
+ <a href="../../" title="Logging Services">Logging Services</a>
+ >
+ <a href=".././" title="log4net">log4net</a>
+ >
+
+ Apache log4net: Features
+ </div>
+ <div class="xright">
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+
+ <h5>Apache log4net</h5>
+ <ul>
+ <li class="none">
+ <a href="../index.html" title="About">About</a>
+ </li>
+ <li class="none">
+ <a href="../download_log4net.cgi" title="Download">Download</a>
+ </li>
+ <li class="none">
+ <a href="../release/release-notes.html" title="Release Notes">Release Notes</a>
+ </li>
+ <li class="none">
+ <a href="../license.html" title="License">License</a>
+ </li>
+ </ul>
+ <h5>Documentation</h5>
+ <ul>
+ <li class="none">
+ <strong>Features</strong>
+ </li>
+ <li class="none">
+ <a href="../release/framework-support.html" title="Supported Frameworks">Supported Frameworks</a>
+ </li>
+ <li class="none">
+ <a href="../release/example-apps.html" title="Example Apps">Example Apps</a>
+ </li>
+ <li class="none">
+ <a href="../release/config-examples.html" title="Config Examples">Config Examples</a>
+ </li>
+ <li class="none">
+ <a href="../release/building.html" title="Building">Building</a>
+ </li>
+ <li class="none">
+ <a href="../release/faq.html" title="FAQ">FAQ</a>
+ </li>
+ <li class="none">
+ <a href="../release/howto/index.html" title="How Tos">How Tos</a>
+ </li>
+ <li class="none">
+ <a href="../release/sdk/index.html" title="SDK Reference">SDK Reference</a>
+ </li>
+ </ul>
+ <h5>Manual</h5>
+ <ul>
+ <li class="none">
+ <a href="../release/manual/introduction.html" title="Introduction">Introduction</a>
+ </li>
+ <li class="none">
+ <a href="../release/manual/configuration.html" title="Configuration">Configuration</a>
+ </li>
+ <li class="none">
+ <a href="../release/manual/contexts.html" title="Contexts">Contexts</a>
+ </li>
+ <li class="none">
+ <a href="../release/manual/plugins.html" title="Plugins">Plugins</a>
+ </li>
+ <li class="none">
+ <a href="../release/manual/repositories.html" title="Repositories">Repositories</a>
+ </li>
+ <li class="none">
+ <a href="../release/manual/internals.html" title="Internals">Internals</a>
+ </li>
+ </ul>
+ <h5>Community</h5>
+ <ul>
+ <li class="none">
+ <a href="../mail-lists.html" title="Mailing Lists">Mailing Lists</a>
+ </li>
+ <li class="none">
+ <a href="../issue-tracking.html" title="Issue Tracking">Issue Tracking</a>
+ </li>
+ </ul>
+ <h5>Development</h5>
+ <ul>
+ <li class="none">
+ <a href="../source-repository.html" title="Repository">Repository</a>
+ </li>
+ <li class="none">
+ <a href="../integration.html" title="Continuous Integration">Continuous Integration</a>
+ </li>
+ </ul>
+ <h5>Project Documentation</h5>
+ <ul>
+ <li class="collapsed">
+ <a href="../project-info.html" title="Project Information">Project Information</a>
+ </li>
+ <li class="collapsed">
+ <a href="../project-reports.html" title="Project Reports">Project Reports</a>
+ </li>
+ </ul>
+ <h5>Apache</h5>
+ <ul>
+ <li class="none">
+ <a href="http://www.apache.org/" class="externalLink" title="Home">Home</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/licenses/" class="externalLink" title="License">License</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsorship">Sponsorship</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks">Thanks</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/security/" class="externalLink" title="Security">Security</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apachecon.com" class="externalLink" title="Conferences">Conferences</a>
+ </li>
+ </ul>
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img class="poweredBy" alt="Built by Maven" src="../images/logos/maven-feather.png" />
+ </a>
+
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+ <!-- Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements. See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to you under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License. You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License. -->
+
+
+ <a name="main"></a><div class="section"><h2 id="main">Apache log4net™ Features</h2>
+
+ <a name="overview"></a><div class="section"><h2 id="overview">Overview</h2>
+ <p>
+ log4net is a tool to help the programmer output log statements to a
+ variety of output targets. In case of problems with an application,
+ it is helpful to enable logging so that the problem can be located.
+ With log4net it is possible to enable logging at runtime without
+ modifying the application binary. The log4net package is designed so
+ that log statements can remain in shipped code without incurring a
+ high performance cost. It follows that the speed of logging (or
+ rather not logging) is crucial.
+ </p>
+ <p>
+ At the same time, log output can be so voluminous that it quickly becomes
+ overwhelming. One of the distinctive features of log4net is the notion of
+ hierarchical loggers. Using these loggers it is possible to selectively
+ control which log statements are output at arbitrary granularity.
+ </p>
+ <p>
+ log4net is designed with two distinct goals in mind: speed and flexibility
+ </p>
+ </div>
+
+ <a name="features"></a><div class="section"><h2 id="features">Features</h2>
+ <ul>
+ <li>Support for multiple frameworks</li>
+ <li>Output to multiple logging targets</li>
+ <li>Hierarchical logging architecture</li>
+ <li>XML Configuration</li>
+ <li>Dynamic Configuration</li>
+ <li>Logging Context</li>
+ <li>Proven architecture</li>
+ <li>Modular and extensible design</li>
+ <li>High performance with flexibility</li>
+ </ul>
+ </div>
+
+ <a name="frameworks"></a><div class="section"><h2 id="frameworks">Support for multiple frameworks</h2>
+ <p>
+ log4net runs on all ECMA CLI 1.0 compatible runtimes.
+ log4net has specific builds for the following frameworks:
+ </p>
+ <ul>
+ <li>Microsoft® .NET Framework 1.0</li>
+ <li>Microsoft .NET Framework 1.1</li>
+ <li>Microsoft .NET Framework 2.0</li>
+ <li>Microsoft .NET Framework 3.5</li>
+ <li>Microsoft .NET Framework 4.0</li>
+ <li>Microsoft .NET Framework 3.5 Client Profile</li>
+ <li>Microsoft .NET Framework 4.0 Client Profile</li>
+ <li>Microsoft .NET Compact Framework 1.0<a href="#no-bin-support"><sup>*</sup></a></li>
+ <li>Microsoft .NET Compact Framework 2.0<a href="#no-bin-support"><sup>*</sup></a></li>
+ <li>Mono 1.0</li>
+ <li>Mono 2.0</li>
+ <li>Microsoft Shared Source CLI 1.0<a href="#no-bin-support"><sup>*</sup></a></li>
+ <li>CLI 1.0 Compatible</li>
+ </ul>
+ <p>The "Client Profile" builds are stripped down
+ versions of the "normal" builds that don't contain any
+ ASP.NET releated code - which for example means the
+ <tt>%aspnet-*</tt> patterns and the
+ <tt>AspNetTraceAppender</tt> are not available.</p>
+
+ <p style="font-size:smaller">
+ <a name="no-bin-support"><sup>*</sup></a>Not
+ supported by the binary release but can be built
+ from the source release.
+ </p>
+ </div>
+
+ <a name="appenders"></a><div class="section"><h2 id="appenders">Output to multiple logging targets</h2>
+ <p>
+ log4net ships with the following appenders (not on all frameworks):
+ </p>
+ <div class="table">
+ <table border="0" class="bodyTable" cellspacing="0">
+ <tr class="a">
+ <th>
+ Type</th>
+ <th>
+ Description</th>
+ </tr>
+ <tr class="b">
+ <td>log4net.Appender.AdoNetAppender</td>
+ <td>
+ Writes logging events to a database using either prepared statements or stored
+ procedures.
+ </td>
+ </tr>
+ <tr class="a">
+ <td>log4net.Appender.AnsiColorTerminalAppender</td>
+ <td>
+ Writes color highlighted logging events to a an ANSI terminal window.
+ </td>
+ </tr>
+ <tr class="b">
+ <td>log4net.Appender.AspNetTraceAppender</td>
+ <td>
+ Writes logging events to the ASP trace context. These can then be rendered at
+ the end of the ASP page or on the ASP trace page.
+ </td>
+ </tr>
+ <tr class="a">
+ <td>log4net.Appender.ColoredConsoleAppender</td>
+ <td>
+ Writes color highlighted logging events to the application's Windows Console.
+ </td>
+ </tr>
+ <tr class="b">
+ <td>log4net.Appender.ConsoleAppender</td>
+ <td>
+ Writes logging events to the application's Console. The events may go to either
+ the standard our stream or the standard error stream.
+ </td>
+ </tr>
+ <tr class="a">
+ <td>log4net.Appender.DebugAppender</td>
+ <td>
+ Writes logging events to the .NET system.
+ </td>
+ </tr>
+ <tr class="b">
+ <td>log4net.Appender.EventLogAppender</td>
+ <td>
+ Writes logging events to the Windows Event Log.
+ </td>
+ </tr>
+ <tr class="a">
+ <td>log4net.Appender.FileAppender</td>
+ <td>
+ Writes logging events to a file in the file system.
+ </td>
+ </tr>
+ <tr class="b">
+ <td>log4net.Appender.LocalSyslogAppender</td>
+ <td>
+ Writes logging events to the local syslog service (UNIX only).
+ </td>
+ </tr>
+ <tr class="a">
+ <td>log4net.Appender.MemoryAppender</td>
+ <td>
+ Stores logging events in an in memory buffer.
+ </td>
+ </tr>
+ <tr class="b">
+ <td>log4net.Appender.NetSendAppender</td>
+ <td>
+ Writes logging events to the Windows Messenger service. These messages are
+ displayed in a dialog on a users terminal.
+ </td>
+ </tr>
+ <tr class="a">
+ <td>log4net.Appender.OutputDebugStringAppender</td>
+ <td>
+ Writes logging events to the debugger. If the application has no
+ debugger, the system debugger displays the string. If the application has no
+ debugger and the system debugger is not active, the message is ignored.
+ </td>
+ </tr>
+ <tr class="b">
+ <td>log4net.Appender.RemoteSyslogAppender</td>
+ <td>
+ Writes logging events to a remote syslog service using UDP networking.
+ </td>
+ </tr>
+ <tr class="a">
+ <td>log4net.Appender.RemotingAppender</td>
+ <td>
+ Writes logging events to a remoting sink using .NET remoting.
+ </td>
+ </tr>
+ <tr class="b">
+ <td>log4net.Appender.RollingFileAppender</td>
+ <td>
+ Writes logging events to a file in the file system. The RollingFileAppender can
+ be configured to log to multiple files based upon date or file size
+ constraints.
+ </td>
+ </tr>
+ <tr class="a">
+ <td>log4net.Appender.SmtpAppender</td>
+ <td>
+ Sends logging events to an email address.
+ </td>
+ </tr>
+ <tr class="b">
+ <td>log4net.Appender.SmtpPickupDirAppender</td>
+ <td>
+ Sends logging events to an email
+ address but writes the emails to a
+ configurable directory rather than
+ sending them directly via SMTP.
+ </td>
+ </tr>
+ <tr class="a">
+ <td>log4net.Appender.TelnetAppender</td>
+ <td>
+ Clients connect via Telnet to receive logging events.
+ </td>
+ </tr>
+ <tr class="b">
+ <td>log4net.Appender.TraceAppender</td>
+ <td>
+ Writes logging events to the .NET trace system.
+ </td>
+ </tr>
+ <tr class="a">
+ <td>log4net.Appender.UdpAppender</td>
+ <td>
+ Sends logging events as connectionless UDP datagrams to a remote host or a
+ multicast group using a UdpClient.
+ </td>
+ </tr>
+ </table>
+ </div>
+ <p>A special log4net.Appender.ForwardingAppender can
+ be used to wrap another appender, for example to
+ attach additional filters.</p>
+ </div>
+
+ <a name="hierarchy"></a><div class="section"><h2 id="hierarchy">Hierarchical logging architecture</h2>
+ <p>
+ Hierarchical logging is an ideal fit with component based development.
+ Each component has its own of logger. When individually tested, the
+ properties of these loggers may be set as the developer requires.
+ When combined with other components, the loggers inherit the properties
+ determined by the integrator of the components. One can selectively elevate
+ logging priorities on one component without affecting the other components.
+ This is useful when you need a detailed trace from just a single component
+ without crowding the trace file with messages from other components. All
+ this can be done through configuration files; no code changes are required.
+ </p>
+ </div>
+
+ <a name="xml-config"></a><div class="section"><h2 id="xml-config">XML Configuration</h2>
+ <p>
+ log4net is configured using an XML configuration file. The configuration
+ information can be embedded within other XML configuration files
+ (such as the application's .config file) or in a separate file. The
+ configuration is easily readable and updateable while retaining the
+ flexibility to express all configurations.
+ </p>
+ <p>
+ Alternatively log4net can be configured programmatically.
+ </p>
+ </div>
+
+ <a name="dynamic-config"></a><div class="section"><h2 id="dynamic-config">Dynamic Configuration</h2>
+ <p>
+ log4net can monitor its configuration file for changes and dynamically
+ apply changes made by the configurator. The logging levels, appenders,
+ layouts, and just about everything else can be adjusted at runtime.
+ In many cases it is possible to diagnose application issues without
+ terminating the process in question. This can a very valuable tool in
+ investigating issues with deployed applications.
+ </p>
+ </div>
+
+ <a name="context"></a><div class="section"><h2 id="context">Logging Context</h2>
+ <p>
+ log4net can be used to collect logging context data in a way that is transparent
+ to the developer at the point of logging. The GlobalContext and the
+ ThreadContext allow the application to store contextual data that is
+ attached to logging messages. For instance, in a web service,
+ once the caller is authenticated the username of the caller could be
+ stored in a ThreadContext property. This property would then be automatically
+ logged as part of each subsequent logging message made from the same thread.
+ </p>
+ </div>
+
+ <a name="history"></a><div class="section"><h2 id="history">Proven architecture</h2>
+ <p>
+ log4net is based on the highly successful Apache log4j™ logging library,
+ in development since 1996. This popular and proven architecture has
+ so far been ported to 12 languages.
+ </p>
+ </div>
+
+ </div>
+
+
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">
+ <div class="xright">Copyright © 2004-2013
+ <a href="http://www.apache.org">Apache Software Foundation</a>.
+
+
+ Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache Software License, Version 2.0</a>.</div><br />
+ <div class="xright">Apache log4net, Apache, log4net, the Apache feather logo, the Apache Logging Services project logo and the Built by Maven logo are trademarks of The Apache Software Foundation.</div>
+ <div class="clear">
+ </div>
+ </div>
+ </body>
+</html>
Propchange: websites/production/logging/content/log4net/log4net-1.2.13/release/features.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: websites/production/logging/content/log4net/log4net-1.2.13/release/framework-support.html
==============================================================================
--- websites/production/logging/content/log4net/log4net-1.2.13/release/framework-support.html (added)
+++ websites/production/logging/content/log4net/log4net-1.2.13/release/framework-support.html Sun Nov 10 08:24:41 2013
@@ -0,0 +1,927 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!-- Generated by Apache Maven Doxia at Nov 10, 2013 -->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+ <title>
+ 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 name="Date-Revision-yyyymmdd" content="20131110" />
+ <meta http-equiv="Content-Language" content="en" />
+ <meta name="keywords" content="log4net supported frameworks, mono, sscli, .net, log4net" />
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="../../" id="bannerLeft">
+ <img src="../images/ls-logo.jpg" alt="Apache Logging Services Project" />
+ </a>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+
+ <div class="xleft">
+ <span id="publishDate">Last Published: 2013-11-10</span>
+ | <span id="projectVersion">Version: 1.2.13</span>
+ | <a href="http://www.apache.org/" class="externalLink" title="Apache">Apache</a>
+ >
+ <a href="../../" title="Logging Services">Logging Services</a>
+ >
+ <a href=".././" title="log4net">log4net</a>
+ >
+
+ Apache log4net: Supported Frameworks
+ </div>
+ <div class="xright">
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+
+ <h5>Apache log4net</h5>
+ <ul>
+ <li class="none">
+ <a href="../index.html" title="About">About</a>
+ </li>
+ <li class="none">
+ <a href="../download_log4net.cgi" title="Download">Download</a>
+ </li>
+ <li class="none">
+ <a href="../release/release-notes.html" title="Release Notes">Release Notes</a>
+ </li>
+ <li class="none">
+ <a href="../license.html" title="License">License</a>
+ </li>
+ </ul>
+ <h5>Documentation</h5>
+ <ul>
+ <li class="none">
+ <a href="../release/features.html" title="Features">Features</a>
+ </li>
+ <li class="none">
+ <strong>Supported Frameworks</strong>
+ </li>
+ <li class="none">
+ <a href="../release/example-apps.html" title="Example Apps">Example Apps</a>
+ </li>
+ <li class="none">
+ <a href="../release/config-examples.html" title="Config Examples">Config Examples</a>
+ </li>
+ <li class="none">
+ <a href="../release/building.html" title="Building">Building</a>
+ </li>
+ <li class="none">
+ <a href="../release/faq.html" title="FAQ">FAQ</a>
+ </li>
+ <li class="none">
+ <a href="../release/howto/index.html" title="How Tos">How Tos</a>
+ </li>
+ <li class="none">
+ <a href="../release/sdk/index.html" title="SDK Reference">SDK Reference</a>
+ </li>
+ </ul>
+ <h5>Manual</h5>
+ <ul>
+ <li class="none">
+ <a href="../release/manual/introduction.html" title="Introduction">Introduction</a>
+ </li>
+ <li class="none">
+ <a href="../release/manual/configuration.html" title="Configuration">Configuration</a>
+ </li>
+ <li class="none">
+ <a href="../release/manual/contexts.html" title="Contexts">Contexts</a>
+ </li>
+ <li class="none">
+ <a href="../release/manual/plugins.html" title="Plugins">Plugins</a>
+ </li>
+ <li class="none">
+ <a href="../release/manual/repositories.html" title="Repositories">Repositories</a>
+ </li>
+ <li class="none">
+ <a href="../release/manual/internals.html" title="Internals">Internals</a>
+ </li>
+ </ul>
+ <h5>Community</h5>
+ <ul>
+ <li class="none">
+ <a href="../mail-lists.html" title="Mailing Lists">Mailing Lists</a>
+ </li>
+ <li class="none">
+ <a href="../issue-tracking.html" title="Issue Tracking">Issue Tracking</a>
+ </li>
+ </ul>
+ <h5>Development</h5>
+ <ul>
+ <li class="none">
+ <a href="../source-repository.html" title="Repository">Repository</a>
+ </li>
+ <li class="none">
+ <a href="../integration.html" title="Continuous Integration">Continuous Integration</a>
+ </li>
+ </ul>
+ <h5>Project Documentation</h5>
+ <ul>
+ <li class="collapsed">
+ <a href="../project-info.html" title="Project Information">Project Information</a>
+ </li>
+ <li class="collapsed">
+ <a href="../project-reports.html" title="Project Reports">Project Reports</a>
+ </li>
+ </ul>
+ <h5>Apache</h5>
+ <ul>
+ <li class="none">
+ <a href="http://www.apache.org/" class="externalLink" title="Home">Home</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/licenses/" class="externalLink" title="License">License</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsorship">Sponsorship</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks">Thanks</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/security/" class="externalLink" title="Security">Security</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apachecon.com" class="externalLink" title="Conferences">Conferences</a>
+ </li>
+ </ul>
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img class="poweredBy" alt="Built by Maven" src="../images/logos/maven-feather.png" />
+ </a>
+
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+ <!-- Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements. See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to you under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License. You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License. -->
+
+
+ <a name="main"></a><div class="section"><h2 id="main">Apache log4net™ Supported Frameworks</h2>
+
+ <a name="summary"></a><div class="section"><h2 id="summary">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 the following frameworks:
+ </p>
+
+ <div class="table">
+ <table border="0" class="bodyTable">
+ <colgroup>
+ <col style="text-align: left; white-space: nowrap" />
+ <col style="text-align: left;" />
+ </colgroup>
+ <tr class="a">
+ <th>Framework</th>
+ <th>Website</th>
+ </tr>
+ <tr class="b" style="vertical-align: top;">
+ <td>Microsoft .NET Framework 1.0</td>
+ <td><a class="externalLink" href="http://msdn.microsoft.com/en-us/netframework/">http://msdn.microsoft.com/en-us/netframework/</a></td>
+ </tr>
+ <tr class="a" style="vertical-align: top;">
+ <td>Microsoft .NET Framework 1.1</td>
+ <td><a class="externalLink" href="http://msdn.microsoft.com/en-us/netframework/">http://msdn.microsoft.com/en-us/netframework/</a></td>
+ </tr>
+ <tr class="b" style="vertical-align: top;">
+ <td>Microsoft .NET Framework 2.0</td>
+ <td><a class="externalLink" href="http://msdn.microsoft.com/en-us/netframework/">http://msdn.microsoft.com/en-us/netframework/</a></td>
+ </tr>
+ <tr class="a" style="vertical-align: top;">
+ <td>Microsoft .NET Framework 3.5</td>
+ <td><a class="externalLink" href="http://msdn.microsoft.com/en-us/netframework/">http://msdn.microsoft.com/en-us/netframework/</a></td>
+ </tr>
+ <tr class="b" style="vertical-align: top;">
+ <td>Microsoft .NET Framework 4.0</td>
+ <td><a class="externalLink" href="http://msdn.microsoft.com/en-us/netframework/">http://msdn.microsoft.com/en-us/netframework/</a></td>
+ </tr>
+ <tr class="a" style="vertical-align: top;">
+ <td>Microsoft .NET Framework 3.5 Client Profile</td>
+ <td><a class="externalLink" href="http://msdn.microsoft.com/en-us/library/cc656912.aspx">http://msdn.microsoft.com/en-us/library/cc656912.aspx</a></td>
+ </tr>
+ <tr class="b" style="vertical-align: top;">
+ <td>Microsoft .NET Framework 4.0 Client Profile</td>
+ <td><a class="externalLink" href="http://msdn.microsoft.com/en-us/library/cc656912.aspx">http://msdn.microsoft.com/en-us/library/cc656912.aspx</a></td>
+ </tr>
+ <tr class="a" style="vertical-align: top;">
+ <td>Microsoft .NET Compact Framework 1.0</td>
+ <td><a class="externalLink" 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" style="vertical-align: top;">
+ <td>Microsoft .NET Compact Framework 2.0</td>
+ <td><a class="externalLink" href="http://msdn2.microsoft.com/en-us/netframework/aa497273.aspx">http://msdn2.microsoft.com/en-us/netframework/aa497273.aspx</a></td>
+ </tr>
+ <tr class="a" style="vertical-align: top;">
+ <td>Mono</td>
+ <td><a class="externalLink" href="http://www.mono-project.com">http://www.mono-project.com</a></td>
+ </tr>
+ <tr class="b" style="vertical-align: top;">
+ <td>Microsoft Shared Source CLI 1.0</td>
+ <td><a class="externalLink" href="http://msdn.microsoft.com/en-us/library/ms973879.aspx">http://msdn.microsoft.com/en-us/library/ms973879.aspx</a></td>
+ </tr>
+ <tr class="a" style="vertical-align: top;">
+ <td>CLI 1.0 Compatible</td>
+ <td><a class="externalLink" href="http://msdn.microsoft.com/en-us/netframework/aa569283.aspx">http://msdn.microsoft.com/en-us/netframework/aa569283.aspx</a></td>
+ </tr>
+ </table>
+ </div>
+ <p>
+ For most 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>
+ <p>
+ There are no assemblies targeting the Compact
+ Framework 1.0/2.0 or Microsoft Shared Source CLI 1.0 in
+ the binary release, but they can be built from the
+ source release.
+ </p>
+ </div>
+
+ <a name="appenders"></a><div class="section"><h2 id="appenders">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 border="0" class="bodyTable">
+ <colgroup>
+ <col style="text-align: left;" />
+ <col style="text-align: center;" />
+ <col style="text-align: center;" />
+ <col style="text-align: center;" />
+ <col style="text-align: center;" />
+ <col style="text-align: center;" />
+ <col style="text-align: center;" />
+ <col style="text-align: center;" />
+ <col style="text-align: center;" />
+ <col style="text-align: center;" />
+ <col style="text-align: center;" />
+ <col style="text-align: center;" />
+ </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 Framework 3.5</th>
+ <th>.NET Framework 4.0</th>
+ <th>.NET Framework 3.5 Client Profile</th>
+ <th>.NET Framework 4.0 Client Profile</th>
+ <th>.NET CF 1.0</th>
+ <th>.NET CF 2.0</th>
+ <th>Mono</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>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>
+ <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>x</td>
+ <td>x</td>
+ <td></td>
+ <td></td>
+ <td></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>
+ <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>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td></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>
+ <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>
+ <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>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td></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>
+ <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>
+ <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>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td></td>
+ <td></td>
+ <td>x</td>
+ <td></td>
+ <td>x</td>
+ </tr>
+ <tr class="a">
+ <td>ManagedColoredConsoleAppender</td>
+ <td></td>
+ <td></td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td></td>
+ <td></td>
+ <td>x</td>
+ <td></td>
+ <td></td>
+ </tr>
+ <tr class="b">
+ <td>MemoryAppender</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</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>NetSendAppender</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td></td>
+ <td></td>
+ <td></td>
+ <td></td>
+ <td></td>
+ </tr>
+ <tr class="b">
+ <td>OutputDebugStringAppender</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td></td>
+ <td></td>
+ <td></td>
+ </tr>
+ <tr class="a">
+ <td>RemoteSyslogAppender</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</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>RemotingAppender</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td></td>
+ <td></td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ </tr>
+ <tr class="a">
+ <td>RollingFileAppender</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</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>SmtpAppender</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td></td>
+ <td></td>
+ <td>x</td>
+ <td></td>
+ <td>x</td>
+ </tr>
+ <tr class="a">
+ <td>SmtpPickupDirAppender</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</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>TelnetAppender</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</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>TraceAppender</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</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>UdpAppender</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</td>
+ <td>x</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="notes"></a><div class="section"><h2 id="notes">Framework Specific Notes</h2>
+ <a name="net1.0"></a><div class="section"><h2 id="net1.0">Microsoft .NET Framework 1.0</h2>
+ <p>
+ none
+ </p>
+ </div>
+
+ <a name="net1.1"></a><div class="section"><h2 id="net1.1">Microsoft .NET Framework 1.1</h2>
+ <p>
+ none
+ </p>
+ </div>
+
+ <a name="net2.0"></a><div class="section"><h2 id="net2.0">Microsoft .NET Framework 2.0</h2>
+ <p>
+ none
+ </p>
+ </div>
+
+ <a name="net3.5"></a><div class="section"><h2 id="net3.5">Microsoft .NET Framework 3.5</h2>
+ <p>
+ none
+ </p>
+ </div>
+
+ <a name="net4.0"></a><div class="section"><h2 id="net4.0">Microsoft .NET Framework 4.0</h2>
+ <p>
+ none
+ </p>
+ </div>
+
+ <a name="netcp3.5"></a><div class="section"><h2 id="netcp3.5">Microsoft .NET Framework 3.5 Client Profile</h2>
+ <p>
+ As of log4net 1.2.11 this version is identical
+ to the .NET 3.5 version without support for
+ ASP.NET specific appenders and patterns.
+ </p>
+ </div>
+
+ <a name="netcp4.0"></a><div class="section"><h2 id="netcp4.0">Microsoft .NET Framework 4.0 Client Profile</h2>
+ <p>
+ As of log4net 1.2.11 this version is identical
+ to the .NET 4.0 version without support for
+ ASP.NET specific appenders and patterns.
+ </p>
+ </div>
+
+ <a name="netcf1.0"></a><div class="section"><h2 id="netcf1.0">Microsoft .NET Compact Framework 1.0</h2>
+ <div class="section"><div class="section"><h4>Assembly attributes<a name="Assembly_attributes"></a></h4>
+ <p>
+ 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>
+ <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>
+ <div class="code"><pre>
+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></div>
+ </div><div class="section"><h4>Notification events<a name="Notification_events"></a></h4>
+ <p>
+ 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>
+ <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>
+ </div><div class="section"><h4>FileSystemWatcher<a name="FileSystemWatcher"></a></h4>
+ <p>
+ 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.
+ </p>
+ </div><div class="section"><h4>UserName<a name="UserName"></a></h4>
+ <p>
+ 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>.
+ </p>
+ </div><div class="section"><h4>Identity<a name="Identity"></a></h4>
+ <p>
+ 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>.
+ </p>
+ </div><div class="section"><h4>Environment variables<a name="Environment_variables"></a></h4>
+ <p>
+ 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.
+ </p>
+ </div><div class="section"><h4>Serialization<a name="Serialization"></a></h4>
+ <p>
+ 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.
+ </p>
+ </div><div class="section"><h4>LoggingEvent.Domain<a name="LoggingEvent.Domain"></a></h4>
+ <p>
+ 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.
+ </p>
+ </div></div></div>
+ <a name="netcf2.0"></a><div class="section"><h2 id="netcf2.0">Microsoft .NET Compact Framework 2.0</h2>
+ <p>
+ See notes for .NET Compact Framework 1.0
+ </p>
+ </div>
+ <a name="mono"></a><div class="section"><h2 id="mono">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="mono1.0"></a><div class="section"><h2 id="mono1.0">Mono 1.0</h2>
+ <p>
+ none
+ </p>
+ </div>
+ <a name="mono2.0"></a><div class="section"><h2 id="mono2.0">Mono 2.0</h2>
+ <p>
+ none
+ </p>
+ </div>
+
+ </div>
+
+ <a name="sscli1.0"></a><div class="section"><h2 id="sscli1.0">Microsoft Shared Source CLI 1.0</h2>
+ <div class="section"><div class="section"><h4>FileSystemWatcher<a name="FileSystemWatcher"></a></h4>
+ <p>
+ 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.
+ </p>
+ </div><div class="section"><h4>UserName<a name="UserName"></a></h4>
+ <p>
+ 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>.
+ </p>
+ </div><div class="section"><h4>Identity<a name="Identity"></a></h4>
+ <p>
+ 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>.
+ </p>
+ </div></div></div>
+
+ <a name="cli1.0"></a><div class="section"><h2 id="cli1.0">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>
+ <p>
+ Only a Release build is generated for this configuration because the assembly
+ debugging information has not been standardized.
+ </p>
+ </div>
+
+ </div>
+
+ </div>
+
+
+
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">
+ <div class="xright">Copyright © 2004-2013
+ <a href="http://www.apache.org">Apache Software Foundation</a>.
+
+
+ Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache Software License, Version 2.0</a>.</div><br />
+ <div class="xright">Apache log4net, Apache, log4net, the Apache feather logo, the Apache Logging Services project logo and the Built by Maven logo are trademarks of The Apache Software Foundation.</div>
+ <div class="clear">
+ </div>
+ </div>
+ </body>
+</html>
Propchange: websites/production/logging/content/log4net/log4net-1.2.13/release/framework-support.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: websites/production/logging/content/log4net/log4net-1.2.13/release/howto/chainsaw.html
==============================================================================
--- websites/production/logging/content/log4net/log4net-1.2.13/release/howto/chainsaw.html (added)
+++ websites/production/logging/content/log4net/log4net-1.2.13/release/howto/chainsaw.html Sun Nov 10 08:24:41 2013
@@ -0,0 +1,295 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!-- Generated by Apache Maven Doxia at Nov 10, 2013 -->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+ <title>
+ 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 name="Date-Revision-yyyymmdd" content="20131110" />
+ <meta http-equiv="Content-Language" content="en" />
+ <meta name="keywords" content="chainsaw log4net, log4net" />
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="../../../" id="bannerLeft">
+ <img src="../../images/ls-logo.jpg" alt="Apache Logging Services Project" />
+ </a>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+
+ <div class="xleft">
+ <span id="publishDate">Last Published: 2013-11-10</span>
+ | <span id="projectVersion">Version: 1.2.13</span>
+ | <a href="http://www.apache.org/" class="externalLink" title="Apache">Apache</a>
+ >
+ <a href="../../../" title="Logging Services">Logging Services</a>
+ >
+ <a href="../.././" title="log4net">log4net</a>
+ >
+
+ Apache log4net: How To view logging events using Apache log4j Chainsaw
+ </div>
+ <div class="xright">
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+
+ <h5>Apache log4net</h5>
+ <ul>
+ <li class="none">
+ <a href="../../index.html" title="About">About</a>
+ </li>
+ <li class="none">
+ <a href="../../download_log4net.cgi" title="Download">Download</a>
+ </li>
+ <li class="none">
+ <a href="../../release/release-notes.html" title="Release Notes">Release Notes</a>
+ </li>
+ <li class="none">
+ <a href="../../license.html" title="License">License</a>
+ </li>
+ </ul>
+ <h5>Documentation</h5>
+ <ul>
+ <li class="none">
+ <a href="../../release/features.html" title="Features">Features</a>
+ </li>
+ <li class="none">
+ <a href="../../release/framework-support.html" title="Supported Frameworks">Supported Frameworks</a>
+ </li>
+ <li class="none">
+ <a href="../../release/example-apps.html" title="Example Apps">Example Apps</a>
+ </li>
+ <li class="none">
+ <a href="../../release/config-examples.html" title="Config Examples">Config Examples</a>
+ </li>
+ <li class="none">
+ <a href="../../release/building.html" title="Building">Building</a>
+ </li>
+ <li class="none">
+ <a href="../../release/faq.html" title="FAQ">FAQ</a>
+ </li>
+ <li class="none">
+ <a href="../../release/howto/index.html" title="How Tos">How Tos</a>
+ </li>
+ <li class="none">
+ <a href="../../release/sdk/index.html" title="SDK Reference">SDK Reference</a>
+ </li>
+ </ul>
+ <h5>Manual</h5>
+ <ul>
+ <li class="none">
+ <a href="../../release/manual/introduction.html" title="Introduction">Introduction</a>
+ </li>
+ <li class="none">
+ <a href="../../release/manual/configuration.html" title="Configuration">Configuration</a>
+ </li>
+ <li class="none">
+ <a href="../../release/manual/contexts.html" title="Contexts">Contexts</a>
+ </li>
+ <li class="none">
+ <a href="../../release/manual/plugins.html" title="Plugins">Plugins</a>
+ </li>
+ <li class="none">
+ <a href="../../release/manual/repositories.html" title="Repositories">Repositories</a>
+ </li>
+ <li class="none">
+ <a href="../../release/manual/internals.html" title="Internals">Internals</a>
+ </li>
+ </ul>
+ <h5>Community</h5>
+ <ul>
+ <li class="none">
+ <a href="../../mail-lists.html" title="Mailing Lists">Mailing Lists</a>
+ </li>
+ <li class="none">
+ <a href="../../issue-tracking.html" title="Issue Tracking">Issue Tracking</a>
+ </li>
+ </ul>
+ <h5>Development</h5>
+ <ul>
+ <li class="none">
+ <a href="../../source-repository.html" title="Repository">Repository</a>
+ </li>
+ <li class="none">
+ <a href="../../integration.html" title="Continuous Integration">Continuous Integration</a>
+ </li>
+ </ul>
+ <h5>Project Documentation</h5>
+ <ul>
+ <li class="collapsed">
+ <a href="../../project-info.html" title="Project Information">Project Information</a>
+ </li>
+ <li class="collapsed">
+ <a href="../../project-reports.html" title="Project Reports">Project Reports</a>
+ </li>
+ </ul>
+ <h5>Apache</h5>
+ <ul>
+ <li class="none">
+ <a href="http://www.apache.org/" class="externalLink" title="Home">Home</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/licenses/" class="externalLink" title="License">License</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsorship">Sponsorship</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks">Thanks</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/security/" class="externalLink" title="Security">Security</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apachecon.com" class="externalLink" title="Conferences">Conferences</a>
+ </li>
+ </ul>
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img class="poweredBy" alt="Built by Maven" src="../../images/logos/maven-feather.png" />
+ </a>
+
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+ <!-- Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements. See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to you under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License. You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License. -->
+
+
+ <a name="main"></a><div class="section"><h2 id="main">How To view logging events using Apache log4j Chainsaw</h2>
+ <p>
+ Apache log4j™ includes <a class="externalLink" href="http://logging.apache.org/log4j/docs/chainsaw.html">Apache 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 />
+ Save one or more of the sample xml config files to your local system and
+ load them when Chainsaw starts.
+ </p>
+
+ <p>
+ Please note also that it may be necessary to configure Chainsaw tabs as reported as
+ issue <a class="externalLink" href="https://issues.apache.org/jira/browse/LOG4NET-259">LOG4NET-259</a>.
+ </p>
+
+ <a name="udp"></a><div class="section"><h2 id="udp">Logging via UDP</h2>
+ <p>
+ Apache log4net™ can be configured to log messages via UDP in such a way that Chainsaw
+ can receive and display them.
+ </p>
+
+ <a name="udp-conf"></a><div class="section"><h2 id="udp-conf">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="udp-chainsaw"></a><div class="section"><h2 id="udp-chainsaw">Chainsaw UDP receiver Configuration</h2>
+ <p>
+ Chainsaw should be configured to start a UDPReceiver 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="xml-file"></a><div class="section"><h2 id="xml-file">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">
+ <div class="xright">Copyright © 2004-2013
+ <a href="http://www.apache.org">Apache Software Foundation</a>.
+
+
+ Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache Software License, Version 2.0</a>.</div><br />
+ <div class="xright">Apache log4net, Apache, log4net, the Apache feather logo, the Apache Logging Services project logo and the Built by Maven logo are trademarks of The Apache Software Foundation.</div>
+ <div class="clear">
+ </div>
+ </div>
+ </body>
+</html>
Propchange: websites/production/logging/content/log4net/log4net-1.2.13/release/howto/chainsaw.html
------------------------------------------------------------------------------
svn:eol-style = native