1 /*- 2 * Copyright (c) 2017 Broadcom. All rights reserved. 3 * The term "Broadcom" refers to Broadcom Limited and/or its subsidiaries. 4 * 5 * Redistribution and use in source and binary forms, with or without 6 * modification, are permitted provided that the following conditions are met: 7 * 8 * 1. Redistributions of source code must retain the above copyright notice, 9 * this list of conditions and the following disclaimer. 10 * 11 * 2. Redistributions in binary form must reproduce the above copyright notice, 12 * this list of conditions and the following disclaimer in the documentation 13 * and/or other materials provided with the distribution. 14 * 15 * 3. Neither the name of the copyright holder nor the names of its contributors 16 * may be used to endorse or promote products derived from this software 17 * without specific prior written permission. 18 * 19 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 20 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 21 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 22 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE 23 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 24 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 25 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 26 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 27 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 28 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 29 * POSSIBILITY OF SUCH DAMAGE. 30 */ 31 32 #if !defined(__OCS_DDUMP_H__) 33 #define __OCS_DDUMP_H__ 34 35 #include "ocs_utils.h" 36 37 #define OCS_DDUMP_FLAGS_WQES (1U << 0) 38 #define OCS_DDUMP_FLAGS_CQES (1U << 1) 39 #define OCS_DDUMP_FLAGS_MQES (1U << 2) 40 #define OCS_DDUMP_FLAGS_RQES (1U << 3) 41 #define OCS_DDUMP_FLAGS_EQES (1U << 4) 42 43 extern int ocs_ddump(ocs_t *ocs, ocs_textbuf_t *textbuf, uint32_t flags, uint32_t qentries); 44 45 extern void ocs_ddump_startfile(ocs_textbuf_t *textbuf); 46 extern void ocs_ddump_endfile(ocs_textbuf_t *textbuf); 47 extern void ocs_ddump_section(ocs_textbuf_t *textbuf, const char *name, uint32_t instance); 48 extern void ocs_ddump_endsection(ocs_textbuf_t *textbuf, const char *name, uint32_t instance); 49 __attribute__((format(printf,3,4))) 50 extern void ocs_ddump_value(ocs_textbuf_t *textbuf, const char *name, const char *fmt, ...); 51 extern void ocs_ddump_buffer(ocs_textbuf_t *textbuf, const char *name, uint32_t instance, void *buffer, uint32_t size); 52 extern int32_t ocs_save_ddump(ocs_t *ocs, uint32_t flags, uint32_t qentries); 53 extern int32_t ocs_get_saved_ddump(ocs_t *ocs, ocs_textbuf_t *textbuf); 54 extern int32_t ocs_save_ddump_all(uint32_t flags, uint32_t qentries, uint32_t alloc_flag); 55 extern int32_t ocs_clear_saved_ddump(ocs_t *ocs); 56 extern void ocs_ddump_queue_entries(ocs_textbuf_t *textbuf, void *q_addr, uint32_t size, uint32_t length, int32_t index, uint32_t qentries); 57 58 #endif 59