summaryrefslogtreecommitdiff
path: root/ace/Logging_Strategy.h
blob: 0544ecf571add434ea9af980ecc9d913a45ae1b7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
/* -*- C++ -*- */
// $Id$

// ============================================================================
//
// = LIBRARY
//    ace
//
// = FILENAME
//    Logging_Strategy.h
//
// = AUTHOR
//    Prashant Jain <pjain@cs.wustl.edu>
//
// ============================================================================

#ifndef ACE_LOGGING_STRATEGY_H
#define ACE_LOGGING_STRATEGY_H

#include "ace/Service_Object.h"
#include "ace/Log_Msg.h"

#if !defined (ACE_LACKS_PRAGMA_ONCE)
# pragma once
#endif /* ACE_LACKS_PRAGMA_ONCE */

#if !defined (ACE_DEFAULT_MAX_LOGFILE_SIZE)
#define ACE_DEFAULT_MAX_LOGFILE_SIZE 16384 /* KB */
#endif /* ACE_DEFAULT_MAX_LOGFILE_SIZE */

class ACE_Export ACE_Logging_Strategy : public ACE_Service_Object
{
  // = TITLE
  //     This class provides the hooks to control the output produced
  //     by any of the network services.
  //
  // = DESCRIPTION
  //     Depending upon when this service is invoked and with what
  //     flags, the output of other network services can be
  //     controlled. The output can be streamed to stderr, to a file,
  //     to a logging daemon, or it can be set to be "silent".
  //
  //     If logging records are output to a file, the file can be set
  //     to a maximum size and repeatedly split into new files.  The
  //     log file size can be limited at any logging point (i.e.,
  //     application, client logging daemon, or server logging daemon)
  //     by specifying the -i <sample_interval_in_secs> and -m
  //     <max_size_in_KB> options for the Logging_Strategy class in a
  //     svc.conf file.
public:
  ACE_Logging_Strategy (void);
  // Constructor.

  virtual int init (int argc, ACE_TCHAR *argv[]);
  // Dynamic linking initialization hook.

  virtual int fini (void);
  // Dynamic linking termination hook.

  virtual int handle_timeout (const ACE_Time_Value& tv, const void* arg);
  // Timeout handler which tests logfile size.  If the current logfile
  // size exceeds <max_size_>, the current logfile is closed, saved to
  // logfile.old, and a new logfile is reopened.

  int parse_args (int argc, ACE_TCHAR *argv[]);
  // Parse svc.conf arguments.

private:
  void tokenize (ACE_TCHAR *flag_string);
  // Tokenize to set all the flags

  void priorities (ACE_TCHAR *priority_string,
                   ACE_Log_Msg::MASK_TYPE mask);
  // Tokenize to set priorities (either process or thread one).

  u_long thread_priority_mask_;
  // Current thread's priority mask set by <priorities>

  u_long process_priority_mask_;
  // Process-wide priority mask set by <priorities>

  u_long flags_;
  // Flags we keep track of.

  ACE_TCHAR *filename_;
  // File name we're logging to.

  int wipeout_logfile_;
  // If non-0 then wipeout the logfile, otherwise append to it.

  u_long interval_;
  // If non-zero, sampling interval (in secs) at which maximum logfile
  // size is checked, otherwise logfile size can grow indefinitely.

  u_long max_size_;
  // Maximum logfile size (in KB).
};

ACE_FACTORY_DECLARE (ACE, ACE_Logging_Strategy)

#endif /* ACE_LOGGING_STRATEGY_H */