1 files changed, 123 insertions, 0 deletions
diff --git a/indra/llcommon/llerrorcontrol.h b/indra/llcommon/llerrorcontrol.h
new file mode 100644
index 0000000000..b1950eebf0
--- /dev/null
+++ b/indra/llcommon/llerrorcontrol.h
@@ -0,0 +1,123 @@
+/** 
+ * @file llerrorcontrol.h
+ * @date   December 2006
+ * @brief error message system control
+ *
+ * Copyright (c) 2007-$CurrentYear$, Linden Research, Inc.
+ * $License$
+ */
+
+#ifndef LL_LLERRORCONTROL_H
+#define LL_LLERRORCONTROL_H
+
+#include "llerror.h"
+
+#include <string>
+
+class LLFixedBuffer;
+class LLSD;
+
+/*
+	This is the part of the LLError namespace that manages the messages
+	produced by the logging.  The logging support is defined in llerror.h.
+	Most files do not need to include this.
+	
+	These implementations are in llerror.cpp.
+*/
+
+
+namespace LLError
+{
+	void initForServer(const std::string& identity);
+		// resets all logging settings to defaults needed by server processes
+		// logs to stderr, syslog, and windows debug log
+		// the identity string is used for in the syslog
+
+	void initForApplication(const std::string& dir);
+		// resets all logging settings to defaults needed by applicaitons
+		// logs to stderr and windows debug log
+		// sets up log configuration from the file logcontrol.xml in dir
+
+
+	/*
+		Settings that control what is logged.
+		Setting a level means log messages at that level or above.
+	*/
+	
+	void setPrintLocation(bool);
+	void setDefaultLevel(LLError::ELevel);
+	void setFunctionLevel(const std::string& function_name, LLError::ELevel);
+	void setClassLevel(const std::string& class_name, LLError::ELevel);
+	void setFileLevel(const std::string& file_name, LLError::ELevel);
+	
+	void configure(const LLSD&);
+		// the LLSD can configure all of the settings
+		// usually read automatically from the live errorlog.xml file
+
+
+	/*
+		Control functions.
+	*/
+
+	typedef void (*FatalFunction)(const std::string& message);
+	void crashAndLoop(const std::string& message);
+		// Default fatal funtion: divides by zero and loops forever
+
+	void setFatalFunction(FatalFunction);
+		// The fatal function will be called when an message of LEVEL_ERROR
+		// is logged.  Note: supressing a LEVEL_ERROR message from being logged
+		// (by, for example, setting a class level to LEVEL_NONE), will keep
+		// the that message from causing the fatal funciton to be invoked.
+		
+	typedef std::string (*TimeFunction)();
+	std::string utcTime();
+	
+	void setTimeFunction(TimeFunction);
+		// The function is use to return the current time, formatted for
+		// display by those error recorders that want the time included.
+
+
+
+	class Recorder
+	{
+		// An object that handles the actual output or error messages.
+	public:
+		virtual ~Recorder();
+		
+		virtual void recordMessage(LLError::ELevel, const std::string& message) = 0;
+			// use the level for better display, not for filtering
+			
+		virtual bool wantsTime(); // default returns false
+			// override and return true if the recorder wants the time string
+			// included in the text of the message
+	};
+	
+	void addRecorder(Recorder*);
+	void removeRecorder(Recorder*);
+		// each error message is passed to each recorder via recordMessage()
+	
+	void logToFile(const std::string& filename);
+	void logToFixedBuffer(LLFixedBuffer*);
+		// Utilities to add recorders for logging to a file or a fixed buffer
+		// A second call to the same function will remove the logger added
+		// with the first.
+		// Passing the empty string or NULL to just removes any prior.
+	std::string logFileName();
+		// returns name of current logging file, empty string if none
+
+
+	/*
+		Utilities for use by the unit tests of LLError itself.
+	*/
+
+	class Settings;
+	Settings* saveAndResetSettings();
+	void restoreSettings(Settings *);
+		
+	std::string abbreviateFile(const std::string& filePath);
+	int shouldLogCallCount();
+	
+};
+
+#endif // LL_LLERRORCONTROL_H
+