xref: /wlan-dirver/qca-wifi-host-cmn/qdf/inc/qdf_status.h (revision 901120c066e139c7f8a2c8e4820561fdd83c67ef) !
1 /*
2  * Copyright (c) 2014-2020 The Linux Foundation. All rights reserved.
3  * Copyright (c) 2022 Qualcomm Innovation Center, Inc. All rights reserved.
4  *
5  * Permission to use, copy, modify, and/or distribute this software for
6  * any purpose with or without fee is hereby granted, provided that the
7  * above copyright notice and this permission notice appear in all
8  * copies.
9  *
10  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
11  * WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
12  * WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
13  * AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
14  * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
15  * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
16  * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
17  * PERFORMANCE OF THIS SOFTWARE.
18  */
19 
20 /**
21  * DOC: qdf_status
22  * QCA driver framework (QDF) status codes
23  * Basic status codes/definitions used by QDF
24  */
25 
26 #ifndef __QDF_STATUS_H
27 #define __QDF_STATUS_H
28 
29 /**
30  * typedef QDF_STATUS - QDF error codes
31  * @QDF_STATUS_SUCCESS: success
32  * @QDF_STATUS_E_RESOURCES: system resource(other than memory) not available
33  * @QDF_STATUS_E_NOMEM: not enough memory
34  * @QDF_STATUS_E_AGAIN: try again
35  * @QDF_STATUS_E_INVAL: invalid request
36  * @QDF_STATUS_E_FAULT: system fault
37  * @QDF_STATUS_E_ALREADY: another request already in progress
38  * @QDF_STATUS_E_BADMSG: bad message
39  * @QDF_STATUS_E_BUSY: device or resource busy
40  * @QDF_STATUS_E_CANCELED: request cancelled
41  * @QDF_STATUS_E_ABORTED: request aborted
42  * @QDF_STATUS_E_NOSUPPORT: request not supported
43  * @QDF_STATUS_E_PERM: operation not permitted
44  * @QDF_STATUS_E_EMPTY: empty condition
45  * @QDF_STATUS_E_EXISTS: existence failure
46  * @QDF_STATUS_E_TIMEOUT: operation timeout
47  * @QDF_STATUS_E_FAILURE: unknown reason do not use unless nothing else applies
48  * @QDF_STATUS_E_NOENT: No such file or directory
49  * @QDF_STATUS_E_E2BIG: Arg list too long
50  * @QDF_STATUS_E_NOSPC: no space left on device
51  * @QDF_STATUS_E_ADDRNOTAVAIL: Cannot assign requested address
52  * @QDF_STATUS_E_ENXIO: No such device or address
53  * @QDF_STATUS_E_NETDOWN: network is down
54  * @QDF_STATUS_E_IO: I/O Error
55  * @QDF_STATUS_E_PENDING: pending status
56  * @QDF_STATUS_E_NETRESET: Network dropped connection because of reset
57  * @QDF_STATUS_E_SIG: Exit due to received SIGINT
58  * @QDF_STATUS_E_PROTO: protocol error
59  * @QDF_STATUS_NOT_INITIALIZED: resource not initialized
60  * @QDF_STATUS_E_NULL_VALUE: request is null
61  * @QDF_STATUS_HEARTBEAT_TMOUT: hearbeat timeout error
62  * @QDF_STATUS_NTH_BEACON_DELIVERY: Nth beacon delivery
63  * @QDF_STATUS_CSR_WRONG_STATE: csr in wrong state
64  * @QDF_STATUS_FT_PREAUTH_KEY_SUCCESS: ft preauth key success
65  * @QDF_STATUS_FT_PREAUTH_KEY_FAILED: ft preauth key failed
66  * @QDF_STATUS_CMD_NOT_QUEUED: command not queued
67  * @QDF_STATUS_FW_MSG_TIMEDOUT: target message timeout
68  * @QDF_STATUS_E_USB_ERROR: USB transaction error
69  * @QDF_STATUS_MAXCOMP_FAIL: Component id is more than MAX UMAC components
70  * @QDF_STATUS_COMP_DISABLED: UMAC Component is disabled
71  * @QDF_STATUS_COMP_ASYNC: UMAC component runs in asynchronous communication
72  * @QDF_STATUS_CRYPTO_PN_ERROR: PN ERROR in received frame
73  * @QDF_STATUS_CRYPTO_MIC_FAILURE: MIC failure in received frame
74  * @QDF_STATUS_CRYPTO_ENCRYPT_FAILED: encryption failed
75  * @QDF_STATUS_CRYPTO_DECRYPT_FAILED: decryption failed
76  * @QDF_STATUS_E_RANGE: result/parameter/operation was out of range
77  * @QDF_STATUS_E_GRO_DROP: return code for GRO drop
78  * @QDF_STATUS_QMI_HANDLE_INIT_FAILED: QMI handle init failed
79  * @QDF_STATUS_QMI_ADD_LOOKUP_FAILED: QMI add lookup failed
80  * @QDF_STATUS_QMI_SVC_CONNECT_FAILED: QMI service connect failed
81  * @QDF_STATUS_QMI_TXN_INIT_FAILED: QMI transaction init failed
82  * @QDF_STATUS_QMI_SEND_REQ_FAILED: QMI send request failed
83  * @QDF_STATUS_QMI_TXN_WAIT_FAILED: QMI transaction wait failed
84  * @QDF_STATUS_MAX: not a real value just a place holder for max
85  */
86 typedef enum {
87 	QDF_STATUS_SUCCESS,
88 	QDF_STATUS_E_RESOURCES,
89 	QDF_STATUS_E_NOMEM,
90 	QDF_STATUS_E_AGAIN,
91 	QDF_STATUS_E_INVAL,
92 	QDF_STATUS_E_FAULT,
93 	QDF_STATUS_E_ALREADY,
94 	QDF_STATUS_E_BADMSG,
95 	QDF_STATUS_E_BUSY,
96 	QDF_STATUS_E_CANCELED,
97 	QDF_STATUS_E_ABORTED,
98 	QDF_STATUS_E_NOSUPPORT,
99 	QDF_STATUS_E_PERM,
100 	QDF_STATUS_E_EMPTY,
101 	QDF_STATUS_E_EXISTS,
102 	QDF_STATUS_E_TIMEOUT,
103 	QDF_STATUS_E_FAILURE,
104 	QDF_STATUS_E_NOENT,
105 	QDF_STATUS_E_E2BIG,
106 	QDF_STATUS_E_NOSPC,
107 	QDF_STATUS_E_ADDRNOTAVAIL,
108 	QDF_STATUS_E_ENXIO,
109 	QDF_STATUS_E_NETDOWN,
110 	QDF_STATUS_E_IO,
111 	QDF_STATUS_E_PENDING,
112 	QDF_STATUS_E_NETRESET,
113 	QDF_STATUS_E_SIG,
114 	QDF_STATUS_E_PROTO,
115 	QDF_STATUS_NOT_INITIALIZED,
116 	QDF_STATUS_E_NULL_VALUE,
117 	QDF_STATUS_HEARTBEAT_TMOUT,
118 	QDF_STATUS_NTH_BEACON_DELIVERY,
119 	QDF_STATUS_CSR_WRONG_STATE,
120 	QDF_STATUS_FT_PREAUTH_KEY_SUCCESS,
121 	QDF_STATUS_FT_PREAUTH_KEY_FAILED,
122 	QDF_STATUS_CMD_NOT_QUEUED,
123 	QDF_STATUS_FW_MSG_TIMEDOUT,
124 	QDF_STATUS_E_USB_ERROR,
125 	QDF_STATUS_MAXCOMP_FAIL,
126 	QDF_STATUS_COMP_DISABLED,
127 	QDF_STATUS_COMP_ASYNC,
128 	QDF_STATUS_CRYPTO_PN_ERROR,
129 	QDF_STATUS_CRYPTO_MIC_FAILURE,
130 	QDF_STATUS_CRYPTO_ENCRYPT_FAILED,
131 	QDF_STATUS_CRYPTO_DECRYPT_FAILED,
132 	QDF_STATUS_E_DEFRAG_ERROR,
133 	QDF_STATUS_E_RANGE,
134 	QDF_STATUS_E_GRO_DROP,
135 	QDF_STATUS_QMI_HANDLE_INIT_FAILED,
136 	QDF_STATUS_QMI_ADD_LOOKUP_FAILED,
137 	QDF_STATUS_QMI_SVC_CONNECT_FAILED,
138 	QDF_STATUS_QMI_TXN_INIT_FAILED,
139 	QDF_STATUS_QMI_SEND_REQ_FAILED,
140 	QDF_STATUS_QMI_TXN_WAIT_FAILED,
141 	QDF_STATUS_MAX
142 } QDF_STATUS;
143 
144 #define QDF_IS_STATUS_SUCCESS(status) (QDF_STATUS_SUCCESS == (status))
145 #define QDF_IS_STATUS_ERROR(status) (QDF_STATUS_SUCCESS != (status))
146 
147 /**
148  * qdf_status_to_os_return() - map a QDF_STATUS into an OS specific return code
149  * @status: QDF_STATUS to map
150  *
151  * Return: an OS specific error code
152  */
153 int qdf_status_to_os_return(QDF_STATUS status);
154 
155 /**
156  * qdf_status_from_os_return() - map an OS specific return code to a QDF_STATUS
157  * @rc: the input return code to map
158  *
159  * Return: QDF_STATUS
160  */
161 QDF_STATUS qdf_status_from_os_return(int rc);
162 
163 #endif /* __QDF_STATUS_H */
164 
165