119 lines · c
1/*2 * linux/drivers/scsi/esas2r/esas2r_log.h3 * For use with ATTO ExpressSAS R6xx SAS/SATA RAID controllers4 *5 * Copyright (c) 2001-2013 ATTO Technology, Inc.6 * (mailto:linuxdrivers@attotech.com)7 *8 * This program is free software; you can redistribute it and/or9 * modify it under the terms of the GNU General Public License10 * as published by the Free Software Foundation; either version 211 * of the License, or (at your option) any later version.12 *13 * This program is distributed in the hope that it will be useful,14 * but WITHOUT ANY WARRANTY; without even the implied warranty of15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the16 * GNU General Public License for more details.17 *18 * NO WARRANTY19 * THE PROGRAM IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OR20 * CONDITIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED INCLUDING, WITHOUT21 * LIMITATION, ANY WARRANTIES OR CONDITIONS OF TITLE, NON-INFRINGEMENT,22 * MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Each Recipient is23 * solely responsible for determining the appropriateness of using and24 * distributing the Program and assumes all risks associated with its25 * exercise of rights under this Agreement, including but not limited to26 * the risks and costs of program errors, damage to or loss of data,27 * programs or equipment, and unavailability or interruption of operations.28 *29 * DISCLAIMER OF LIABILITY30 * NEITHER RECIPIENT NOR ANY CONTRIBUTORS SHALL HAVE ANY LIABILITY FOR ANY31 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL32 * DAMAGES (INCLUDING WITHOUT LIMITATION LOST PROFITS), HOWEVER CAUSED AND33 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR34 * TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE35 * USE OR DISTRIBUTION OF THE PROGRAM OR THE EXERCISE OF ANY RIGHTS GRANTED36 * HEREUNDER, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES37 *38 * You should have received a copy of the GNU General Public License39 * along with this program; if not, write to the Free Software40 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,41 * USA.42 */43 44#ifndef __esas2r_log_h__45#define __esas2r_log_h__46 47struct device;48 49enum {50 ESAS2R_LOG_NONE = 0, /* no events logged */51 ESAS2R_LOG_CRIT = 1, /* critical events */52 ESAS2R_LOG_WARN = 2, /* warning events */53 ESAS2R_LOG_INFO = 3, /* info events */54 ESAS2R_LOG_DEBG = 4, /* debugging events */55 ESAS2R_LOG_TRCE = 5, /* tracing events */56 57#ifdef ESAS2R_TRACE58 ESAS2R_LOG_DFLT = ESAS2R_LOG_TRCE59#else60 ESAS2R_LOG_DFLT = ESAS2R_LOG_WARN61#endif62};63 64__printf(2, 3) int esas2r_log(const long level, const char *format, ...);65__printf(3, 4) int esas2r_log_dev(const long level,66 const struct device *dev,67 const char *format,68 ...);69int esas2r_log_hexdump(const long level,70 const void *buf,71 size_t len);72 73/*74 * the following macros are provided specifically for debugging and tracing75 * messages. esas2r_debug() is provided for generic non-hardware layer76 * debugging and tracing events. esas2r_hdebug is provided specifically for77 * hardware layer debugging and tracing events.78 */79 80#ifdef ESAS2R_DEBUG81#define esas2r_debug(f, args ...) esas2r_log(ESAS2R_LOG_DEBG, f, ## args)82#define esas2r_hdebug(f, args ...) esas2r_log(ESAS2R_LOG_DEBG, f, ## args)83#else84#define esas2r_debug(f, args ...)85#define esas2r_hdebug(f, args ...)86#endif /* ESAS2R_DEBUG */87 88/*89 * the following macros are provided in order to trace the driver and catch90 * some more serious bugs. be warned, enabling these macros may *severely*91 * impact performance.92 */93 94#ifdef ESAS2R_TRACE95#define esas2r_bugon() \96 do { \97 esas2r_log(ESAS2R_LOG_TRCE, "esas2r_bugon() called in %s:%d" \98 " - dumping stack and stopping kernel", __func__, \99 __LINE__); \100 dump_stack(); \101 BUG(); \102 } while (0)103 104#define esas2r_trace_enter() esas2r_log(ESAS2R_LOG_TRCE, "entered %s (%s:%d)", \105 __func__, __FILE__, __LINE__)106#define esas2r_trace_exit() esas2r_log(ESAS2R_LOG_TRCE, "exited %s (%s:%d)", \107 __func__, __FILE__, __LINE__)108#define esas2r_trace(f, args ...) esas2r_log(ESAS2R_LOG_TRCE, "(%s:%s:%d): " \109 f, __func__, __FILE__, __LINE__, \110 ## args)111#else112#define esas2r_bugon()113#define esas2r_trace_enter()114#define esas2r_trace_exit()115#define esas2r_trace(f, args ...)116#endif /* ESAS2R_TRACE */117 118#endif /* __esas2r_log_h__ */119