[Openais] [PATCH 3/9] logsys: update man page to reflect new changes

Fabio M. Di Nitto fdinitto at redhat.com
Wed Jun 17 03:53:43 PDT 2009


Signed-off-by: Fabio M. Di Nitto <fdinitto at redhat.com>
---
:100644 100644 e39837a... e19836e... M	man/logsys_overview.8
 man/logsys_overview.8 |   32 +++++++-------------------------
 1 files changed, 7 insertions(+), 25 deletions(-)

diff --git a/man/logsys_overview.8 b/man/logsys_overview.8
index e39837a..e19836e 100644
--- a/man/logsys_overview.8
+++ b/man/logsys_overview.8
@@ -32,7 +32,7 @@
 .\" * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
 .\" * THE POSSIBILITY OF SUCH DAMAGE.
 .\" */
-.TH LOGSYS_OVERVIEW 8 2009-04-15 "corosync Man Page" "Corosync Cluster Engine Programmer's Manual"
+.TH LOGSYS_OVERVIEW 8 2009-06-16 "corosync Man Page" "Corosync Cluster Engine Programmer's Manual"
 .SH OVERVIEW
 The logsys library provides a generically usable logging and tracing system for
 use by applications.  It supports many features including:
@@ -62,7 +62,7 @@ require it and enables full logging capabilities before any application code is
 executed.
 
 #define LOGSYS_DECLARE_SYSTEM (name, mode, debug, file, file_priority,
-syslog_facility, syslog_priority, tags, format, rec_size)
+syslog_facility, syslog_priority, format, rec_size)
 
 The name parameter is the name of the application or system.
 
@@ -96,14 +96,6 @@ messages.
 The syslog_priority, similar to file_priority, specifies the message priority that should be logged to
 syslog.
 
-The tags parameter enables tracing by logically ORing these flags:
-
-LOGSYS_TAG_ENTER
-
-LOGSYS_TAG_LEAVE
-
-LOGSYS_TAG_TRACE1 to LOGSYS_TAG_TRACE8
-
 The format parameter allows to set custom output format.
 Set to NULL to use built-in default.
 
@@ -122,7 +114,6 @@ LOGSYS_DECLARE_SYSTEM ("test",                            /* name */
         LOGSYS_LEVEL_INFO,                                /* logfile_priority */
         LOG_DAEMON,                                       /* syslog facility */
         LOGSYS_LEVEL_INFO,                                /* syslog level */
-        0,                                                /* tags */
         NULL,                                             /* use default format */
         1000000);                                         /* flight recorder size */
 
@@ -163,20 +154,13 @@ An example of using log_printf would be
 
 log_printf (LOGSYS_LEVEL_EMERG, "This is an emergency %s value %d\n", string, value);
 
-Tracing of functions can be done using ENTER_VOID() or ENTER (format, args) LEAVE_VOID() or LEAVE (format, args);
-
-An exmaple of using ENTER_VOID is
-void funtion (void) {
-ENTER_VOID();
-... function contents ...
-LEAVE_VOID();
-}
+Tracing of functions can be done using ENTER(), LEAVE();
 
 An example of using ENTER is
 void function (char *name) {
-ENTER ("The name is %s\n", name);
+ENTER();
 ... function contents ...
-LEAVE ("Bye\n");
+LEAVE();
 }
 
 Individual tracing levels are supported through the macros
@@ -190,6 +174,8 @@ An example of using TRACE is
 char *name = "test";
 TRACE7 ("This is a trace 7 log with name %s\n", name);
 
+Note that ENTER/LEAVE/TRACE* calls are recorded only in the flight recorder.
+
 .SH "SEE ALSO"
 .BR logsys_fork_completed (3),
 .BR logsys_atexit (3),
@@ -202,8 +188,6 @@ TRACE7 ("This is a trace 7 log with name %s\n", name);
 .BR logsys_config_syslog_facility_get (3),
 .BR logsys_config_mode_set (3),
 .BR logsys_config_mode_get (3),
-.BR logsys_config_tags_set (3),
-.BR logsys_config_tags_get (3),
 .BR logsys_config_file_set (3),
 .BR logsys_config_logfile_priority_set (3),
 .BR logsys_config_debug_set (3),
@@ -211,6 +195,4 @@ TRACE7 ("This is a trace 7 log with name %s\n", name);
 .BR logsys_facility_name_get (3),
 .BR logsys_priority_id_get (3),
 .BR logsys_priority_name_get (3),
-.BR logsys_tag_id_get (3),
-.BR logsys_tag_name_get (3)
 .PP
-- 
1.5.4.3



More information about the Openais mailing list