Error codes and descriptions in MicroPython

[Josverl]

I am trying to improve the documentation ( and typestubs) with regards to the error codes, partly based on the descriptions provided for the micro:bit
For that I have tried to build a table of the error codes defined by the different ports ( mor codes could be thrown, but these are in the errno module.

Some things stand out

• MicroPython defines fewer codes than the micro:bit documents. Clearly some are never used, or are they ?
• some ports use different error codes ( ESP32 , Windows) I assume these are SDK / platform specific ?
• there there are ports that have only a few different ones ( STM32 / ESP32 )

Mostly this is a quest for understanding, and to improve the docs, as not everyone knows the *nix errorcodes by heart,

Error Code	Description	micro:bit	stm32	esp32	rp2	samd	unix	windows	webassembly
EPERM	Operation not permitted	1	1	1	1	1	1	1	1
ENOENT	No such file or directory	2	2	2	2	2	2	2	2
ESRCH	No such process	3
EINTR	Interrupted system call	4
EIO	I/O error	5	5	5	5	5	5	5	5
ENXIO	No such device or address	6
E2BIG	Argument list too long	7
ENOEXEC	Exec format error	8
EBADF	Bad file number	9	9	9	9	9	9	9	9
ECHILD	No child processes	10
EAGAIN	Try again	11	11	11	11	11	11	11	11
ENOMEM	Out of memory	12	12	12	12	12	12	12	12
EACCES	Permission denied	13	13	13	13	13	13	13	13
EFAULT	Bad address	14
ENOTBLK	Block device required	15
EBUSY	Device or resource busy	16
EEXIST	File exists	17	17	17	17	17	17	17	17
EXDEV	Cross-device link	18
ENODEV	No such device	19	19	19	19	19	19	19	19
ENOTDIR	Not a directory	20
EISDIR	Is a directory	21	21	21	21	21	21	21	21
EINVAL	Invalid argument	22	22	22	22	22	22	22	22
ENFILE	File table overflow	23
EMFILE	Too many open files	24
ENOTTY	Not a typewriter	25
ETXTBSY	Text file busy	26
EFBIG	File too large	27
ENOSPC	No space left on device	28
ESPIPE	Illegal seek	29
EROFS	Read-only file system	30
EMLINK	Too many links	31
EPIPE	Broken pipe	32
EDOM	Math argument out of domain of func	33
ERANGE	Math result not representable	34
EAFNOSUPPORT	Address family not supported by protocol	97
EOPNOTSUPP	Operation not supported		95	95	95	95	95	130	95
ECONNABORTED	Connection aborted		103	113	103	103	103	106	103
ECONNRESET	Connection reset	104	104	104	104	104	104	108	104
ENOBUFS	No buffer space available		105	105	105	105	105	119	105
ENOTCONN	Transport endpoint is not connected		107	128	107	107	107	126	107
EHOSTUNREACH	No route to host		113	118	113	113	113	110	113
EALREADY	Operation already in progress		114	120	114	114	114	103	114
EINPROGRESS	Operation now in progress	115	115	119	115	115	115	112	115
EADDRINUSE	Address already in use		98	112	98	98	98	100	98
ECONNREFUSED	Connection refused		111	111	111	111	111	107	111
ETIMEDOUT	Connection timed out	110	110	116	110	110	110	138	110

• errno : add enumeration / descriptions Josverl/micropython-stubs#797
• https://support.microbit.org/support/solutions/articles/19000126750-python-oserror-codes
• https://www.man7.org/linux/man-pages/man3/errno.3.html

[ricksorensen]

Thanks