SOCU:poll - Revision history

DaniElectra: /* Events */ Update poll events. The 3DS doesn't use the same event flags as the Wii

2024-05-10T12:54:48Z

Events: Update poll events. The 3DS doesn't use the same event flags as the Wii

← Older revision		Revision as of 16:54, 10 May 2024
Line 77:		Line 77:

	=Events=		=Events=
	Events are a bitwise set of these flags.		Events are a bitwise set of these flags. These flags don't exactly match the Wii flags, even though the sockets sysmodule uses the same codebase.

	{\| class="wikitable" border="1"		{\| class="wikitable" border="1"
	\|-		\|-
Line 85:		Line 86:
	\|-		\|-
	\| 0x01		\| 0x01
	\| ~~POLLRDNORM~~		\| POLLIN
	\| ~~Normal data~~ can be read.		\| Data can be read.
	\|-		\|-
	\| 0x02		\| 0x02
	~~\| POLLRDBAND~~
	~~\| Priority Band Data can be read.~~
	\|-
	~~\| 0x04~~
	\| POLLPRI		\| POLLPRI
	\| Urgent data can be read.		\| Urgent data can be read.
Line 105:		Line 102:
	\|-		\|-
	\| 0x20		\| 0x20
	~~\| POLLERR~~
	~~\| Socket has an error condition.~~
	\|-
	~~\| 0x40~~
	~~\| POLLHUP~~
	~~\| Socket has been disconnected.~~
	\|-
	~~\| 0x80~~
	\| POLLNVAL		\| POLLNVAL
	\| Invalid socket handle~~. This is set if you use fd=-1, which is non-standard behavior.~~		\| Invalid socket handle.
	\|-
	~~\| POLLRDNORM <nowiki>\|</nowiki> POLLRDBAND~~
	~~\| POLLIN~~
	~~\| Data can be read~~.
	\|-		\|-
	\| POLLWRNORM		\| POLLWRNORM
Line 124:		Line 109:
	\| Data can be written.		\| Data can be written.
	\|}		\|}

			Flag 0x4 isn't ever assigned in the code. Flags 0x40 and 0x80 are also not used, even though they are assgined in the input events by default along with 0x20. This is likely because that code section was inherited from the Wii, where these flags are used for poll errors.

			Contrary to the Wii sockets, the 3DS doesn't have POLLERR or POLLHUP, so poll shouldn't be relied on when checking for socket errors.

Unknown: /* Events */ Fix values for flags and add new flags

2019-11-24T11:05:01Z

Events: Fix values for flags and add new flags

← Older revision		Revision as of 14:05, 24 November 2019
Line 82:		Line 82:
	! Value		! Value
	! Name		! Name
	~~! Input/Output~~
	! Description		! Description
	\|-		\|-
	\| 0x01		\| 0x01
	\| ~~POLLIN~~		\| POLLRDNORM
	\| ~~Both~~		\| Normal data can be read.
	~~\| Can recv()~~ data ~~from socket without blocking. For listen sockets, this means you~~ can ~~accept() a connection without blocking~~.
	\|-		\|-
	\| 0x02		\| 0x02
	\| ~~POLLPRI~~		\| POLLRDBAND
	\| ~~Both~~		\| Priority Band Data can be read.
	~~\| There is OOB data ready to recv()~~. ~~Appears that recv()'ing without OOB flag still reads OOB data?~~
	\|-		\|-
	\| 0x04		\| 0x04
	\| ~~???~~		\| POLLPRI
	\| ~~???~~		\| Urgent data can be read.
	~~\| Have never seen this flag. Could possibly~~ be ~~POLLHUP (need to test)~~.
	\|-		\|-
	\| 0x08		\| 0x08
			\| POLLWRNORM
			\| Normal data can be written.
			\|-
			\| 0x10
			\| POLLWRBAND
			\| Priority data can be written.
			\|-
			\| 0x20
	\| POLLERR		\| POLLERR
	~~\| Out~~
	\| Socket has an error condition.		\| Socket has an error condition.
	\|-		\|-
	\| ~~0x10~~		\| 0x40
	\| ~~POLLOUT~~		\| POLLHUP
	\| ~~Both~~		\| Socket has been disconnected.
	~~\| Can send() data to socket without blocking. For a non-blocking connect(), this means the connection~~ has ~~completed (need to test)~~.
	\|-		\|-
	\| ~~0x20~~		\| 0x80
	\| POLLNVAL		\| POLLNVAL
	~~\| Out~~
	\| Invalid socket handle. This is set if you use fd=-1, which is non-standard behavior.		\| Invalid socket handle. This is set if you use fd=-1, which is non-standard behavior.
	\|-		\|-
	\| ~~???~~		\| POLLRDNORM <nowiki>\|</nowiki> POLLRDBAND
	\| ~~POLLHUP~~		\| POLLIN
	\| ~~Out~~		\| Data can be read.
	\| ~~Socket has been disconnected~~.		\|-
			\| POLLWRNORM
			\| POLLOUT
			\| Data can be written.
	\|}		\|}

Mtheall: /* Events */

2014-12-08T20:39:07Z

Events

← Older revision		Revision as of 23:39, 8 December 2014
Line 101:		Line 101:
	\|-		\|-
	\| 0x08		\| 0x08
	\| ~~???~~		\| POLLERR
	\| ~~???~~		\| Out
	\| ~~This flag is almost always set when requested~~.		\| Socket has an error condition.
	\|-		\|-
	\| 0x10		\| 0x10
Line 114:		Line 114:
	\| Out		\| Out
	\| Invalid socket handle. This is set if you use fd=-1, which is non-standard behavior.		\| Invalid socket handle. This is set if you use fd=-1, which is non-standard behavior.
	\|-
	~~\| ???~~
	~~\| POLLERR~~
	~~\| Out~~
	~~\| Socket error.~~
	\|-		\|-
	\| ???		\| ???

Mtheall at 18:04, 8 December 2014

2014-12-08T17:04:46Z

@@ Line 24: / Line 24: @@
 |-
 | 6
-| Input fds struct ptr
+| Pointer to input pollfd struct array
 |}
@@ Line 37: / Line 37: @@
 |-
 | 1
-| Output fds struct ptr
+| Pointer to output pollfd struct array
 |}
@@ Line 54: / Line 54: @@
 | 2
 | POSIX return value
 |}

Yellows8: Created page with "=Request= {| class="wikitable" border="1" |- ! Index Word ! Description |- | 0 | Header code [0x00140084] |- | 1 | nfds_t nfds |- | 2 | int timeout |- | 3 | Value 0x20 (process..."

2014-05-01T00:11:20Z

Created page with "=Request= {| class="wikitable" border="1" |- ! Index Word ! Description |- | 0 | Header code [0x00140084] |- | 1 | nfds_t nfds |- | 2 | int timeout |- | 3 | Value 0x20 (process..."

New page

=Request=
{| class="wikitable" border="1"
|-
! Index Word
! Description
|-
| 0
| Header code [0x00140084]
|-
| 1
| nfds_t nfds
|-
| 2
| int timeout
|-
| 3
| Value 0x20 (processID header)
|-
| 4
| ProcessID set by the ARM11 kernel.
|-
| 5
| (insize<<14) <nowiki>|</nowiki> 0x2802
|-
| 6
| Input fds struct ptr
|}

The following is located 0x100-bytes after the beginning of the above command buffer:
{| class="wikitable" border="1"
|-
! Index Word
! Description
|-
| 0
| (outsize<<14) <nowiki>|</nowiki> 2
|-
| 1
| Output fds struct ptr
|}

=Response=
{| class="wikitable" border="1"
|-
! Index Word
! Description
|-
| 0
| Header code
|-
| 1
| Result code
|-
| 2
| POSIX return value
|}