err.h@ 18555

Last change on this file since 18555 was 18342, checked in by vboxsync, 16 years ago
iprt/err.h: Created a group for internal processing error codes since we're rapidly running out of space in the generic range.
Property svn:eol-style set to `native` Property svn:keywords set to `Author Date Id Revision`
File size: 37.0 KB

Line
1	/** @file
2	* IPRT - Status Codes.
3	*/
4
5	/*
6	* Copyright (C) 2006-2007 Sun Microsystems, Inc.
7	*
8	* This file is part of VirtualBox Open Source Edition (OSE), as
9	* available from http://www.virtualbox.org. This file is free software;
10	* you can redistribute it and/or modify it under the terms of the GNU
11	* General Public License (GPL) as published by the Free Software
12	* Foundation, in version 2 as it comes in the "COPYING" file of the
13	* VirtualBox OSE distribution. VirtualBox OSE is distributed in the
14	* hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
15	*
16	* The contents of this file may alternatively be used under the terms
17	* of the Common Development and Distribution License Version 1.0
18	* (CDDL) only, as it comes in the "COPYING.CDDL" file of the
19	* VirtualBox OSE distribution, in which case the provisions of the
20	* CDDL are applicable instead of those of the GPL.
21	*
22	* You may elect to license modified versions of this file under the
23	* terms and conditions of either the GPL or the CDDL or both.
24	*
25	* Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa
26	* Clara, CA 95054 USA or visit http://www.sun.com if you need
27	* additional information or have any questions.
28	*/
29
30	#ifndef ___iprt_err_h
31	#define ___iprt_err_h
32
33	#include <iprt/cdefs.h>
34	#include <iprt/types.h>
35
36	__BEGIN_DECLS
37
38	/** @defgroup grp_rt_err RTErr - Status Codes
39	* @ingroup grp_rt
40	* @{
41	*/
42
43	/** @defgroup grp_rt_err_hlp Status Code Helpers
44	* @ingroup grp_rt_err
45	* @{
46	*/
47
48	/** @def RT_SUCCESS
49	* Check for success. We expect success in normal cases, that is the code path depending on
50	* this check is normally taken. To prevent any prediction use RT_SUCCESS_NP instead.
51	*
52	* @returns true if rc indicates success.
53	* @returns false if rc indicates failure.
54	*
55	* @param rc The iprt status code to test.
56	*/
57	#define RT_SUCCESS(rc) ( RT_LIKELY((int)(rc) >= VINF_SUCCESS) )
58
59	/** @def RT_SUCCESS_NP
60	* Check for success. Don't predict the result.
61	*
62	* @returns true if rc indicates success.
63	* @returns false if rc indicates failure.
64	*
65	* @param rc The iprt status code to test.
66	*/
67	#define RT_SUCCESS_NP(rc) ( (int)(rc) >= VINF_SUCCESS )
68
69	/** @def RT_FAILURE
70	* Check for failure. We don't expect in normal cases, that is the code path depending on
71	* this check is normally NOT taken. To prevent any prediction use RT_FAILURE_NP instead.
72	*
73	* @returns true if rc indicates failure.
74	* @returns false if rc indicates success.
75	*
76	* @param rc The iprt status code to test.
77	*/
78	#define RT_FAILURE(rc) ( RT_UNLIKELY(!RT_SUCCESS_NP(rc)) )
79
80	/** @def RT_FAILURE_NP
81	* Check for failure. Don't predict the result.
82	*
83	* @returns true if rc indicates failure.
84	* @returns false if rc indicates success.
85	*
86	* @param rc The iprt status code to test.
87	*/
88	#define RT_FAILURE_NP(rc) ( !RT_SUCCESS_NP(rc) )
89
90	/**
91	* Converts a Darwin HRESULT error to an iprt status code.
92	*
93	* @returns iprt status code.
94	* @param iNativeCode HRESULT error code.
95	* @remark Darwin ring-3 only.
96	*/
97	RTDECL(int) RTErrConvertFromDarwinCOM(int32_t iNativeCode);
98
99	/**
100	* Converts a Darwin IOReturn error to an iprt status code.
101	*
102	* @returns iprt status code.
103	* @param iNativeCode IOReturn error code.
104	* @remark Darwin only.
105	*/
106	RTDECL(int) RTErrConvertFromDarwinIO(int iNativeCode);
107
108	/**
109	* Converts a Darwin kern_return_t error to an iprt status code.
110	*
111	* @returns iprt status code.
112	* @param iNativeCode kern_return_t error code.
113	* @remark Darwin only.
114	*/
115	RTDECL(int) RTErrConvertFromDarwinKern(int iNativeCode);
116
117	/**
118	* Converts a Darwin error to an iprt status code.
119	*
120	* This will consult RTErrConvertFromDarwinKern, RTErrConvertFromDarwinIO
121	* and RTErrConvertFromDarwinCOM in this order. The latter is ring-3 only as it
122	* doesn't apply elsewhere.
123	*
124	* @returns iprt status code.
125	* @param iNativeCode Darwin error code.
126	* @remarks Darwin only.
127	* @remarks This is recommended over RTErrConvertFromDarwinKern and RTErrConvertFromDarwinIO
128	* since these are really just subsets of the same error space.
129	*/
130	RTDECL(int) RTErrConvertFromDarwin(int iNativeCode);
131
132	/**
133	* Converts errno to iprt status code.
134	*
135	* @returns iprt status code.
136	* @param uNativeCode errno code.
137	*/
138	RTDECL(int) RTErrConvertFromErrno(unsigned uNativeCode);
139
140	/**
141	* Converts a L4 errno to a iprt status code.
142	*
143	* @returns iprt status code.
144	* @param uNativeCode l4 errno.
145	* @remark L4 only.
146	*/
147	RTDECL(int) RTErrConvertFromL4Errno(unsigned uNativeCode);
148
149	/**
150	* Converts NT status code to iprt status code.
151	*
152	* Needless to say, this is only available on NT and winXX targets.
153	*
154	* @returns iprt status code.
155	* @param lNativeCode NT status code.
156	* @remark Windows only.
157	*/
158	RTDECL(int) RTErrConvertFromNtStatus(long lNativeCode);
159
160	/**
161	* Converts OS/2 error code to iprt status code.
162	*
163	* @returns iprt status code.
164	* @param uNativeCode OS/2 error code.
165	* @remark OS/2 only.
166	*/
167	RTDECL(int) RTErrConvertFromOS2(unsigned uNativeCode);
168
169	/**
170	* Converts Win32 error code to iprt status code.
171	*
172	* @returns iprt status code.
173	* @param uNativeCode Win32 error code.
174	* @remark Windows only.
175	*/
176	RTDECL(int) RTErrConvertFromWin32(unsigned uNativeCode);
177
178	/**
179	* Converts an iprt status code to a errno status code.
180	*
181	* @returns errno status code.
182	* @param iErr iprt status code.
183	*/
184	RTDECL(int) RTErrConvertToErrno(int iErr);
185
186
187	#ifdef IN_RING3
188
189	/**
190	* iprt status code message.
191	*/
192	typedef struct RTSTATUSMSG
193	{
194	/** Pointer to the short message string. */
195	const char *pszMsgShort;
196	/** Pointer to the full message string. */
197	const char *pszMsgFull;
198	/** Pointer to the define string. */
199	const char *pszDefine;
200	/** Status code number. */
201	int iCode;
202	} RTSTATUSMSG;
203	/** Pointer to iprt status code message. */
204	typedef RTSTATUSMSG *PRTSTATUSMSG;
205	/** Pointer to const iprt status code message. */
206	typedef const RTSTATUSMSG *PCRTSTATUSMSG;
207
208	/**
209	* Get the message structure corresponding to a given iprt status code.
210	*
211	* @returns Pointer to read-only message description.
212	* @param rc The status code.
213	*/
214	RTDECL(PCRTSTATUSMSG) RTErrGet(int rc);
215
216	/**
217	* Get the define corresponding to a given iprt status code.
218	*
219	* @returns Pointer to read-only string with the \#define identifier.
220	* @param rc The status code.
221	*/
222	#define RTErrGetDefine(rc) (RTErrGet(rc)->pszDefine)
223
224	/**
225	* Get the short description corresponding to a given iprt status code.
226	*
227	* @returns Pointer to read-only string with the description.
228	* @param rc The status code.
229	*/
230	#define RTErrGetShort(rc) (RTErrGet(rc)->pszMsgShort)
231
232	/**
233	* Get the full description corresponding to a given iprt status code.
234	*
235	* @returns Pointer to read-only string with the description.
236	* @param rc The status code.
237	*/
238	#define RTErrGetFull(rc) (RTErrGet(rc)->pszMsgFull)
239
240	#ifdef RT_OS_WINDOWS
241	/**
242	* Windows error code message.
243	*/
244	typedef struct RTWINERRMSG
245	{
246	/** Pointer to the full message string. */
247	const char *pszMsgFull;
248	/** Pointer to the define string. */
249	const char *pszDefine;
250	/** Error code number. */
251	long iCode;
252	} RTWINERRMSG;
253	/** Pointer to Windows error code message. */
254	typedef RTWINERRMSG *PRTWINERRMSG;
255	/** Pointer to const Windows error code message. */
256	typedef const RTWINERRMSG *PCRTWINERRMSG;
257
258	/**
259	* Get the message structure corresponding to a given Windows error code.
260	*
261	* @returns Pointer to read-only message description.
262	* @param rc The status code.
263	*/
264	RTDECL(PCRTWINERRMSG) RTErrWinGet(long rc);
265
266	/** On windows COM errors are part of the Windows error database. */
267	typedef RTWINERRMSG RTCOMERRMSG;
268
269	#else /* !RT_OS_WINDOWS */
270
271	/**
272	* COM/XPCOM error code message.
273	*/
274	typedef struct RTCOMERRMSG
275	{
276	/** Pointer to the full message string. */
277	const char *pszMsgFull;
278	/** Pointer to the define string. */
279	const char *pszDefine;
280	/** Error code number. */
281	uint32_t iCode;
282	} RTCOMERRMSG;
283	#endif /* !RT_OS_WINDOWS */
284	/** Pointer to a XPCOM/COM error code message. */
285	typedef RTCOMERRMSG *PRTCOMERRMSG;
286	/** Pointer to const a XPCOM/COM error code message. */
287	typedef const RTCOMERRMSG *PCRTCOMERRMSG;
288
289	/**
290	* Get the message structure corresponding to a given COM/XPCOM error code.
291	*
292	* @returns Pointer to read-only message description.
293	* @param rc The status code.
294	*/
295	RTDECL(PCRTCOMERRMSG) RTErrCOMGet(uint32_t rc);
296
297	#endif /* IN_RING3 */
298
299	/** @} */
300
301
302	/* SED-START */
303
304	/** @name Misc. Status Codes
305	* @{
306	*/
307	/** Success. */
308	#define VINF_SUCCESS 0
309
310	/** General failure - DON'T USE THIS!!! */
311	#define VERR_GENERAL_FAILURE (-1)
312	/** Invalid parameter. */
313	#define VERR_INVALID_PARAMETER (-2)
314	/** Invalid parameter. */
315	#define VWRN_INVALID_PARAMETER 2
316	/** Invalid magic or cookie. */
317	#define VERR_INVALID_MAGIC (-3)
318	/** Invalid magic or cookie. */
319	#define VWRN_INVALID_MAGIC 3
320	/** Invalid loader handle. */
321	#define VERR_INVALID_HANDLE (-4)
322	/** Invalid loader handle. */
323	#define VWRN_INVALID_HANDLE 4
324	/** Failed to lock the address range. */
325	#define VERR_LOCK_FAILED (-5)
326	/** Invalid memory pointer. */
327	#define VERR_INVALID_POINTER (-6)
328	/** Failed to patch the IDT. */
329	#define VERR_IDT_FAILED (-7)
330	/** Memory allocation failed. */
331	#define VERR_NO_MEMORY (-8)
332	/** Already loaded. */
333	#define VERR_ALREADY_LOADED (-9)
334	/** Permission denied. */
335	#define VERR_PERMISSION_DENIED (-10)
336	/** Version mismatch. */
337	#define VERR_VERSION_MISMATCH (-11)
338	/** The request function is not implemented. */
339	#define VERR_NOT_IMPLEMENTED (-12)
340
341	/** Failed to allocate temporary memory. */
342	#define VERR_NO_TMP_MEMORY (-20)
343	/** Invalid file mode mask (RTFMODE). */
344	#define VERR_INVALID_FMODE (-21)
345	/** Incorrect call order. */
346	#define VERR_WRONG_ORDER (-22)
347	/** There is no TLS (thread local storage) available for storing the current thread. */
348	#define VERR_NO_TLS_FOR_SELF (-23)
349	/** Failed to set the TLS (thread local storage) entry which points to our thread structure. */
350	#define VERR_FAILED_TO_SET_SELF_TLS (-24)
351	/** Not able to allocate contiguous memory. */
352	#define VERR_NO_CONT_MEMORY (-26)
353	/** No memory available for page table or page directory. */
354	#define VERR_NO_PAGE_MEMORY (-27)
355	/** Already initialized. */
356	#define VINF_ALREADY_INITIALIZED 28
357	/** The specified thread is dead. */
358	#define VERR_THREAD_IS_DEAD (-29)
359	/** The specified thread is not waitable. */
360	#define VERR_THREAD_NOT_WAITABLE (-30)
361	/** Pagetable not present. */
362	#define VERR_PAGE_TABLE_NOT_PRESENT (-31)
363
364	/** The per process timer is busy. */
365	#define VERR_TIMER_BUSY (-33)
366	/** Address conflict. */
367	#define VERR_ADDRESS_CONFLICT (-34)
368	/** Unresolved (unknown) host platform error. */
369	#define VERR_UNRESOLVED_ERROR (-35)
370	/** Invalid function. */
371	#define VERR_INVALID_FUNCTION (-36)
372	/** Not supported. */
373	#define VERR_NOT_SUPPORTED (-37)
374	/** Access denied. */
375	#define VERR_ACCESS_DENIED (-38)
376	/** Call interrupted. */
377	#define VERR_INTERRUPTED (-39)
378	/** Timeout. */
379	#define VERR_TIMEOUT (-40)
380	/** Buffer too small to save result. */
381	#define VERR_BUFFER_OVERFLOW (-41)
382	/** Buffer too small to save result. */
383	#define VINF_BUFFER_OVERFLOW 41
384	/** Data size overflow. */
385	#define VERR_TOO_MUCH_DATA (-42)
386	/** Max threads number reached. */
387	#define VERR_MAX_THRDS_REACHED (-43)
388	/** Max process number reached. */
389	#define VERR_MAX_PROCS_REACHED (-44)
390	/** The recipient process has refused the signal. */
391	#define VERR_SIGNAL_REFUSED (-45)
392	/** A signal is already pending. */
393	#define VERR_SIGNAL_PENDING (-46)
394	/** The signal being posted is not correct. */
395	#define VERR_SIGNAL_INVALID (-47)
396	/** The state changed.
397	* This is a generic error message and needs a context to make sense. */
398	#define VERR_STATE_CHANGED (-48)
399	/** Warning, the state changed.
400	* This is a generic error message and needs a context to make sense. */
401	#define VWRN_STATE_CHANGED 48
402	/** Error while parsing UUID string */
403	#define VERR_INVALID_UUID_FORMAT (-49)
404	/** The specified process was not found. */
405	#define VERR_PROCESS_NOT_FOUND (-50)
406	/** The process specified to a non-block wait had not exitted. */
407	#define VERR_PROCESS_RUNNING (-51)
408	/** Retry the operation. */
409	#define VERR_TRY_AGAIN (-52)
410	/** Retry the operation. */
411	#define VINF_TRY_AGAIN 52
412	/** Generic parse error. */
413	#define VERR_PARSE_ERROR (-53)
414	/** Value out of range. */
415	#define VERR_OUT_OF_RANGE (-54)
416	/** A numeric convertion encountered a value which was too big for the target. */
417	#define VERR_NUMBER_TOO_BIG (-55)
418	/** A numeric convertion encountered a value which was too big for the target. */
419	#define VWRN_NUMBER_TOO_BIG 55
420	/** The number begin converted (string) contained no digits. */
421	#define VERR_NO_DIGITS (-56)
422	/** The number begin converted (string) contained no digits. */
423	#define VWRN_NO_DIGITS 56
424	/** Encountered a '-' during convertion to an unsigned value. */
425	#define VERR_NEGATIVE_UNSIGNED (-57)
426	/** Encountered a '-' during convertion to an unsigned value. */
427	#define VWRN_NEGATIVE_UNSIGNED 57
428	/** Error while characters translation (unicode and so). */
429	#define VERR_NO_TRANSLATION (-58)
430	/** Encountered unicode code point which is reserved for use as endian indicator (0xffff or 0xfffe). */
431	#define VERR_CODE_POINT_ENDIAN_INDICATOR (-59)
432	/** Encountered unicode code point in the surrogate range (0xd800 to 0xdfff). */
433	#define VERR_CODE_POINT_SURROGATE (-60)
434	/** A string claiming to be UTF-8 is incorrectly encoded. */
435	#define VERR_INVALID_UTF8_ENCODING (-61)
436	/** Ad string claiming to be in UTF-16 is incorrectly encoded. */
437	#define VERR_INVALID_UTF16_ENCODING (-62)
438	/** Encountered a unicode code point which cannot be represented as UTF-16. */
439	#define VERR_CANT_RECODE_AS_UTF16 (-63)
440	/** Got an out of memory condition trying to allocate a string. */
441	#define VERR_NO_STR_MEMORY (-64)
442	/** Got an out of memory condition trying to allocate a UTF-16 (/UCS-2) string. */
443	#define VERR_NO_UTF16_MEMORY (-65)
444	/** Get an out of memory condition trying to allocate a code point array. */
445	#define VERR_NO_CODE_POINT_MEMORY (-66)
446	/** Can't free the memory because it's used in mapping. */
447	#define VERR_MEMORY_BUSY (-67)
448	/** The timer can't be started because it's already active. */
449	#define VERR_TIMER_ACTIVE (-68)
450	/** The timer can't be stopped because i's already suspended. */
451	#define VERR_TIMER_SUSPENDED (-69)
452	/** The operation was cancelled by the user (copy) or another thread (local ipc). */
453	#define VERR_CANCELLED (-70)
454	/** Failed to initialize a memory object.
455	* Exactly what this means is OS specific. */
456	#define VERR_MEMOBJ_INIT_FAILED (-71)
457	/** Out of memory condition when allocating memory with low physical backing. */
458	#define VERR_NO_LOW_MEMORY (-72)
459	/** Out of memory condition when allocating physical memory (without mapping). */
460	#define VERR_NO_PHYS_MEMORY (-73)
461	/** The address (virtual or physical) is too big. */
462	#define VERR_ADDRESS_TOO_BIG (-74)
463	/** Failed to map a memory object. */
464	#define VERR_MAP_FAILED (-75)
465	/** Trailing characters. */
466	#define VERR_TRAILING_CHARS (-76)
467	/** Trailing characters. */
468	#define VWRN_TRAILING_CHARS 76
469	/** Trailing spaces. */
470	#define VERR_TRAILING_SPACES (-77)
471	/** Trailing spaces. */
472	#define VWRN_TRAILING_SPACES 77
473	/** Generic not found error. */
474	#define VERR_NOT_FOUND (-78)
475	/** Generic not found warning. */
476	#define VWRN_NOT_FOUND 78
477	/** Generic invalid state error. */
478	#define VERR_INVALID_STATE (-79)
479	/** Generic invalid state warning. */
480	#define VWRN_INVALID_STATE 79
481	/** Generic out of resources error. */
482	#define VERR_OUT_OF_RESOURCES (-80)
483	/** Generic out of resources warning. */
484	#define VWRN_OUT_OF_RESOURCES 80
485	/** No more handles available, too many open handles. */
486	#define VERR_NO_MORE_HANDLES (-81)
487	/** Preemption is disabled.
488	* The requested operation can only be performed when preemption is enabled. */
489	#define VERR_PREEMPT_DISABLED (-82)
490	/** End of string. */
491	#define VERR_END_OF_STRING (-83)
492	/** End of string. */
493	#define VINF_END_OF_STRING 83
494	/** A page count is ouf of range. */
495	#define VERR_PAGE_COUNT_OUT_OF_RANGE (-84)
496	/** Generic object destroyed status. */
497	#define VERR_OBJECT_DESTROYED (-85)
498	/** Generic object was destroyed by the call status. */
499	#define VINF_OBJECT_DESTROYED 85
500	/** Generic dangling objects status. */
501	#define VERR_DANGLING_OBJECTS (-86)
502	/** Generic dangling objects status. */
503	#define VWRN_DANGLING_OBJECTS 86
504	/** Invalid Base64 encoding. */
505	#define VERR_INVALID_BASE64_ENCODING (-87)
506	/** @} */
507
508
509	/** @name Common File/Disk/Pipe/etc Status Codes
510	* @{
511	*/
512	/** Unresolved (unknown) file i/o error. */
513	#define VERR_FILE_IO_ERROR (-100)
514	/** File/Device open failed. */
515	#define VERR_OPEN_FAILED (-101)
516	/** File not found. */
517	#define VERR_FILE_NOT_FOUND (-102)
518	/** Path not found. */
519	#define VERR_PATH_NOT_FOUND (-103)
520	/** Invalid (malformed) file/path name. */
521	#define VERR_INVALID_NAME (-104)
522	/** File/Device already exists. */
523	#define VERR_ALREADY_EXISTS (-105)
524	/** Too many open files. */
525	#define VERR_TOO_MANY_OPEN_FILES (-106)
526	/** Seek error. */
527	#define VERR_SEEK (-107)
528	/** Seek below file start. */
529	#define VERR_NEGATIVE_SEEK (-108)
530	/** Trying to seek on device. */
531	#define VERR_SEEK_ON_DEVICE (-109)
532	/** Reached the end of the file. */
533	#define VERR_EOF (-110)
534	/** Reached the end of the file. */
535	#define VINF_EOF 110
536	/** Generic file read error. */
537	#define VERR_READ_ERROR (-111)
538	/** Generic file write error. */
539	#define VERR_WRITE_ERROR (-112)
540	/** Write protect error. */
541	#define VERR_WRITE_PROTECT (-113)
542	/** Sharing violation, file is being used by another process. */
543	#define VERR_SHARING_VIOLATION (-114)
544	/** Unable to lock a region of a file. */
545	#define VERR_FILE_LOCK_FAILED (-115)
546	/** File access error, another process has locked a portion of the file. */
547	#define VERR_FILE_LOCK_VIOLATION (-116)
548	/** File or directory can't be created. */
549	#define VERR_CANT_CREATE (-117)
550	/** Directory can't be deleted. */
551	#define VERR_CANT_DELETE_DIRECTORY (-118)
552	/** Can't move file to another disk. */
553	#define VERR_NOT_SAME_DEVICE (-119)
554	/** The filename or extension is too long. */
555	#define VERR_FILENAME_TOO_LONG (-120)
556	/** Media not present in drive. */
557	#define VERR_MEDIA_NOT_PRESENT (-121)
558	/** The type of media was not recognized. Not formatted? */
559	#define VERR_MEDIA_NOT_RECOGNIZED (-122)
560	/** Can't unlock - region was not locked. */
561	#define VERR_FILE_NOT_LOCKED (-123)
562	/** Unrecoverable error: lock was lost. */
563	#define VERR_FILE_LOCK_LOST (-124)
564	/** Can't delete directory with files. */
565	#define VERR_DIR_NOT_EMPTY (-125)
566	/** A directory operation was attempted on a non-directory object. */
567	#define VERR_NOT_A_DIRECTORY (-126)
568	/** A non-directory operation was attempted on a directory object. */
569	#define VERR_IS_A_DIRECTORY (-127)
570	/** Tried to grow a file beyond the limit imposed by the process or the filesystem. */
571	#define VERR_FILE_TOO_BIG (-128)
572	/** @} */
573
574
575	/** @name Generic Filesystem I/O Status Codes
576	* @{
577	*/
578	/** Unresolved (unknown) disk i/o error. */
579	#define VERR_DISK_IO_ERROR (-150)
580	/** Invalid drive number. */
581	#define VERR_INVALID_DRIVE (-151)
582	/** Disk is full. */
583	#define VERR_DISK_FULL (-152)
584	/** Disk was changed. */
585	#define VERR_DISK_CHANGE (-153)
586	/** Drive is locked. */
587	#define VERR_DRIVE_LOCKED (-154)
588	/** The specified disk or diskette cannot be accessed. */
589	#define VERR_DISK_INVALID_FORMAT (-155)
590	/** Too many symbolic links. */
591	#define VERR_TOO_MANY_SYMLINKS (-156)
592	/** @} */
593
594
595	/** @name Generic Directory Enumeration Status Codes
596	* @{
597	*/
598	/** Unresolved (unknown) search error. */
599	#define VERR_SEARCH_ERROR (-200)
600	/** No more files found. */
601	#define VERR_NO_MORE_FILES (-201)
602	/** No more search handles available. */
603	#define VERR_NO_MORE_SEARCH_HANDLES (-202)
604	/** RTDirReadEx() failed to retrieve the extra data which was requested. */
605	#define VWRN_NO_DIRENT_INFO 203
606	/** @} */
607
608
609	/** @name Internal Processing Errors
610	* @{
611	*/
612	/** Internal error - we're screwed if this happens. */
613	#define VERR_INTERNAL_ERROR (-225)
614	/** Internal error no. 2. */
615	#define VERR_INTERNAL_ERROR_2 (-226)
616	/** Internal error no. 3. */
617	#define VERR_INTERNAL_ERROR_3 (-227)
618	/** Internal error no. 4. */
619	#define VERR_INTERNAL_ERROR_4 (-228)
620	/** Internal error no. 5. */
621	#define VERR_INTERNAL_ERROR_5 (-229)
622	/** Internal error: Unexpected status code. */
623	#define VERR_IPE_UNEXPECTED_STATUS (-230)
624	/** Internal error: Unexpected status code. */
625	#define VERR_IPE_UNEXPECTED_INFO_STATUS (-231)
626	/** Internal error: Unexpected status code. */
627	#define VERR_IPE_UNEXPECTED_ERROR_STATUS (-232)
628	/** @} */
629
630
631	/** @name Generic Device I/O Status Codes
632	* @{
633	*/
634	/** Unresolved (unknown) device i/o error. */
635	#define VERR_DEV_IO_ERROR (-250)
636	/** Device i/o: Bad unit. */
637	#define VERR_IO_BAD_UNIT (-251)
638	/** Device i/o: Not ready. */
639	#define VERR_IO_NOT_READY (-252)
640	/** Device i/o: Bad command. */
641	#define VERR_IO_BAD_COMMAND (-253)
642	/** Device i/o: CRC error. */
643	#define VERR_IO_CRC (-254)
644	/** Device i/o: Bad length. */
645	#define VERR_IO_BAD_LENGTH (-255)
646	/** Device i/o: Sector not found. */
647	#define VERR_IO_SECTOR_NOT_FOUND (-256)
648	/** Device i/o: General failure. */
649	#define VERR_IO_GEN_FAILURE (-257)
650	/** @} */
651
652
653	/** @name Generic Pipe I/O Status Codes
654	* @{
655	*/
656	/** Unresolved (unknown) pipe i/o error. */
657	#define VERR_PIPE_IO_ERROR (-300)
658	/** Broken pipe. */
659	#define VERR_BROKEN_PIPE (-301)
660	/** Bad pipe. */
661	#define VERR_BAD_PIPE (-302)
662	/** Pipe is busy. */
663	#define VERR_PIPE_BUSY (-303)
664	/** No data in pipe. */
665	#define VERR_NO_DATA (-304)
666	/** Pipe is not connected. */
667	#define VERR_PIPE_NOT_CONNECTED (-305)
668	/** More data available in pipe. */
669	#define VERR_MORE_DATA (-306)
670	/** @} */
671
672
673	/** @name Generic Semaphores Status Codes
674	* @{
675	*/
676	/** Unresolved (unknown) semaphore error. */
677	#define VERR_SEM_ERROR (-350)
678	/** Too many semaphores. */
679	#define VERR_TOO_MANY_SEMAPHORES (-351)
680	/** Exclusive semaphore is owned by another process. */
681	#define VERR_EXCL_SEM_ALREADY_OWNED (-352)
682	/** The semaphore is set and cannot be closed. */
683	#define VERR_SEM_IS_SET (-353)
684	/** The semaphore cannot be set again. */
685	#define VERR_TOO_MANY_SEM_REQUESTS (-354)
686	/** Attempt to release mutex not owned by caller. */
687	#define VERR_NOT_OWNER (-355)
688	/** The semaphore has been opened too many times. */
689	#define VERR_TOO_MANY_OPENS (-356)
690	/** The maximum posts for the event semaphore has been reached. */
691	#define VERR_TOO_MANY_POSTS (-357)
692	/** The event semaphore has already been posted. */
693	#define VERR_ALREADY_POSTED (-358)
694	/** The event semaphore has already been reset. */
695	#define VERR_ALREADY_RESET (-359)
696	/** The semaphore is in use. */
697	#define VERR_SEM_BUSY (-360)
698	/** The previous ownership of this semaphore has ended. */
699	#define VERR_SEM_OWNER_DIED (-361)
700	/** Failed to open semaphore by name - not found. */
701	#define VERR_SEM_NOT_FOUND (-362)
702	/** Semaphore destroyed while waiting. */
703	#define VERR_SEM_DESTROYED (-363)
704	/** Nested ownership requests are not permitted for this semaphore type. */
705	#define VERR_SEM_NESTED (-364)
706	/** Deadlock detected. */
707	#define VERR_DEADLOCK (-365)
708	/** Ping-Pong listen or speak out of turn error. */
709	#define VERR_SEM_OUT_OF_TURN (-366)
710	/** @} */
711
712
713	/** @name Generic Network I/O Status Codes
714	* @{
715	*/
716	/** Unresolved (unknown) network error. */
717	#define VERR_NET_IO_ERROR (-400)
718	/** The network is busy or is out of resources. */
719	#define VERR_NET_OUT_OF_RESOURCES (-401)
720	/** Net host name not found. */
721	#define VERR_NET_HOST_NOT_FOUND (-402)
722	/** Network path not found. */
723	#define VERR_NET_PATH_NOT_FOUND (-403)
724	/** General network printing error. */
725	#define VERR_NET_PRINT_ERROR (-404)
726	/** The machine is not on the network. */
727	#define VERR_NET_NO_NETWORK (-405)
728	/** Name is not unique on the network. */
729	#define VERR_NET_NOT_UNIQUE_NAME (-406)
730
731	/* These are BSD networking error codes - numbers correspond, don't mess! */
732	/** Operation in progress. */
733	#define VERR_NET_IN_PROGRESS (-436)
734	/** Operation already in progress. */
735	#define VERR_NET_ALREADY_IN_PROGRESS (-437)
736	/** Attempted socket operation with a non-socket handle.
737	* (This includes closed handles.) */
738	#define VERR_NET_NOT_SOCKET (-438)
739	/** Destination address required. */
740	#define VERR_NET_DEST_ADDRESS_REQUIRED (-439)
741	/** Message too long. */
742	#define VERR_NET_MSG_SIZE (-440)
743	/** Protocol wrong type for socket. */
744	#define VERR_NET_PROTOCOL_TYPE (-441)
745	/** Protocol not available. */
746	#define VERR_NET_PROTOCOL_NOT_AVAILABLE (-442)
747	/** Protocol not supported. */
748	#define VERR_NET_PROTOCOL_NOT_SUPPORTED (-443)
749	/** Socket type not supported. */
750	#define VERR_NET_SOCKET_TYPE_NOT_SUPPORTED (-444)
751	/** Operation not supported. */
752	#define VERR_NET_OPERATION_NOT_SUPPORTED (-445)
753	/** Protocol family not supported. */
754	#define VERR_NET_PROTOCOL_FAMILY_NOT_SUPPORTED (-446)
755	/** Address family not supported by protocol family. */
756	#define VERR_NET_ADDRESS_FAMILY_NOT_SUPPORTED (-447)
757	/** Address already in use. */
758	#define VERR_NET_ADDRESS_IN_USE (-448)
759	/** Can't assign requested address. */
760	#define VERR_NET_ADDRESS_NOT_AVAILABLE (-449)
761	/** Network is down. */
762	#define VERR_NET_DOWN (-450)
763	/** Network is unreachable. */
764	#define VERR_NET_UNREACHABLE (-451)
765	/** Network dropped connection on reset. */
766	#define VERR_NET_CONNECTION_RESET (-452)
767	/** Software caused connection abort. */
768	#define VERR_NET_CONNECTION_ABORTED (-453)
769	/** Connection reset by peer. */
770	#define VERR_NET_CONNECTION_RESET_BY_PEER (-454)
771	/** No buffer space available. */
772	#define VERR_NET_NO_BUFFER_SPACE (-455)
773	/** Socket is already connected. */
774	#define VERR_NET_ALREADY_CONNECTED (-456)
775	/** Socket is not connected. */
776	#define VERR_NET_NOT_CONNECTED (-457)
777	/** Can't send after socket shutdown. */
778	#define VERR_NET_SHUTDOWN (-458)
779	/** Too many references: can't splice. */
780	#define VERR_NET_TOO_MANY_REFERENCES (-459)
781	/** Too many references: can't splice. */
782	#define VERR_NET_CONNECTION_TIMED_OUT (-460)
783	/** Connection refused. */
784	#define VERR_NET_CONNECTION_REFUSED (-461)
785	/* ELOOP is not net. */
786	/* ENAMETOOLONG is not net. */
787	/** Host is down. */
788	#define VERR_NET_HOST_DOWN (-464)
789	/** No route to host. */
790	#define VERR_NET_HOST_UNREACHABLE (-465)
791	/** Protocol error. */
792	#define VERR_NET_PROTOCOL_ERROR (-466)
793	/** @} */
794
795
796	/** @name TCP Status Codes
797	* @{
798	*/
799	/** Stop the TCP server. */
800	#define VERR_TCP_SERVER_STOP (-500)
801	/** The server was stopped. */
802	#define VINF_TCP_SERVER_STOP 500
803	/** @} */
804
805
806	/** @name L4 Specific Status Codes
807	* @{
808	*/
809	/** Invalid offset in an L4 dataspace */
810	#define VERR_L4_INVALID_DS_OFFSET (-550)
811	/** IPC error */
812	#define VERR_IPC (-551)
813	/** Item already used */
814	#define VERR_RESOURCE_IN_USE (-552)
815	/** Source/destination not found */
816	#define VERR_IPC_PROCESS_NOT_FOUND (-553)
817	/** Receive timeout */
818	#define VERR_IPC_RECEIVE_TIMEOUT (-554)
819	/** Send timeout */
820	#define VERR_IPC_SEND_TIMEOUT (-555)
821	/** Receive cancelled */
822	#define VERR_IPC_RECEIVE_CANCELLED (-556)
823	/** Send cancelled */
824	#define VERR_IPC_SEND_CANCELLED (-557)
825	/** Receive aborted */
826	#define VERR_IPC_RECEIVE_ABORTED (-558)
827	/** Send aborted */
828	#define VERR_IPC_SEND_ABORTED (-559)
829	/** Couldn't map pages during receive */
830	#define VERR_IPC_RECEIVE_MAP_FAILED (-560)
831	/** Couldn't map pages during send */
832	#define VERR_IPC_SEND_MAP_FAILED (-561)
833	/** Send pagefault timeout in receive */
834	#define VERR_IPC_RECEIVE_SEND_PF_TIMEOUT (-562)
835	/** Send pagefault timeout in send */
836	#define VERR_IPC_SEND_SEND_PF_TIMEOUT (-563)
837	/** (One) receive buffer was too small, or too few buffers */
838	#define VINF_IPC_RECEIVE_MSG_CUT 564
839	/** (One) send buffer was too small, or too few buffers */
840	#define VINF_IPC_SEND_MSG_CUT 565
841	/** Dataspace manager server not found */
842	#define VERR_L4_DS_MANAGER_NOT_FOUND (-566)
843	/** @} */
844
845
846	/** @name Loader Status Codes.
847	* @{
848	*/
849	/** Invalid executable signature. */
850	#define VERR_INVALID_EXE_SIGNATURE (-600)
851	/** The iprt loader recognized a ELF image, but doesn't support loading it. */
852	#define VERR_ELF_EXE_NOT_SUPPORTED (-601)
853	/** The iprt loader recognized a PE image, but doesn't support loading it. */
854	#define VERR_PE_EXE_NOT_SUPPORTED (-602)
855	/** The iprt loader recognized a LX image, but doesn't support loading it. */
856	#define VERR_LX_EXE_NOT_SUPPORTED (-603)
857	/** The iprt loader recognized a LE image, but doesn't support loading it. */
858	#define VERR_LE_EXE_NOT_SUPPORTED (-604)
859	/** The iprt loader recognized a NE image, but doesn't support loading it. */
860	#define VERR_NE_EXE_NOT_SUPPORTED (-605)
861	/** The iprt loader recognized a MZ image, but doesn't support loading it. */
862	#define VERR_MZ_EXE_NOT_SUPPORTED (-606)
863	/** The iprt loader recognized an a.out image, but doesn't support loading it. */
864	#define VERR_AOUT_EXE_NOT_SUPPORTED (-607)
865	/** Bad executable. */
866	#define VERR_BAD_EXE_FORMAT (-608)
867	/** Symbol (export) not found. */
868	#define VERR_SYMBOL_NOT_FOUND (-609)
869	/** Module not found. */
870	#define VERR_MODULE_NOT_FOUND (-610)
871	/** The loader resolved an external symbol to an address to big for the image format. */
872	#define VERR_SYMBOL_VALUE_TOO_BIG (-611)
873	/** The image is too big. */
874	#define VERR_IMAGE_TOO_BIG (-612)
875	/** The image base address is to high for this image type. */
876	#define VERR_IMAGE_BASE_TOO_HIGH (-614)
877	/** Mismatching architecture. */
878	#define VERR_LDR_ARCH_MISMATCH (-615)
879	/** The PE loader encountered delayed imports, a feature which hasn't been implemented yet. */
880	#define VERR_LDRPE_DELAY_IMPORT (-620)
881	/** The PE loader doesn't have a clue what the security data directory entry is all about. */
882	#define VERR_LDRPE_SECURITY (-621)
883	/** The PE loader doesn't know how to deal with the global pointer data directory entry yet. */
884	#define VERR_LDRPE_GLOBALPTR (-622)
885	/** The PE loader doesn't support the TLS data directory yet. */
886	#define VERR_LDRPE_TLS (-623)
887	/** The PE loader doesn't grok the COM descriptor data directory entry. */
888	#define VERR_LDRPE_COM_DESCRIPTOR (-624)
889	/** The PE loader encountered an unknown load config directory/header size. */
890	#define VERR_LDRPE_LOAD_CONFIG_SIZE (-625)
891	/** The PE loader encountered a lock prefix table, a feature which hasn't been implemented yet. */
892	#define VERR_LDRPE_LOCK_PREFIX_TABLE (-626)
893	/** The ELF loader doesn't handle foreign endianness. */
894	#define VERR_LDRELF_ODD_ENDIAN (-630)
895	/** The ELF image is 'dynamic', the ELF loader can only deal with 'relocatable' images at present. */
896	#define VERR_LDRELF_DYN (-631)
897	/** The ELF image is 'executable', the ELF loader can only deal with 'relocatable' images at present. */
898	#define VERR_LDRELF_EXEC (-632)
899	/** The ELF image was created for an unsupported target machine type. */
900	#define VERR_LDRELF_MACHINE (-633)
901	/** The ELF version is not supported. */
902	#define VERR_LDRELF_VERSION (-634)
903	/** The ELF loader cannot handle multiple SYMTAB sections. */
904	#define VERR_LDRELF_MULTIPLE_SYMTABS (-635)
905	/** The ELF loader encountered a relocation type which is not implemented. */
906	#define VERR_LDRELF_RELOCATION_NOT_SUPPORTED (-636)
907	/** The ELF loader encountered a bad symbol index. */
908	#define VERR_LDRELF_INVALID_SYMBOL_INDEX (-637)
909	/** The ELF loader encountered an invalid symbol name offset. */
910	#define VERR_LDRELF_INVALID_SYMBOL_NAME_OFFSET (-638)
911	/** The ELF loader encountered an invalid relocation offset. */
912	#define VERR_LDRELF_INVALID_RELOCATION_OFFSET (-639)
913	/** The ELF loader didn't find the symbol/string table for the image. */
914	#define VERR_LDRELF_NO_SYMBOL_OR_NO_STRING_TABS (-640)
915	/** @}*/
916
917	/** @name Debug Info Reader Status Codes.
918	* @{
919	*/
920	/** The specified segment:offset address was invalid. Typically an attempt at
921	* addressing outside the segment boundrary. */
922	#define VERR_DBGMOD_INVALID_ADDRESS (-650)
923	/** @} */
924
925	/** @name Request Packet Status Codes.
926	* @{
927	*/
928	/** Invalid RT request type.
929	* For the RTReqAlloc() case, the caller just specified an illegal enmType. For
930	* all the other occurences it means indicates corruption, broken logic, or stupid
931	* interface user. */
932	#define VERR_RT_REQUEST_INVALID_TYPE (-700)
933	/** Invalid RT request state.
934	* The state of the request packet was not the expected and accepted one(s). Either
935	* the interface user screwed up, or we've got corruption/broken logic. */
936	#define VERR_RT_REQUEST_STATE (-701)
937	/** Invalid RT request packet.
938	* One or more of the RT controlled packet members didn't contain the correct
939	* values. Some thing's broken. */
940	#define VERR_RT_REQUEST_INVALID_PACKAGE (-702)
941	/** The status field has not been updated yet as the request is still
942	* pending completion. Someone queried the iStatus field before the request
943	* has been fully processed. */
944	#define VERR_RT_REQUEST_STATUS_STILL_PENDING (-703)
945	/** The request has been freed, don't read the status now.
946	* Someone is reading the iStatus field of a freed request packet. */
947	#define VERR_RT_REQUEST_STATUS_FREED (-704)
948	/** @} */
949
950	/** @name Environment Status Code
951	* @{
952	*/
953	/** The specified environment variable was not found. (RTEnvGetEx) */
954	#define VERR_ENV_VAR_NOT_FOUND (-750)
955	/** The specified environment variable was not found. (RTEnvUnsetEx) */
956	#define VINF_ENV_VAR_NOT_FOUND (750)
957	/** @} */
958
959	/** @name Multiprocessor Status Codes.
960	* @{
961	*/
962	/** The specified cpu is offline. */
963	#define VERR_CPU_OFFLINE (-800)
964	/** The specified cpu was not found. */
965	#define VERR_CPU_NOT_FOUND (-801)
966	/** @} */
967
968	/** @name RTGetOpt status codes
969	* @{ */
970	/** RTGetOpt: command line option not recognized. */
971	#define VERR_GETOPT_UNKNOWN_OPTION (-825)
972	/** RTGetOpt: command line option needs argument. */
973	#define VERR_GETOPT_REQUIRED_ARGUMENT_MISSING (-826)
974	/** RTGetOpt: command line option has argument with bad format. */
975	#define VERR_GETOPT_INVALID_ARGUMENT_FORMAT (-827)
976	/** RTGetOpt: Not an option. */
977	#define VINF_GETOPT_NOT_OPTION 828
978	/** @} */
979
980	/** @name RTCache status codes
981	* @{ */
982	/** RTCache: cache is full. */
983	#define VERR_CACHE_FULL (-850)
984	/** RTCache: cache is empty. */
985	#define VERR_CACHE_EMPTY (-851)
986	/** @} */
987
988	/* SED-END */
989
990	/** @} */
991
992	__END_DECLS
993
994	#endif
995

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

source: vbox/trunk/include/iprt/err.h@ 18555

Download in other formats: