dvbcss-synckit-ios
SimpleLogger Framework

This framework provides a simple set of convenience wrapper functions for writing to ASL (Apple System Log).

It supports a compile-time log level by setting the value of the preprocessor macro MW_COMPILE_TIME_LOG_LEVEL. This will turn the associated log calls into NOPs.

Overview

To control the logging level at compile time, set the value of the preprocessor macro MW_COMPILE_TIME_LOG_LEVEL. The log levels are the constants defined in asl.h:

#define ASL_LEVEL_EMERG   0
#define ASL_LEVEL_ALERT   1
#define ASL_LEVEL_CRIT    2
#define ASL_LEVEL_ERR     3
#define ASL_LEVEL_WARNING 4
#define ASL_LEVEL_NOTICE  5
#define ASL_LEVEL_INFO    6
#define ASL_LEVEL_DEBUG   7

For a description of when to use each level, see here: http://developer.apple.com/library/mac/#documentation/MacOSX/Conceptual/BPSystemStartup/Chapters/LoggingErrorsAndWarnings.html#//apple_ref/doc/uid/10000172i-SW8-SW1

Emergency (level 0) - The highest priority, usually reserved for catastrophic failures and reboot notices.
Alert (level 1) - A serious failure in a key system.
Critical (level 2) - A failure in a key system.
Error (level 3) - Something has failed.
Warning (level 4) - Something is amiss and might fail if not corrected.
Notice (level 5) - Things of moderate interest to the user or administrator.
Info (level 6) - The lowest priority that you would normally log, and purely informational in nature.
Debug (level 7) - The lowest priority, and normally not logged except for messages from the kernel.

Note that by default the iOS syslog/console will only record items up to level ASL_LEVEL_NOTICE.

How to use

1. Add the framework to your project

A Cocoa Pod version of this library is not currently available. To use this library, you must add it and its dependencies to your project.

Either include AudioPlayerEngine in your workspace and build it; or build it in this repository’s synckit.xcworkspace

Then add AudioPlayerEngine.framework under Linked Frameworks and libraries in your project’s target configuration.

2. Import the header files

#import <SimpleLogger/SimpleLogger.h>

Use logging functions

Call the appropriate function for the logging level you wish to log at. For example:

MWLogDebug("Logging message at ASL_LEVEL_DEBUG");
MWLogError("Logging message at ASL_LEVEL_ERR");

The logging message can include formatting for additional parameters, as per [NSString initWithFormat], for example:

int numItems = 5;
...

MWLogInfo("For information there are %d items left.", numItems);

Licence

This framework is developed by BBC R&D and distributed under Licensed under the Apache License, Version 2.0.