1204 lines
388 KiB
Plaintext
1204 lines
388 KiB
Plaintext
|
rust
|
|||
|
|
Ô #rustc 1.96.0 (ac68faa20 2026-05-25)ÁÀ뉊 ]!ÜÛê(¹Þ—šên -5be7b69c3ff7b5b8Á íàÄTËŸ ÜJîÄ)'ß\¥! -3d1337db07d0b3aeÁ ¤²XctÔ'ÐÓ©z¨É½Ó -a4945860e1c53b00Á ¤°ð ¾ä-±($²ï=©Ã -7e98a21bfd32b0edÁ–�òÖÀH•‘P IÓHã#£ -055f30b747f859b6Á rustc_std_workspace_coreÁCçß^ò½èÝ$Çÿ+Cé -c4878ee60b2242c9Á ŸÃï+Ñ]ŠqB<ÏïW# -8dd1dd90e70d0b6aÁ miniz_oxideÁ€š»J(P>àö÷g\K -1eb618da2918ab7fÁ adler2ÁÆ;+Þ®5¥ÌýÝ°¦ÛLˆ -f7919172d268e069Á hashbrownÁPäV9ÒÆèÜ�"ÊÖVŽ\ -0fc2184a5da6723aÁ rustc_std_workspace_allocÁs&ØòØy¯s•bæ!‰ýŠ -97e4bf30be240674Á
|
|||
|
|
std_detectÁhŠBîÙºÌI®Ë�Å�š -9dbbf8346ba7ac8bÁ rustc_demangleÁûë9´Ç×@Œ�’ùXFº -f33013f239bf9f14Á cfg_ifÁÜLh�ž§Œaã¯>� -0a71c8f33a838301Á addr2lineÁ׎Þ!]8V$É@@T· -e618e6be60e87ba2Á gimliÁ¸
|
|||
|
|
°µ~Î1‹Ñt ðÁ€w -1f7768a68858f670Á objectÁ
|
|||
|
|
áPÃ?À¶¼QHJ¥� -914cd6a4dbe590d1Á memchrÁ›º«8Ór2Ù $¨ûib‚ -cf21ca6f2bb15dcdÁë
|
|||
|
|
‹ás «LÖ€îâƒ×ɯŒ -ee6f3747e38367f0Á–WÉ?A©ú¡E2¯ëäu -8e0657b9e365f274Á hermitÁ4™ ú wasiÁ$‡ úŠ”ò â<à â <Ü Ž AsRawFdÁ<Áúî¤�Ž FromRawFdÁLÊúî "Ž RawFdÁ,Õúî:<Ó WakerÁ,ä ú solarisÁ¬« ¨ô,‚úî¤Òþ¸<ÚúþÖLãú<Âú•ÖLËúî£
|
|||
|
|
SocketAddrExtÁl9ú androidÁ¬£ testsÁ,þ%‚ $ó%¶ set_nonblockingÁ| Œú aixÁŒÆ‹ú illumosÁ¬Ù‹úŸ ¬ð‹ú vitaÁ”‡ŒüÅ‹U[ shellÁ,‚» os-pollÁ˜¿„ ¨¿ƒ ð¸<œ
|
|||
|
|
úî¤ì
|
|||
|
|
ð AsRawSocketÁ\Ï
|
|||
|
|
â <«
|
|||
|
|
ª AsFdÁ$Ø ú ª¸<Þ úîª
|
|||
|
|
BorrowedFdÁTç úî68ªÖLó úîKMª IntoRawFdÁLþ úîikª OwnedFdÁ<‰ úî…‡ªô,’ úîšœª‰ \Ê â < ª AsSocketÁD× â ª BorrowedSocketÁtá â <>ª
|
|||
|
|
FromRawSocketÁlñ â []ª
|
|||
|
|
IntoRawSocketÁl€ â z|ª OwnedSocketÁ\� â —™ª RawSocketÁLœ â ²´ç¨ $§ úî¤ö ç¸< úîçØ T¶ úî,.çÖL úîACçŒ
|
|||
|
|
LÍ úîVXçª
|
|||
|
|
<Ø úîkmçô,á úî€‚ç‰ \™ â <ï çï
|
|||
|
|
D¦ â ç‰t° â &(ç©lÀ â 8:çÈlÏ â JLçç\Þ â \^ç„Lë â npǨ $Ú
|
|||
|
|
ú
|
|||
|
|
Ǹ<à
|
|||
|
|
úîÇØ Té
|
|||
|
|
úî,.ÇÖLõ
|
|||
|
|
úîACÇŒ
|
|||
|
|
L€
|
|||
|
|
úîVXǪ
|
|||
|
|
<‹
|
|||
|
|
úîkmÇô,”
|
|||
|
|
úlj \Ì
|
|||
|
|
â <¢
|
|||
|
|
Çï
|
|||
|
|
DÙ
|
|||
|
|
â ljtã
|
|||
|
|
â &(Ç©ló
|
|||
|
|
â 8:ÇÈl‚
|
|||
|
|
â JLÇç\‘
|
|||
|
|
â \^Ç„Lž
|
|||
|
|
â np À macrosÁ cfg_os_pollÁ cfg_not_os_pollÁ
|
|||
|
|
cfg_os_extÁ cfg_netÁ
|
|||
|
|
cfg_io_sourceÁ cfg_any_os_extÁ traceÁ Õ errorÁ logÁ interestÁ READABLEÁ WRITABLEÁ AIOÁ LIOÁ PRIORITYÁ � ¬ Ï • removeÁ is_readableÁ is_writableÁ is_aioÁ is_lioÁ is_priorityÁ #° #± &² (× Š * ********* *
|
|||
|
|
* * *
|
|||
|
|
******· > registryÁ * RegistryÁ @ selectorÁ @ has_wakerÁ * CÝ CŠ *F as_raw_fdÁ *H× *J registerÁ K¤ J
|
|||
|
|
reregisterÁ M¤ J
|
|||
|
|
deregisterÁ O¤ J try_cloneÁ Q J register_wakerÁ Jû *U× *W as_fdÁ *Y° sysÁ tokenÁ \ ]÷ wakerÁ _ _____ eæ f e wakeÁ eventÁ iÆ j jjjj oõ o‹ o� o is_errorÁ o is_read_closedÁ o is_write_closedÁ oÉ o¯ o¼ o from_sys_event_refÁ jz× { EventDetailsÁ |
|
|||
|
|
| 'aÁ |ˆ { €× i eventsÁ ‚ ‚‚‚ EventsÁ † innerÁ ‚ ˆ
|
|||
|
|
with_capacityÁ ˆ capacityÁ ˆ is_emptyÁ ˆù ˆ clearÁ ˆë ‚�Œ �› � IntoIterÁ �ê ‚”Œ ”› ”ó ” size_hintÁ ”ü ‚š× i sourceÁ œ œœœœœÜ ¢Ï ¢å ¢ý œ ¦¥ ¦Ï ¦å ¦ý i iiii ú · pipeÁ ¸ ¸¸¸· featuresÁ guideÁ InterestÁ À
|
|||
|
|
Àˆ Å� ÇÖ Êƒ
|
|||
|
|
Ìï
|
|||
|
|
΋ Cæ Ð [ debug_detailÁ [ú Ó syscallÁ [ Óû Ö ÖÖÖÖÖÖÖÖÖ Ö
|
|||
|
|
Ö Ö Ö
|
|||
|
|
ÖÖÖÖÖÖÖÖ NEXT_IDÁ Ö íæ í• ï í selectÁ ñ ñ íÏ ô ÖöÔ Öø° Ö interests_to_epollÁ Ö EventÁ ÖÅ ÖÆ ý ýýýõ ý‹ ý� ý‚ ý‘ ý¦ ýÉ ý¯ ý¼ ý
|
|||
|
|
debug_detailsÁ Š check_eventsÁ ÖÓ ÓŒ Ž ŽŽŽŽŽŽŽŽŽ Ž
|
|||
|
|
Ž Ž Ž œæ œ new_unregisteredÁ œ» Ÿ œ
|
|||
|
|
ack_and_resetÁ œ fdÁ œ wokenÁ œ resetÁ ¤ Ž¦° Ó sourcefdÁ ¨ ¨¨¨¨¨¨¨ °Œ °Ï °å °ý ÓÓÉ ¶ ¶¶ new_rawÁ ¹ ¹ ÖÖ SelectorÁ ½ idÁ ½ epÁ ÖÀ× íå  íý Ä ÖÆ£' Š
|
|||
|
|
EventsDetailsÁ È
|
|||
|
|
Ȉ Š Ë× Ö stateless_io_sourceÁ Í ÍÍÍÍÍÍ
|
|||
|
|
IoSourceStateÁ Ô
|
|||
|
|
Í Öæ Ö do_ioÁ Ø¥ Ø— Ø£ ÖÏ Öå Öý ÖŽŽ àÐ% Žâ× ¨ SourceFdÁ ä
|
|||
|
|
äŒ äˆ ¨èŒ è× Ó netÁ ë ëëëëëëëë
|
|||
|
|
new_ip_socketÁ ë
|
|||
|
|
new_socketÁ ë SocketAddrCReprÁ ö v4Á ö v6Á ë ù as_ptrÁ ë socket_addrÁ û ë to_socket_addrÁ Ó tcpÁ þ þþþþþþþþþ þ
|
|||
|
|
þ þ þ
|
|||
|
|
þ new_for_addrÁ þ bindÁ þ connectÁ þ listenÁ þ
|
|||
|
|
set_reuseaddrÁ þ acceptÁ ’ ’ Ó udpÁ • ••••••••• •
|
|||
|
|
•¾, • only_v6Á Ó udsÁ £ ££££££££ datagramÁ ¬ ¬¬¬¬¬¬¬¬¬ bind_addrÁ ¬ unboundÁ ¬ pairÁ £ listenerÁ ¹ ¹¹¹¹¹¹¹¹¹ ¹
|
|||
|
|
¹ ¹ ¹
|
|||
|
|
¹¹¹¹Ý. ¹ü, Ì £ streamÁ Î ÎÎÎÎÎÎÎ connect_addrÁ Îý. £ UNNAMED_ADDRESSÁ £ path_offsetÁ £ unix_addrÁ £ý. Û¥ Û ¶¶¶¶¶¶¶¶ ¶
|
|||
|
|
¶ ¶ ¶
|
|||
|
|
¶¶¶¶¶¶¶¶¶¶¶¶æ ¶ öâ
|
|||
|
|
ö try_ioÁ ø— ø¥ ø ¶üÏ üå üý ¶€ writeÁ � € write_vectoredÁ ƒ € flushÁ … ¶‡í2 ˆ ‡ÿ2 Š ‡š3 Œ ¶Ž÷ ¶� from_raw_fdÁ ¶’° ¶” into_raw_fdÁ ¶–÷ ¶ ˜Ô ¶
|
|||
|
|
š÷ ¶ œâ
|
|||
|
|
œ¨2 ž— ž¥ ž ¶ ¢Ï ¢å ¢ý ¶
|
|||
|
|
¦ readÁ § ¦
|
|||
|
|
read_vectoredÁ © ¶«•5 ¬ «¦5 ® ¶°÷ ¶²÷ ¶´�4 ¶¶° ¶¸ê3 ¶º÷ ¶¼Ô ¶¾÷ ¶â
|
|||
|
|
¶ SenderÁ ÁÓ ¶Ã× ¶ ReceiverÁ ÅÓ ¶Ç× \ TokenÁ É
|
|||
|
|
Ɉ \\\΃ \Ð× \\Ó� \ÕÖ \×ï
|
|||
|
|
\ Ù‹ \
|
|||
|
|
Û§ Üù _Ž ÞÓ _à× j™# âÓ jäƒ ‚ IterÁ æŒ æÓ æ posÁ ‚êŒ ê× ‚íŒ íƒ io_sourceÁ ð ððððððððð ð
|
|||
|
|
ð ð ð
|
|||
|
|
ððð IoSourceÁ �¥ �º �Ó � selector_idÁ 𠆥 †æ †ú( ‰— ‰£ †
|
|||
|
|
into_innerÁ ð�¥ �å �´ ð‘¥ ‘¶ 𔥠”Ï ”å ”ý 𙥠™× ðœ UNASSOCIATEDÁ œæ œ associateÁ œ check_associationÁ œ remove_associationÁ 𢃠ð
|
|||
|
|
SelectorIdÁ ¤£' ð¦× “* ¨Ù+ ©‰/ ª ªªªªªªªªª ª
|
|||
|
|
ª ª ª
|
|||
|
|
ªªªªªªªªªªªªªª TcpListenerÁ ÆÓ ª Ⱦ, È from_stdÁ Èü, Ë Ì È
|
|||
|
|
local_addrÁ È set_ttlÁ È ttlÁ È
|
|||
|
|
take_errorÁ ªÒÏ Òå Òý ªÖ× ªØ�4 ªÚ° ªÜê3 ªÞ÷ ªàÔ ªâ÷ ª ä÷ © ©ƒ0 ç ççççççççç ç
|
|||
|
|
ç ç ç
|
|||
|
|
ççççççççççççççç TcpStreamÁ „Ó ç †Ê, †Ä> † peer_addrÁ †æ> † shutdownÁ † set_nodelayÁ † nodelayÁ †ø> †‡? †’? † peekÁ ‘ †¨2 “— “¥ “ ç—•5 ˜ —¦5 š 眕5 � œ¦5 Ÿ ç¡í2 ¢ ¡ÿ2 ¤ ¡š3 ¦ ç¨í2 © ¨ÿ2 « ¨š3 ç¯Ï ¯å ¯ý ç³× çµ�4 ç·° ç ¹ê3 ç
|
|||
|
|
»÷ ç ½Ô ç ¿÷ ç
|
|||
|
|
Á÷ ©¨ ¨¨¨”- Ç ÇÇÇÇÇÇÇÇÇ Ç
|
|||
|
|
Ç Ç Ç
|
|||
|
|
ÇÇÇÇÇÇÇÇÇÇ UdpSocketÁ ßÓ Ç á¾, áÄ> áæ> áðA á send_toÁ æ á recv_fromÁ è á peek_fromÁ ê á sendÁ ì á recvÁ î áÓB ð áÊ, á
|
|||
|
|
set_broadcastÁ á broadcastÁ á set_multicast_loop_v4Á á multicast_loop_v4Á á set_multicast_ttl_v4Á á multicast_ttl_v4Á á set_multicast_loop_v6Á á multicast_loop_v6Á áø> á‡? á join_multicast_v4Á á join_multicast_v6Á á leave_multicast_v4Á á leave_multicast_v6Á áÞ- á’? á¨2 ƒ— ƒ¥ ƒ Ç‡Ï ‡å ‡ý Ç‹× Ç��4 Ç�° Ç‘ê3 Ç“÷ Ç•Ô Ç—÷ Ç ™÷ ¨¨í- œ . � ��������� �
|
|||
|
|
� � �
|
|||
|
|
���������� UnixDatagramÁ µÓ � ·¾, ¸¡ ·Ý. ·Ä> ·Ê, ¼¡ ·î. ·ý. ¿ ·æ> ·ðA ·ýF à ·ºG Å ·éF Ç¡ Ç ·©G Ê ·’? ·‰B ·¨2 Η Î¥ Î �ÒÏ Òå Òý �Ö× �Ø�4 �Ú° �Üê3 �Þ÷ �à÷ �âÔ � ä÷ œ œ‰/ ç ççççççççç ç
|
|||
|
|
ç ç ç
|
|||
|
|
çççççççççç UnixListenerÁ ÿÓ ç �¾, ‚¡ �Ý. �Ä> �ü, �æ> �’? ç‰Ï ‰å ‰ý ç�× ç��4 ç‘° ç“ê3 ç•÷ ç—÷ ç™Ô ç ›÷ œœƒ0 ž žžžžžžžžž ž
|
|||
|
|
ž ž ž
|
|||
|
|
žžžžžžžžžžžžžž
|
|||
|
|
UnixStreamÁ ºÓ ž ¼Ê, ½¡ ¼´0 ¼Ä> ¼ý. Á ¼æ> ¼ðA ¼’? ¼‰B ¼¨2 Ç— Ç¥ Ç žË•5 Ì Ë¦5 Î žÐ•5 Ñ Ð¦5 Ó žÕí2 Ö Õÿ2 Ø Õš3 Ú žÜí2 Ý Üÿ2 ß Üš3 á žãÏ ãå ãý žç× žé�4 žë° ž íê3 ž
|
|||
|
|
ï÷ ž ñ÷ ž óÔ ž
|
|||
|
|
õ÷ œ¨¨¨¨'
|
|||
|
|
)
|
|||
|
|
)
|
|||
|
|
)
|
|||
|
|
D
|
|||
|
|
E
|
|||
|
|
E
|
|||
|
|
G
|
|||
|
|
I
|
|||
|
|
I
|
|||
|
|
I
|
|||
|
|
K
|
|||
|
|
K
|
|||
|
|
M
|
|||
|
|
M
|
|||
|
|
O
|
|||
|
|
O
|
|||
|
|
Q
|
|||
|
|
S
|
|||
|
|
T
|
|||
|
|
V
|
|||
|
|
V
|
|||
|
|
V
|
|||
|
|
X
|
|||
|
|
Z
|
|||
|
|
f
|
|||
|
|
h
|
|||
|
|
p
|
|||
|
|
q
|
|||
|
|
r
|
|||
|
|
s
|
|||
|
|
t
|
|||
|
|
u
|
|||
|
|
v
|
|||
|
|
w
|
|||
|
|
x
|
|||
|
|
y
|
|||
|
|
{
|
|||
|
|
{
|
|||
|
|
{
|
|||
|
|
€
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
Š
|
|||
|
|
‹
|
|||
|
|
Œ
|
|||
|
|
�
|
|||
|
|
Ž
|
|||
|
|
—
|
|||
|
|
˜
|
|||
|
|
›
|
|||
|
|
›
|
|||
|
|
›
|
|||
|
|
£
|
|||
|
|
£
|
|||
|
|
¤
|
|||
|
|
¤
|
|||
|
|
¥
|
|||
|
|
¥
|
|||
|
|
¨
|
|||
|
|
¨
|
|||
|
|
©
|
|||
|
|
©
|
|||
|
|
ª
|
|||
|
|
ª
|
|||
|
|
Æ
|
|||
|
|
Æ
|
|||
|
|
È
|
|||
|
|
Ë
|
|||
|
|
Í
|
|||
|
|
Í
|
|||
|
|
Ï
|
|||
|
|
Ï
|
|||
|
|
ï
|
|||
|
|
ñ
|
|||
|
|
ñ
|
|||
|
|
ô
|
|||
|
|
÷
|
|||
|
|
ù
|
|||
|
|
�
|
|||
|
|
‚
|
|||
|
|
ƒ
|
|||
|
|
„
|
|||
|
|
…
|
|||
|
|
†
|
|||
|
|
‡
|
|||
|
|
ˆ
|
|||
|
|
‰
|
|||
|
|
Š
|
|||
|
|
Š
|
|||
|
|
Š
|
|||
|
|
‹
|
|||
|
|
‹
|
|||
|
|
�
|
|||
|
|
Ÿ
|
|||
|
|
¡
|
|||
|
|
¢
|
|||
|
|
£
|
|||
|
|
¤
|
|||
|
|
§
|
|||
|
|
²
|
|||
|
|
²
|
|||
|
|
³
|
|||
|
|
³
|
|||
|
|
´
|
|||
|
|
´
|
|||
|
|
Á
|
|||
|
|
Á
|
|||
|
|
Á
|
|||
|
|
Â
|
|||
|
|
Ä
|
|||
|
|
Ç
|
|||
|
|
Ì
|
|||
|
|
Ì
|
|||
|
|
Ì
|
|||
|
|
Ø
|
|||
|
|
Ø
|
|||
|
|
Ø
|
|||
|
|
Ü
|
|||
|
|
Ü
|
|||
|
|
Ý
|
|||
|
|
Ý
|
|||
|
|
Þ
|
|||
|
|
Þ
|
|||
|
|
ã
|
|||
|
|
ã
|
|||
|
|
ã
|
|||
|
|
ê
|
|||
|
|
ê
|
|||
|
|
ê
|
|||
|
|
ú
|
|||
|
|
û
|
|||
|
|
Ž
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
‘
|
|||
|
|
’
|
|||
|
|
¢
|
|||
|
|
¶
|
|||
|
|
Ë
|
|||
|
|
Ì
|
|||
|
|
Ö
|
|||
|
|
Ù
|
|||
|
|
Ú
|
|||
|
|
÷
|
|||
|
|
ø
|
|||
|
|
ý
|
|||
|
|
ý
|
|||
|
|
þ
|
|||
|
|
þ
|
|||
|
|
ÿ
|
|||
|
|
ÿ
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
ƒ
|
|||
|
|
ƒ
|
|||
|
|
ƒ
|
|||
|
|
…
|
|||
|
|
‡
|
|||
|
|
ˆ
|
|||
|
|
ˆ
|
|||
|
|
Š
|
|||
|
|
Š
|
|||
|
|
Š
|
|||
|
|
Œ
|
|||
|
|
“
|
|||
|
|
™
|
|||
|
|
�
|
|||
|
|
ž
|
|||
|
|
£
|
|||
|
|
£
|
|||
|
|
¤
|
|||
|
|
¤
|
|||
|
|
¥
|
|||
|
|
¥
|
|||
|
|
§
|
|||
|
|
§
|
|||
|
|
©
|
|||
|
|
©
|
|||
|
|
©
|
|||
|
|
«
|
|||
|
|
¬
|
|||
|
|
¬
|
|||
|
|
®
|
|||
|
|
®
|
|||
|
|
®
|
|||
|
|
·
|
|||
|
|
½
|
|||
|
|
Ä
|
|||
|
|
Ä
|
|||
|
|
Ä
|
|||
|
|
È
|
|||
|
|
È
|
|||
|
|
È
|
|||
|
|
Ï
|
|||
|
|
Ñ
|
|||
|
|
Ñ
|
|||
|
|
Ñ
|
|||
|
|
Ô
|
|||
|
|
Ô
|
|||
|
|
Ö
|
|||
|
|
Ø
|
|||
|
|
Ø
|
|||
|
|
Ú
|
|||
|
|
Ú
|
|||
|
|
Ü
|
|||
|
|
Ü
|
|||
|
|
á
|
|||
|
|
á
|
|||
|
|
á
|
|||
|
|
å
|
|||
|
|
ì
|
|||
|
|
ì
|
|||
|
|
ì
|
|||
|
|
ï
|
|||
|
|
‰
|
|||
|
|
‰
|
|||
|
|
�
|
|||
|
|
“
|
|||
|
|
–
|
|||
|
|
–
|
|||
|
|
—
|
|||
|
|
—
|
|||
|
|
˜
|
|||
|
|
˜
|
|||
|
|
›
|
|||
|
|
›
|
|||
|
|
›
|
|||
|
|
Ÿ
|
|||
|
|
Ÿ
|
|||
|
|
|
|||
|
|
|
|||
|
|
¡
|
|||
|
|
¡
|
|||
|
|
£
|
|||
|
|
§
|
|||
|
|
§
|
|||
|
|
§
|
|||
|
|
Ë
|
|||
|
|
Î
|
|||
|
|
Ï
|
|||
|
|
Ð
|
|||
|
|
Ñ
|
|||
|
|
Ó
|
|||
|
|
Ó
|
|||
|
|
Ô
|
|||
|
|
Ô
|
|||
|
|
Õ
|
|||
|
|
Õ
|
|||
|
|
×
|
|||
|
|
×
|
|||
|
|
×
|
|||
|
|
Û
|
|||
|
|
á
|
|||
|
|
‰
|
|||
|
|
Š
|
|||
|
|
‹
|
|||
|
|
Œ
|
|||
|
|
�
|
|||
|
|
Ž
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
‘
|
|||
|
|
‘
|
|||
|
|
“
|
|||
|
|
˜
|
|||
|
|
˜
|
|||
|
|
š
|
|||
|
|
š
|
|||
|
|
š
|
|||
|
|
œ
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
Ÿ
|
|||
|
|
Ÿ
|
|||
|
|
Ÿ
|
|||
|
|
¢
|
|||
|
|
¢
|
|||
|
|
¤
|
|||
|
|
¤
|
|||
|
|
¤
|
|||
|
|
¦
|
|||
|
|
¨
|
|||
|
|
©
|
|||
|
|
©
|
|||
|
|
«
|
|||
|
|
«
|
|||
|
|
«
|
|||
|
|
|
|||
|
|
°
|
|||
|
|
°
|
|||
|
|
±
|
|||
|
|
±
|
|||
|
|
²
|
|||
|
|
²
|
|||
|
|
´
|
|||
|
|
´
|
|||
|
|
´
|
|||
|
|
¸
|
|||
|
|
¾
|
|||
|
|
ä
|
|||
|
|
å
|
|||
|
|
æ
|
|||
|
|
æ
|
|||
|
|
è
|
|||
|
|
è
|
|||
|
|
ê
|
|||
|
|
ê
|
|||
|
|
ì
|
|||
|
|
ì
|
|||
|
|
î
|
|||
|
|
î
|
|||
|
|
ð
|
|||
|
|
ð
|
|||
|
|
ò
|
|||
|
|
ó
|
|||
|
|
ô
|
|||
|
|
õ
|
|||
|
|
ö
|
|||
|
|
÷
|
|||
|
|
ø
|
|||
|
|
ù
|
|||
|
|
ú
|
|||
|
|
û
|
|||
|
|
ü
|
|||
|
|
ý
|
|||
|
|
ý
|
|||
|
|
ý
|
|||
|
|
þ
|
|||
|
|
þ
|
|||
|
|
ÿ
|
|||
|
|
ÿ
|
|||
|
|
ÿ
|
|||
|
|
€
|
|||
|
|
€
|
|||
|
|
�
|
|||
|
|
‚
|
|||
|
|
ƒ
|
|||
|
|
ˆ
|
|||
|
|
ˆ
|
|||
|
|
‰
|
|||
|
|
‰
|
|||
|
|
Š
|
|||
|
|
Š
|
|||
|
|
Œ
|
|||
|
|
Œ
|
|||
|
|
Œ
|
|||
|
|
�
|
|||
|
|
–
|
|||
|
|
º
|
|||
|
|
¼
|
|||
|
|
Á
|
|||
|
|
Â
|
|||
|
|
Ã
|
|||
|
|
Ã
|
|||
|
|
Å
|
|||
|
|
Å
|
|||
|
|
Ç
|
|||
|
|
Ç
|
|||
|
|
Ê
|
|||
|
|
Ê
|
|||
|
|
Ì
|
|||
|
|
Í
|
|||
|
|
Î
|
|||
|
|
Ó
|
|||
|
|
Ó
|
|||
|
|
Ô
|
|||
|
|
Ô
|
|||
|
|
Õ
|
|||
|
|
Õ
|
|||
|
|
×
|
|||
|
|
×
|
|||
|
|
×
|
|||
|
|
Û
|
|||
|
|
ã
|
|||
|
|
„
|
|||
|
|
†
|
|||
|
|
‡
|
|||
|
|
ˆ
|
|||
|
|
Š
|
|||
|
|
Š
|
|||
|
|
‹
|
|||
|
|
‹
|
|||
|
|
Œ
|
|||
|
|
Œ
|
|||
|
|
Ž
|
|||
|
|
Ž
|
|||
|
|
Ž
|
|||
|
|
’
|
|||
|
|
š
|
|||
|
|
¿
|
|||
|
|
Ã
|
|||
|
|
Ä
|
|||
|
|
Å
|
|||
|
|
Æ
|
|||
|
|
Ç
|
|||
|
|
Ì
|
|||
|
|
Ì
|
|||
|
|
Î
|
|||
|
|
Î
|
|||
|
|
Î
|
|||
|
|
Ð
|
|||
|
|
Ñ
|
|||
|
|
Ñ
|
|||
|
|
Ó
|
|||
|
|
Ó
|
|||
|
|
Ó
|
|||
|
|
Ö
|
|||
|
|
Ö
|
|||
|
|
Ø
|
|||
|
|
Ø
|
|||
|
|
Ø
|
|||
|
|
Ú
|
|||
|
|
Ü
|
|||
|
|
Ý
|
|||
|
|
Ý
|
|||
|
|
ß
|
|||
|
|
ß
|
|||
|
|
ß
|
|||
|
|
á
|
|||
|
|
ä
|
|||
|
|
ä
|
|||
|
|
å
|
|||
|
|
å
|
|||
|
|
æ
|
|||
|
|
æ
|
|||
|
|
è
|
|||
|
|
è
|
|||
|
|
è
|
|||
|
|
ì
|
|||
|
|
ô
|
|||
|
|
¢Š À À Áˆ ˆ RS@Æ‘�ôN Ðì³h µß³h³h ™³h Û³h سh íß³h³h º³h –ú³h³h •˜³h³h ¿c³h «+ > > · ?Ý * ôHÜC¾= ¿cài ¿c @ @ ì Aû * BŠ * Wž¹{ÜУø �,›j «+›j ¿c ½ ½ “' ¾£' Ö ¿' Ö %†Jè ¥- �,êj «+êj ¿c È È Éë' ʈ ý bkåêm,úÀ ¿c à à Ž áÐ% Ž œ÷Ö³^ú «+øk ¿c ä ä åÙ) çˆ fÃÂ_ܲ® Œ ¢·l ¿c Á Á Ï6 ÂÓ ¶ ª"�ŒmÞªþ ¢ýl Ÿ!ýl Ÿ! 8ýl é ýlº1º1
|
|||
|
|
ChildStdinÁ »1Ó ’1 J,CÏ· øû +ýl «+ýl ¯+ýl é ö+ö+ ª
|
|||
|
|
÷+Ð%ä+ Þí¼>XG¸, ýl �,ýl é ýl¶n ¿c Å Å ò6 ÆÓ ¶ )¯0â|íÃM ¢…o à …o à 8…o é …oÎ1Î1 ChildStdoutÁ Ï1Ó ’1 ®Òô? é …oÞ1Þ1 ChildStderrÁ ß1Ó ’1 +Oý‹k€M ¯+…o «+…o +…o é ¶n…o �,…o é …o¶n Š É É Ê–7 ˈ ` ç� åµ' Û¦q ئq ¿c¦q Ðì¦q µß¦q¦q ™¦q íߦq¦q º¦q še¦q é ¦q ¿c Þ Þ Ž ßÓ _ HÄ U¼ƒÇl Ø â â ™# ãÓ j n=TÈmªQ% ¿c€s ¿c | | }õ ˆ j "ž¡Ë‚_V 8 ¿c æ æ Î8 èÓ ‚ éê8 ‚ tâQóÜ°Í™ Œ Ø÷s ÇL Œ † † Å ‡Ó ‚ 1Nÿ8Þ? ùM÷s ¿cÎt ¢�� ž BoxÁ ¡ˆˆ ¢‰ˆ l }.xÏ ¥çEçEèE GlobalÁ ¿±‡§í# é! � � ÿ9 ƒº ð „Ó ð …§: ð ™]”Õ·Ùu ö!’v ¢’v ¿c’v ¿c ¤ ¤ ×< ¥£' ð ÍÔ Å
|
|||
|
|
‘Ùÿ Ø€w ¢ Æ Æ œ> ÇÓ ª '*+¨ ù ¿c¿w ¯+¿w «+¿w +¿w é ¶n¿w �,¿w é ¿w¶n é Š#Š# ‹#œ> Œ#ˆô" N� À];óÉ ¿w à „ „ ÂA …Ó ç ¤c|Pءÿ à 8üx Ÿ!üx Ÿ!±y ¢üx ¿cüx ¯+üx «+üx +üx é ¶nüx �,üx é üx¶n é ‡#‡# ˆ#ÂA ‰#ˆô" ¤‰?ßøkã üx ¢ ß ß «F àÓ Ç mðbA—À ¿cçz ¯+çz «+çz +çz é ¶nçz �,çz é çz¶n é ð#ð# ñ#«F ò#ˆà# ¬ãøàFð™ çz ¢ µ µ ÖL ¶Ó � …Ê:pûW› ¿c¤| ¯+¤| «+¤| +¤| é ’'’' “'ÖL ”'ˆñ& ÒÛ0É@ßh ¤| é ¶n¤| �,¤| é ¤|¶n ¢ ÿ ÿ ºP €Ó ç Ÿ=%Q‹/iw ¿cá} ¯+á} «+á} +á} é ã'ã' ä'ºP å'ˆË' Nó:xÔ§eö á} é ¶ná} �,á} é á}¶n à º º ¬S »Ó ž †ùcEãhÿú à 8ž Ÿ!ž Ÿ!Ó ¢ž ¿cž ¯+ž «+ž +ž é (( ®(¬S ¯(ˆê% ׶'™g$² ž é ¶nž �,ž é ž¶n à ÀÌ ÉÄ ÀÒ ÉÅ ÀÓ ÉÇ ÀÕ ÉÉ ÀÍ ÉÊ ÀÎ Éä âí æ¢ ¤Ì À× ÉÎ ÀÙ É# À& À( ÀH >U @À ½Ë Èâ àè äà ÁÇ ÅÐ Éà Þz †|ê æš †™ �¦ ¤Ö Ƴ „‹ ßÖ µ� ÿç ºF >Y @ø ½¦ à’ Á¶ ÅÚ Æ· „� ßÚ µ‘ ÿë ºW @ö ½˜ Á¼ Åà ƽ „• ßâ µ™ ÿó º° äü Á¢ Ŧ�” �Ò Æ¯ „‡ ßÒ µ‰ ÿã º€ Á‡
|
|||
|
|
¡ „¨
|
|||
|
|
Õ ºÜ
|
|||
|
|
Ž Á–ö+š Á° Ų źö+¾ Å] Þö+â ÆäŠ#»ö+¿ „Á‡#“ö+— ß™ð#Þ’'àö+ä µ•ã'—ö+› ÿï(ñö+õ º� Á¸ ÅÜ Æ¹ „‘ ßÜ µ“ ÿí º” Á´ ÅØ Æµ „� ßØ µ� ÿé º¦ Å«
|
|||
|
|
— „œ
|
|||
|
|
Ë ºÐ
|
|||
|
|
Û É�
|
|||
|
|
” æ� �‘ �Š ˜Ðìµß™ÛØíß#º–ú•˜¿c«+ š�,
|
|||
|
|
P ¢ DŸ!Mé $+³¯+8à 8še$ÇLùMé!ö! 0b0001Á 0b0010Á 0b0100Á 0b1000Á 0b10000Áü™- ü¢"
|
|||
|
|
|
|||
|
|
Ä¢
|
|||
|
|
´
|
|||
|
|
D» 5 ü�7 À Æ üñW ³h D… ô ô õ ¨ ÷ ˆÐ mjç�ítoé ¹ ]š _Á ü¸ - üÁ "
|
|||
|
|
|
|||
|
|
ÄÁ ™ŠDÚ 0 ü¯ 7 À å ü� W ³h D¤ ýŠ ƒ ,i _Á üà- üé"
|
|||
|
|
|
|||
|
|
Äé ™ŠD‚ 0 ü×7 À � ü¸W ³h DÌ ýŠ ƒ ,i _Á üïA ä‘ d‘ 4‘ ýŠ
|
|||
|
|
' ˜
|
|||
|
|
·
|
|||
|
|
7 ,˜ œ l < ýŠ
|
|||
|
|
' ¨ ëŽ 2 ,¨ ¬
|
|||
|
|
üø6
|
|||
|
|
|
|||
|
|
Äø ™Š æ & üæK À ° · ü¨� ³h DÓ ³h $¹ ³h ,¿ ýŠ ^ ] ] ýŠ ^ ýŠ G ¹
|
|||
|
|
K v Ì» d¼ 4¼ ýŠ
|
|||
|
|
' Ã ëŽ 2 ,Ã Ç X DË Ó ô» Ø
|
|||
|
|
ß üŠ U $¬ ³h $£ Ê É ýŠ É ! AŒ Ìå dæ 4æ ýŠ
|
|||
|
|
' í ëŽ 2 ,í ñ X Dõ ý ôå ‚
|
|||
|
|
‰ ü´ U $Ö ³h $Í Ê É ýŠ É ! AŒ ¤†! d‡! 4‡! ýŠ
|
|||
|
|
' Ž! ëŽ 2 ,Ž! ’! X –! ™! ̆! ž!
|
|||
|
|
¥! üÚ K $÷ ³h $î Ê É ýŠ É ! AŒ ¤¢" d£" 4£" ýŠ
|
|||
|
|
' ª" ëŽ 2 ,ª" ®" X ²" µ" Ì¢" º"
|
|||
|
|
Á" ! üö!K $“" ³h $Š" Ê É ýŠ É ! AŒ ÌÈ# dÉ# 4É# ýŠ
|
|||
|
|
' Ð# ëŽ 2 ,Ð# Ô# X DØ# à# ôÈ# å#
|
|||
|
|
ì# " ü—#U $¹# ³h $°# Ê É ýŠ É ! AŒ ¿r 8Á ¿r 8Á ¿r 8Á ÷ Ø ¿r 4 A N
|
|||
|
|
ù üØ# Ø ƒ� ,ï Èœ ™ Èœ ¡ Êœ ø Èœ ³ H _Á% Ú è Ø … Èœ Êœ c ¿r 2Á ¿r 2Á ¿r 2Á ¿r 0ÁüÉ4$
|
|||
|
|
|
|||
|
|
„É4
|
|||
|
|
|
|||
|
|
ŒÄ ”Ú4
|
|||
|
|
� ¿r
|
|||
|
|
9 ü¬4L
|
|||
|
|
¤ ÷4
|
|||
|
|
þ4
|
|||
|
|
ž ü…4y
|
|||
|
|
€w T—4
|
|||
|
|
¤]¤] V ¦]Á‚] üß3ø¤”&¿r ² K™ � ¿r œ£ À Á % ³h 0 ýŠ 8 ? ÐAë È É & ¿k 1 8 ? ¼á ä å ' ä ä åÙ) çˆ fÃÂ_ܲ® ` j q „±' É Ê % ¦q 0 ¿r 7 > ¼À@ | } % | | }õ ˆ j "ž¡Ë‚_V \ Ð Ð epoll_eventÁ Ñ ¨ Ò Ú 4è6ÞXÒ¢ ¢ © *[\_i·¾¿ð¨À Å 4ú † ° ˆ D”
|
|||
|
|
À ±·$
|
|||
|
|
> ³ìD³
|
|||
|
|
@ ´–7,Í
|
|||
|
|
É µ–7 Ê µŽ ,Ÿ Þ ¶ü ÊO ü³O L Mio is a fast, low-level I/O library for Rust focusing on non-blocking APIsÁ üƒP M and event notification for building high performance I/O apps with as littleÁ üÔ2 / overhead as possible over the OS abstractions.Á ‡ ú \‹ # UsageÁ — ú ü›O L Using Mio starts by creating a [`Poll`], which reads events from the OS andÁ üëM J puts them into [`Events`]. You can handle I/O events from the OS with it.Á ¹ ú ü½" For more detail, see [`Poll`].Á à ú üä% " [`Poll`]: ../mio/struct.Poll.htmlÁ üŠ/ , [`Events`]: ../mio/event/struct.Events.htmlÁ º ú |¾ ## ExamplesÁ Î ú üÒP M Examples can be found in the `examples` directory of the source code, or [onÁ d£ GitHub].Á ° ú ü´E B [on GitHub]: https://github.com/tokio-rs/mio/tree/master/examplesÁ ú ú dþ ## GuideÁ ‹ ú ü�A > A getting started guide is available in the [`guide`] module.Á Ñ ú ÌÕ ## Available featuresÁ ï ú üóD A The available features are described in the [`features`] module.Á tŸ *[\_i·¾¿ð¨À7 Å 8 † ° ˆ 7 À ±·6 > ³ì5 @ ´–74 É µ–7E Ê µŽ 4 Þ ¶ÀÃÆT‚ 4† Ķ \Ã Ï € Õ ä , Ö × â , Ø 8÷ $Ù & Ý 8÷ $Þ
|
|||
|
|
ã *æ é þ , ó ô ÷ + ‚ ƒ œ 8â „ ‡ › 8» <ˆ � 7Ø L’ + ª « Û 8ä D¬ ´ Ú 8 docsrsÁ 4µ $ » 8Ó ½ À Ù 8â Á Ä Ø 8» <Å Í 7Ø LÏ , é 8÷ $ê
|
|||
|
|
ø äª |· Ç ¾ Í Ü , Î Ï Ú , Ð 8÷ $Ñ & Õ 8÷ $Ö
|
|||
|
|
Û *Þ á ¼ , ë ì µ + ú û ™ 8â ü ÿ ˜ 8”
|
|||
|
|
€ ƒ — 8» <„ Œ 7Ø LŽ , § 8÷ $¨
|
|||
|
|
¶ ¼æ Tó þ „ “ , … † ‘ , ‡ 8÷ $ˆ & Œ 8÷ $�
|
|||
|
|
’ *• ˜ « , ¢ £ ¤ + ± ² Ê 8â ³ ¶ É 8» <· ¿ 7 os-extÁ DÁ + Ø Ù ˆ 8ä DÚ â ‡ 8í± 4ã $ é 8Ó ë î † 8â ï ò … 8» <ó û 7¶¶ Dý , – 8÷ $—
|
|||
|
|
¥ ¤Ò <ß ç � í ü , î ï ú , ð 8÷ $ñ & õ 8÷ $ö
|
|||
|
|
û *þ � Ž , ‹ Œ ‡ + š › ° 8â œ Ÿ ¯ 8» < ¨ 7“* ,ª + ¾ ¿ ë 8ä DÀ È ê 8í± 4É $ Ï 8Ó Ñ Ô é 8â Õ Ø è 8» <Ù á 7“* ,ã , ù 8÷ $ú
|
|||
|
|
ˆ Ôþ l‹ ™ Š Ÿ ® , ¡ ¬ , ¢ 8÷ $£ & § 8÷ $¨
|
|||
|
|
*° ³ ˆ , ½ ¾ � + Ì Í †
|
|||
|
|
8â Î Ñ …
|
|||
|
|
8º Ò Õ „
|
|||
|
|
8» <Ö Þ 7“* ,à $ å 8£ ç ê ƒ
|
|||
|
|
8ú $ë $ ï 8» <ñ ù 7¶¶ Dû + ”
|
|||
|
|
•
|
|||
|
|
å
|
|||
|
|
8ä D–
|
|||
|
|
ž
|
|||
|
|
ä
|
|||
|
|
8í± 4Ÿ
|
|||
|
|
$ ¥
|
|||
|
|
8Ó §
|
|||
|
|
ª
|
|||
|
|
ã
|
|||
|
|
8â «
|
|||
|
|
®
|
|||
|
|
â
|
|||
|
|
8º ¯
|
|||
|
|
²
|
|||
|
|
á
|
|||
|
|
8» <³
|
|||
|
|
»
|
|||
|
|
7“* ,½
|
|||
|
|
$ Â
|
|||
|
|
8£ Ä
|
|||
|
|
Ç
|
|||
|
|
à
|
|||
|
|
8ú $È
|
|||
|
|
$ Ì
|
|||
|
|
8» <Î
|
|||
|
|
Ö
|
|||
|
|
7¶¶ DØ
|
|||
|
|
, ó
|
|||
|
|
8÷ $ô
|
|||
|
|
|
|||
|
|
‚ ÜÝ tê ù Ô
|
|||
|
|
ÿ Ž , € � Œ , ‚ 8÷ $ƒ & ‡ 8÷ $ˆ
|
|||
|
|
� *� “ Ò
|
|||
|
|
, � ž Ë
|
|||
|
|
+ ¬ Û 8â ® ± Ú 8º ² µ Ù 8» <¶ ¾ 7¶¶ DÀ $ È 8» <Ê Ò 7“* ,Ô + é ê ¯
|
|||
|
|
8ä Dë ó ®
|
|||
|
|
8í± 4ô $ ú 8Ó ü ÿ
|
|||
|
|
8â €
|
|||
|
|
ƒ
|
|||
|
|
¬
|
|||
|
|
8º „
|
|||
|
|
‡
|
|||
|
|
«
|
|||
|
|
8» <ˆ
|
|||
|
|
�
|
|||
|
|
7¶¶ D’
|
|||
|
|
$ š
|
|||
|
|
8» <œ
|
|||
|
|
¤
|
|||
|
|
7“* ,¦
|
|||
|
|
, ½
|
|||
|
|
8÷ $¾
|
|||
|
|
|
|||
|
|
Ì
|
|||
|
|
”×
|
|||
|
|
,ä
|
|||
|
|
ê
|
|||
|
|
£ ð
|
|||
|
|
ú
|
|||
|
|
, ñ
|
|||
|
|
ò
|
|||
|
|
ø
|
|||
|
|
, ó
|
|||
|
|
8¿ ô
|
|||
|
|
& õ
|
|||
|
|
8¯ ö
|
|||
|
|
|
|||
|
|
ù
|
|||
|
|
*ü
|
|||
|
|
ÿ
|
|||
|
|
¡ 8ô ‰ Œ � › 8Õ ,Ž $ “ , • – ™ , — 8¿ ˜
|
|||
|
|
š Œ¦ $³ ¸ ð ¾ È , ¿ À Æ , Á 8¿  & à 8¯ Ä
|
|||
|
|
Ç *Ê Í î 8ô × Ú Û è 8Õ $Ü $ à , â ã æ , ä 8¿ å
|
|||
|
|
ç ”ó ,€ † ¿ Œ – , � Ž ” , � 8¿ � & ‘ 8¯ ’
|
|||
|
|
• *˜ › ½ 8ô ¥ ¨ © · 8è ,ª $ ¯ , ± ² µ , ³ 8¿ ´
|
|||
|
|
¶ „Â Ï Ó À Ù ò , Ú 8 levelÁ ,Û & à 8¼ ,â $ ç , é ê ð , ë 8¿ ì & í 8¯ î
|
|||
|
|
ñ *ô ÷ ¾ + � ‚ — 8â ƒ † – 8» <‡ � 7ô ,‘ ¡ ¸ 8ô £ '¦ , ¨ 8ÀÈ ,© ® ¯ ¶ , ° ± ´ , ² 8¿ ³
|
|||
|
|
µ + ð ñ ‹ 8â ò õ Š 8”
|
|||
|
|
ö ù ‰ 8» <ú ‚ 7ô ,„ • ¸ 8 — 8 ,š ¶ 8 ¢ 8 ¦ ¨ ª ³ , ¬ ° , ® 8¿ ¯
|
|||
|
|
± % ´ d� D“ ÀÁ NonZeroU8ÁL ¤” × # ¤,
|
|||
|
|
(  œ7 )+ ”ÝDã ”úD€ lÌ Ò lä ê ”üD‚ l› ³h !" äñ ü¯= : Returns a `Interest` set representing readable interests.ÁDû ³hä� üÎ= : Returns a `Interest` set representing writable interests.ÁDš ³hä¸ ü¯H E Returns a `Interest` set representing priority completion interests.Á ú linuxÁœ†ú¸
|
|||
|
|
¬›ü…,üü7D ³hü¨3 ü• Add together two `Interest`.Á ºú üÂD A This does the same thing as the `BitOr` implementation, but is aÁ ´‹ constant function.Á ¦ú <® ```Á ´º use mio::Interest;Á Õú üÝK H const INTERESTS: Interest = Interest::READABLE.add(Interest::WRITABLE);Á ü2 / # fn silent_dead_code_warning(_: Interest) { }Á üä) & # silent_dead_code_warning(INTERESTS)Á <’ßÒ .üËX Hthis returns the result of the operation, without modifying the originalÁ µ ³h³h³h
|
|||
|
|
ú"¹
|
|||
|
|
ø"ü± 8 ü½+ ( Removes `other` `Interest` from `self`.Á íú üõD A Returns `None` if the set would be empty after removing `other`.Á ¾ú <ÆßÒ ´ÒïÒ íú üõN K const RW_INTERESTS: Interest = Interest::READABLE.add(Interest::WRITABLE);Á Èú üÐ= : // As long a one interest remain this will return `Some`.Á ü’F C let w_interest = RW_INTERESTS.remove(Interest::READABLE).unwrap();Á üÝ' $ assert!(!w_interest.is_readable());Á ü‰& # assert!(w_interest.is_writable());Á ´ú ü¼> ; // Removing all interests from the set will return `None`.Á üÿ< 9 assert_eq!(w_interest.remove(Interest::WRITABLE), None);Á Àú üÈ> ; // Its also possible to remove multiple interests at once.Á ü‹8 5 assert_eq!(RW_INTERESTS.remove(RW_INTERESTS), None);Á <ÈßÒ .üÔXêÔ4¸ ³h³hۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙ³h
|
|||
|
|
$¿ ¹
|
|||
|
|
,Å üŠ & ü» : 7 Returns true if the value includes readable readiness.Á .\ú \— ³h
|
|||
|
|
O&ü´ & üå : 7 Returns true if the value includes writable readiness.Á .\¤ \Á ³h
|
|||
|
|
Ô%üÚ ! ü� 6 3 Returns true if `Interest` contains AIO readiness.Á .\Ê 4ç ³h
|
|||
|
|
U%üö!! ü«!6 3 Returns true if `Interest` contains LIO readiness.Á .\æ! 4ƒ" ³h
|
|||
|
|
! Ö$ü—#& üÇ"; 8 Returns true if `Interest` contains priority readiness.Á .\‡# \¤# ³h
|
|||
|
|
" \$äð# ³h$% ˜ú ™ú % \“$4˜$ # # ³hüº$#,½$ ³h³h³h # #
|
|||
|
|
% $Ã$¹
|
|||
|
|
,É$ü�%" ³h' —˜ ' ü¸%'d»% ü ü³h³h & È% &
|
|||
|
|
' $Í%¹
|
|||
|
|
,Ó%ä�& ³h) Àc ) ü²&: µ& ý þ ÿ ý³h þ c c ˆ ¢cµ
|
|||
|
|
` £c bufÁ ` àB¤GS
|
|||
|
|
ÿÖ¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
ŸÈŸÈ È ErrorÁ O˜éBL ( ¹& (
|
|||
|
|
) $º&× À&D� $¡ >@¨ $© �, * ,¸<¯ «+ * -Ø T¸ ÎN * .ô,Ä ª+ * /
|
|||
|
|
AtomicBoolÁT· ¬] * 1®Dà ¼À * 2K ° †J * 3 DurationÁDÄ Ö * 4× Ø ¤, * 6 ioÁÝ ¦ * 7Æ,ï i * 9ë ö [ * :Å 4û † * ; ° ˆ Dƒ À * < ±–7,� É * = µ–7 Ê * = µ\›X[KN>A14Œ£ !t¥œ¹ô ÒæèÕ×,çÊ̼¾®°—™„†|Œ[ ü–8 5 Polls for readiness events on all registered values.Á Ïú üÓL I `Poll` allows a program to monitor a large number of [`event::Source`]s,Á ü O L waiting until one or more become "ready" for some class of operations; e.g.Á üðN K reading and writing. An event source is considered ready if it is possibleÁ ü¿F C to immediately perform a corresponding operation; e.g. [`read`] orÁ t† [`write`].Á • ú ü™ N K To use `Poll`, an `event::Source` must first be registered with the `Poll`Á üè H E instance using the [`register`] method on its associated `Register`,Á ü±
|
|||
|
|
K H supplying readiness interest. The readiness interest tells `Poll` whichÁ üý
|
|||
|
|
L I specific operations on the handle to monitor for readiness. A `Token` isÁ üÊ M J also passed to the [`register`] function. When `Poll` returns a readinessÁ ü˜ J G event, it will include this token. This associates the event with theÁ üã * ' event source that generated the event.Á Ž
|
|||
|
|
ú ü’
|
|||
|
|
0 - [`event::Source`]: ./event/trait.Source.htmlÁ üÃ
|
|||
|
|
5 2 [`read`]: ./net/struct.TcpStream.html#method.readÁ üù
|
|||
|
|
7 4 [`write`]: ./net/struct.TcpStream.html#method.writeÁ ü±6 3 [`register`]: struct.Registry.html#method.registerÁ èú tì # ExamplesÁ ûú üÿ= : A basic example -- establishing a `TcpStream` connection.Á ½ú ,ý\÷ ```Á äÔ # use std::error::Error;Á üñ/ , # fn main() -> Result<(), Box<dyn Error>> {Á ü¡- * use mio::{Events, Poll, Interest, Token};Á äÏ use mio::net::TcpStream;Á ìú üð% " use std::net::{self, SocketAddr};Á –ú üš* ' // Bind a server socket to connect to.Á üÅ2 / let addr: SocketAddr = "127.0.0.1:0".parse()?;Á üø/ , let server = net::TcpListener::bind(addr)?;Á ¨ú ü¬M J // Construct a new `Poll` handle as well as the `Events` we'll store intoÁ üú let mut poll = Poll::new()?;Á ü›1 . let mut events = Events::with_capacity(1024);Á Íú ÌÑ // Connect the streamÁ üë? < let mut stream = TcpStream::connect(server.local_addr()?)?;Á «ú ü¯& # // Register the stream with `Poll`Á üÖ^ [ poll.registry().register(&mut stream, Token(0), Interest::READABLE | Interest::WRITABLE)?;Á µú ü¹K H // Wait for the socket to become ready. This has to happen in a loop toÁ ü… // handle spurious wakeups.Á T¥ loop {Á ü°& # poll.poll(&mut events, None)?;Á ×ú ôÛ for event in &events {Á üúA > if event.token() == Token(0) && event.is_writable() {Á ü¼O L // The socket connected (probably, it could still be a spuriousÁ ÔŒ // wakeup)Á ô§ return Ok(());Á lÆ
|
|||
|
|
}Á LÔ }Á ,Þ }Á <ä # }Á <ìßÒ ôú Œø # PortabilityÁ Šú üŽL I Using `Poll` provides a portable interface across supported platforms asÁ üÛ> ; long as the caller takes the following into consideration:Á šú ¼ž ### Spurious eventsÁ ¶ú üºE B [`Poll::poll`] may return readiness events even if the associatedÁ ü€ E B event source is not actually ready. Given the same code, this mayÁ üÆ N K happen more on some platforms than others. It is important to never assumeÁ ü• J G that, just because a readiness event was received, that the associatedÁ üà # operation will succeed as well.Á „ ú üˆ L I If operation fails with [`WouldBlock`], then the caller should not treatÁ üÕ N K this as an error, but instead should wait until another readiness event isÁ l¤
|
|||
|
|
received.Á ² ú Ô¶ ### Draining readinessÁ Ñ ú üÕ K H Once a readiness event is received, the corresponding operation must beÁ ü¡ N K performed repeatedly until it returns [`WouldBlock`]. Unless this is done,Á üð N K there is no guarantee that another readiness event will be delivered, evenÁ ü¿!5 2 if further data is received for the event source.Á õ!ú üù!2 / [`WouldBlock`]: std::io::ErrorKind::WouldBlockÁ ¬"ú ä°" ### Readiness operationsÁ Í"ú üÑ"J G The only readiness operations that are guaranteed to be present on allÁ üœ#N K supported platforms are [`readable`] and [`writable`]. All other readinessÁ üë#H E operations may have false negatives and as such should be consideredÁ ü´$J G **hints**. This means that if a socket is registered with [`readable`]Á üÿ$M J interest and either an error or close is received, a readiness event willÁ üÍ%G D be generated for the socket, but it **may** only include `readable`Á ü•&G D readiness. Also note that, given the potential for spurious events,Á üÝ&N K receiving a readiness event with `read_closed`, `write_closed`, or `error`Á ü¬'J G doesn't actually mean that a `read` on the socket will return a resultÁ ü÷'! matching the readiness event.Á ™(ú ü�(P M In other words, portable programs that explicitly check for [`read_closed`],Á üî(E B [`write_closed`], or [`error`] readiness should be doing so as anÁ ü´)M J **optimization** and always be able to handle an error or close situationÁ ü‚*. + when performing the actual read operation.Á ±*ú üµ*> ; [`readable`]: ./event/struct.Event.html#method.is_readableÁ üô*> ; [`writable`]: ./event/struct.Event.html#method.is_writableÁ ü³+8 5 [`error`]: ./event/struct.Event.html#method.is_errorÁ üì+D A [`read_closed`]: ./event/struct.Event.html#method.is_read_closedÁ ü±,F C [`write_closed`]: ./event/struct.Event.html#method.is_write_closedÁ ø,ú Üü, ### Registering handlesÁ ˜-ú üœ-H E Unless otherwise noted, it should be assumed that types implementingÁ üå-M J [`event::Source`] will never become ready unless they are registered withÁ \³. `Poll`.Á ¿.ú „Ã.
|
|||
|
|
For example:Á Ô.ú ,”/\Ž/�ö äë/¬ö œˆ0 # use std::net;Á üœ0/Òö üÌ0% " use mio::{Poll, Interest, Token};Á äò0Á÷ ì�1 use std::net::SocketAddr;Á ä1 use std::time::Duration;Á ¤Ê1 use std::thread;Á ß1ú üã15 2 let address: SocketAddr = "127.0.0.1:0".parse()?;Á ü™24 1 let listener = net::TcpListener::bind(address)?;Á üÎ2? < let mut sock = TcpStream::connect(listener.local_addr()?)?;Á Ž3ú ü’3* ' thread::sleep(Duration::from_secs(1));Á ½3ú äÁ3 let poll = Poll::new()?;Á Þ3ú üâ3N K // The connect is not guaranteed to have started until it is registered atÁ Œ±4 // this pointÁ üÃ4\ Y poll.registry().register(&mut sock, Token(0), Interest::READABLE | Interest::WRITABLE)?;Á „ 5
|
|||
|
|
# Ok(())Á <±5Ý� <¹5ßÒ Á5ú ¼Å5 ### Dropping `Poll`Á Ý5ú üá5N K When the `Poll` instance is dropped it may cancel in-flight operations forÁ ü°6O L the registered [event sources], meaning that no further events for them mayÁ ü€7P M be received. It also means operations on the registered event sources may noÁ üÑ7M J longer work. It is up to the user to keep the `Poll` instance alive whileÁ üŸ8, ) registered event sources are being used.Á Ì8ú üÐ8. + [event sources]: ./event/trait.Source.htmlÁ ÿ8ú üƒ9& # ### Accessing raw fd/socket/handleÁ ª9ú ü®9H E Mio makes it possible for many types to be converted into a raw fileÁ ü÷9N K descriptor (fd, Unix), socket (Windows) or handle (Windows). This makes itÁ üÆ:J G possible to support more operations on the type than Mio supports, forÁ ü‘;L I example it makes [mio-aio] possible. However accessing t
|
|||
|
|
` £cûå ` àB¤GS
|
|||
|
|
† ¢ç H “– H
|
|||
|
|
I $”–× š–lü– ›jKMOQST ü¥¶‹ ü�—; 8 Register an [`event::Source`] with the `Poll` instance.Á Зú üØ—J G Once registered, the `Poll` instance will monitor the event source forÁ ü§˜K H readiness state changes. When it notices a state change, it will returnÁ ü÷˜F C a readiness event for the handle the next time [`poll`] is called.Á ™ú üÊ™0 - See [`Poll`] docs for a high level overview.Á ÿ™ú |‡š # ArgumentsÁ ›šú ü£šJ G `source: &mut S: event::Source`: This is the source of events that theÁ üòš? < `Poll` instance should monitor for readiness state changes.Á ¶›ú ü¾›J G `token: Token`: The caller picks a token to associate with the socket.Á ü�œJ G When [`poll`] returns an event for the handle, this token is included.Á üÜœD A This allows the caller to map the event to its source. The tokenÁ ü¥�E B associated with the `event::Source` can be changed at any time byÁ Üï� calling [`reregister`].Á �žú ü—žE B See documentation on [`Token`] for an example showing how to pickÁ ¬áž [`Token`] values.Á ûžú üƒŸJ G `interest: Interest`: Specifies which operations `Poll` should monitorÁ üÒŸJ G for readiness. `Poll` will only return readiness events for operationsÁ ü¡ specified by this argument.Á Å ú üÍ K H If a socket is registered with readable interest and the socket becomesÁ ü�¡6 3 writable, no event will be returned from [`poll`].Á Ø¡ú üà¡L I The readiness interest for an `event::Source` can be changed at any timeÁ ô±¢ by calling [`reregister`].Á Ô¢ú \Ü¢÷à ì¢ú üô¢G D Callers must ensure that if a source being registered with a `Poll`Á üÀ£H E instance was previously registered with that `Poll` instance, then aÁ ü�¤E B call to [`deregister`] has already occurred. Consecutive calls toÁ üפ' $ `register` is unspecified behavior.Á ƒ¥ú ü‹¥K H Unless otherwise specified, the caller should assume that once an eventÁ üÛ¥K H source is registered with a `Poll` instance, it is bound to that `Poll`Á ü«¦I F instance for the lifetime of the event source. This remains true evenÁ üù¦D A if the event source is deregistered from the poll instance usingÁ œÂ§ [`deregister`].Á Ú§ú üâ§0Ÿó ü—¨* ' [`poll`]: struct.Poll.html#method.pollÁ üƨ: 7 [`reregister`]: struct.Registry.html#method.reregisterÁ ü…©: 7 [`deregister`]: struct.Registry.html#method.deregisterÁ üÄ© [`Token`]: struct.Token.htmlÁ é©ú tñ©¤õ „ªú ,Ȫ\ª�ö 䧫¬ö œÈ«öš üà«/Òö ü”¬-‹÷ äƬÁ÷ ìç¬Ü› ü‰' $ use std::time::{Duration, Instant};Á µú ü½ ºú âú üê5Ñœ ü¤®4�� üÝ®A > let mut socket = TcpStream::connect(listener.local_addr()?)?;Á £¯ú ü«¯& # // Register the socket with `poll`Á ìÖ¯‹ë ¤ø¯ &mut socket,Á Œ‘°Ðë ü§°2ìë Þ°ú üæ°1äú üœ± let start = Instant::now();Á üÀ±- * let timeout = Duration::from_millis(500);Á ò±ú Tú±Ãþ ü‰²& # let elapsed = start.elapsed();Á ´²ú ü¼² if elapsed >= timeout {Á üà²# // Connection timed outÁ Ôˆ³ return Ok(());Á L§³½� µ³ú ü½³* ' let remaining = timeout - elapsed;Á üì³1 . poll.poll(&mut events, Some(remaining))?;Á ¢´ú ôª´’ÿ üÍ´* ' if event.token() == Token(0) {Á üü´? < // Something (probably) happened on the socket.Á ôÀµ€� l㵧� Lõµ½� ,ƒ¶Ï� <�¶Ý� <™¶ßÒ D¬¶ ‡ ˆ ‡ ›j ˆ ¤¦q³hñð J ¤ L L ¸¶ J ÎìÄ• µ¶ ¢Ä• l™·
|
|||
|
|
KÄ•
|
|||
|
|
the poll.Á ´Òú ü¼ÒLþš ü�Ó5Õ› ÇÓú üÏÓ? < A handle can be passed back to `register` after it has beenÁ ü“ÔH E deregistered; however, it must be passed back to the **same** `Poll`Á üàÔ4 1 instance, otherwise the behavior is unspecified.Á ™Õú t¡Õ¤õ ´Õú ,øÕ\òÕ�ö ä×Ö¬ö œøÖöš ü�×/Òö üÄ×-‹÷ äö×Á÷ ì—ØÜ› ä¹Ø‚œ ÚØú üâØ ºú ‡Ùú ü�Ù5Ñœ üÉÙ4�� ü‚ÚAóŒ ÈÚú üÐÚ&Ì� ìûÚ‹ë ¤�ÛŠŽ Œ¶ÛÐë ìÌÛ² îÛú üöÛ- * poll.registry().deregister(&mut socket)?;Á ¨Üú ü°Ü1äú æÜú üîÜG D // Set a timeout because this poll should never receive any events.Á üºÝ: 7 poll.poll(&mut events, Some(Duration::from_secs(1)))?;Á üùÝ assert!(events.is_empty());Á „�Þë <²ÞÝ� <¾ÞßÒ TÑÞ ‹ Œ ‹ ›j Œ Ä•ñð J ¤ P P ßÞ J ó• ÜÞ …–l�ß
|
|||
|
|
OÄ•$àÞ¦ 4æÞ') üáá/ ü à1 . Creates a new independently owned `Registry`.Á Öàú üÞàI F Event sources registered with this `Registry` will be registered withÁ ü¬á0 - the original `Registry` and `Poll` instance.ÁLèá � � ›j Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
›jÂñ J òá J
|
|||
|
|
Q $óáT¹â Q <closure_kind>Á R <closure_signature>Á R <upvars>Á R R Q R êj›j ›j üÅå# � „øäúŠ”’åú®Î¬¦åü‘å+ü�å0ü÷äGüîäRtÓå Ž Ž ›j J âå J
|
|||
|
|
S $ãåü°è/ úŠ”Ëç¤Ê结*|àçüÆç*ü½ç5 D¾è � � ›j � êj J Çè J
|
|||
|
|
T $Èèä‚é ›jV Àc V ü¥é: ¨é � ‘ ’ � ›j ‘ c c ˆ ¢cµ
|
|||
|
|
` £cûå ` àB¤GS
|
|||
|
|
’ ¢ç U ¬é U
|
|||
|
|
V $é× ³é´°í ú $¨êÀñ ü¶ê üµê! ú€ Œíêú„ò¤ˆëú—òœ¦ëú½òœÃëú©ò¬àëúî¤ÿëúÜò”�ìúíòŒ¹ìú± ”ÔìúŠó¤ðìú®Î¬ŽíüãêÆüßêËü¢ê‹ü™ê– ›jX Ž, X üÍí!,Ðí “ “ ›j ÎNÎN Ø ÐNÐ%ä+ ÑN _phantomÁä+ §] ò�Þ^ “ W Öí W
|
|||
|
|
X $×í̯ñ ú $§îÀñ üµî ü´î! ú€ Œìîú„ò¤‡ïú—òœ¥ïú½òœÂïú©ò¬ßïúî¤þïúÜò”œðúíòŒ¸ðú± ”ÓðúŠó¤ïðú®Î¬�ñüâîÆüÞîËü¡î‹ü˜î– ›jZ ¬+ Z äÏñLÒñ ” ” ›j Y Üñ Y
|
|||
|
|
Z $Ýñ<§ « ÓÉ $à ¶ ÕÙ)D� ä Õ µÙ) å Õ µÙ+ £! þ Õ”- ¿! • Õí- ž" £ Õ™#,™ û Õ �Å 4Ì ü Õ �Æ,ê ý Õ �Ž ,Ì6 à Õ � Œ“'DÍ ½ Õ �Ó(lª7 Ô Õ � ßÓ( Õ Õ � ßL° ,´ ÉÊÔÏ' ¿r^ ë ^ äð'$ó' ¦q¿r ] ]
|
|||
|
|
^ ¹ ø'L÷ ú®Î¬É úŠ”à üÈ + üÄ 0 ü» ; ,û Þë [ _ aìD @ _ b ´–7, É _ c µ–7 Ê _ c µ“é- ¦ _ d,fhY[HJ<(!T Ìrfh üÜB ̾ Create a new `Waker`.Á ã • • ›j ¦qÖ¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
ÌrÂñ e ñ e
|
|||
|
|
f ÝDçõ,ü<� f ï¶ g ‡· g ¤· g g f g økÌr ü§$ üÁ6 3 Wake up the [`Poll`] associated with this `Waker`.Á üú ô„ [`Poll`]: struct.Poll.htmlÁ$® – – Ìr ñð e ³ e
|
|||
|
|
h $´lƒ ü ( % Readiness event types and utilities.Á ,‹ j‚œ™#,† â «Å 4¤ † Î8$¬ æ ®Ü4É ¢ ¯LM ,Qiâë [ j l–7, É j m µ–7 Ê j m µ× # ¤, j n,PRCED T¹ €spqrstuvwxy äí ôÊ Returns the event's token.Á,ô — — €s ¦q o ú o
|
|||
|
|
p $ûüÿ! ü¾: 7 Returns true if the event contains readable readiness.Á ýú \…÷à •ú ü�B ? Out-of-band (OOB) data also triggers readable events. But mostÁ üäB ? applications don't actually read OOB data, this could leave anÁ ü«= : application open to a Denial-of-Service (Dos) attack, seeÁ üíŒ ‰ <https://github.com/sandstorm-io/sandstorm-website/blob/58f93346028c0576e8147627667328eaaf4be9fa/_posts/2015-04-08-osx-security-bug.md>.Á üþL I However because Mio uses edge-triggers it will not result in an infiniteÁ üÏ+ ( loop as described in the article above.Á\† ˜ ˜ €s o ’ o
|
|||
|
|
q $“ üš
|
|||
|
|
! üÛ : 7 Returns true if the event contains writable readiness.Á\¡
|
|||
|
|
™ ™ €s o
|
|||
|
|
o
|
|||
|
|
r $®
|
|||
|
|
ô� üö
|
|||
|
|
7 4 Returns true if the event contains error readiness.Á ² ú üº K H Error events occur when the socket enters an error state. In this case,Á üŠ I F the socket will also receive a readable or writable event. Reading orÁ üØ 2 / writing to the socket will result in an error.Á �
|
|||
|
|
ú \—
|
|||
|
|
÷à §
|
|||
|
|
ú ü¯
|
|||
|
|
K H Method is available on all platforms, but not all platforms trigger theÁ „ÿ
|
|||
|
|
|
|||
|
|
error event.Á ”ú üœ< 9 The table below shows what flags are checked on what OS.Á Ýú üå' $ | [OS selector] | Flag(s) checked |Á ü‘' $ |---------------|-----------------|Á ü½' $ | [epoll] | `EPOLLERR` |Á üéI F | [kqueue] | `EV_ERROR` and `EV_EOF` with `fflags` set to `0`. |Á ·ú ü¿; 8 [OS selector]: ../struct.Poll.html#implementation-notesÁ üÿ?ÎÈ üÃHøÉD— š š €s o o
|
|||
|
|
s $¡üº $ üæ= : Returns true if the event contains read closed readiness.Á ¨ú \°÷à Àú üÈI F Read closed readiness can be expected after any of the following haveÁ l–
|
|||
|
|
occurred:Á ü¨? < * The local stream has shutdown the read half of its socketÁ üìI F * The local stream has shutdown both the read half and the write halfÁ œº of its socketÁ üÒJ G * The peer stream has shutdown the write half its socket; this sends aÁ ü¡= : `FIN` packet that has been received by the local streamÁ ãú üëH E Method is a best effort implementation. While some platforms may notÁ ü¸D A return readiness when read half is closed, it is guaranteed thatÁ ü�# false-positives will not occur.Á ©ú ü±<É× òú üú'›Ø ü¦'ÌØ üÒ' $ | [epoll] | `EPOLLHUP`, or |Á üþ2 / | | `EPOLLIN` and `EPOLLRDHUP` |Á üµ' $ | [kqueue] | `EV_EOF` |Á áú üé;�Ú ü©?ÎÈ üíHøÉtÁ › › €s o Ð o
|
|||
|
|
t $Ñ ü˜&% üœ > ; Returns true if the event contains write closed readiness.Á ß ú \ç ÷à ÷ ú üÿ E B On [epoll] this is essentially a check for `EPOLLHUP` flag as theÁ üÉ J G local stream shutting down its write half does not trigger this event.Á ˜ ú ü D A On [kqueue] the local stream shutting down the write half of itsÁ üé # socket will trigger this event.Á ‘ ú ü™ Hñß üæ E B return readiness when write half is closed, it is guaranteed thatÁ ü°!#‘á Ø!ú üà!<É× ¡"ú ü©"'›Ø üÕ"'ÌØ ü�#'€â ü#+ ( | | only `EPOLLERR`, or |Á üÝ#1 . | | `EPOLLOUT` and `EPOLLERR` |Á ü“$'íâ ¿$ú üÇ$;�Ú ü‡%?ÎÈ üË%HøÉ|Ÿ& œ œ €s o ¯& o
|
|||
|
|
u $°&ü«,! üü&: 7 Returns true if the event contains priority readiness.Á »'ú \Ã'÷à Ó'ú üÛ'KÏÖ œ«( priority event.Á Ã(ú üË(<É× Œ)ú ü”)'›Ø üÀ)'ÌØ üì)' $ | [epoll] | `EPOLLPRI` |Á ü˜*' $ | [kqueue] | *Not supported* |Á Ä*ú üÌ*;�Ú üŒ+?ÎÈ üÐ+HøÉ\², � � €s o ¾, o
|
|||
|
|
v $¿,äÜ2 ü‡-5 2 Returns true if the event contains AIO readiness.Á Á-ú \É-÷à Ù-ú üá-L I Method is available on all platforms, but not all platforms support AIO.Á ².ú üº.<É× û.ú üƒ/'›Ø ü¯/'ÌØ üÛ/' $ | [epoll] | *Not supported* |Á ü‡0+ ( | [kqueue]<sup>1</sup> | `EVFILT_AIO` |Á ·0ú ü¿0? < 1: Only supported on DragonFly BSD, FreeBSD, iOS and macOS.Á ƒ1ú ü‹1;�Ú üË1?ÎÈ ü�2HøÉ4ã2 ž ž €s o ê2 o
|
|||
|
|
w $ë2ä’5 ü®35 2 Returns true if the event contains LIO readiness.Á è3ú \ð3÷à €4ú üˆ4K H Method is available on all platforms, but only FreeBSD supports LIO. OnÁ üØ45 2 FreeBSD this method checks the `EVFILT_LIO` flag.Á4™5 Ÿ Ÿ €s o 5 o
|
|||
|
|
x $¡5ü6B”»6 °¤ €s o Ù6 o
|
|||
|
|
y sys_eventÁLÎ6Ì°; üë8J G When the [alternate] flag is enabled this will print platform specificÁ ü¶9O L details, for example the fields of the `kevent` structure on platforms thatÁ ü†:K H use `kqueue(2)`. Note however that the output of this implementation isÁ üÒ:. + **not** consider a part of the stable API.Á �;ú ü…;* ' [alternate]: fmt::Formatter::alternateÁ €s{ Àc { üÐ;8 Ó; ¡ ¢ £ ¡ €s ¢ c c ˆ ¢cµ
|
|||
|
|
` £cûå ` àB¤GS
|
|||
|
|
£ ¢ç z ×; z
|
|||
|
|
{ $Ø;± Þ;NQ dÇ@j Œ ~ ~ | | }õ ˆ j "ž¡Ë‚_V Œ "ž¡Ë‚_V } Œ °¤ úû NQy j Æüúû | |
|
|||
|
|
} Œ Ô@tØ@j | | Æüüö@$ 8 ¤ ¤ ¾s� Àc � üA8 °A ¥ ¦ § ¥ ¾s ¦ c c ˆ ¢cµ
|
|||
|
|
` £cûå ` àB¤GS
|
|||
|
|
§ ¢ç € ´A €
|
|||
|
|
� 8$µA± »ATX 4\i†æ™#, â ‚ ƒ «ë $ [ ‚ „× 3 ¤, ‚ …œ?T ,D. Œ„ ü9% " A collection of readiness events.Á _ú ücK H `Events` is passed as an argument to [`Poll::poll`] and will be used toÁ ü¯M J receive any new readiness events received since the last poll. Usually, aÁ üýJ G single `Events` instance is created at the same time as a [`Poll`] andÁ üÈ* ' reused on each call to [`Poll::poll`].Á óú ü÷3 0 See [`Poll`] for more documentation on polling.Á «ú ü¯3 0 [`Poll::poll`]: ../struct.Poll.html#method.pollÁ üã! [`Poll`]: ../struct.Poll.htmlÁ …ú t‰¤õ ˜ú ,Â\¼�ö 䃬ö ü /Òö äÐ use mio::{Events, Poll};Á äí‚œ Šú üŽ1äú üÀ ºú ,á #Á üç! # assert!(events.is_empty());Á ‰ú ü�- * // Register `event::Source`s with `poll`.Á »ú ü¿> ; poll.poll(&mut events, Some(Duration::from_millis(100)))?;Á þú ü‚ for event in events.iter() {Á ü£9 6 println!("Got an event for {:?}", event.token());Á ,ÝÏ� „ãë <ôÝ� <üßÒ 4� Ît 1Nÿ8Þ? ‡”œ ,œ ‚ † † ªBªB ö Bûå÷< ®B‘÷< 9)
|
|||
|
|
-ÜnL°¤ßu\‹ Ît‰Š‹Œ�Ž ü¢/ ü�E B Return a new `Events` capable of holding up to `capacity` events.Á çú tï¤õ ‚ú <ŠßÒ ¤– use mio::Events;Á ¯ú ü·- * let events = Events::with_capacity(1024);Á üé( % assert_eq!(1024, events.capacity());Á <–ßÒl© ¿rÎt ˆ ˆ
|
|||
|
|
‰ ú D·ü– ü³> ; Returns the number of `Event` values that `self` can hold.Á öú <þßÒ ¤Šù‰ £ú ü«-£Š üÝ(ÚŠ <ŠßÒD� ¨ ¨ Ît ¿r ˆ ¦ ˆ
|
|||
|
|
Š $§ôÐ üá8 5 Returns `true` if `self` contains no `Event` values.Á žú t¦¤õ ¹ú <ÁßÒ ¤Íù‰ æú üî-£Š ü î± <ÄßÒD× © © Ît ˆ à ˆ
|
|||
|
|
‹ $áôù üš0 - Returns an iterator over the `Event` values.Á Ïú tפõ êú ,˜\’�ö äá¬ö ü‚/Òö ä¶öƒ äׂœ øú ü€1äú ü¶ ºú Ûú üã$ ! // Register handles with `poll`.Á Œ ú ü” >Ù… × ú üß † ü„ 9׆ , Ï� „Ì ë <á Ý� <í ßÒ $€ ª ª Ît æ æ Î8 èÓ ‚ éê8 ‚ tâQóÜ°Í™ ª ˆ … ˆ
|
|||
|
|
Œ $† ¼Å% üë : 7 Clearing all `Event` values from container explicitly.Á ª ú \² ÷à  ú üÊ I F Events are cleared before every `poll`, so it is not required to callÁ ”˜ this manually.Á ¯ ú t· ¤õ Ê ú ,ø \ò �ö äÁ!¬ö üâ!/Òö ä–"öƒ ä·"‚œ Ø"ú üà"1äú ü–# ºú »#ú üÃ#$®‘ ì#ú üô#>Ù… ·$ú Ä¿$ // Clear all events.Á œÜ$ events.clear();Á üô$ î± „˜%ë <%Ý� <¹%ßÒ ,Ì% « « Ît ˆ Ò% ˆ
|
|||
|
|
� $×%ü¯&0 ½& ¬ ¬ Ît ¬ …‰ ˆ Á& ˆ
|
|||
|
|
Ž $Æ&üƒ'$ Œ � � Èt‘’“ ÈL ÉL ÊL “ ˆ'L®'$³' � � Œ €s lÉ'DÎ' � � ÷süè'$Lë' ÈtÈt ÉL � �
|
|||
|
|
“ Œ $õ'ô¬( Œ • • ÷s–—˜™ úM ûM ÿM €N — ˜ ™ ±(LÑ($Ö( ” ” úšüí(($ð( ÷sۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙ÷s úM ” õ( ”
|
|||
|
|
— Œ $ú(üË*-LÎ* ® ® ÷s ¿rÛ¼
|
|||
|
|
` £cûå ` àB¤GS
|
|||
|
|
± ¢ç š ¶, š
|
|||
|
|
› $·,± ½,Td 4hi¢ˆ D À œ ž ±ìD @ œ Ÿ ´–7, É œ µ–7 Ê œ µ“é2 ¦ œ ¡,uwacNP<-#„Ÿ ü7= : An event source that may be registered with [`Registry`].Á uú üy? < Types that implement `event::Source` can be registered withÁ ü¹I F `Registry`. Users of Mio **should not** use the `event::Source` traitÁ üƒN K functions directly. Instead, the equivalent functions on `Registry` shouldÁ dÒ be used.Á ßú üã& # See [`Registry`] for more details.Á Šú üŽ) & [`Registry`]: ../struct.Registry.htmlÁ ¸ú ü¼" # Implementing `event::Source`Á ßú üãO L Event sources are always backed by system handles, such as sockets or otherÁ ü³J G system handles. These `event::Source`s will be monitored by the systemÁ üþL I selector. An implementation of `Source` will almost always delegate to aÁ üËO L lower level handle. Examples of this are [`TcpStream`]s, or the *unix only*Á Œ› [`SourceFd`].Á ú ü±/ , [`TcpStream`]: ../net/struct.TcpStream.htmlÁ üá. + [`SourceFd`]: ../unix/struct.SourceFd.htmlÁ �ú ü” # Dropping `event::Source`sÁ ´ú ü¸O L All `event::Source`s, unless otherwise specified, need to be [deregistered]Á üˆN K before being dropped for them to not leak resources. This goes against theÁ ü×O L normal drop behaviour of types in Rust which cleanup after themselves, e.g.Á ü§ K H a `File` will close itself. However since deregistering needs access toÁ üó 9 6 [`Registry`] this cannot be done while being dropped.Á
|
|||
|
|
ú ü±
|
|||
|
|
= : [deregistered]: ../struct.Registry.html#method.deregisterÁ ï
|
|||
|
|
ú tó
|
|||
|
|
¤õ ‚ ú ü† : 7 Implementing `Source` on a struct containing a socket:Á Á ú ,� \û �ö üØ ) & use mio::{Interest, Registry, Token};Á Ü‚
|
|||
|
|
use mio::event::Source;Á äž
|
|||
|
|
Á÷ »
|
|||
|
|
ú „¿
|
|||
|
|
|
|||
|
|
use std::io;Á Ð
|
|||
|
|
ú ÌÔ
|
|||
|
|
# #[allow(dead_code)]Á Ìî
|
|||
|
|
pub struct MySource {Á Ôˆ socket: TcpStream,Á ,£Ï� ©ú ô impl Source for MySource {Á üÌV S fn register(&mut self, registry: &Registry, token: Token, interests: Interest)Á ì£ -> io::Result<()>Á LÁ {Á üË7 4 // Delegate the `register` call to `socket`Á üƒ< 9 self.socket.register(registry, token, interests)Á LÀ½� Êú üÎX U fn reregister(&mut self, registry: &Registry, token: Token, interests: Interest)Á 짳² LÅÙ² üÏ9 6 // Delegate the `reregister` call to `socket`Á ü‰> ; self.socket.reregister(registry, token, interests)Á LȽ� Òú üÖI F fn deregister(&mut self, registry: &Registry) -> io::Result<()> {Á ü 9 6 // Delegate the `deregister` call to `socket`Á üÚ, ) self.socket.deregister(registry)Á L‡½� ,‘Ï� <—ßÒ 4© ¢ ¢ Îì üŸ– ¢ ´¹ ´¹ £¤¥£¤¥ £ ¤ ¥ üŒˆ ü¶7 4 Register `self` with the given `Registry` instance.Á òú üúK H This function should not be called directly. Use [`Registry::register`]Á üÊK H instead. Implementors should handle registration by delegating the callÁ ìš to another `Source` type.Á ¼ú üÄC @ [`Registry::register`]: ../struct.Registry.html#method.registerÁD� ² ³ ² ¼¹ ³ ›j ¦q³hñð ¢ ¡ ¢
|
|||
|
|
£¼¹$¦ÝD´õ,ѹ•LçüƒŠ üš: 7 Re-register `self` with the given `Registry` instance.Á Ùú üá4 1 This function should not be called directly. UseÁ üš@ = [`Registry::reregister`] instead. Implementors should handleÁ üßK H re-registration by either delegating the call to another `Source` type.Á ¯ú ü·G D [`Registry::reregister`]: ../struct.Registry.html#method.reregisterÁT† ´ µ ´ ¼¹ µ ›j ¦q³hñð ¢ š ¢
|
|||
|
|
¤¼¹$ŸÝDõ,ʹ•Làüó @ ü“ 9 6 Deregister `self` from the given `Registry` instance.Á Ñ ú üÙ 4ß½ ü’ @ = [`Registry::deregister`] instead. Implementors should handleÁ ü× C @ deregistration by delegating the call to another `Source` type.Á Ÿ ú ü§ G D [`Registry::deregister`]: ../struct.Registry.html#method.deregisterÁTö ¶ · ¶ ¼¹ · ›j ñð ¢ � ¢
|
|||
|
|
¥¼¹$† ÝDŒ ü· 7 ¥ § § ÎìÙu ¼ ¢Ùu 4Þ ˜u¨©ª £ ¤ ¥ ª ¨ © 79 üõ ‡Dø ¸ ¹ ¸ ˜u ¹ ›j ¦q³hñð ¦ Š ¦
|
|||
|
|
¨Ùu$� ÝD� õ,º ¹•LÐ üÀ!‰TÃ! º » º ˜u » ›j ¦q³hñð ¦ ×! ¦
|
|||
|
|
©Ùu$Ü!ÝDê!õ,‡"¹•L�"ü�#?T’# ¼ ½ ¼ ˜u ½ ›j ñð ¦ �# ¦
|
|||
|
|
ªÙu$¢#ÝD¨#”yô>d•é>ì>Ý>à>¤»Õ>ló 'R”Š
|
|||
|
|
=R$¦
|
|||
|
|
OROR`R`RdÆ
|
|||
|
|
qRd˜ •RdŠ Ì� Unix only extensions.Á ú $± »¶¶”· Ô° ü§% $’ ¸Ù)D ä ½ Õ µÙ)+D å ½ Õ µd¼ tÓ Unix pipe.Á ê ú üö/ , See the [`new`] function for documentation.Á $Ä æ Ê õ ºò6DÏ Å »Ï64Ù Á ¼„· 79)+ ¤õ ôD„¡ ô¸ # Mio's optional features.Á Û ú üã: 7 This document describes the available features in Mio.Á ¢ ú ÄÑ ôË ## `os-poll` (enabled)Á ¼ ú üÄJ G Mio by default provides only a shell implementation that `panic!`s theÁ ü“E B moment it is actually run. To run it requires OS support,
|
|||
|
|
–† ³hÈ › È ! ' < À À ³h Ç † Ç
|
|||
|
|
È …(Š
|
|||
|
|
³h / 3 ³hË Ù Ë MO Á Á ³h ³h Ê Š Ê
|
|||
|
|
Ë ˜P‘ ³hÍ ïß Í "$  à  ³h à ³h ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙ¿ßÀßÁß LessÁ Âß ÃßÄß~ Åß ÆßÇß GreaterÁ Èß åºÝÈnûê7 Ì ‘ Ì
|
|||
|
|
Í #¹
|
|||
|
|
*� ³hÏ » Ï !# Ä Å Ä ³h Å ³h ÈŽ Î � Î
|
|||
|
|
Ï ~¹
|
|||
|
|
„üŸk üë] Return a new `Poll` handle.Á “^ú üŸ^G D This function will make a syscall to the operating system to createÁ üï^G D the system selector. If this syscall fails, `Poll::new` will returnÁ œ¿_ with the error.Á Û_ú üç_U R close-on-exec flag is set on the file descriptors used by the selector to preventÁ üÅ`F C leaking it to executed processes. However, on some systems such asÁ ü”aK H old Linux systems that don't support `epoll_create1` syscall it is doneÁ üèaF C non-atomically, so a separate thread executing in parallel to thisÁ ü·bG D function may accidentally leak the file descriptor if it executes aÁ ü‡c- * new process before this function returns.Á ½cú üÉc- * See [struct] level docs for more details.Á ÿcú ô‹d†à ²dú t¾d¤õ Õdú <ádßÒ äñd¬ö ü–e/Òö äÎe use mio::{Poll, Events};Á äóe‚œ ˜fú ü¤f& # let mut poll = match Poll::new() {Á ÌÓf Ok(poll) => poll,Á üõfH E Err(e) => panic!("failed to create Poll instance; err={:?}", e),Á 4Æg };Á Õgú üág2 / // Create a structure to receive polled eventsÁ üœh1äú Öhú üâh< 9 // Wait for events, but none will be received because noÁ ü§iG D // `event::Source`s have been registered with this `Poll` instance.Á ü÷i> ; poll.poll(&mut events, Some(Duration::from_millis(500)))?;Á ü¾j î± „æjë <ÿjÝ� <�kßÒ »Ø ˜)ˆ Ø)‚ ¦k Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
àiÂñ C C
|
|||
|
|
Ð Tçk Ð ï¶ Ñ ‡· Ñ ¤· Ñ Ñ Ð Ñ Ê¸ài ̨ »Ø ˜5ˆ Ø5‚ dµ Â Ù Ì Ø , Ú 8! $Û & ß 8¼ ,á ç ÷ , è 8
|
|||
|
|
event_typeÁ Té & ó 8´ õ $ ø , ú 8‚ $û & ÿ 8õ
|
|||
|
|
$� $ … , “ ” Æ , • – § + — ˜ ¦ , ™ 8ê 4š & 8û $¢
|
|||
|
|
¨ , ª 8– $« & ¯ 8¼ ,± '· , º 8 flagÁ $» & ¿ 8¼ ,Á $ Ç È , Ê Ë Í $ Ì
|
|||
|
|
Î *Ú Ý Ò
|
|||
|
|
8 4ë , ò 8! $ó ÷ ƒ , ø 8ßž Tù % „ 8 $“ 8× ˜ '› 8p ,� 8
|
|||
|
|
£ , § 8! $¨ È 8 ¿ 8× Â Å ç
|
|||
|
|
Æ 8 $Ç $ Ë 8± Í & Î Ð 8 Ñ 8× Õ 'Ø 8ˆ LÚ ã :8 ä æ (é 8× ì 'ï 8Í 4ñ ø º 8 Ž 8 ’ 8 written_oneÁ \– ¢ 8 ,¤ % © , ¿ À ‚ , Ú Û æ + Ü Ý å , Þ 8ê 4ß
|
|||
|
|
ç + � ‚ ž 8« ,ƒ ˆ � 8� 4‰ '� 8 bad_bit_maskÁ d‘ Û ì
|
|||
|
|
8 É
|
|||
|
|
, Ì
|
|||
|
|
8‚ $Í
|
|||
|
|
Ñ
|
|||
|
|
ê
|
|||
|
|
Ò
|
|||
|
|
8 $Ó
|
|||
|
|
×
|
|||
|
|
7ˆ Ø
|
|||
|
|
$ Ù
|
|||
|
|
Û
|
|||
|
|
, Ü
|
|||
|
|
8– $Ý
|
|||
|
|
'â
|
|||
|
|
, å
|
|||
|
|
8Ñ $æ
|
|||
|
|
ì
|
|||
|
|
Ò
|
|||
|
|
8 Ž ‘ 8�¤ \’ ž Á 8í2 ,Ä É Ê å 8± Ë $ Ì 7û $Î $ Ò 8Ô LÔ Ý Þ ä , ß 8Ñ $à - æ % ç 8�¤ \� ™ 8 $› % Ÿ 8 $Ã È ´
|
|||
|
|
8í2 ,î ó ô �
|
|||
|
|
8± õ $ ö 7 |{}Á ,ø $ ý 8Ô Lÿ ˆ
|
|||
|
|
‰
|
|||
|
|
�
|
|||
|
|
, Š
|
|||
|
|
8Ñ $‹
|
|||
|
|
- ‘
|
|||
|
|
% ’
|
|||
|
|
ƒ 8 ™ œ 8�¤ \� © ì 8í2 ,Ã È É Ö 8± Ê $ Ë 7 (empty)Á LÍ 8 $î ó ¨ 8« � � ’ � ‘ % Ó DØ »Ø ˜6ˆ Ø6‚ $Ü[ÖŽ¨¶ëþ•£Ù)Dà ä µÙ) å µ™#Üt û �Å ×t ü �ÆÒt ý �Ž Ít à � Œ“'Èt ½ �Ó(Ãt Ô � ßÓ(Út Õ � ߤž<« ³ ¸ ¹ ß , º 8 » & ½ 8¼ ,¿ Å Ý , Ç È Ó , É 8 argÁ Ê & Í 8› $Ï $ Ô
|
|||
|
|
Õ , × Ø Ú $ Ù
|
|||
|
|
Û *á ä µ å ´ + ï ð … 8« ,ñ ö „ 8
|
|||
|
|
unused_unsafeÁ l÷ 8 � 8 resÁ “ — 8" 4™ ¸ 8– $¢ '¦ , ¨ 8 © « ¶ , ¬ ´ , ® 8”® ¯ $ ²
|
|||
|
|
µ % ¹ 8 Ã 8Ó¯ Æ Ê 7ˆ Ì Î ‰ 8 Ü ß ÿ 8À à 'ã 8“é å 'ç 8„ç ,é 'î 8
|
|||
|
|
last_os_errorÁ lð ý þ 8 $‹ � ® 8« ž ¤ 8Ó¯ ¡ % ¶ T‹dË
|
|||
|
|
»Ø ˜7ˆ Ø7‚ /DÏ
|
|||
|
|
Óìúûüý½Í“é ¦ Ö ×¨ $ �, Ö Ù¸<% «+ Ö ÚØ T. ÎN Ö ÛÖL: + Ö Üª
|
|||
|
|
<E ö+ Ö Ýô,N ª+ Ö Þ AtomicUsizeÁ\‡ „Ä Ö à®D” ¼À Ö áäèD® Ö Ö â EPOLLETÁ<Ä ñ Ö ä EPOLLINÁ<Í ã Ö å EPOLLOUTÁDÖ å Ö æ EPOLLPRIÁDà ä Ö ç
|
|||
|
|
EPOLLRDHUPÁTê í Ö èˆ D„ À Ö ê ±–7,Ž É Ö ë µ–7 Ê Ö ë µŽ Èy à Œµ µ “ Ö ¼Ó(¼y Ô ßÓ(Ïy Õ ß< \ý ïòáäÓÖÅÈ·ºŒs¡¤‘”œ£„$½nqWZ?B'*
|
|||
|
|
,üîðÜý � „êÄä<„ Ö š C l˜ / êjîïñôÂÄ ü¬$ ³ Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
êjÂñ í í
|
|||
|
|
î ü�/L” Æ Æ êj ’º í ž í
|
|||
|
|
ï $Ÿ$ß ï ï¶ ð ‡· ð ¤· ð ð ï ð ¶nêj êj ü‘ V4˜ Ç È Ç êj È …‰åïñð í Ÿ í
|
|||
|
|
ñ $ ¨ 4¦ ›ñ<» $™
|
|||
|
|
ñ ï¶ ò ‡· ò ¤· ò ò ñ ò ªð T� ñ ï¶ ó ‡· ó ¤· ó ó ñ ó …‰üÓVDÚ É É êj ¦q³hñð í ã í
|
|||
|
|
ô $äÐ%êõ,õ¹•Lƒ ï ô ï¶ õ ‡· õ ¤· õ õ ô õð¾ ´� / êj÷ Ž, ÷ üº!,½ Ê Ê êj ÎNÎN Ø ÐNÐ%ä+ ÑN›¾ä+ §] ò�Þ^ Ê ö à ö
|
|||
|
|
÷ $ÄÌÿ / êjù ¬+ ù äŸ L¢ Ë Ë êj ø ¬ ø
|
|||
|
|
ù $ üã 1”æ Ö ³h
|
|||
|
|
ú ¹•Lù tŸ ,¨ °¤|à ÷ …‰lâ /ô �‚ƒ„…†‡ˆ‰Š× ÿ ¤, ý þ™#T€ û ý ÿ Õ �–7,¯ É ý € µ–7 Ê ý € µDú dŒ� ©€d¨ @ü» $,Â Ì Ì °¤ ¦q Ï
|
|||
|
|
� Æ,È ü�!)\–! Í Í °¤ ©!
|
|||
|
|
‚ Æ,¢!üÄ")\Ë" Î Î °¤ Þ"
|
|||
|
|
ƒ Æ,×"ü·#&D¾# Ï Ï °¤ Î#
|
|||
|
|
„ Æ,Ç#ü§$,t®$ Ð Ð °¤ Ä$
|
|||
|
|
… Æ,½$ü˜'-|Ÿ' Ñ Ñ °¤ ¶'
|
|||
|
|
† Æ,¯'üõ*)\ü* Ò Ò °¤ �+
|
|||
|
|
‡ Æ,ˆ+üè+ 4ï+ Ó Ó °¤ ù+
|
|||
|
|
ˆ ö+üÚ, 4á, Ô Ô °¤ ë,
|
|||
|
|
‰ è,ü°-Nl·- Õ Ö × Õ c c ˆ ¢cµ
|
|||
|
|
` £cûå ` àB¤GS
|
|||
|
|
Ö × °¤ ¢ç È-
|
|||
|
|
Š ± Å-Æ,á-ü¾.6dÁ. ý Ø Ù Ø Ù Ó.
|
|||
|
|
‹ gotÁ Î. wantÁ$Ù.ô³6I„tì
|
|||
|
|
Lì »Ø y w /,ð Óà FileÁ$
|
|||
|
|
� Ž �“é$! ¦ Ž ‘ ReadÁ$' à Ž ’ WriteÁ,- Ÿ! Ž “¸<i «+ Ž •ÖLr + Ž –ô,} ª+ Ž —“'Dî ½ Ž ˜ Õ �ˆ D„ À Ž š ±–7,Ž É Ž › µ–7 Ê Ž › µlþ<î ÛÝÆÈ\[¹»©«™›¤â�,üvxacTþ / øk�žŸ¡¢£¤ üÔI â Ú Ú êj ¦qÖ¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
økÂñ œ ð œ
|
|||
|
|
� ûDæõ,ûüº5„È „Ð œ œ
|
|||
|
|
ž üÄ +$Ò Û Û øk ñð œ × œ
|
|||
|
|
Ÿ $Ø ¤ ¿rü¢"l° Ü Ü øk œ ¾ œ
|
|||
|
|
¡ $¿ü¶(Ä Ý Ý øk ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙ œ Ç œ
|
|||
|
|
¢ $Èü—",¥ Þ Þ øk œ « œ
|
|||
|
|
£ $¬üé!,ì Ž ß ß øk ñð œ ò œ
|
|||
|
|
¤ $ó § ¿r´‘ / øk§ ¬+ § ä®L± à à øk ¦ » ¦
|
|||
|
|
§ $¼d— »Ø ZX»¶¶”þ Ôø /D› Óäå“é ¦ ¨ ©ô,@ ª+ ¨ ªÆ,– i ¨ ¬ˆ D� À ¨ ±ìD§ @ ¨ ® ´–7,± É ¨ ¯ µ–7 Ê ¨ ¯ µ<Ÿ”3�,Ž‚„rt]_IKüŠ' / Œ ± ± ·l²³´ £ ¤ ¥ ³ ´ ² �ü¸‡D» á â á ·l â ›j ¦q³hñð ° Í °
|
|||
|
|
² Œ $ÒÝDàõ,ý¹•L“ü�‰T� ã ä ã ·l ä ›j ¦q³hñð ° ¤ °
|
|||
|
|
³ Œ $©ÝD·õ,Ô¹•Lêüæ ?Té å æ å ·l æ ›j ñð ° ô °
|
|||
|
|
´ Œ $ù ÝDÿ ÄÐ †œ‡, »Ø " »¶¶”ž# mio_unsupported_force_waker_pipeÁ üó# Àñ üþ$ ú freebsdÁ¬È%ú iosÁŒó%ú macosÁœš&ú tvosÁ”Ã&ú visionosÁ´ë&ú watchosÁ¬—'ü²%�ü¤$ªú€ Œ£(ú dragonflyÁ¼Â(ú½òœç(úÜò”ˆ)ú netbsdÁ¤¨)úíòŒÊ)ú openbsdÁ¬é)ú redoxÁœŒ* Àñ ü±* úŸ ¬Ò*ü°*8ú± ”ö*úŠó¤–+üÄ"ñúî¤Ã+´Â+úŠ”æ+¤å+ü·"É ü®"Ô /$–, ¹õÀÁÅ“éM ¦ ¶ ·ô,b ª+ ¶ ¸ôË$Å � ¶ Þ IoSliceÁ<Ù æL ¶ à
|
|||
|
|
IoSliceMutÁTâ ö ¶ á¡Ì$î à ¶ â¹Ì,ô Ÿ! ¶ 㨠$Ž �, ¶ å¸<” «+ ¶ æØ T� ÎN ¶ çÖL© + ¶ èŒ
|
|||
|
|
L´ ¯+ ¶ éª
|
|||
|
|
<¿ ö+ ¶ ê®o\Ü Þ1 ¶ ìãlTé º1 ¶ íën\õ Î1 ¶ îÿ9Dš � ¶ ïÆ,° i ¶ ñˆ D· À ¶ ò ±ìDÁ @ ¶ ó ´–7,Ë É ¶ ô µ–7 Ê ¶ ô µ<Hî”Uàüj1<x Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
¿r Âñ
|
|||
|
|
¹ ˜ ¿r · ¿rD°�œÂ 2e� êj %†Jè ¥- ¾¿Lù � „âÄÜùÖ ½ ½ ¿r\ˆˆÖ ½ ½ ¶n(9º ? êjÁ Àc Á !# ç è é ç êj è c c ˆ ¢cµ
|
|||
|
|
` £cûå ` àB¤GS
|
|||
|
|
é ¢ç À 9º À
|
|||
|
|
Á ıÊü˜X »¶¶�=¶ »“*x=Ê ø=µ % ø=¬ 0 TŸ ê ê êj ¦q³hñð í ª í
|
|||
|
|
 $«Ð%±õ,¼¹•LÊ ¶ Â ï¶ Ã ‡· à ¤· à à  Ãð¾ üÉ5 »¶¶ý»“*ú÷ó TÐ ë ë êj ñð í Û í
|
|||
|
|
Ä $ÜÐ%â õ Ä ï¶ Å ‡· Å ¤· Å Å Ä Åð¾ l¡ »“*x@Ö ú @ë »¶¶�@ñ Ð@ê ø@Õ 0 ø@Ì ; 7 êjÇ ÌÚ � „¿Ä¹á ì ì êj ¿r Æ ä Æ
|
|||
|
|
Ç $å6P 8lÒ/ý ¿k bkåêm,úÀ É Ê ¿k 6P6 ý ¿k È È
|
|||
|
|
É XAøý È È ÈA“ 8 ¿kÌ Àc Ì øA¿8AÂ í î ï í ¿k î c c ˆ ¢cµ
|
|||
|
|
` £cûå ` àB¤GS
|
|||
|
|
ï ¢ç Ë AÆ Ë
|
|||
|
|
Ì ADZAͼé6 »“*x¤Ö ú ¤ë »¶¶�¤ñ Фê ø¤Õ 0 ø¤Ì ; 9œí6ÖÔÕ“éW ¦ Í Îô,l ª+ Í Ïˆ D€ À Í Ñ ±ìDŠ @ Í Ò ´–7,” É Í Ó µ–7 Ê Í Ó µ<R‹”_|,xmoXZDFü� 9l¯ Ô Ô ÕÓ( ýH Š©
|
|||
|
|
T ýH Š©
|
|||
|
|
T Õ QL Ô Ô ¶ñ”¿ 9 ¶ñ×ØÜÝÞ üØ$ æ ¶ñ Ö Ö
|
|||
|
|
× ü t,® ñ ò ñ ¶ñ — ò Ùu Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
£Âñ Ö ¥ Ù — Ú £ Û Û Ù Ú ½ Ö ÍìÙu ´ Íì°ó · Íì�ô º ð –"°ó ð Ùu Üø ð °ó�õ˜" Áól†
|
|||
|
|
ØÙu°ó�ô$¾± Ä“éÊŽ� ŠŒ †ˆ üŒ¥Dš ó ô ó ¶ñ ô ›j ¦q³hñð Ö ¬ Ö
|
|||
|
|
Ü $±ÝD¿õ,ܹ•LòÐ%�ü¬§Tº õ ö õ ¶ñ ö ›j ¦q³hñð Ö Î Ö
|
|||
|
|
Ý $ÓÝDáõ,þ¹•L”Ð%±üÐUTÞ ÷ ø ÷ ¶ñ ø ›j ñð Ö é Ö
|
|||
|
|
Þ $îÝDôÐ%‰ ü•7"‚š¼Ó :,å øk œ÷Ö³^ú áDññŽ à à �� ôË �Ó õ ýmï˜"ù.» (¥Ë ¤ økã Àc ã #% ù ú û ù øk ú c c ˆ ¢cµ
|
|||
|
|
` £cûå ` àB¤GS
|
|||
|
|
û ¢ç â ¥Ë â
|
|||
|
|
ã DZ̓P üºH E Adapter for [`RawFd`] providing an [`event::Source`] implementation.Á ƒú ü‡E B `SourceFd` enables registering any type with an FD with [`Poll`].Á Íú üÑI F While only implementations for TCP and UDP are provided, Mio supportsÁ ü›N K registering any FD that can be registered with the underlying OS selector.Á üê- * `SourceFd` provides the necessary bridge.Á ˜ú üœL I Note that `SourceFd` takes a `&RawFd`. This is because `SourceFd` **doesÁ üéH E not** take ownership of the FD. Specifically, it will not manage anyÁ ü²P M lifecycle related operations, such as closing the FD on drop. It is expectedÁ üƒ= : that the `SourceFd` is constructed right before a call toÁ üÁ= : [`Registry::register`]. See the examples for more detail.Á ÿú üƒ1 . [`event::Source`]: ../event/trait.Source.htmlÁ üµ!ü‚ ü×C¹» › ú tŸ ¤õ ® ú „²
|
|||
|
|
Basic usage.Á Ã ú ,
|
|||
|
|
\š
|
|||
|
|
�ö ä– ¬ö ü³ /Òö üã % " use mio::{Interest, Poll, Token};Á „‰
|
|||
|
|
#[cfg(unix)]Á äš use mio::unix::SourceFd;Á ô· #[cfg(target_os = "wasi")]Á äÖ use mio::wasi::SourceFd;Á ó ú ì÷ use std::os::fd::AsRawFd;Á ô•
|
|||
|
|
use std::net::TcpListener;Á ´
|
|||
|
|
ú Ô¸
|
|||
|
|
// Bind a std listenerÁ üÓ
|
|||
|
|
5 2 let listener = TcpListener::bind("127.0.0.1:0")?;Á ‰ú ä�âž ªú ä® // Register the listenerÁ ìË‹ë üé- * &mut SourceFd(&listener.as_raw_fd()),Á Œ—Ðë 쩲 „Çë <ØÝ� <àßÒ èú üìK H Implementing [`event::Source`] for a custom type backed by a [`RawFd`].Á ¸ú ,û\õ�ö üÕ0 - use mio::{event, Interest, Registry, Token};Á „†Çƒ ä—àƒ ô´…„ äÓ¬„ ðú Üô use std::os::fd::RawFd;Á „�‡° ¡ú Ì¥¬° ¬¿ pub struct MyIo {Á ”Õ fd: RawFd,Á ,èÏ� îú üò! impl event::Source for MyIo {Á ü”VÔ± ìë³² L‰Ù² ü“C @ SourceFd(&self.fd).register(registry, token, interests)Á L×½� áú üåXŒ´ ì¾³² LÜÙ² üæE B SourceFd(&self.fd).reregister(registry, token, interests)Á L¬½� ¶ú üºI¬¶ ü„3 0 SourceFd(&self.fd).deregister(registry)Á L¸½� ,ÂÏ� <ÈßÒ <Dì Œ æ æ ·l fÃÂ_ܲ® å ç Œ ·l ƒPJ è�·l ä ä
|
|||
|
|
å Œ õlù ä ä è�(§Ù ¥ Œ é é ·lê Àc ê NP46 ü ý þ ü ·l ý c c ˆ ¢cµ
|
|||
|
|
` £cûå ` àB¤GS
|
|||
|
|
þ ¢ç è §Ù è
|
|||
|
|
ê Œ ß±å<‚! »“*x¨ ¸¨š = †!Óôõöûý“é ¦ ë ìš< À ë í Ipv4AddrÁD3 ¾º ë ï Ipv6AddrÁD= ̺ ë ð
|
|||
|
|
SocketAddrÁTG “¼ ë ñ SocketAddrV4ÁdS ª¼ ë ò SocketAddrV6Áda ½¼ ë ó<ÃŒ´D(�Ÿ„†ikLN/1üqbl “¼”¼ •¼ V4Á –¼ˆ —¼ ˜¼ V6Á™¼ˆ cÌ£•w® Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
Âñ
|
|||
|
|
ô addrÁ$� socket_typeÁ\Ÿü¤bT² Á•
|
|||
|
|
õ domainÁ4½³•\ÒüÓ =|ä ö ö í* ÷„+ ë øŽ+ ë ø¹'‡,ä¾ï ø¹'‡,ä¾ï ÷ø¬úúë ö ö ãã sockaddr_inÁ ä
|
|||
|
|
sin_familyÁ å sin_portÁ æ sin_addrÁ ç sin_zeroÁ Åì`0 o$ ´••ë ö ö ðð sockaddr_in6Á ñ sin6_familyÁ ò sin6_portÁ ó
|
|||
|
|
sin6_flowinfoÁ ô sin6_addrÁ õ
|
|||
|
|
sin6_scope_idÁ £1PÛv㪠¤° = §—ú üË44Ù ÿ ÿ §— ØØ sockaddrÁ Ù sa_familyÁ Ú sa_dataÁ .çÞ›÷È= ù à ù
|
|||
|
|
ú $áüþR\Œ €
|
|||
|
|
€
|
|||
|
|
í” §— ž
|
|||
|
|
û §•$˜ ë û û ¿rü�7lt²7 Ë Ë sockaddr_storageÁ Ì ss_familyÁ Í __ss_pad2ÁŒ Ï
|
|||
|
|
__ss_alignÁŒ ‡^³bAÉ C Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
í”Âñ
|
|||
|
|
ý storageÁ<Æ7””! »“* =í �Ž��‘’“é ¦ þ ÿš< À þ � MaybeUninitÁ\% ÑÛ þ ‚“*$B ž" þ „Î’TH “¼ þ …¸<‰ «+ þ ‡ÖL’ + þ ˆÛ*TŒ õ þ Š«+\˜ û þ ‹Ã+t¥ ý þ Œ<ÛDÌα³D7£ <“•\{…‡tv¬ôgiVXEGü·JdÅ í”Á•
|
|||
|
|
� ˜<Òü²Q$À �
|
|||
|
|
�
|
|||
|
|
Àx í”ñð Í
|
|||
|
|
Ž socketÁ4ŧ•$àü›R<© ‚
|
|||
|
|
‚
|
|||
|
|
«z í”ñð ¹
|
|||
|
|
� ™¡4±§•$ÊüŒ
|
|||
|
|
O4š
|
|||
|
|
ƒ
|
|||
|
|
ƒ
|
|||
|
|
Àx ñð ©
|
|||
|
|
|
|||
|
|
� ™¡4¡
|
|||
|
|
backlogÁ<¼
|
|||
|
|
ü Yl® „
|
|||
|
|
„
|
|||
|
|
Àx ñð Ä
|
|||
|
|
‘ ™¡4¼ reuseaddrÁL× üŸ]4 …
|
|||
|
|
…
|
|||
|
|
Àx Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
«zí”Âñ ¾
|
|||
|
|
’ ‰/D´D³ ’ ï¶ “ ‡· “ ¤· “ “ ’ “ ó¾«z 4µ' ’ ï¶ ” ‡· ” ¤· ” ” ’ ” í”Ï¥ «z”°! »“*‰
|
|||
|
|
†
|
|||
|
|
=K² ¡¢“é ¦ • –í ë • —“*$* ž" • ™Î’T0 “¼ • š¸<q «+ • œÖLz + • �Æ*lô ô • Ÿ«+\ƒ û • <¤D•D † $vx\chjXZ¬ÜLN;=ü’;$™ í”Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
è{Âñ
|
|||
|
|
¡ §•$žüÍB<Û †
|
|||
|
|
†
|
|||
|
|
è{ Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
Âñ ë
|
|||
|
|
¢ ™¡4ã”�" »“* ª úî¤Ú!úŠ”ð!üÙ!*üÕ!/üÌ!: =…´ ¬¹ÎØÙÚÛ
|
|||
|
|
l} ö, £ ¤ OsStrExtÁD¤ Ï$ £ ¥ÖLÅ + £ ¦Î’Tè þM £ §“éþ ¦ £ ©í ‚ ë £ ªµ ‡ “ £ «üh"�ä�‡ä²xôÔh øXZGI68¼Ž =D� ¶·¸“é ¦ ¬ ¸< «+ ¬ ¯ÖL( + ¬ °“*$M ê% ¬ ²Î’TS þM ¬ ³Û*T| õ ¬ ´ú0L£ Ú ¬ µ<Ž\�oq”8b GRTüe!FüŒ 9ü¯NL½ ‡
|
|||
|
|
‡
|
|||
|
|
þMþM Î’ ÿM§•ê% €N‘ê% è)6{}š~É Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
�}Âñ Ð
|
|||
|
|
¶ ˜<Çüú8<ˆ µ°
|
|||
|
|
· ü©J$· Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
�}�}Âñ
|
|||
|
|
¸ ¼§ =D¶ ËÌ OsStrÁ, ˆ ¹ º¸<' «+ ¹ ¼ÖL0 + ¹ ½Ò«DT Ï$ ¹ ¾“*$w ê% ¹ ÀÎ’T} þM ¹ Á PathÁ$™ …0 ¹ Â“é© ¦ ¹ Äí ë ¹ ŬSTÄ º ¹ Æ û ÷Û*Të õ ¹ Çç0\“ Ù ¹ Éú0L Ú ¹ Ê|\ þ ä@ñ”bâ qÒÔ|ŽÂ £²´¡£´¸”üÔ!~¬ûoq^`üNL» ˆ
|
|||
|
|
ˆ
|
|||
|
|
ù¯ Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
¾~Âñ Î
|
|||
|
|
Ë ˜<Åü² Z4À ‰
|
|||
|
|
‰
|
|||
|
|
¾~ Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
žù¯Âñ Ñ
|
|||
|
|
Ì ‰/DÇ D« Ì ï¶ Í ‡· Í ¤· Í Í Ì Í ó¾©€ ¬À =4Ï Ö×“é ¦ Î ÏÖL + ΠГ*$B ê% Î ÒÎ’TH þM Î ÓÛ*Tq õ Î Ôú0L˜ Ú Î Õ<z´k”-\ <LNüZ!@ü� 3ü¤Od² Š
|
|||
|
|
Š
|
|||
|
|
ù¯ Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
©€Âñ È
|
|||
|
|
Ö ˜<¿üÍF$Û Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
©€©€Âñ
|
|||
|
|
× äØ|Þ£ …� ü¾5\Á £ ‹
|
|||
|
|
‹
|
|||
|
|
À À sockaddr_unÁ Á
|
|||
|
|
sun_familyÁ  sun_pathÁ {öËʾ6w ¿r ×
|
|||
|
|
Ù ÿ™DÍü°JL³ £ Œ
|
|||
|
|
Œ
|
|||
|
|
ù¯ ¯½ Æ
|
|||
|
|
Ú ˜<½ü¿L$ £ Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
ÙuÙuÂñ ¥ Ü Ü Ûô Ç +Ùu L�
|
|||
|
|
ÛÙu flagsÁ,Ê(* Ã Û Û ¿rl¼d0<ÏO0R06090&0)000\€ 00ü/ÿ/í/ð/Þ/á/Ï/Ò/À/Ã/d͵/¸/¦/©/—/š/ÔˆŒ/,¨~/�/p/s/]/`/K/N/üê4. üÔ( % Create a new non-blocking Unix pipe.Á ýú ü�N K This is a wrapper around Unix's [`pipe(2)`] system call and can be used asÁ üÐ2 / inter-process or thread communication channel.Á ƒú ü‡P M This channel may be created before forking the process and then one end usedÁ üØP M in each process, e.g. the parent process has the sending end to send commandÁ Ì© to the child process.Á Ãú üÇU R [`pipe(2)`]: https://pubs.opengroup.org/onlinepubs/9699919799/functions/pipe.htmlÁ �ú d¡ # EventsÁ ®ú ü²J G The [`Sender`] can be registered with [`WRITABLE`] interest to receiveÁ üýP M [writable events], the [`Receiver`] with [`READABLE`] interest. Once data isÁ üÎL I written to the `Sender` the `Receiver` will receive an [readable event].Á ›ú üŸP M In addition to those events, events will also be generated if the other sideÁ üðH E is dropped. To check if the `Sender` is dropped you'll need to checkÁ ü¹K H [`is_read_closed`] on events for the `Receiver`, if it returns true theÁ ü…M J `Sender` is dropped. On the `Sender` end check [`is_write_closed`], if itÁ üÓO L returns true the `Receiver` was dropped. Also see the second example below.Á £ú ü§$ ! [`WRITABLE`]: Interest::WRITABLEÁ üÌ0 - [writable events]: event::Event::is_writableÁ üý$ ! [`READABLE`]: Interest::READABLEÁ ü¢/ , [readable event]: event::Event::is_readableÁ üÒ4 1 [`is_read_closed`]: event::Event::is_read_closedÁ ü‡6 3 [`is_write_closed`]: event::Event::is_write_closedÁ ¾ú œÂ # DeregisteringÁ Öú üÚI F Both `Sender` and `Receiver` will deregister themselves when dropped,Á ü¤ E B **iff** the file descriptors are not duplicated (via [`dup(2)`]).Á ê ú üî S P [`dup(2)`]: https://pubs.opengroup.org/onlinepubs/9699919799/functions/dup.htmlÁ  ú tÆ ¤õ Õ ú üÙ M J Simple example that writes data into the sending end and read it from theÁ ”§ receiving end.Á º ú <¾ ßÒ üÆ % " use std::io::{self, Read, Write};Á ì ú üð - * use mio::{Poll, Events, Interest, Token};Á Äž use mio::unix::pipe;Á · ú ü» 5 2 // Unique tokens for the two ends of the channel.Á üñ & # const PIPE_RECV: Token = Token(0);Á ü˜ & # const PIPE_SEND: Token = Token(1);Á ¿ ú üà #´ó üç = : // Create our `Poll` instance and the `Events` container.Á ü¥! ºú üÆ!. + let mut events = Events::with_capacity(8);Á õ!ú Ìù! // Create a new pipe.Á ü“"2 / let (mut sender, mut receiver) = pipe::new()?;Á Æ"ú üÊ") & // Register both ends of the channel.Á üô"L I poll.registry().register(&mut receiver, PIPE_RECV, Interest::READABLE)?;Á üÁ#J G poll.registry().register(&mut sender, PIPE_SEND, Interest::WRITABLE)?;Á Œ$ú ü�$* ' const MSG: &[u8; 11] = b"Hello world";Á »$ú T¿$Ãþ üÊ$&×þ ñ$ú üõ$$™ø üš%!Ûù ü¼%. + PIPE_SEND => sender.write(MSG)Á üë%5 2 .and_then(|n| if n != MSG.len() {Á ü¡&L I // We'll consider a short write an error in thisÁ üî&K H // example. NOTE: we can't use `write_all` withÁ üº'0 - // non-blocking I/O.Á üë'@ = Err(io::ErrorKind::WriteZero.into())Á ü¬( } else {Á üÍ(" Ok(())Á
|
|||
|
|
�
|
|||
|
|
ýl ñð ö ê8 ö
|
|||
|
|
÷ $ë8‹
|
|||
|
|
\ñ8üùJa üà9J G Execute an I/O operation ensuring that the socket receives more eventsÁ ü¯:& # if it hits a [`WouldBlock`] error.Á Ú:ú \â:÷à ò:ú üú:F C This method is required to be called for **all** I/O operations toÁ üÅ;L I ensure the user will receive events once the socket is ready again afterÁ ü–<% " returning a [`WouldBlock`] error.Á À<ú üÈ<- * [`WouldBlock`]: io::ErrorKind::WouldBlockÁ ú<ú t‚=¤õ •=ú <�=ßÒ ä©=¬ö ,Ê=Є üÔ=/Òö „ˆ>‡° ì�>Ý„ Ä¿>âÒ Ü>ú üä>* ' let (sender, receiver) = pipe::new()?;Á “?ú ü›?+ ( // Wait until the sender is writable...Á Ë?ú üÓ?B ? // Write to the sender using a direct libc call, of course theÁ üš@9 6 // `io::Write` implementation would be easier to use.Á ¼Ø@ let buf = b"hello";Á ôô@ let n = sender.try_io(|| {Á ü—A3 0 let buf_ptr = &buf as *const _ as *const _;Á üÏAQ N let res = unsafe { libc::write(sender.as_raw_fd(), buf_ptr, buf.len()) };Á ´¥B if res != -1 {Á äÀB Ok(res as usize)Á „áB
|
|||
|
|
} else {Á üöBJ G // If EAGAIN or EWOULDBLOCK is set by libc::write, the closureÁ üÅC0 - // should return `WouldBlock` error.Á üúC+ ( Err(io::Error::last_os_error())Á LªD½� D¸D })?;Á üÅD# eprintln!("write {} bytes", n);Á íDú üõD- * // Wait until the receiver is readable...Á §Eú ü¯EE B // Read from the receiver using a direct libc call, of course theÁ üùE8 5 // `io::Read` implementation would be easier to use.Á ܶF let mut buf = [0; 512];Á üÖF let n = receiver.try_io(|| {Á üûF3 0 let buf_ptr = &mut buf as *mut _ as *mut _;Á ü³GR O let res = unsafe { libc::read(receiver.as_raw_fd(), buf_ptr, buf.len()) };Á ´ŠH�ö ä¥Hö „ÆHÓö üÛHI F // If EAGAIN or EWOULDBLOCK is set by libc::read, the closureÁ ü©I0Ã÷ üÞI+þ÷ LŽJ½� DœJÁø ü©J" eprintln!("read {} bytes", n);Á dÐJÒÛ <áJÝ� <íJßÒ4€K Ž
|
|||
|
|
Ž
|
|||
|
|
ýl —Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
¥Âñ ö — ù ¥ ú ú ù �K ö Íì‚€ ‡K ÍìÕ€ ŠK –"‚€ ÌÀK ‚€ ˜" ‡€lÌK
|
|||
|
|
ø‚€Õ€$ŽK± ”KZ\ VX úK øï¶ û ‡· û ¤· û û ø û‚€Õ€ ÿù ‡€ ‚€ìŒL »¶¶Ó Ð > ýlýþÿ £ ¤ ¥ ÿ ý þ ü°L‡D³L �
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
ýl �
|
|||
|
|
›j ¦q³hñð ü ÅL ü
|
|||
|
|
ý $ÊLÝDØLõ,õL¹•L‹MüýM‰T€N ‘
|
|||
|
|
’
|
|||
|
|
‘
|
|||
|
|
ýl ’
|
|||
|
|
›j ¦q³hñð ü ”N ü
|
|||
|
|
þ $™NÝD§Nõ,ÄN¹•LÚNüÎO?TÑO “
|
|||
|
|
”
|
|||
|
|
“
|
|||
|
|
ýl ”
|
|||
|
|
›j ñð ü ÜO ü
|
|||
|
|
ÿ $áOÝDçO¬ÁP »¶¶Œ
|
|||
|
|
‰
|
|||
|
|
> ýl�ƒ… ! ¡! ¤! ƒ � … üÝP4,àP •
|
|||
|
|
–
|
|||
|
|
•
|
|||
|
|
ýl –
|
|||
|
|
…� Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
¿rÂñ € æP €
|
|||
|
|
� $ëPûå ñPdQ � ï¶ ‚ ‡· ‚ ¤· ‚ ‚ � ‚ õ‚· ƒ�üØQGtÛQ —
|
|||
|
|
˜
|
|||
|
|
™
|
|||
|
|
—
|
|||
|
|
ýl ˜
|
|||
|
|
|
|||
|
|
æLæL çLŒß éLˆ¦ —óë@M$ T ™
|
|||
|
|
· € êQ €
|
|||
|
|
ƒ $ïQ bufsÁ$õQd»R ƒ ï¶ „ ‡· „ ¤· „ „ ƒ „¢‰
|
|||
|
|
æLæL çLŒß éLˆ¦ —óë@M$ T üðR%,óR š
|
|||
|
|
š
|
|||
|
|
ýlñð € ùR €
|
|||
|
|
… $þRd±S … ï¶ † ‡· † ¤· † † … † õ‚ñð ´×S »¶¶ûø > 8 ›
|
|||
|
|
›
|
|||
|
|
ÆmˆŠŒ ! ¡! ¤! Œ ˆ Š üôS4,÷S œ
|
|||
|
|
�
|
|||
|
|
œ
|
|||
|
|
Æm �
|
|||
|
|
…� · ‡ ýS ‡
|
|||
|
|
ˆ 8$‚Tûå ˆTdÄT ˆï¶ ‰ ‡· ‰ ¤· ‰ ‰ ˆ ‰ ¢‰±‰üïTGtòT ž
|
|||
|
|
Ÿ
|
|||
|
|
|
|||
|
|
ž
|
|||
|
|
Æm Ÿ
|
|||
|
|
|
|||
|
|
æLæL çLŒß éLˆ¦ —óë@M$ T
|
|||
|
|
· ‡ �U ‡
|
|||
|
|
Š 8$†U܉$ŒUdÒU Šï¶ ‹ ‡· ‹ ¤· ‹ ‹ Š ‹ ¢‰À‹ü‡V%,ŠV ¡
|
|||
|
|
¡
|
|||
|
|
Æmñð ‡ �V ‡
|
|||
|
|
Œ 8$•VdÈV Œï¶ � ‡· � ¤· � � Œ � ¤� ü¶W \îV÷à úVú üþV7 4 The underlying pipe is **not** set to non-blocking.Á »¶¶IF > ýl� ë � üÝW$$àW Ùmýl Ž Ž
|
|||
|
|
� stdinÁ,åWÌ–Y »¶¶¿¼ > ýl‘ ®+ ‘ ü¶Y*\ÀY ýl � �
|
|||
|
|
‘ Ð%ÌY¼ÀZ »¶¶0- > ýl“ ¬+ “ äÞZLáZ ¢
|
|||
|
|
¢
|
|||
|
|
ýl ’ ëZ ’
|
|||
|
|
“ $ìZÌ¥[ »¶¶²¯ > ýl• °+ • ìÅ[\È[ ýl ” ”
|
|||
|
|
• $Ô[ìœ\ »¶¶! > ¶n— ë — üÀ\ $Ã\ ýl¶n – –
|
|||
|
|
— senderÁ4È\¤”] »¶¶˜• > ýl™ Ž, ™ ü¯]!,²] £
|
|||
|
|
£
|
|||
|
|
ýl ÎNÎN Ø ÐNÐ%ä+ ÑN›¾ä+ §] ò�Þ^ £
|
|||
|
|
˜ ¸] ˜
|
|||
|
|
™ $¹]ì÷] »¶¶\Y > ýl› ë › ä›^$ž^ ¶nýl š š
|
|||
|
|
› Ð%£^l³` »¶¶ÌÉ > …o�ž ü„aB üÇ`8 5 Set the `Receiver` into or out of non-blocking mode.Á|‹a ¤
|
|||
|
|
¤
|
|||
|
|
…o ñð œ ›a œ
|
|||
|
|
� $œa‹
|
|||
|
|
\¢aüªsa ü‘bJ²í üàb&‡î ‹cú \“c÷à £cú ü«cFàî üöcL±ï üÇd%ˆð ñdú üùd-Åð «eú t³e¤õ Æeú <ÎeßÒ äÚe¬ö ,ûeЄ ü…f/Òö „¹f‡° ìÎfÝ„ ÄðfâÒ �gú ü•g*•ò Ägú üÌg+×ò ügú ü„hBšó üËh9çó ¼‰iªô ô¥iËô üÈi3ôô ü€jQ²õ ´Öj�ö äñjö „’kÓö ü§kJîö üök0Ã÷ ü«l+þ÷ LÛl½� DélÁø üöl#Ôø žmú ü¦m-�ù Ømú üàmEÔù üªn8¤ú Üçnæú ü‡o Œû ü¬o3·û üäoRõû ´»p�ö äÖpö „÷pÓö üŒqIüü üÚq0Ã÷ ü�r+þ÷ L¿r½� DÍrÁø üÚr"Šþ d�sÒÛ <’sÝ� <žsßÒ4±s ¥
|
|||
|
|
¥
|
|||
|
|
…o ‚€‡€ œ — Ÿ ¥ Ÿ ¾s œ ’� ¸s £� »s ´�Ìñs Ç�lýs
|
|||
|
|
ž‚€Õ€$¿s± Ås8: =? «t žï¶ ¡ ‡· ¡ ¤· ¡ ¡ ž ¡‚€Õ€ð‚ˆƒü½t »¶¶% " > …o£¤¥ £ ¤ ¥ ¥ £ ¤ üãt‡Dæt ¦
|
|||
|
|
§
|
|||
|
|
¦
|
|||
|
|
…o §
|
|||
|
|
›j ¦q³hñð ¢ øt ¢
|
|||
|
|
£ $ýtÝD‹uõ,¨u¹•L¾uü°v‰T³v ¨
|
|||
|
|
©
|
|||
|
|
¨
|
|||
|
|
…o ©
|
|||
|
|
›j ¦q³hñð ¢ Çv ¢
|
|||
|
|
¤ $ÌvÝDÚvõ,÷v¹•L�wü�x?T„x ª
|
|||
|
|
«
|
|||
|
|
ª
|
|||
|
|
…o «
|
|||
|
|
›j ñð ¢ �x ¢
|
|||
|
|
¥ $”xÝDšx´ôx »¶¶Þ Û > …o§© á â § © ü‘y7$”y ¬
|
|||
|
|
|
|||
|
|
¬
|
|||
|
|
…o
|
|||
|
|
…�· ¦ ™y ¦
|
|||
|
|
§ $žyûå ¤ydäy § ï¶ ¨ ‡· ¨ ¤· ¨ ¨ § ¨¢‰ …�üŽzMl‘z ®
|
|||
|
|
¯
|
|||
|
|
°
|
|||
|
|
®
|
|||
|
|
…o ¯
|
|||
|
|
|
|||
|
|
ö ö ÷ ¨ß ù ˆ¦ èóÇãp9Ü °
|
|||
|
|
· ¦ Ÿz ¦
|
|||
|
|
© $¤z܉$ªzd÷z © ï¶ ª ‡· ª ¤· ª ª © ª¢‰
|
|||
|
|
ö ö ÷ ¨ß ù ˆ¦ èóÇãp9Ü ¼©{ »¶¶+!(! > 8 ±
|
|||
|
|
±
|
|||
|
|
Îo¬® á â ® ¬ üÇ{7$Ê{ ²
|
|||
|
|
³
|
|||
|
|
²
|
|||
|
|
Îo ³
|
|||
|
|
…�· « Ï{ «
|
|||
|
|
¬ 8$Ô{ûå Ú{dš| ¬ï¶ ‡· ¤· ¬ ¢‰œ«üÄ|MlÇ| ´
|
|||
|
|
µ
|
|||
|
|
¶
|
|||
|
|
´
|
|||
|
|
Îo µ
|
|||
|
|
|
|||
|
|
ö ö ÷ ¨ß ù ˆ¦ èóÇãp9Ü ¶
|
|||
|
|
· « Õ| «
|
|||
|
|
® 8$Ú|܉$à|d} ®ï¶ ¯ ‡· ¯ ¤· ¯ ¯ ® ¯ ¢‰«ü§~# \ß}÷à ë}ú üï}7Ñ’ »¶¶ƒ#€# > …o± ë ± üÑ~($Ô~ áo…o ° °
|
|||
|
|
± stdoutÁ4Ù~üÚ€# \’€÷à ž€ú ü¢€7Ñ’ »¶¶)$&$ > …o³ ë ³ ü„�($‡� ¤p…o ² ²
|
|||
|
|
³ stderrÁ4Œ�ÜÅ‚ »¶¶¤$¡$ > …oµ °+ µ ìç‚\ê‚ …o ´ ´
|
|||
|
|
µ $ö‚̾ƒ »¶¶%% > …o· ¬+ · äÞƒLრ·
|
|||
|
|
·
|
|||
|
|
…o ¶ ëƒ ¶
|
|||
|
|
· $ìƒÜ¥„ »¶¶ž%›% > …o¹ ®+ ¹ üÇ„,\Ñ„ …o ¸ ¸
|
|||
|
|
¹ Ð%Ý„üÕ… »¶¶&& > ¶n» ë » üû…#$þ… …o¶n º º
|
|||
|
|
» ç Dƒ†´Õ† »¶¶‰&†& > …o½ Ž, ½ üò†!,õ† ¸
|
|||
|
|
¸
|
|||
|
|
…o ÎNÎN Ø ÐNÐ%ä+ ÑN›¾ä+ §] ò�Þ^ ¸
|
|||
|
|
¼ û† ¼
|
|||
|
|
½ $ü†üº‡ »¶¶S'P' > …o¿ ë ¿ äà‡$㇠¶n…o ¾ ¾
|
|||
|
|
¿ Ð%è‡ü½‰B »¶¶È'Å'ú€ Œåˆú� ¬øˆúŸ ¬�‰ú± ”¦‰üäˆUüàˆZü׈e |À‰ ¶ ñð
|
|||
|
|
À Ð%Љ‹
|
|||
|
|
\Û‰ŒÔ7 üç6 Sending end of an Unix pipe.Á ˆ7ú üŒ76 3 See [`new`] for documentation, including examples.Á »¶¶ç(ä( ·4ß7 ýl ª"�ŒmÞªþ ¬ì7,ì7¶ Á Á � � ÿ9 ƒº ð „Ó ð …§: ð ™]”Õ·ÿù(¼Ì7 ¹ ýlÄ Àc Ä #% ¹
|
|||
|
|
º
|
|||
|
|
»
|
|||
|
|
¹
|
|||
|
|
ýl º
|
|||
|
|
c c ˆ ¢cµ
|
|||
|
|
` £cûå ` àB¤GS
|
|||
|
|
»
|
|||
|
|
¢ç à ¼Ì7 Ã
|
|||
|
|
Ä Ç±Íœÿ_ ü�_" Receiving end of an Unix pipe.Á ³_ú ü·_6ð» »¶¶¡*ž* ¸DŠ` …o )¯0â|íÃM Ƭ™`,™`¶ Å Å ú½(½÷_ º …oÈ Àc È #% ¼
|
|||
|
|
½
|
|||
|
|
¾
|
|||
|
|
¼
|
|||
|
|
…o ½
|
|||
|
|
c c ˆ ¢cµ
|
|||
|
|
` £cûå ` àB¤GS
|
|||
|
|
¾
|
|||
|
|
¢ç Ç ½÷_ Ç
|
|||
|
|
È Ç±ÍQ ü 8 5 Associates readiness events with [`event::Source`]s.Á 9ú ü=E B `Token` is a wrapper around `usize` and is used as an argument toÁ üƒ8 5 [`Registry::register`] and [`Registry::reregister`].Á ¼ú üÀ3ö� ôú üø0Ÿó ô©¤É üÈ@ = [`Registry::register`]: struct.Registry.html#method.registerÁ ü‰D A [`Registry::reregister`]: struct.Registry.html#method.reregisterÁ Îú lÒ
|
|||
|
|
# ExampleÁ àú üäM J Using `Token` to track which socket generated the event. In this example,Á ü²E B `HashMap` is used, but usually something like [`slab`] is better.Á øú üü+ ( [`slab`]: https://crates.io/crates/slabÁ ¨ú ,è\â�ö 俬ö üÜ/Òö üŒ2½å ü¿3úå üó- * use mio::{Events, Interest, Poll, Token};Á ô¡ use mio::net::TcpListener;Á Àú ¤Ä§œ ôÙ use std::io::{self, Read};Á üø" use std::collections::HashMap;Á › ú üŸ J G // After this number of sockets is accepted, the server will shutdown.Á üê " const MAX_SOCKETS: usize = 32;Á �
|
|||
|
|
ú ü‘
|
|||
|
|
N K // Pick a token that will not be used by any other socket and use that oneÁ Äà
|
|||
|
|
// for the listener.Á üù
|
|||
|
|
( % const LISTENER: Token = Token(1024);Á ¢ ú ü¦ ! // Used to store the sockets.Á üÈ % " let mut sockets = HashMap::new();Á î ú üò ; 8 // This is used to generate a unique token for a socketÁ ü® " let mut next_socket_index = 0;Á Ñ ú ÔÕ // The `Poll` instanceÁ üð ºú ‘
|
|||
|
|
ú œ•
|
|||
|
|
// Tcp listenerÁ ü©
|
|||
|
|
B ? let mut listener = TcpListener::bind("127.0.0.1:0".parse()?)?;Á ì
|
|||
|
|
ú äð
|
|||
|
|
½† ü�K H poll.registry().register(&mut listener, LISTENER, Interest::READABLE)?;Á Ùú üÝJ G // Spawn a thread that will connect a bunch of sockets then close themÁ ü¨& # let addr = listener.local_addr()?;Á ÜÏÿè üë use std::net::TcpStream;Á Œú ü�N K // +1 here is to connect an extra socket to signal the socket to closeÁ üß% " for _ in 0..(MAX_SOCKETS+1) {Á ü…+ ( // Connect then drop the socketÁ ü±6 3 let _ = TcpStream::connect(addr).unwrap();Á Lè½� <òÏé úú ¤þ // Event storageÁ ü“1äú Åú üÉ7 4 // Read buffer, this will never actually get filledÁ Ü� let mut buf = [0; 256];Á �ú Ô¡ // The main event loopÁ T¼Ãþ ÔÇ // Wait for eventsÁ üâ&×þ ‰ú ô�’ÿ ü¬!Ûù ìÎ LISTENER => {Á üìI F // Perform operations in a loop until `WouldBlock` isÁ ü¶# // encountered.Á ÔÚ loop {Á üõ1 . match listener.accept() {Á ü§4 1 Ok((mut socket, _)) => {Á üÜ6 3 // Shutdown the serverÁ ü“E B if next_socket_index == MAX_SOCKETS {Á üÙ2 / return Ok(());Á üŒ! }Á ®ú ü²? < // Get the token for the socketÁ üòE B let token = Token(next_socket_index);Á ü¸7 4 next_socket_index += 1;Á ðú üôB ? // Register the new socket w/ pollÁ ü·b _ poll.registry().register(&mut socket, token, Interest::READABLE)?;Á šú üž3 0 // Store the socketÁ üÒ> ; sockets.insert(token, socket);Á ì‘ }Á ü¯ T Q Err(ref e) if e.kind() == io::ErrorKind::WouldBlock => {Á ü„ N K // Socket is not ready anymore, stop acceptingÁ üÓ & # break;Á ìú Öß ü˜ K H e => panic!("err={:?}", e), // Unexpected errorÁ Ìä }Á ¬þ È€ Œ” æ€ Ô¦ token => {Á üÁ / , // Always operate in a loopÁ Ôñ ŠØ üŒ O L match sockets.get_mut(&token).unwrap().read(&mut buf) {Á üÜ & # Ok(0) => {Á üƒ!K H // Socket is closed, remove it from the mapÁ üÏ!7 4 sockets.remove(&token);Á ü‡"&³á ì®"Öß üÌ"H E // Data is not actually sent in this exampleÁ ü•#4 1 Ok(_) => unreachable!(),Á üÊ#Týß üŸ$L I // Socket is not ready anymore, stop readingÁ üì$&³á ì“%Öß ü±%Kðá Ìý%Äâ ¬—&È€ Œ&æ€ l¿&§� LÍ&½� ,×&Ï� <Ý&Ý� <å&ßÒ ,¼' ¦q ` ç� åµ' Ê Ë ¿r¦q Q4 ¿r¦q É É
|
|||
|
|
Ê LÂ' É É ¿r Àö& » ¦q (Áü& ¼ ¦q 1 5 ¼ ¦qÏ Ù Ï PR ¿
|
|||
|
|
¿
|
|||
|
|
¦q ¦q Î Áü& Î
|
|||
|
|
Ï œ(ƒ' ½ ¦qÑ Àc Ñ #% À
|
|||
|
|
Á
|
|||
|
|
Â
|
|||
|
|
À
|
|||
|
|
¦q Á
|
|||
|
|
c c ˆ ¢cµ
|
|||
|
|
` £cûå ` àB¤GS
|
|||
|
|
Â
|
|||
|
|
¢ç Рƒ' Ð
|
|||
|
|
Ñ Ç±ÍHÊ' ¾ ¦q ¾ ¦qÔ ·ß Ô 8: Ã
|
|||
|
|
Ä
|
|||
|
|
Ã
|
|||
|
|
¦q Ä
|
|||
|
|
¦q Ó ÃŠ' Ó
|
|||
|
|
Ô ”¹
|
|||
|
|
šÄ•' ¿ ¦qÖ › Ö # ) > Å
|
|||
|
|
Å
|
|||
|
|
¦q Õ Ä•' Õ
|
|||
|
|
Ö ˆPÅ™' À ¦qØ ïß Ø $& Æ
|
|||
|
|
Ç
|
|||
|
|
Æ
|
|||
|
|
¦q Ç
|
|||
|
|
¦q ƒŽ × Å™' ×
|
|||
|
|
Ø ‚¹
|
|||
|
|
ˆÆ¥' Á ¦qÚ » Ú #% È
|
|||
|
|
É
|
|||
|
|
È
|
|||
|
|
¦q É
|
|||
|
|
¦q ÈŽ ٠ƥ' Ù
|
|||
|
|
Ú �¹
|
|||
|
|
‡ Ǫ'  ¦qÜ ›e Ü #% Ê
|
|||
|
|
Ë
|
|||
|
|
Ê
|
|||
|
|
¦q Ë
|
|||
|
|
ù Û ù Ý Ý Çª' Û Íì¼ó ˜ ¢e¼ó ¦
|
|||
|
|
ܼ󴺺¼¾ „€ ü21 . Waker allows cross-thread waking of [`Poll`].Á dú ühI F When created it will cause events with [`readable`] readiness and theÁ ü²I F provided `token` if [`wake`] is called, possibly from another thread.Á üú ô€¤É üŸ>À• üÞ+ ( [`wake`]: struct.Waker.html#method.wakeÁ Šú \Ž÷à šú üžN K `Waker` events are only guaranteed to be delivered while the `Waker` valueÁ lí
|
|||
|
|
is alive.Á ûú üÿN K Only a single `Waker` can be active per [`Poll`], if multiple threads needÁ üÎI F access to the `Waker` it can be shared via for example an `Arc`. WhatÁ ü˜G D happens if multiple `Waker`s are registered with the same `Poll` isÁ „à
|