Line data Source code
1 0 : /* 2 : 3 : OOLogOutputHandler.h 4 : By Jens Ayton 5 : 6 : Output handler for OOLogging. 7 : 8 : This does two things: 9 : 1. It writes log output to ~/Logs/Oolite/Latest.log under Mac OS X or 10 : ~/.Oolite/Logs/Latest.log under Linux, handling thread serialization. 11 : 2. It installs a filter to capture NSLogs and convert them to OOLogs. This is 12 : different to the macro in OOLogging.h, which acts at compile time; the 13 : filter catches logging in included frameworks. 14 : 15 : OOLogOutputHandlerPrint() is thread-safe. Other functions are not. 16 : 17 : 18 : Copyright (C) 2007-2013 Jens Ayton and contributors 19 : 20 : Permission is hereby granted, free of charge, to any person obtaining a copy 21 : of this software and associated documentation files (the "Software"), to deal 22 : in the Software without restriction, including without limitation the rights 23 : to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 24 : copies of the Software, and to permit persons to whom the Software is 25 : furnished to do so, subject to the following conditions: 26 : 27 : The above copyright notice and this permission notice shall be included in all 28 : copies or substantial portions of the Software. 29 : 30 : THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 31 : IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 32 : FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 33 : AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 34 : LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 35 : OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 36 : SOFTWARE. 37 : 38 : */ 39 : 40 : #import <Foundation/Foundation.h> 41 : 42 : 43 0 : void OOLogOutputHandlerInit(void); 44 0 : void OOLogOutputHandlerClose(void); 45 0 : void OOLogOutputHandlerPrint(NSString *string); 46 : 47 : // This will attempt to ensure the containing directory exists. If it fails, it will return nil. 48 0 : NSString *OOLogHandlerGetLogPath(void); 49 0 : NSString *OOLogHandlerGetLogBasePath(void); 50 0 : void OOLogOutputHandlerChangeLogFile(NSString *newLogName); 51 : 52 0 : void OOLogOutputHandlerStartLoggingToStdout(void); 53 0 : void OOLogOutputHandlerStopLoggingToStdout(void);