From commits-return-481-apmail-logging-commits-archive=logging.apache.org@logging.apache.org Tue Feb 14 17:11:44 2012 Return-Path: X-Original-To: apmail-logging-commits-archive@minotaur.apache.org Delivered-To: apmail-logging-commits-archive@minotaur.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 60F749AF8 for ; Tue, 14 Feb 2012 17:11:44 +0000 (UTC) Received: (qmail 77725 invoked by uid 500); 14 Feb 2012 17:11:44 -0000 Delivered-To: apmail-logging-commits-archive@logging.apache.org Received: (qmail 77703 invoked by uid 500); 14 Feb 2012 17:11:44 -0000 Mailing-List: contact commits-help@logging.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@logging.apache.org Delivered-To: mailing list commits@logging.apache.org Received: (qmail 77693 invoked by uid 99); 14 Feb 2012 17:11:44 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 14 Feb 2012 17:11:44 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=5.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 14 Feb 2012 17:11:42 +0000 Received: from eris.apache.org (localhost [127.0.0.1]) by eris.apache.org (Postfix) with ESMTP id 3B73C2388C28; Tue, 14 Feb 2012 17:10:58 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r1244132 [12/14] - in /logging/log4net/site: ./ css/ images/ images/logos/ release/ release/howto/ release/manual/ Date: Tue, 14 Feb 2012 17:10:56 -0000 To: commits@logging.apache.org From: bodewig@apache.org X-Mailer: svnmailer-1.0.8-patched Message-Id: <20120214171058.3B73C2388C28@eris.apache.org> Added: logging/log4net/site/release/manual/repositories.html URL: http://svn.apache.org/viewvc/logging/log4net/site/release/manual/repositories.html?rev=1244132&view=auto ============================================================================== --- logging/log4net/site/release/manual/repositories.html (added) +++ logging/log4net/site/release/manual/repositories.html Tue Feb 14 17:10:54 2012 @@ -0,0 +1,290 @@ + + + + + + + Apache log4net Manual: Repositories + + + + + + + + + + +
+ +
+
+
+ + + +

Apache log4net™ Manual - Repositories

+

Logging Repositories

+

+ Logging repositories are considered advanced functionality. The default behavior + should be sufficient for most users. +

+

+ Log4net supports logging repositories. A repository is uniquely named. + Each repository is a (ILoggerRepository). + Multiple assemblies can link to the same repository. +

+

+ By default there is a single logging repository per process (more precisely per AppDomain). This extends + across all assemblies loaded into the process and allows them to all share a + single configuration. The configuration of the repository only needs to be done once, + typically in the entry point to the application, either programmatically or using + a configuration attribute. +

+

+ Named logging repositories can be created using the LogManager.CreateRepository + method. The repository for can be retrieved using the + LogManager.GetRepository method. + A repository created in this way will need to be configured programmatically. +

+ +

Attributes

+

+ An assembly may choose to utilize a named logging repository rather than the default repository. + This completely separates the logging for the assembly from the rest of the application. + This can be very useful to component developers that wish to use log4net for their + components but do not want to require that all the applications that use their + component are aware of log4net. It also means that their debugging configuration is + separated from the applications configuration. The assembly should specify the + RepositoryAttribute to set its logging repository. +

+

+ The log4net logging repositories can be configured using the following assembly-level + attributes: +

+
    +
  • + AliasRepositoryAttribute +

    + Specifies a named repository to use as this assembly's repository. +

    +

    + An assembly's logger repository is defined by its + RepositoryAttribute, however this can be overridden by an + assembly loaded before the target assembly. +

    +

    + An assembly can alias another assembly's repository by specifying + this attribute with the name of the target repository. +

    +

    + This attribute may be used as many times as necessary to alias all the required + repositories. +

    +
  • +
  • + RepositoryAttribute +

    + Specifies the logging repository for the assembly. +

    +

    + Assemblies are mapped to logging repositories. This attribute controls the configuration of the repository. The + Name property specifies the name of the repository + for this assembly. The RepositoryType + property specifies the type of the repository object to create for the assembly. + If this attribute is not specified and a Name + is not specified then the assembly will be part of the default shared logging + repository. +

    +

    + This attribute may only be used once per assembly. +

    +
  • +
+
+
+
+ + +
+
+
+
+
+