xref: /wlan-dirver/qca-wifi-host-cmn/qdf/inc/qdf_status.h (revision dd5f5c1afa4ab969b68717be955752f19527fb17)
1 /*
2  * Copyright (c) 2014-2020 The Linux Foundation. All rights reserved.
3  * Copyright (c) 2022-2023 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_E_RESTART: return error code for wait_event_interruptible
79  * @QDF_STATUS_FILT_REQ_ERROR: return error code cee filter rule request
80  * @QDF_STATUS_TDLS_MLO_SYNC: tdls mlo sync
81  * @QDF_STATUS_MAX: not a real value just a place holder for max
82  */
83 typedef enum {
84 	QDF_STATUS_SUCCESS,
85 	QDF_STATUS_E_RESOURCES,
86 	QDF_STATUS_E_NOMEM,
87 	QDF_STATUS_E_AGAIN,
88 	QDF_STATUS_E_INVAL,
89 	QDF_STATUS_E_FAULT,
90 	QDF_STATUS_E_ALREADY,
91 	QDF_STATUS_E_BADMSG,
92 	QDF_STATUS_E_BUSY,
93 	QDF_STATUS_E_CANCELED,
94 	QDF_STATUS_E_ABORTED,
95 	QDF_STATUS_E_NOSUPPORT,
96 	QDF_STATUS_E_PERM,
97 	QDF_STATUS_E_EMPTY,
98 	QDF_STATUS_E_EXISTS,
99 	QDF_STATUS_E_TIMEOUT,
100 	QDF_STATUS_E_FAILURE,
101 	QDF_STATUS_E_NOENT,
102 	QDF_STATUS_E_E2BIG,
103 	QDF_STATUS_E_NOSPC,
104 	QDF_STATUS_E_ADDRNOTAVAIL,
105 	QDF_STATUS_E_ENXIO,
106 	QDF_STATUS_E_NETDOWN,
107 	QDF_STATUS_E_IO,
108 	QDF_STATUS_E_PENDING,
109 	QDF_STATUS_E_NETRESET,
110 	QDF_STATUS_E_SIG,
111 	QDF_STATUS_E_PROTO,
112 	QDF_STATUS_NOT_INITIALIZED,
113 	QDF_STATUS_E_NULL_VALUE,
114 	QDF_STATUS_HEARTBEAT_TMOUT,
115 	QDF_STATUS_NTH_BEACON_DELIVERY,
116 	QDF_STATUS_CSR_WRONG_STATE,
117 	QDF_STATUS_FT_PREAUTH_KEY_SUCCESS,
118 	QDF_STATUS_FT_PREAUTH_KEY_FAILED,
119 	QDF_STATUS_CMD_NOT_QUEUED,
120 	QDF_STATUS_FW_MSG_TIMEDOUT,
121 	QDF_STATUS_E_USB_ERROR,
122 	QDF_STATUS_MAXCOMP_FAIL,
123 	QDF_STATUS_COMP_DISABLED,
124 	QDF_STATUS_COMP_ASYNC,
125 	QDF_STATUS_CRYPTO_PN_ERROR,
126 	QDF_STATUS_CRYPTO_MIC_FAILURE,
127 	QDF_STATUS_CRYPTO_ENCRYPT_FAILED,
128 	QDF_STATUS_CRYPTO_DECRYPT_FAILED,
129 	QDF_STATUS_E_DEFRAG_ERROR,
130 	QDF_STATUS_E_RANGE,
131 	QDF_STATUS_E_GRO_DROP,
132 	QDF_STATUS_E_RESTART,
133 	QDF_STATUS_FILT_REQ_ERROR,
134 	QDF_STATUS_TDLS_MLO_SYNC,
135 	QDF_STATUS_MAX
136 } QDF_STATUS;
137 
138 #define QDF_IS_STATUS_SUCCESS(status) (QDF_STATUS_SUCCESS == (status))
139 #define QDF_IS_STATUS_ERROR(status) (QDF_STATUS_SUCCESS != (status))
140 
141 /**
142  * qdf_status_to_os_return() - map a QDF_STATUS into an OS specific return code
143  * @status: QDF_STATUS to map
144  *
145  * Return: an OS specific error code
146  */
147 int qdf_status_to_os_return(QDF_STATUS status);
148 
149 /**
150  * qdf_status_from_os_return() - map an OS specific return code to a QDF_STATUS
151  * @rc: the input return code to map
152  *
153  * Return: QDF_STATUS
154  */
155 QDF_STATUS qdf_status_from_os_return(int rc);
156 
157 #endif /* __QDF_STATUS_H */
158 
159