RTErrConvertFromWin32.cpp@ 57529

Last change on this file since 57529 was 57358, checked in by vboxsync, 9 years ago
*: scm cleanup run.
Property svn:eol-style set to `native` Property svn:keywords set to `Id Revision`
File size: 19.3 KB

Line
1	/* $Id: RTErrConvertFromWin32.cpp 57358 2015-08-14 15:16:38Z vboxsync $ */
2	/** @file
3	* IPRT - Convert win32 error codes to iprt status codes.
4	*/
5
6	/*
7	* Copyright (C) 2006-2015 Oracle Corporation
8	*
9	* This file is part of VirtualBox Open Source Edition (OSE), as
10	* available from http://www.virtualbox.org. This file is free software;
11	* you can redistribute it and/or modify it under the terms of the GNU
12	* General Public License (GPL) as published by the Free Software
13	* Foundation, in version 2 as it comes in the "COPYING" file of the
14	* VirtualBox OSE distribution. VirtualBox OSE is distributed in the
15	* hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
16	*
17	* The contents of this file may alternatively be used under the terms
18	* of the Common Development and Distribution License Version 1.0
19	* (CDDL) only, as it comes in the "COPYING.CDDL" file of the
20	* VirtualBox OSE distribution, in which case the provisions of the
21	* CDDL are applicable instead of those of the GPL.
22	*
23	* You may elect to license modified versions of this file under the
24	* terms and conditions of either the GPL or the CDDL or both.
25	*/
26
27
28	/*********************************************************************************************************************************
29	* Header Files *
30	*********************************************************************************************************************************/
31	#include <Windows.h>
32
33	#include <iprt/err.h>
34	#include <iprt/assert.h>
35	#include <iprt/err.h>
36
37
38	RTR3DECL(int) RTErrConvertFromWin32(unsigned uNativeCode)
39	{
40	/* very fast check for no error. */
41	if (uNativeCode == ERROR_SUCCESS)
42	return(VINF_SUCCESS);
43
44	/* process error codes. */
45	switch (uNativeCode)
46	{
47	case ERROR_INVALID_FUNCTION: return VERR_INVALID_FUNCTION;
48	case ERROR_FILE_NOT_FOUND: return VERR_FILE_NOT_FOUND;
49	case ERROR_PATH_NOT_FOUND: return VERR_PATH_NOT_FOUND;
50	case ERROR_TOO_MANY_OPEN_FILES: return VERR_TOO_MANY_OPEN_FILES;
51	case ERROR_ACCESS_DENIED: return VERR_ACCESS_DENIED;
52	case ERROR_NOACCESS: return VERR_ACCESS_DENIED;
53
54	case ERROR_INVALID_HANDLE:
55	case ERROR_DIRECT_ACCESS_HANDLE: return VERR_INVALID_HANDLE;
56
57	case ERROR_NO_SYSTEM_RESOURCES: /** @todo better translation */
58	case ERROR_NOT_ENOUGH_MEMORY:
59	case ERROR_OUTOFMEMORY: return VERR_NO_MEMORY;
60
61	case ERROR_INVALID_DRIVE: return VERR_INVALID_DRIVE;
62	case ERROR_CURRENT_DIRECTORY: return VERR_CANT_DELETE_DIRECTORY;
63	case ERROR_NOT_SAME_DEVICE: return VERR_NOT_SAME_DEVICE;
64	case ERROR_NO_MORE_FILES: return VERR_NO_MORE_FILES;
65	case ERROR_WRITE_PROTECT: return VERR_WRITE_PROTECT;
66	case ERROR_BAD_UNIT: return VERR_IO_BAD_UNIT;
67	case ERROR_NOT_READY: return VERR_IO_NOT_READY;
68	case ERROR_BAD_COMMAND: return VERR_IO_BAD_COMMAND;
69	case ERROR_CRC: return VERR_IO_CRC;
70	case ERROR_BAD_LENGTH: return VERR_IO_BAD_LENGTH;
71	case ERROR_SEEK: return VERR_SEEK;
72	case ERROR_NOT_DOS_DISK: return VERR_DISK_INVALID_FORMAT;
73	case ERROR_SECTOR_NOT_FOUND: return VERR_IO_SECTOR_NOT_FOUND;
74	case ERROR_WRITE_FAULT: return VERR_WRITE_ERROR;
75	case ERROR_READ_FAULT: return VERR_READ_ERROR;
76	case ERROR_GEN_FAILURE: return VERR_IO_GEN_FAILURE;
77	case ERROR_SHARING_VIOLATION: return VERR_SHARING_VIOLATION;
78	case ERROR_LOCK_VIOLATION: return VERR_FILE_LOCK_VIOLATION;
79	case ERROR_HANDLE_EOF: return VERR_EOF;
80	case ERROR_NOT_LOCKED: return VERR_FILE_NOT_LOCKED;
81	case ERROR_DIR_NOT_EMPTY: return VERR_DIR_NOT_EMPTY;
82
83	case ERROR_HANDLE_DISK_FULL:
84	case ERROR_DISK_FULL: return VERR_DISK_FULL;
85
86	case ERROR_NOT_SUPPORTED: return VERR_NOT_SUPPORTED;
87
88	case ERROR_INVALID_PARAMETER:
89	case ERROR_BAD_ARGUMENTS:
90	case ERROR_INVALID_FLAGS: return VERR_INVALID_PARAMETER;
91
92	case ERROR_REM_NOT_LIST: return VERR_NET_IO_ERROR;
93
94	case ERROR_BAD_NETPATH:
95	case ERROR_NETNAME_DELETED: return VERR_NET_HOST_NOT_FOUND;
96
97	case ERROR_BAD_NET_NAME:
98	case ERROR_DEV_NOT_EXIST: return VERR_NET_PATH_NOT_FOUND;
99
100	case ERROR_NETWORK_BUSY:
101	case ERROR_TOO_MANY_CMDS:
102	case ERROR_TOO_MANY_NAMES:
103	case ERROR_TOO_MANY_SESS:
104	case ERROR_OUT_OF_STRUCTURES: return VERR_NET_OUT_OF_RESOURCES;
105
106	case ERROR_PRINTQ_FULL:
107	case ERROR_NO_SPOOL_SPACE:
108	case ERROR_PRINT_CANCELLED: return VERR_NET_PRINT_ERROR;
109
110	case ERROR_DUP_NAME:
111	case ERROR_ADAP_HDW_ERR:
112	case ERROR_BAD_NET_RESP:
113	case ERROR_UNEXP_NET_ERR:
114	case ERROR_BAD_REM_ADAP:
115	case ERROR_NETWORK_ACCESS_DENIED:
116	case ERROR_BAD_DEV_TYPE:
117	case ERROR_SHARING_PAUSED:
118	case ERROR_REQ_NOT_ACCEP:
119	case ERROR_REDIR_PAUSED:
120	case ERROR_ALREADY_ASSIGNED:
121	case ERROR_INVALID_PASSWORD:
122	case ERROR_NET_WRITE_FAULT: return VERR_NET_IO_ERROR;
123
124	case ERROR_FILE_EXISTS:
125	case ERROR_ALREADY_EXISTS: return VERR_ALREADY_EXISTS;
126
127	case ERROR_CANNOT_MAKE: return VERR_CANT_CREATE;
128	case ERROR_NO_PROC_SLOTS: return VERR_MAX_PROCS_REACHED;
129	case ERROR_TOO_MANY_SEMAPHORES: return VERR_TOO_MANY_SEMAPHORES;
130	case ERROR_EXCL_SEM_ALREADY_OWNED: return VERR_EXCL_SEM_ALREADY_OWNED;
131	case ERROR_SEM_IS_SET: return VERR_SEM_IS_SET;
132	case ERROR_TOO_MANY_SEM_REQUESTS: return VERR_TOO_MANY_SEM_REQUESTS;
133	case ERROR_SEM_OWNER_DIED: return VERR_SEM_OWNER_DIED;
134	case ERROR_DRIVE_LOCKED: return VERR_DRIVE_LOCKED;
135	case ERROR_BROKEN_PIPE: return VERR_BROKEN_PIPE;
136	case ERROR_OPEN_FAILED: return VERR_OPEN_FAILED;
137
138	case ERROR_BUFFER_OVERFLOW:
139	case ERROR_INSUFFICIENT_BUFFER: return VERR_BUFFER_OVERFLOW;
140
141	case ERROR_NO_MORE_SEARCH_HANDLES: return VERR_NO_MORE_SEARCH_HANDLES;
142
143	case ERROR_SEM_TIMEOUT:
144	case WAIT_TIMEOUT:
145	case ERROR_SERVICE_REQUEST_TIMEOUT:
146	case ERROR_COUNTER_TIMEOUT:
147	case ERROR_TIMEOUT: return VERR_TIMEOUT;
148
149	case ERROR_INVALID_NAME:
150	case ERROR_BAD_PATHNAME: return VERR_INVALID_NAME;
151
152	case ERROR_NEGATIVE_SEEK: return VERR_NEGATIVE_SEEK;
153	case ERROR_SEEK_ON_DEVICE: return VERR_SEEK_ON_DEVICE;
154
155	case ERROR_SIGNAL_REFUSED:
156	case ERROR_NO_SIGNAL_SENT: return VERR_SIGNAL_REFUSED;
157
158	case ERROR_SIGNAL_PENDING: return VERR_SIGNAL_PENDING;
159	case ERROR_MAX_THRDS_REACHED: return VERR_MAX_THRDS_REACHED;
160	case ERROR_LOCK_FAILED: return VERR_FILE_LOCK_FAILED;
161	case ERROR_SEM_NOT_FOUND: return VERR_SEM_NOT_FOUND;
162	case ERROR_FILENAME_EXCED_RANGE: return VERR_FILENAME_TOO_LONG;
163	case ERROR_INVALID_SIGNAL_NUMBER: return VERR_SIGNAL_INVALID;
164
165	case ERROR_BAD_PIPE: return VERR_BAD_PIPE;
166	case ERROR_PIPE_BUSY: return VERR_PIPE_BUSY;
167	case ERROR_NO_DATA: return VERR_NO_DATA;
168	case ERROR_PIPE_NOT_CONNECTED: return VERR_PIPE_NOT_CONNECTED;
169	case ERROR_MORE_DATA: return VERR_MORE_DATA;
170	case ERROR_NOT_OWNER: return VERR_NOT_OWNER;
171	case ERROR_TOO_MANY_POSTS: return VERR_TOO_MANY_POSTS;
172
173	case ERROR_PIPE_CONNECTED:
174	case ERROR_PIPE_LISTENING: return VERR_PIPE_IO_ERROR;
175
176	case ERROR_OPERATION_ABORTED: return VERR_INTERRUPTED;
177	case ERROR_NO_UNICODE_TRANSLATION: return VERR_NO_TRANSLATION;
178
179	case RPC_S_INVALID_STRING_UUID: return VERR_INVALID_UUID_FORMAT;
180
181	case ERROR_PROC_NOT_FOUND: return VERR_SYMBOL_NOT_FOUND;
182	case ERROR_MOD_NOT_FOUND: return VERR_MODULE_NOT_FOUND;
183
184	case ERROR_INVALID_EXE_SIGNATURE: return VERR_INVALID_EXE_SIGNATURE;
185	case ERROR_BAD_EXE_FORMAT: return VERR_BAD_EXE_FORMAT;
186	case ERROR_RESOURCE_DATA_NOT_FOUND: return VERR_NO_DATA; ///@todo fix ERROR_RESOURCE_DATA_NOT_FOUND translation
187	case ERROR_INVALID_ADDRESS: return VERR_INVALID_POINTER; ///@todo fix ERROR_INVALID_ADDRESS translation - dbghelp returns it on some line number queries.
188
189	case ERROR_CANCELLED: return VERR_CANCELLED;
190	case ERROR_USER_MAPPED_FILE: return VERR_SHARING_VIOLATION;
191	case ERROR_DIRECTORY: return VERR_NOT_A_DIRECTORY;
192
193	case ERROR_LOGON_FAILURE: return VERR_AUTHENTICATION_FAILURE;
194
195	/*
196	* Winsocket errors are mostly BSD errno.h wrappers.
197	* This is copied from RTErrConvertFromErrno() and checked against winsock.h.
198	* Please, keep things in sync!
199	*/
200	#ifdef WSAEPERM
201	case WSAEPERM: return VERR_ACCESS_DENIED; /* 1 */
202	#endif
203	#ifdef WSAENOENT
204	case WSAENOENT: return VERR_FILE_NOT_FOUND;
205	#endif
206	#ifdef WSAESRCH
207	case WSAESRCH: return VERR_PROCESS_NOT_FOUND;
208	#endif
209	case WSAEINTR: return VERR_INTERRUPTED;
210	#ifdef WSAEIO
211	case WSAEIO: return VERR_DEV_IO_ERROR;
212	#endif
213	#ifdef WSAE2BIG
214	case WSAE2BIG: return VERR_TOO_MUCH_DATA;
215	#endif
216	#ifdef WSAENOEXEC
217	case WSAENOEXEC: return VERR_BAD_EXE_FORMAT;
218	#endif
219	case WSAEBADF: return VERR_INVALID_HANDLE;
220	#ifdef WSAECHILD
221	case WSAECHILD: return VERR_PROCESS_NOT_FOUND; //... /* 10 */
222	#endif
223	case WSAEWOULDBLOCK: return VERR_TRY_AGAIN; /* EAGAIN */
224	#ifdef WSAENOMEM
225	case WSAENOMEM: return VERR_NO_MEMORY;
226	#endif
227	case WSAEACCES: return VERR_ACCESS_DENIED;
228	case WSAEFAULT: return VERR_INVALID_POINTER;
229	//case WSAENOTBLK: return VERR_;
230	#ifdef WSAEBUSY
231	case WSAEBUSY: return VERR_DEV_IO_ERROR;
232	#endif
233	#ifdef WSAEEXIST
234	case WSAEEXIST: return VERR_ALREADY_EXISTS;
235	#endif
236	//case WSAEXDEV:
237	#ifdef WSAENODEV
238	case WSAENODEV: return VERR_NOT_SUPPORTED;
239	#endif
240	#ifdef WSAENOTDIR
241	case WSAENOTDIR: return VERR_PATH_NOT_FOUND; /* 20 */
242	#endif
243	#ifdef WSAEISDIR
244	case WSAEISDIR: return VERR_FILE_NOT_FOUND;
245	#endif
246	case WSAEINVAL: return VERR_INVALID_PARAMETER;
247	#ifdef WSAENFILE
248	case WSAENFILE: return VERR_TOO_MANY_OPEN_FILES;
249	#endif
250	case WSAEMFILE: return VERR_TOO_MANY_OPEN_FILES;
251	#ifdef WSAENOTTY
252	case WSAENOTTY: return VERR_INVALID_FUNCTION;
253	#endif
254	#ifdef WSAETXTBSY
255	case WSAETXTBSY: return VERR_SHARING_VIOLATION;
256	#endif
257	//case WSAEFBIG:
258	#ifdef WSAENOSPC
259	case WSAENOSPC: return VERR_DISK_FULL;
260	#endif
261	#ifdef WSAESPIPE
262	case WSAESPIPE: return VERR_SEEK_ON_DEVICE;
263	#endif
264	#ifdef WSAEROFS
265	case WSAEROFS: return VERR_WRITE_PROTECT; /* 30 */
266	#endif
267	//case WSAEMLINK:
268	#ifdef WSAEPIPE
269	case WSAEPIPE: return VERR_BROKEN_PIPE;
270	#endif
271	#ifdef WSAEDOM
272	case WSAEDOM: return VERR_INVALID_PARAMETER;
273	#endif
274	#ifdef WSAERANGE
275	case WSAERANGE: return VERR_INVALID_PARAMETER;
276	#endif
277	#ifdef WSAEDEADLK
278	case WSAEDEADLK: return VERR_DEADLOCK;
279	#endif
280	case WSAENAMETOOLONG: return VERR_FILENAME_TOO_LONG;
281	#ifdef WSAENOLCK
282	case WSAENOLCK: return VERR_FILE_LOCK_FAILED;
283	#endif
284	#ifdef WSAENOSYS
285	case WSAENOSYS: return VERR_NOT_SUPPORTED;
286	#endif
287	case WSAENOTEMPTY: return VERR_CANT_DELETE_DIRECTORY;
288	case WSAELOOP: return VERR_TOO_MANY_SYMLINKS; /* 40 */
289	//case WSAENOMSG 42 /* No message of desired type */
290	//case WSAEIDRM 43 /* Identifier removed */
291	//case WSAECHRNG 44 /* Channel number out of range */
292	//case WSAEL2NSYNC 45 /* Level 2 not synchronized */
293	//case WSAEL3HLT 46 /* Level 3 halted */
294	//case WSAEL3RST 47 /* Level 3 reset */
295	//case WSAELNRNG 48 /* Link number out of range */
296	//case WSAEUNATCH 49 /* Protocol driver not attached */
297	//case WSAENOCSI 50 /* No CSI structure available */
298	//case WSAEL2HLT 51 /* Level 2 halted */
299	//case WSAEBADE 52 /* Invalid exchange */
300	//case WSAEBADR 53 /* Invalid request descriptor */
301	//case WSAEXFULL 54 /* Exchange full */
302	//case WSAENOANO 55 /* No anode */
303	//case WSAEBADRQC 56 /* Invalid request code */
304	//case WSAEBADSLT 57 /* Invalid slot */
305	//case 58:
306	//case WSAEBFONT 59 /* Bad font file format */
307	//case WSAENOSTR 60 /* Device not a stream */
308	#ifdef WSAENODATA
309	case WSAENODATA: return VERR_NO_DATA;
310	#endif
311	//case WSAETIME 62 /* Timer expired */
312	//case WSAENOSR 63 /* Out of streams resources */
313	#ifdef WSAENONET
314	case WSAENONET: return VERR_NET_NO_NETWORK;
315	#endif
316	//case WSAENOPKG 65 /* Package not installed */
317	//case WSAEREMOTE 66 /* Object is remote */
318	//case WSAENOLINK 67 /* Link has been severed */
319	//case WSAEADV 68 /* Advertise error */
320	//case WSAESRMNT 69 /* Srmount error */
321	//case WSAECOMM 70 /* Communication error on send */
322	//case WSAEPROTO 71 /* Protocol error */
323	//case WSAEMULTIHOP 72 /* Multihop attempted */
324	//case WSAEDOTDOT 73 /* RFS specific error */
325	//case WSAEBADMSG 74 /* Not a data message */
326	#ifdef WSAEOVERFLOW
327	case WSAEOVERFLOW: return VERR_TOO_MUCH_DATA;
328	#endif
329	#ifdef WSAENOTUNIQ
330	case WSAENOTUNIQ: return VERR_NET_NOT_UNIQUE_NAME;
331	#endif
332	#ifdef WSAEBADFD
333	case WSAEBADFD: return VERR_INVALID_HANDLE;
334	#endif
335	//case WSAEREMCHG 78 /* Remote address changed */
336	//case WSAELIBACC 79 /* Can not access a needed shared library */
337	//case WSAELIBBAD 80 /* Accessing a corrupted shared library */
338	//case WSAELIBSCN 81 /* .lib section in a.out corrupted */
339	//case WSAELIBMAX 82 /* Attempting to link in too many shared libraries */
340	//case WSAELIBEXEC 83 /* Cannot exec a shared library directly */
341	#ifdef WSAEILSEQ
342	case WSAEILSEQ: return VERR_NO_TRANSLATION;
343	#endif
344	#ifdef WSAERESTART
345	case WSAERESTART: return VERR_INTERRUPTED;
346	#endif
347	//case WSAESTRPIPE 86 /* Streams pipe error */
348	//case WSAEUSERS 87 /* Too many users */
349	case WSAENOTSOCK: return VERR_NET_NOT_SOCKET;
350	case WSAEDESTADDRREQ: return VERR_NET_DEST_ADDRESS_REQUIRED;
351	case WSAEMSGSIZE: return VERR_NET_MSG_SIZE;
352	case WSAEPROTOTYPE: return VERR_NET_PROTOCOL_TYPE;
353	case WSAENOPROTOOPT: return VERR_NET_PROTOCOL_NOT_AVAILABLE;
354	case WSAEPROTONOSUPPORT: return VERR_NET_PROTOCOL_NOT_SUPPORTED;
355	case WSAESOCKTNOSUPPORT: return VERR_NET_SOCKET_TYPE_NOT_SUPPORTED;
356	case WSAEOPNOTSUPP: return VERR_NET_OPERATION_NOT_SUPPORTED;
357	case WSAEPFNOSUPPORT: return VERR_NET_PROTOCOL_FAMILY_NOT_SUPPORTED;
358	case WSAEAFNOSUPPORT: return VERR_NET_ADDRESS_FAMILY_NOT_SUPPORTED;
359	case WSAEADDRINUSE: return VERR_NET_ADDRESS_IN_USE;
360	case WSAEADDRNOTAVAIL: return VERR_NET_ADDRESS_NOT_AVAILABLE;
361	case WSAENETDOWN: return VERR_NET_DOWN;
362	case WSAENETUNREACH: return VERR_NET_UNREACHABLE;
363	case WSAENETRESET: return VERR_NET_CONNECTION_RESET;
364	case WSAECONNABORTED: return VERR_NET_CONNECTION_ABORTED;
365	case WSAECONNRESET: return VERR_NET_CONNECTION_RESET_BY_PEER;
366	case WSAENOBUFS: return VERR_NET_NO_BUFFER_SPACE;
367	case WSAEISCONN: return VERR_NET_ALREADY_CONNECTED;
368	case WSAENOTCONN: return VERR_NET_NOT_CONNECTED;
369	case WSAESHUTDOWN: return VERR_NET_SHUTDOWN;
370	case WSAETOOMANYREFS: return VERR_NET_TOO_MANY_REFERENCES;
371	case WSAETIMEDOUT: return VERR_TIMEOUT;
372	case WSAECONNREFUSED: return VERR_NET_CONNECTION_REFUSED;
373	case WSAEHOSTDOWN: return VERR_NET_HOST_DOWN;
374	case WSAEHOSTUNREACH: return VERR_NET_HOST_UNREACHABLE;
375	case WSAEALREADY: return VERR_NET_ALREADY_IN_PROGRESS;
376	case WSAEINPROGRESS: return VERR_NET_IN_PROGRESS;
377	//case WSAESTALE 116 /* Stale NFS file handle */
378	//case WSAEUCLEAN 117 /* Structure needs cleaning */
379	//case WSAENOTNAM 118 /* Not a XENIX named type file */
380	//case WSAENAVAIL 119 /* No XENIX semaphores available */
381	//case WSAEISNAM 120 /* Is a named type file */
382	//case WSAEREMOTEIO 121 /* Remote I/O error */
383	case WSAEDQUOT: return VERR_DISK_FULL;
384	#ifdef WSAENOMEDIUM
385	case WSAENOMEDIUM: return VERR_MEDIA_NOT_PRESENT;
386	#endif
387	#ifdef WSAEMEDIUMTYPE
388	case WSAEMEDIUMTYPE: return VERR_MEDIA_NOT_RECOGNIZED;
389	#endif
390	case WSAEPROCLIM: return VERR_MAX_PROCS_REACHED;
391
392	//case WSAEDISCON: (WSABASEERR+101)
393	//case WSASYSNOTREADY (WSABASEERR+91)
394	//case WSAVERNOTSUPPORTED (WSABASEERR+92)
395	//case WSANOTINITIALISED (WSABASEERR+93)
396
397	#ifdef WSAHOST_NOT_FOUND
398	case WSAHOST_NOT_FOUND: return VERR_NET_HOST_NOT_FOUND;
399	#endif
400	#ifdef WSATRY_AGAIN
401	case WSATRY_AGAIN: return VERR_TRY_AGAIN;
402	#endif
403	#ifndef WSANO_RECOVERY
404	case WSANO_RECOVERY: return VERR_IO_GEN_FAILURE;
405	#endif
406	#ifdef WSANO_DATA
407	case WSANO_DATA: return VERR_NET_ADDRESS_NOT_AVAILABLE;
408	#endif
409
410
411	#ifndef ERROR_NOT_A_REPARSE_POINT
412	# define ERROR_NOT_A_REPARSE_POINT 0x1126
413	#endif
414	case ERROR_NOT_A_REPARSE_POINT: return VERR_NOT_SYMLINK;
415
416	case NTE_BAD_ALGID: return VERR_CR_PKIX_UNKNOWN_DIGEST_TYPE;
417	}
418
419	/* unknown error. */
420	#ifndef DEBUG_dmik
421	AssertMsgFailed(("Unhandled error %u\n", uNativeCode));
422	#endif
423	return VERR_UNRESOLVED_ERROR;
424	}
425

Note: See TracBrowser for help on using the repository browser.

source: vbox/trunk/src/VBox/Runtime/win/RTErrConvertFromWin32.cpp@ 57529

Download in other formats: