xref: /wlan-dirver/qca-wifi-host-cmn/utils/logging/inc/wlan_logging_sock_svc.h (revision 0626a4da6c07f30da06dd6747e8cc290a60371d8)
1 /*
2  * Copyright (c) 2014-2018 The Linux Foundation. All rights reserved.
3  *
4  * Permission to use, copy, modify, and/or distribute this software for
5  * any purpose with or without fee is hereby granted, provided that the
6  * above copyright notice and this permission notice appear in all
7  * copies.
8  *
9  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
10  * WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
11  * WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
12  * AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
13  * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
14  * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
15  * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
16  * PERFORMANCE OF THIS SOFTWARE.
17  */
18 
19 /******************************************************************************
20 * wlan_logging_sock_svc.h
21 *
22 ******************************************************************************/
23 
24 #ifndef WLAN_LOGGING_SOCK_SVC_H
25 #define WLAN_LOGGING_SOCK_SVC_H
26 
27 #include <wlan_nlink_srv.h>
28 #include <qdf_status.h>
29 #include <qdf_trace.h>
30 #include <wlan_nlink_common.h>
31 
32 int wlan_logging_sock_init_svc(void);
33 int wlan_logging_sock_deinit_svc(void);
34 int wlan_log_to_user(QDF_TRACE_LEVEL log_level, char *to_be_sent, int length);
35 
36 /**
37  * wlan_logging_set_flush_timer() - Sets the time period for log flush timer
38  * @milliseconds: Time period in milliseconds
39  *
40  * This function sets the time period interval during which the log buffers
41  * will be flushed out to user space. Setting this interval can set an
42  * approximate maximum delay after which any message logged through QDF_TRACE
43  * will appear at user-space
44  *
45  * Return: void
46  */
47 int wlan_logging_set_flush_timer(uint32_t milliseconds);
48 
49 #ifdef WLAN_LOGGING_SOCK_SVC_ENABLE
50 void wlan_logging_set_per_pkt_stats(void);
51 void wlan_logging_set_fw_flush_complete(void);
52 void wlan_flush_host_logs_for_fatal(void);
53 void wlan_logging_set_active(bool active);
54 void wlan_logging_set_log_to_console(bool log_to_console);
55 #else
56 static inline void wlan_flush_host_logs_for_fatal(void) {}
57 static inline void wlan_logging_set_per_pkt_stats(void) {}
58 static inline void wlan_logging_set_fw_flush_complete(void) {}
59 static inline void wlan_logging_set_active(bool active) {}
60 static inline void wlan_logging_set_log_to_console(bool log_to_console) {}
61 #endif /* WLAN_LOGGING_SOCK_SVC_ENABLE */
62 
63 #if defined(WLAN_LOGGING_SOCK_SVC_ENABLE) && !defined(REMOVE_PKT_LOG)
64 void wlan_deregister_txrx_packetdump(void);
65 void wlan_register_txrx_packetdump(void);
66 #else
67 static inline void wlan_deregister_txrx_packetdump(void) {}
68 static inline void wlan_register_txrx_packetdump(void) {}
69 #endif
70 
71 #if defined(WLAN_LOGGING_SOCK_SVC_ENABLE) && defined(FEATURE_WLAN_DIAG_SUPPORT)
72 void wlan_report_log_completion(uint32_t is_fatal,
73 		uint32_t indicator,
74 		uint32_t reason_code,
75 		uint8_t ring_id);
76 #else
77 static inline void wlan_report_log_completion(uint32_t is_fatal,
78 		uint32_t indicator,
79 		uint32_t reason_code,
80 		uint8_t ring_id)
81 {
82 	return;
83 }
84 
85 #endif /* FEATURE_WLAN_DIAG_SUPPORT */
86 
87 #if defined(CONFIG_MCL) && !defined(REMOVE_PKT_LOG)
88 void wlan_pkt_stats_to_logger_thread(void *pl_hdr, void *pkt_dump, void *data);
89 #else
90 static inline
91 void wlan_pkt_stats_to_logger_thread(void *pl_hdr, void *pkt_dump, void *data)
92 {
93 }
94 #endif
95 
96 
97 #endif /* WLAN_LOGGING_SOCK_SVC_H */
98