"OBEWFOUVSFPG)BQQZ&ZFCBMMT .JTBLJ4IJPJ !TIJPJNN!DPF@ .BZ 3VCZ,BJHJ

QQTFMG .JTBLJ4IJPJ !TIJPJNN (JU)VC !DPF@ 5XJUUFS #TLZ 3BJMTBQQMJDBUJPOQSPHSBNNFSBU4.4$P -UE .FNCFSPG"TBLVTBSC "NJOUFSFTUFEJOOFUXPSLJOH

5IJTQSFTFOUBUJPOJTCBTFEPOUIFQSPKFDU *OUSPEVDUJPOPG)BQQZ&ZFCBMMT7FSTJPO 3'$ UPUIFTPDLFUMJCSBSZ XIJDIXBTTFMFDUFEGPS UIF3VCZ"TTPDJBUJPOHSBOUJO 3VCZ"TTPDJBUJPO(SBOUTFMFDUJPOSFTVMU IUUQTXXXSVCZPSKQFOOFXT

8IBUJT)BQQZ&ZFCBMMTʜ

#FGPSFEJTDVTTJOH)BQQZ&ZFCBMMT *XPVMEMJLFUPJOUSPEVDFTPNFJTTVFT DVSSFOUMZQSFTFOUJO3VCZTTPDLFUMJCSBSZ

3VCZTTPDLFUMJCSBSZ 3VCZTTPDLFUMJCSBSZJODMVEFTBNFUIPEUIBU SFUVSOTBTPDLFUDPOOFDUFEWJB5$1UPBTFSWFS 5IFTFNFUIPETBSFVTFEJOMJCSBSJFTTVDIBTOFUIUUQ OFUGUQBOEOFUJNBQ $MJFOU 4FSWFS $POOFDUJPOFTUBCMJTIFE 3FUVSOB4PDLFUPCKFDUDPOOFDUFEUPUIFUBSHFUTFSWFS &YFDVUFUIFNFUIPE

)PXTPDLFUMJCSBSZTNFUIPETXPSL 5IFZXPSLJOUFSOBMMZBTGPMMPXT %/44FSWFS 4FSWFS $MJFOU 4FSWFS XXXSVCZMBOHPSH

)PXTPDLFUMJCSBSZTNFUIPETXPSL 'JSTU RVFSZB%/4TFSWFSGPSBUBSHFUTFSWFST EPNBJOOBNFUPPCUBJOJUT*1BEESFTT %/44FSWFS 2VFSZ*1BEESFTTFT "OTXFS*1BEESFTTFT 4FSWFS $MJFOU 4FSWFS XXXSVCZMBOHPSH 5IF*1BEESFTTJT D

/FYU UIFZTUBSUBDPOOFDUJPOBUUFNQUUPUIFSFTPMWFE*1 BEESFTT )PXTPDLFUMJCSBSZTNFUIPETXPSL 4FSWFS $MJFOU 4FSWFS 5PBSFTPMWFE*1BEESFTT D

*GUIFDPOOFDUJPOJTFTUBCMJTIFE UIFOJUSFUVSOTUIFTPDLFU DPOOFDUFEUPUIFUBSHFUTFSWFS )PXTPDLFUMJCSBSZTNFUIPETXPSL 4FSWFS $MJFOU 4FSWFS 5PBSFTPMWFE*1BEESFTT D $POOFDUJPO0, 3FUVSOB4PDLFUPCKFDUDPOOFDUFEUPUIFUBSHFUTFSWFS

"UBSHFUTFSWFSNBZIBWFCPUI*1WBOE*1WBEESFTTFT *1WD *1W 4FSWFS $MJFOU 4FSWFS *TTVFTJO3VCZTTPDLFUMJCSBSZ

5IFSFGPSF BDMJFOUNVTURVFSZ%/4GPSCPUI*1WBOE *1WBEESFTTFT %/44FSWFS $MJFOU 5IF*1WBEESFTTJT D 5IF*1WBEESFTTJT "OTXFS*1WBEESFTTFT "OTXFS*1WBEESFTTFT *TTVFTJO3VCZTTPDLFUMJCSBSZ 2VFSZ*1WBEESFTTFT 2VFSZ*1WBEESFTTFT

$VSSFOUMZ JURVFSJFTTFRVFOUJBMMZGPSFBDIBEESFTTGBNJMZ *U fi STURVFSJFTFJUIFSBO*1WPS*1WBEESFTT UIFORVFSJFTUIFPUIFSUZQFPODFBOTXFSFE %/44FSWFS $MJFOU *TTVFTJO3VCZTTPDLFUMJCSBSZ 2VFSZ*1WBEESFTTFTMBUFS 2VFSZ*1WBEESFTTFTFBSMJFS "OTXFS*1WBEESFTTFT FH

-FUTDPOTJEFSBTDFOBSJPXIFSF B%/4TFSWFSUBLFTBMPOHUJNFUPBOTXFSXJUI*1W BOEDBOBOTXFSJNNFEJBUFMZXJUI*1W *1WDBOOPUBOTXFSJNNFEJBUFMZ *1WDBOBOTXFS %/44FSWFS $MJFOU *TTVFTJO3VCZTTPDLFUMJCSBSZ

*TTVFTJO3VCZTTPDLFUMJCSBSZ *GBDMJFOURVFSJFTGPSUIF*1WBEESFTT fi STU JUFOETVQ XBJUJOHBMPOHUJNFGPSHFUUJOHUIFBOTXFS $BOOPUSFTQPOTFJNNFEJBUFMZ %FTQJUFUIFQPTTJCJMJUZPGBOJNNFEJBUF*1WBOTXFS %/44FSWFS $MJFOU *1WDBOOPUBOTXFSJNNFEJBUFMZ *1WDBOBOTXFS 2VFSZ*1WBEESFTTFT

'VSUIFSNPSF DPOTJEFSBTDFOBSJPXIFSFOBNFSFTPMVUJPO JTTVDDFTTGVMBOECPUI*1WBOE*1WBEESFTTFTBSF PCUBJOFE "DMJFOUBUUFNQUUPDPOOFDUUPPOFPGUIFSFTPMWFE*1 BEESFTT *1WSFTPMWFE *1WSFTPMWFE 4FSWFS $MJFOU 4FSWFS *TTVFTJO3VCZTTPDLFUMJCSBSZ 5PBSFTPMWFE*1BEESFTT

$VSSFOUMZ UIFBUUFNQUTBSFNBEFTFRVFOUJBMMZGPSFBDI*1 BEESFTT*GBDPOOFDUJPOBUUFNQUUPPOFBEESFTTGBJMT JUXBJUTVOUJMUIFGBJMVSFJTDPO fi SNFECFGPSFBUUFNQUJOH XJUIBOPUIFSBEESFTT 4FSWFS $MJFOU 4FSWFS *1WSFTPMWFE *1WSFTPMWFE *TTVFTJO3VCZTTPDLFUMJCSBSZ $POOFDUJPO0, 5PBOPUIFSSFTPMWFE*1BEESFTT $POOFDUJPO/050, 5PBSFTPMWFE*1BEESFTT

*TTVFTJO3VCZTTPDLFUMJCSBSZ /PXDPOTJEFSBHBJOBTDFOBSJPXIFSFBUBSHFUTFSWFS UBLFTBMPOHUJNFUPDPOOFDUXJUI*1WBOEDBODPOOFDU JNNFEJBUFMZXJUI*1W 4FSWFS $MJFOU 4FSWFS *1WDBOOPUDPOOFDUJNNFEJBUFMZ *1WDBODPOOFDU *1WSFTPMWFE *1WSFTPMWFE

*GBDMJFOUBUUFNQUTUPDPOOFDUUPBO*1WBEESFTT fi STU JUFOETVQXBJUJOHBMPOHUJNFGPSUIFDPOOFDUJPOUPCF FTUBCMJTIFE *TTVFTJO3VCZTTPDLFUMJCSBSZ $BOOPUSFTQPOTFJNNFEJBUFMZ 4FSWFS $MJFOU 4FSWFS %FTQJUFUIFDMJFOULOPXJOHBOBWBJMBCMF*1WBEESFTT *1WSFTPMWFE *1WSFTPMWFE 5PBSFTPMWFE*1WBEESFTT *1WDBOOPUDPOOFDUJNNFEJBUFMZ *1WDBODPOOFDU

5IFTFJTTVFTDPNNPOMZPDDVSJOFOWJSPONFOUT LOPXOBTEVBMTUBDL XIFSFBUBSHFUTFSWFSIBWF CPUI*1WBOE*1WBEESFTTFT

5PBEESFTTUIJT *&5'IBTTQFDJ fi FEBOBMHPSJUIN JO3'$UPSFEVDFUIJTQSPCMFN 5IBUJT

)BQQZ&ZFCBMMT7FSTJPO IUUQTEBUBUSBDLFSJFUGPSHEPDIUNMSGD

)PX)BQQZ&ZFCBMMT7FSTJPO )&W XPSLT /PX MFUTTFFIPX)&WXPSLT"DDPSEJOHUP3'$ UIJTBMHPSJUINJODMVEFTGPVSQIBTFT )BQQZ&ZFCBMMT7FSTJPO#FUUFS$POOFDUJWJUZ6TJOH$PODVSSFODZ0WFSWJFX IUUQTEBUBUSBDLFSJFUGPSHEPDIUNMSGDTFDUJPO

)PX)BQQZ&ZFCBMMT7FSTJPO )&W XPSLT /PX MFUTTFFIPX)&WXPSLT"DDPSEJOHUP3'$ UIJTBMHPSJUINJODMVEFTGPVSQIBTFT *OJUJBUJPOPGBTZODISPOPVT%/4RVFSJFT )BQQZ&ZFCBMMT7FSTJPO#FUUFS$POOFDUJWJUZ6TJOH$PODVSSFODZ0WFSWJFX IUUQTEBUBUSBDLFSJFUGPSHEPDIUNMSGDTFDUJPO

)PX)BQQZ&ZFCBMMT7FSTJPO )&W XPSLT /PX MFUTTFFIPX)&WXPSLT"DDPSEJOHUP3'$ UIJTBMHPSJUINJODMVEFTGPVSQIBTFT *OJUJBUJPOPGBTZODISPOPVT%/4RVFSJFT 4PSUJOHPGSFTPMWFEEFTUJOBUJPOBEESFTTFT )BQQZ&ZFCBMMT7FSTJPO#FUUFS$POOFDUJWJUZ6TJOH$PODVSSFODZ0WFSWJFX IUUQTEBUBUSBDLFSJFUGPSHEPDIUNMSGDTFDUJPO

)PX)BQQZ&ZFCBMMT7FSTJPO )&W XPSLT /PX MFUTTFFIPX)&WXPSLT"DDPSEJOHUP3'$ UIJTBMHPSJUINJODMVEFTGPVSQIBTFT *OJUJBUJPOPGBTZODISPOPVT%/4RVFSJFT 4PSUJOHPGSFTPMWFEEFTUJOBUJPOBEESFTTFT *OJUJBUJPOPGBTZODISPOPVTDPOOFDUJPOBUUFNQUT )BQQZ&ZFCBMMT7FSTJPO#FUUFS$POOFDUJWJUZ6TJOH$PODVSSFODZ0WFSWJFX IUUQTEBUBUSBDLFSJFUGPSHEPDIUNMSGDTFDUJPO

)PX)BQQZ&ZFCBMMT7FSTJPO )&W XPSLT /PX MFUTTFFIPX)&WXPSLT"DDPSEJOHUP3'$ UIJTBMHPSJUINJODMVEFTGPVSQIBTFT *OJUJBUJPOPGBTZODISPOPVT%/4RVFSJFT 4PSUJOHPGSFTPMWFEEFTUJOBUJPOBEESFTTFT *OJUJBUJPOPGBTZODISPOPVTDPOOFDUJPOBUUFNQUT &TUBCMJTINFOUPGPOFDPOOFDUJPO XIJDIDBODFMT BMMPUIFSBUUFNQUT )BQQZ&ZFCBMMT7FSTJPO#FUUFS$POOFDUJWJUZ6TJOH$PODVSSFODZ0WFSWJFX IUUQTEBUBUSBDLFSJFUGPSHEPDIUNMSGDTFDUJPO

)PX)BQQZ&ZFCBMMT7FSTJPO )&W XPSLT -FUTMPPLBUUIJTJOBMJUUMFNPSFEFUBJM 5IFNBJODPNQPOFOUTBSFUIFTBNFBTCFGPSF BDMJFOU B%/4TFSWFS BOEBUBSHFUTFSWFS %/44FSWFS 4FSWFS $MJFOU 4FSWFS

*OJUJBUJPOPGBTZODISPOPVT%/4RVFSJFT 5IF fi STUQIBTFJTBTZODISPOPVT%/4RVFSJFT "DMJFOURVFSJFTGPSBO*1WBEESFTT fi STU UIFO JNNFEJBUFMZGPS*1WXJUIPVUXBJUJOHGPSUIF*1WBOTXFS %/44FSWFS 4FSWFS $MJFOU 4FSWFS 2VFSZ*1WBEESFTTFT 2VFSZ*1WBEESFTTFT 2VFSZBUBCPVUUIFTBNFUJNF

*G*1WBEESFTTFTBSFSFTPMWFE fi STU %/44FSWFS 4FSWFS $MJFOU 4FSWFS "OTXFS*1WBEESFTTFT *OJUJBUJPOPGBTZODISPOPVT%/4RVFSJFT 2VFSZ*1WBEESFTTFT 2VFSZ*1WBEESFTTFT

UIFDMJFOUJNNFEJBUFMZTUBSUTUPDPOOFDUUPPOFPGUIF *1WBEESFTTFT %/44FSWFS 4FSWFS $MJFOU 4FSWFS 5PBSFTPMWFE*1WBEESFTT *OJUJBUJPOPGBTZODISPOPVT%/4RVFSJFT "OTXFS*1WBEESFTTFT

*G*1WBEESFTTFTBSFSFTPMWFECFGPSF*1WBEESFTTFT %/44FSWFS 4FSWFS $MJFOU 4FSWFS "OTXFS*1WBEESFTTFT *OJUJBUJPOPGBTZODISPOPVT%/4RVFSJFT 2VFSZ*1WBEESFTTFT 2VFSZ*1WBEESFTTFT

XBJUGPSNTGPS*1WBEESFTTFTUPCFSFTPMWFE 5IJTJTCFDBVTF 3'$TQFDJ fi FTUIBU)&WQSFGFSTUP DPOOFDUXJUI*1WJGQPTTJCMF %/44FSWFS 4FSWFS $MJFOU 4FSWFS "OTXFS*1WBEESFTTFT 8BJUNTGPS*1WBOTXFS /P*1WBOTXFST *OJUJBUJPOPGBTZODISPOPVT%/4RVFSJFT

*G*1WBEESFTTFTBSFSFTPMWFEXJUIJOUIJTUJNF JUTUBSUTBDPOOFDUJPOBUUFNQUUPPOFPGUIFN JNNFEJBUFMZ %/44FSWFS 4FSWFS $MJFOU 4FSWFS 5PBSFTPMWFE*1WBEESFTT *OJUJBUJPOPGBTZODISPOPVT%/4RVFSJFT "OTXFS*1WBEESFTTFT "OTXFS*1WBEESFTTFT

*G*1WBEESFTTFTDBOOPUCFSFTPMWFEXJUIJONT BDPOOFDUJPOBUUFNQUJTTUBSUFEUPPOFPGUIFSFTPMWFE *1WBEESFTTFT *OJUJBUJPOPGBTZODISPOPVT%/4RVFSJFT %/44FSWFS 4FSWFS $MJFOU 4FSWFS 5PBSFTPMWFE*1WBEESFTT /P*1WBOTXFST "OTXFS*1WBEESFTTFT

8IFORVFSZJOHBEPNBJOOBNFPGBUBSHFUTFSWFS JUJT PGUFOUIFDBTFUIBUNVMUJQMF*1WBOE*1WBEESFTTFTBSF PCUBJOFE 4PSUJOHPGSFTPMWFEEFTUJOBUJPOBEESFTTFT %/44FSWFS $MJFOU "OTXFS*1WBEESFTTFT "OTXFS*1WBEESFTTFT *1WBEESFTTFTBSF D D *1WBEESFTTFTBSF 2VFSJFT*1WBEESFTT 2VFSJFT*1WBEESFTT

*OTVDIBDBTF UIFDMJFOUTPSUTUIFBEESFTTFTBDDPSEJOH UP3'$BOE4FDUJPOPG3'$ BMMPXJOHDPOOFDUJPOBUUFNQUTUPCFTUBSUFEGSPNUIF QSFGFSSFEBEESFTT $MJFOU D D 4PSUJOHPGSFTPMWFEEFTUJOBUJPOBEESFTTFT

"GUFSTUBSUJOHBDPOOFDUJPOBUUFNQU TPNFUJNFTUIFDPOOFDUJPOJTFTUBCMJTIFEJNNFEJBUFMZ BOETPNFUJNFTJUJTOPU *OJUJBUJPOPGBTZODISPOPVTDPOOFDUJPOBUUFNQUT 4FSWFS $MJFOU 4FSWFS 5PBSFTPMWFE*1BEESFTT $BOUIFDPOOFDUJPOCFFTUBCMJTIFEJNNFEJBUFMZ

5IFDMJFOUXBJUTNTGSPNUIFTUBSUPGUIFDPOOFDUJPO GPSJUUPCFFTUBCMJTIFE *OJUJBUJPOPGBTZODISPOPVTDPOOFDUJPOBUUFNQUT 4FSWFS $MJFOU 4FSWFS 5PBSFTPMWFE*1BEESFTT 8BJUGPSNT

*GUIFDPOOFDUJPOJTOUFTUBCMJTIFEXJUIJOUIBUUJNF UIFDMJFOUPCUBJOTBOPUIFSBEESFTTGSPNUIFMJTUPG SFTPMWFE*1BEESFTTFTUIBUIBTOPUZFUCFFOBUUFNQUFE *OJUJBUJPOPGBTZODISPOPVTDPOOFDUJPOBUUFNQUT 4FSWFS $MJFOU 4FSWFS 5PBSFTPMWFE*1BEESFTT 6OBUUFNQUFEBEESFTTFT 0CUBJO

*UUIFOTUBSUTBOFXDPOOFDUJPOBUUFNQUUPUIFPCUBJOFE BEESFTT *OJUJBUJPOPGBTZODISPOPVTDPOOFDUJPOBUUFNQUT 4FSWFS $MJFOU 4FSWFS 5PBSFTPMWFE*1BEESFTT NTMBUFS UPBOPUIFSSFTPMWFE*1BEESFTT

'SPNUIJTQPJOUPOXBSET BTMPOHBTUIFSFBSFBEESFTTFT UIBUIBWFOUCFFOBUUFNQUFE UIFGPMMPXJOHTUFQTXJMMCF SFQFBUFEFWFSZNT *OJUJBUJPOPGBTZODISPOPVTDPOOFDUJPOBUUFNQUT $MJFOU 4FSWFS 5PBSFTPMWFE*1BEESFTT NTMBUFS UPBOPUIFSSFTPMWFE*1BEESFTT 8BJUGPSNT

0CUBJOJOHBOBEESFTTGSPNUIFMJTUPGSFTPMWFE*1 BEESFTTFT *OJUJBUJPOPGBTZODISPOPVTDPOOFDUJPOBUUFNQUT $MJFOU 4FSWFS 6OBUUFNQUFEBEESFTTFT 0CUBJO 5PBSFTPMWFE*1BEESFTT NTMBUFS UPBOPUIFSSFTPMWFE*1BEESFTT

4UBSUJOHBDPOOFDUJPOBUUFNQUUPUIFPCUBJOFEBEESFTT *OJUJBUJPOPGBTZODISPOPVTDPOOFDUJPOBUUFNQUT $MJFOU 4FSWFS 6OBUUFNQUFEBEESFTTFT 0CUBJO 5PBSFTPMWFE*1BEESFTT NTMBUFS UPBOPUIFSSFTPMWFE*1BEESFTT NTMBUFS UPBOPUIFSSFTPMWFE*1BEESFTT

8BJUJOHGPSPOFPGUIFDPOOFDUJPOTUPCFFTUBCMJTIFEGPS NT "OEUIJTJTUIFUIJSEQIBTF *OJUJBUJPOPGBTZODISPOPVTDPOOFDUJPOBUUFNQUT $MJFOU 4FSWFS 6OBUUFNQUFEBEESFTTFT 0CUBJO 5PBSFTPMWFE*1BEESFTT NTMBUFS UPBOPUIFSSFTPMWFE*1BEESFTT NTMBUFS UPBOPUIFSSFTPMWFE*1BEESFTT 8BJUGPSNT

"EEJUJPOBMMZ JOTPNFDBTFT OBNFSFTPMVUJPOGPSPUIFS BEESFTTGBNJMZFOETJOUIFCBDLHSPVOEEVSJOHSFQFBUFE DPOOFDUJPOBUUFNQUT *OJUJBUJPOPGBTZODISPOPVTDPOOFDUJPOBUUFNQUT $MJFOU 4FSWFS 5PBSFTPMWFE*1BEESFTT %/44FSWFS "OTXFSPUIFSBEESFTTFT

*OUIJTDBTF UIFOFXMZPCUBJOFEBEESFTTFTBSFBEEFEUP UIFMJTUPGSFTPMWFE*1BEESFTTFTBOEVTFEGPS TVCTFRVFOUDPOOFDUJPOBUUFNQUT *OJUJBUJPOPGBTZODISPOPVTDPOOFDUJPOBUUFNQUT $MJFOU 4FSWFS "EEPUIFSSFTPMWFEBEESFTTFT 6OBUUFNQUFEBEESFTTFT 5PBSFTPMWFE*1BEESFTT

0ODFBDPOOFDUJPOJTTVDDFTTGVMMZFTUBCMJTIFE UIFDMJFOU BOEUIFUBSHFUTFSWFSDPNNVOJDBUFWJBUIBU*1BEESFTT &TUBCMJTINFOUPGPOFDPOOFDUJPO XIJDIDBODFMTBMMPUIFSBUUFNQUT $MJFOU 4FSWFS $POOFDUJPO0,XJUIUIFBEESFTT C 5IFSFBGUFS DPNNVOJDBUFWJBUIFBEESFTT C NTMBUFS UPBOPUIFSSFTPMWFE*1BEESFTT C 5PBSFTPMWFE*1BEESFTT B

"UUIJTQPJOU UIFDMJFOUDBODFMTPUIFSDPOOFDUJPO BUUFNQUT5IJTJTUIFGPVSUIQIBTF $MJFOU 4FSWFS $BODFM &TUBCMJTINFOUPGPOFDPOOFDUJPO XIJDIDBODFMTBMMPUIFSBUUFNQUT $POOFDUJPO0,XJUIUIFBEESFTT C NTMBUFS UPBOPUIFSSFTPMWFE*1BEESFTT C 5PBSFTPMWFE*1BEESFTT B

*UTFFNTTJNQMF

"OZXBZ MFUTDPOTJEFSJNQMFNFOUJOH )BQQZ&ZFCBMMT7FSTJPOJO3VCZTPDLFUMJCSBSZ

5IFNFUIPETUBSHFUFEGPSUIFJOUSPEVDUJPOPG )&WBSF 4PDLFUUDQ JNQMFNFOUFECZ3VCZ 5$14PDLFUOFX JNQMFNFOUFECZ$ 5IJTUJNF *EMJLFUPGPDVTPO4PDLFUUDQ

class Socket def self.tcp(host, port) # Do something end end /PX MFUTJNQMFNFOU4PDLFUUDQUIBUTVQQPSUT)&W *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&W

class Socket def self.tcp(host, port) threads = [Socket::AF_INET6, Socket::AF_INET].map { |family| Thread.new(...) { |...| addresses = Addrinfo.getaddrinfo(...) shared_list.concat(addresses); cond.signal } } connected_socket = loop do cond.wait(mutex) while addresses.empty? address = addresses.shift; socket = Socket.new(...) socket.connect_nonblock(address); sockets.push(socket) _, writables, = IO.select(nil, sockets, nil, 0.25) connected_socket = pick_connected_socket(...) break connected_socket if connected_socket end connected_socket end end "OEJUJTDPNQMFUFE *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&W

class Socket def self.tcp(host, port) # ... threads = [Socket::AF_INET6, Socket::AF_INET].map { |family| args = { Thread.new(args) { |args| addresses = Addrinfo.getaddrinfo(...) sleep 0.05 if addresses.last == Socket::AF_INET args[:mutex].synchronize do args[:shared_list].concat(addresses) args[:cond].signal end } } # ... end end 5IF fi STUQBSUJTUPIBOEMFOBNFSFTPMVUJPO *UTUBSUTCZDSFBUJOHUISFBETGPSFBDIBEESFTTGBNJMZ BOETUBSUIPTUOBNFSFTPMVUJPOBTZODISPOPVTMZ XJUIJOFBDIUISFBE )PTUOBNFSFTPMVUJPO $SFBUFBUISFBE *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&W { host:, port:, family:, resolved_addresses:, mutex:, cond: }

class Socket def self.tcp(host, port) # ... threads = [Socket::AF_INET6, Socket::AF_INET].map { |family| args = { Thread.new(args) { |args| addresses = Addrinfo.getaddrinfo(...) sleep 0.05 if addresses.last == Socket::AF_INET args[:mutex].synchronize do args[:resolved_addresses].concat(addresses) args[:cond].signal end } } # ... end end 0ODFOBNFSFTPMVUJPOJT fi OJTIFE BEEUIFOFXBEESFTTFTUPUIFMJTUPGSFTPMWFE *1BEESFTTFT "EEBEESFTTFTUPUIFMJTU *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&W { host:, port:, family:, resolved_addresses:, mutex:, cond: }

class Socket def self.tcp(host, port) # ... threads = [Socket::AF_INET6, Socket::AF_INET].map { |family| # ... } # Do "obtaining an address", "starting a connection attempt", # and "waiting for connections" # ... end end 5IFOFYUQBSUJTDPOOFDUJPOQSPDFTTJOH 5IFQSPDFTTPGPCUBJOJOHBOBEESFTT TUBSUJOHB DPOOFDUJPOBUUFNQUBOEXBJUJOHGPSDPOOFDUJPOTJT SFQFBUFEFWFSZNT *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&W

class Socket def self.tcp(host, port) # ... threads = [Socket::AF_INET6, Socket::AF_INET].map { |family| # ... } loop do # Do "obtaining an address", "starting a connection # and "waiting for connections" end # ... end end 6TF,FSOFMMPPQUPSFQFBUUIFTFTUFQT *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&W n attempt",

class Socket def self.tcp(host, port) # ... loop do mutex.synchronize do cond.wait(mutex) while resolved_addresses.empty? address = resolved_addresses.shift end socket = Socket.new(...) # ... end # ... end end 6QPO fi STUFOUFSJOHUIFMPPQ UIFMJTUPGSFTPMWFE*1 BEESFTTFTJTFNQUZ8BJUVOUJMBOZDIJMEUISFBEBEET BEESFTTFT UIFOCSFBLUIFXBJUBOEPCUBJOPOFPGUIFN 8BJUGPSBEESFTTFT 0CUBJOBOBEESFTT *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&W

class Socket def self.tcp(host, port) # ... loop do mutex.synchronize do cond.wait(mutex) while resolved_addresses.empty? address = resolved_addresses.shift end socket = sockets.push(Socket.new(...)).last socket.connect_nonblock(address, exception: false) # ... end # ... end end 5IFOTUBSUBDPOOFDUJPOBUUFNQU UPUIFPCUBJOFEBEESFTT *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&W 4UBSUBDPOOFDUJPOBUUFNQU

class Socket def self.tcp(host, port) # ... loop do mutex.synchronize do cond.wait(mutex) while resolved_addresses.empty? address = resolved_addresses.shift end socket = sockets.push(Socket.new(...)).last socket.connect_nonblock(address, exception: false) _, writable_sockets, = IO.select(nil, sockets, nil, 0.25) connected = pick_connected_socket(writable_sockets, sockets) break connected if connected end # cleanup connected end end "GUFSTUBSUJOHUIFDPOOFDUJPO XBJUGPSNT *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&W 8BJUGPSDPOOFDUJPOT

class Socket def self.tcp(host, port) # ... loop do mutex.synchronize do cond.wait(mutex) while resolved_addresses.empty? address = resolved_addresses.shift end socket = sockets.push(Socket.new(...)).last socket.connect_nonblock(address, exception: false) _, writable_sockets, = IO.select(nil, sockets, nil, 0.25) connected = pick_connected_socket(writable_sockets, sockets) break connected if connected end do_cleanup connected end end *GBDPOOFDUJPOJTFTUBCMJTIFEXJUIJOUIFUJNF FYJUUIF MPPQ"GUFSQPTUQSPDFTTJOH SFUVSOUIFDPOOFDUFE TPDLFU BOEUIFNFUIPEDPODMVEFT 0CUBJODPOOFDUFETPDLFU 3FUVSOJU *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&W

class Socket def self.tcp(host, port) # ... connected = loop do mutex.synchronize do cond.wait(mutex) while resolved_addresses.empty? address = resolved_addresses.shift end socket = sockets.push(Socket.new(...)).last socket.connect_nonblock(address, exception: false) _, writable_sockets, = IO.select(nil, sockets, nil, 0.25) connected = pick_connected_socket(writable_sockets, sockets) break connected if connected end do_cleanup connected end end 0UIFSXJTF JUHPFTUPUIFUPQPGUIFMPPQBOESFQFBUT UIFQSPDFTTPGPCUBJOJOHBOBEESFTT TUBSUJOH BDPOOFDUJPOBUUFNQU BOEXBJUJOHGPSDPOOFDUJPOT *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&W &OUFSUIFOFYUMPPQ

class Socket def self.tcp(host, port) # ... connected = loop do mutex.synchronize do cond.wait(mutex) while resolved_addresses.empty? address = resolved_addresses.shift end socket = sockets.push(Socket.new(...)).last socket.connect_nonblock(address, exception: false) _, writable_sockets, = IO.select(nil, sockets, nil, 0.25) connected = pick_connected_socket(writable_sockets, sockets) break connected if connected end do_cleanup connected end end 4PDLFUUDQXJUI)&WTVQQPSUFEJTOPXDPNQMFUF *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&W

)PXFWFS

"DUVBMMZ XIBUZPVWFTFFOTPGBSJT BTJNQMJ fi FEWFSTJPOPGNZJOJUJBMJNQMFNFOUBUJPO XIFO*TUBSUFEXPSLJOHPO)&W 5IJTJNQMFNFOUBUJPOIBETPNFJTTVFT 'PSFYBNQMF *TTVFTXJUIUIJTJNQMFNFOUBUJPO

def self.tcp(host, port) # ... connected = loop do mutex.synchronize do cond.wait(mutex) while resolved_addresses.empty? address = resolved_addresses.shift end socket = sockets.push(Socket.new(...)).last socket.connect_nonblock(address, exception: false) _, writable_sockets, = IO.select(nil, sockets, nil, 0.25) connected = pick_connected_socket(writable_sockets, sockets) break connected if connected end # ... end *TTVFTXJUIUIJTJNQMFNFOUBUJPO -FUTDPOTJEFSUIFDBTFXIFSF BGUFSTUBSUJOHB DPOOFDUJPOBUUFNQU JUIBTOPUCFFOFTUBCMJTIFE XJUIJONT BOEJUFOUFSTUIFOFYUMPPQ &OUFSUIFOFYUMPPQ

def self.tcp(host, port) # ... connected = loop do mutex.synchronize do cond.wait(mutex) while resolved_addresses.empty? address = resolved_addresses.shift end socket = sockets.push(Socket.new(...)).last socket.connect_nonblock(address, exception: false) _, writable_sockets, = IO.select(nil, sockets, nil, 0.25) connected = pick_connected_socket(writable_sockets, sockets) break connected if connected end # ... end 4VQQPTFUIFMJTUPGSFTPMWFE*1BEESFTTFTJTFNQUZ BUUIJTUJNF *GTP JUXJMMXBJUIFSFVOUJMOFXBEESFTTFTBSFBEEFE 8BJUIFSF *TTVFTXJUIUIJTJNQMFNFOUBUJPO &NQUZ

def self.tcp(host, port) # ... connected = loop do mutex.synchronize do cond.wait(mutex) while resolved_addresses.empty? address = resolved_addresses.shift end socket = sockets.push(Socket.new(...)).last socket.connect_nonblock(address, exception: false) _, writable_sockets, = IO.select(nil, sockets, nil, 0.25) connected = pick_connected_socket(writable_sockets, sockets) break connected if connected end # ... end 8IBUTIPVMEJUEPJGUIFDPOOFDUJPOJTFTUBCMJTIFEJO UIFCBDLHSPVOEEVSJOHUIJTUJNF "DPOOFDUJPOJTFTUBCMJTIFE JOUIFCBDLHSPVOE *TTVFTXJUIUIJTJNQMFNFOUBUJPO 8BJUIFSF &NQUZ

def self.tcp(host, port) # ... connected = loop do mutex.synchronize do cond.wait(mutex) while resolved_addresses.empty? address = resolved_addresses.shift end socket = sockets.push(Socket.new(...)).last socket.connect_nonblock(address, exception: false) _, writable_sockets, = IO.select(nil, sockets, nil, 0.25) connected = pick_connected_socket(writable_sockets, sockets) break connected if connected end # ... end *OTVDIBDBTF UIFNFUIPETIPVMESFUVSOUIFDPOOFDUFE TPDLFUJNNFEJBUFMZ)PXFWFS JUTJNQPTTJCMFUPEFUFDUB FTUBCMJTIFEDPOOFDUJPOXIJMFBXBJUJOHBEESFTTFTDVSSFOUMZ *TTVFTXJUIUIJTJNQMFNFOUBUJPO $BOUTUPQUPXBJU &NQUZ

def self.tcp(host, port) # ... connected = loop do mutex.synchronize do cond.wait(mutex) while resolved_addresses.empty? address = resolved_addresses.shift end socket = sockets.push(Socket.new(...)).last socket.connect_nonblock(address, exception: false) _, writable_sockets, = IO.select(nil, sockets, nil, 0.25) connected = pick_connected_socket(writable_sockets, sockets) break connected if connected end # ... end 0SXIBUXPVMEIBQQFOJGUIFMJTUPGSFTPMWFE*1 BEESFTTFTJTFNQUZBOEBMMBEESFTTGBNJMJFTIBWFCFFO OBNFSFTPMWFE *TTVFTXJUIUIJTJNQMFNFOUBUJPO 8BJUIFSF &NQUZ "MMOBNFSFTPMVUJPOTIBWF BMSFBEZCFFO fi OJTIFE

def self.tcp(host, port) # ... connected = loop do mutex.synchronize do cond.wait(mutex) while resolved_addresses.empty? address = resolved_addresses.shift end socket = sockets.push(Socket.new(...)).last socket.connect_nonblock(address, exception: false) _, writable_sockets, = IO.select(nil, sockets, nil, 0.25) connected = pick_connected_socket(writable_sockets, sockets) break connected if connected end # ... end *OTVDIBDBTF OPOFXBEESFTTFTXJMMCFBEEFEUP UIFMJTU BOEUIVT UIFQSPDFTTXPVMECFQFSNBOFOUMZ TUPQQFE *TTVFTXJUIUIJTJNQMFNFOUBUJPO 8BJUIFSFGPSFWFS &NQUZ

def self.tcp(host, port) # ... connected = loop do mutex.synchronize do cond.wait(mutex) while resolved_addresses.empty? address = resolved_addresses.shift end socket = sockets.push(Socket.new(...)).last socket.connect_nonblock(address, exception: false) _, writable_sockets, = IO.select(nil, sockets, nil, 0.25) connected = pick_connected_socket(writable_sockets, sockets) break connected if connected end # ... end "MTP DPOOFDUJPOBUUFNQUTDBOGBJMXJUIJONTPGTUBSUJOH *OTVDIBDBTF JUTIPVMEXBJUGPSUIFSFNBJOEFSPGUIFNT CFGPSFFOUFSJOHUIFOFYUMPPQBOETUBSUBOFXBUUFNQU *UUVSOFEPVUUIBUBDPOOFDUJPOBUUFNQUJTGBJMFE *TTVFTXJUIUIJTJNQMFNFOUBUJPO

def self.tcp(host, port) # ... connected = loop do mutex.synchronize do cond.wait(mutex) while resolved_addresses.empty? address = resolved_addresses.shift end socket = sockets.push(Socket.new(...)).last socket.connect_nonblock(address, exception: false) _, writable_sockets, = IO.select(nil, sockets, nil, 0.25) connected = pick_connected_socket(writable_sockets, sockets) break connected if connected end # ... end #VUXJUIUIFJNQMFNFOUBUJPO JUQSPDFFETUPUIFOFYU MPPQXJUIPVUXBJUJOHGPSUIFSFNBJOEFSPGUIFUJNF JNNFEJBUFMZTUBSUJOHBOFXDPOOFDUJPOBUUFNQU &OUFSUIFOFYUMPPQXJUIPVU XBJUJOHGPSSFNBJOJOHUJNF *TTVFTXJUIUIJTJNQMFNFOUBUJPO 4UBSUBOFXDPOOFDUJPOBUUFNQU

def self.tcp(host, port) # ... connected = loop do mutex.synchronize do cond.wait(mutex) while resolved_addresses.empty? address = resolved_addresses.shift end socket = sockets.push(Socket.new(...)).last socket.connect_nonblock(address, exception: false) _, writable_sockets, = IO.select(nil, sockets, nil, 0.25) connected = pick_connected_socket(writable_sockets, sockets) sleep(remaining) if connection_failed break connected if connected end # ... end 5PBWPJEUIJT TIPVMEJUTMFFQGPSUIFSFNBJOJOHUJNF JGBOZDPOOFDUJPOTGBJM 4IPVMETMFFQ *TTVFTXJUIUIJTJNQMFNFOUBUJPO

def self.tcp(host, port) # ... connected = loop do mutex.synchronize do cond.wait(mutex) while resolved_addresses.empty? address = resolved_addresses.shift end socket = sockets.push(Socket.new(...)).last socket.connect_nonblock(address, exception: false) _, writable_sockets, = IO.select(nil, sockets, nil, 0.25) connected = pick_connected_socket(writable_sockets, sockets) sleep(remaining) if connection_failed break connected if connected end # ... end *OUIBUDBTF JGPUIFSDPOOFDUJPOTBSFJOQSPHSFTTBOE POFJTFTUBCMJTIFEXIJMFTMFFQJOHJOUIFCBDLHSPVOE JUDBOUEFUFDUUIFFTUBCMJTIFEDPOOFDUJPO $BOUEFUFDUFTUBCMJTIFEDPOOFDUJPOT *TTVFTXJUIUIJTJNQMFNFOUBUJPO "DPOOFDUJPOJTFTUBCMJTIFE JOUIFCBDLHSPVOE

def self.tcp(host, port) # ... connected = loop do mutex.synchronize do cond.wait(mutex) while resolved_addresses.empty? address = resolved_addresses.shift end socket = sockets.push(Socket.new(...)).last socket.connect_nonblock(address, exception: false) _, writable_sockets, = IO.select(nil, sockets, nil, 0.25) connected = pick_connected_socket(writable_sockets, sockets) sleep(remaining) if connection_failed break connected if connected end # ... end 0S JGUIFMJTUPGSFTPMWFE*1BEESFTTFTJTFNQUZJOUIF OFYUMPPQBGUFSXBLJOHGSPNTMFFQ JUXPVMETUBSUXBJUJOH GPSBEESFTTFTBHBJO"OETPPOBOETPGPSUI &OUFSUIFOFYUMPPQ *TTVFTXJUIUIJTJNQMFNFOUBUJPO 4UBSUUPXBJUIFSFBHBJO JGUIFMJTUJTFNQUZ &NQUZ

No content

8IZEPFTUIFNIBQQFO def self.tcp(host, port) # ... connected = loop do mutex.synchronize do cond.wait(mutex) while resolved_addresses.empty? address = resolved_addresses.shift end socket = sockets.push(Socket.new(...)).last socket.connect_nonblock(address, exception: false) _, writable_sockets, = IO.select(nil, sockets, nil, 0.25) connected = pick_connected_socket(writable_sockets, sockets) sleep(remaining) if connection_failed break connected if connected end # ... end -FUTSFWJTJUUIFDVSSFOUJNQMFNFOUBUJPO UPDMBSJGZUIFVOEFSMZJOHQSPCMFN

def self.tcp(host, port) # ... connected = loop do mutex.synchronize do cond.wait(mutex) while resolved_addresses.empty? address = resolved_addresses.shift end socket = sockets.push(Socket.new(...)).last socket.connect_nonblock(address, exception: false) _, writable_sockets, = IO.select(nil, sockets, nil, 0.25) connected = pick_connected_socket(writable_sockets, sockets) sleep(remaining) if connection_failed break connected if connected end # ... end 8JUIJOUIJTMPPQ GSPNUIFUPQEPXO JUTXBJUJOHGPS OBNFSFTPMVUJPOTBOEPCUBJOJOHBOBEESFTT 8IZEPFTUIFNIBQQFO 8BJUGPSOBNFSFTPMVUJPOT "DPOUJOVPVTTFRVFODFJOUIFMPPQ 0CUBJOBOBEESFTT

def self.tcp(host, port) # ... connected = loop do mutex.synchronize do cond.wait(mutex) while resolved_addresses.empty? address = resolved_addresses.shift end socket = sockets.push(Socket.new(...)).last socket.connect_nonblock(address, exception: false) _, writable_sockets, = IO.select(nil, sockets, nil, 0.25) connected = pick_connected_socket(writable_sockets, sockets) sleep(remaining) if connection_failed break connected if connected end # ... end TUBSUJOHBDPOOFDUJPOBUUFNQU 8IZEPFTUIFNIBQQFO "DPOUJOVPVTTFRVFODFJOUIFMPPQ 4UBSUBDPOOFDUJPOBUUFNQU

def self.tcp(host, port) # ... connected = loop do mutex.synchronize do cond.wait(mutex) while resolved_addresses.empty? address = resolved_addresses.shift end socket = sockets.push(Socket.new(...)).last socket.connect_nonblock(address, exception: false) _, writable_sockets, = IO.select(nil, sockets, nil, 0.25) connected = pick_connected_socket(writable_sockets, sockets) sleep(remaining) if connection_failed break connected if connected end # ... end BOEXBJUJOHGPSUIPTFDPOOFDUJPOT BTBDPOUJOVPVTTFRVFODF 8IZEPFTUIFNIBQQFO 8BJUGPSDPOOFDUJPOT "DPOUJOVPVTTFRVFODFJOUIFMPPQ

def self.tcp(host, port) # ... connected = loop do mutex.synchronize do cond.wait(mutex) while resolved_addresses.empty? address = resolved_addresses.shift end socket = sockets.push(Socket.new(...)).last socket.connect_nonblock(address, exception: false) _, writable_sockets, = IO.select(nil, sockets, nil, 0.25) connected = pick_connected_socket(writable_sockets, sockets) sleep(remaining) if connection_failed break connected if connected end # ... end 8IZEPFTUIFNIBQQFO )PXFWFS EFQFOEJOHPOUIFTUBUVTPGUIFMJTUPG SFTPMWFE*1BEESFTTFTBOEUIFDPOOFDUJOHTPDLFUT VOOFDFTTBSZEFMBZTDBOPDDVSXJUIJOUIFMPPQ 6OOFDFTTBSZEFMBZTDBOPDDVS "DPOUJOVPVTTFRVFODFJOUIFMPPQ

def self.tcp(host, port) # ... connected = loop do mutex.synchronize do cond.wait(mutex) while resolved_addresses.empty? address = resolved_addresses.shift end socket = sockets.push(Socket.new(...)).last socket.connect_nonblock(address, exception: false) _, writable_sockets, = IO.select(nil, sockets, nil, 0.25) connected = pick_connected_socket(writable_sockets, sockets) sleep(remaining) if connection_failed break connected if connected end # ... end 8IZEPFTUIFNIBQQFO 5IFQSPDFTTUIBUTIPVMECFFYFDVUFEJOUIFMPPQTFFNT UPCFEJ ff FSFOUFBDIUJNF EFQFOEJOHPOUIFTUBUVT PGUIFMJTUPGBEESFTTFTBOEUIFDPOOFDUJOHTPDLFUT "DPOUJOVPVTTFRVFODFJOUIFMPPQ

5IFOBUVSFPG)&W 5PQVUJUNPSFBCTUSBDUMZ JUHPFTMJLFUIJT )&WBMHPSJUINEFBMTXJUISFTPVSDFTTVDIBTSFTPMWFE*1 BEESFTTFTBOEDPOOFDUJOHTPDLFUT $POOFDUJOHTPDLFUT 3FTPVSDFT 3FTPMWFE*1BEESFTTFT

"QQSPQSJBUFBDUJPOTBSFFYFDVUFECBTFEPOUIFTF SFTPVSDFT 5IFOBUVSFPG)&W $POOFDUJOHTPDLFUT 3FTPVSDFT 3FTPMWFE*1BEESFTTFT 3FTPMWFIPTUOBNF "DUJPO

"TBSFTVMU UIFSFTPVSDFTBSFDIBOHFE 5IFOBUVSFPG)&W $POOFDUJOHTPDLFUT 3FTPVSDFT 3FTPMWFE*1BEESFTTFT 3FTPMWFE*1BEESFTTFTBSFBEEFE

5IFOFYUBDUJPOTBSFFYFDVUFECBTFEPOUIFDIBOHFE SFTPVSDFT5IFOUIFSFTPVSDFTBSFDIBOHFEBHBJO 5IFOBUVSFPG)&W $POOFDUJOHTPDLFUT 3FTPVSDFT 3FTPMWFE*1BEESFTTFT 4UBSUUPDPOOFDU "DUJPO "$POOFDUJOHTPDLFUJTBEEFE

5IFOFYUBDUJPOTBSFFYFDVUFECBTFEPOUIFDIBOHFE TUBUFPGUIFSFTPVSDFT5IFOUIFTUBUFPGUIFSFTPVSDF DIBOHFTBHBJO 5IFOBUVSFPG)&W $POOFDUJOHTPDLFUT 3FTPVSDFT 3FTPMWFE*1BEESFTTFT "$POOFDUJOHTPDLFUJTBEEFE 4UBSUUPDPOOFDU "DUJPO 5IJTDPVMENFBO JUTFTTFOUJBMMZBTUBUFNBDIJOF DPVMEO`UJU

"DUVBMMZ UIFTUBUFUSBOTJUJPOEJBHSBNPGUIJTIBEBMSFBEZCFFO DSFBUFECZ!BLSEVSJOHUIF3VCZ"TTPDJBUJPOHSBOU ɹ )&WTTUBUFUSBOTJUJPO IUUQTXXXSVCZPSKQHSBOUNBUTVTIJUB@NFOUPS@SFQPSUQEG

)&WTTUBUFUSBOTJUJPO 4P JOUIFBDUVBMEFWFMPQNFOUUIJTUJNF UPVOEFSTUBOEUIF fl PXPG)&W`TCFIBWJPS *TUBSUFECZDSFBUJOHQTFVEPDPEF MJLFUIJT SFGFSSJOHUIFFBSMJFSEJBHSBNBTBIJOU case start to - v6c - v4w - failure - timeout do Thread.new { IPv6 Addrinfo.getaddrinfo } Thread.new { IPv4 Addrinfo.getaddrinfo } Until the next state is determined select([Hostname resolution rpipe], Resolv timeout expires at) case IPv6 resolved Selectable addrinfo = Hostname resolution queue.pop Selectable addrinfos.push Selectable addrinfo -> v6c "OFYBNQMFPGUIFQTFVEPDPEF

)&WTTUBUFUSBOTJUJPO 5PDPNQMFUFUIJT JUTOFDFTTBSZUPDPOTJEFSUIFTUBUFTSFRVJSFEGPS JNQMFNFOUBUJPOBOEUPDPWFSQPUFOUJBMDPSOFSDBTFT "TBSFTVMU XIBUJUFOEFEVQXJUI

)&WTTUBUFUSBOTJUJPO case start to - v6c - v4w - failure - timeout do Local addrinfos = Addrinfo.getaddrinfo case ϦϞʔτϗετ·ͨ͸ϩʔΧϧϗετ͕IPΞυϨε addrinfo = Addrinfo.getaddrinfo Selectable addrinfos.push Selectable addrinfo case IPv6 addrinfo -> v6c case IPv4 addrinfo -> v4c case ϦϞʔτϗετͱϩʔΧϧϗετ͕υϝΠϯ໊ Thread.new { IPv6 Addrinfo.getaddrinfo } Thread.new { IPv4 Addrinfo.getaddrinfo } while ࣍ͷstate͕ܾఆ͢Δ·Ͱ select([Hostname resolution rpipe], Resolv timeout expires at) case Resolv timeout expires at ௒ա -> timeout case v6໊લղܾ Selectable addrinfo = Hostname resolution queue.pop Selectable addrinfos.push Selectable addrinfo -> v6c case v4໊લղܾ Selectable addrinfo = Hostname resolution queue.pop Selectable addrinfos.push Selectable addrinfo -> v4w case ໊લղܾΤϥʔ case retryable: true retry case retryable: false Last error = Τϥʔ -> failure case v4w from - start condition - selectͷฦΓ஋: - Resolution delay expires at ௒ա - v6໊લղܾ - ໊લղܾΤϥʔ to - v4c - v46c do select([Hostname resolution rpipe], Resolution delay expires at) case Resolution delay expires at ௒ա -> v4c case v6ΞυϨεղܾ Selectable addrinfo = Hostname resolution queue.pop Selectable addrinfos.push Selectable addrinfo -> v46c case ໊લղܾΤϥʔ -> v46c case v6c, v4c, v46c from - start - v4w - v46w to - v46c - v46w - success - failure do Connecting addrinfo = Selectable addrinfos.pop Connecting socket = Socket.new(Connecting addrinfo) case Local addrinfos: any case Connecting addrinfoͱಉ͡ΞυϨεϑΝϛϦͷLocal addrinfo͕͋Δ Local addrinfo = Local addrinfos.pick Connecting socket.bind Local addrinfo ҎԼ΁ਐΉ case Connecting addrinfoͱಉ͡ΞυϨεϑΝϛϦͷLocal addrinfo͕ͳ͍ case Selectable addrinfos: any && Connecting sockets: any && Hostname resolution queue: opened # ࣍ͷϧʔϓͰผͷSelectable addrinfoΛࢼ͢ -> v46c case Selectable addrinfos: any && Connecting sockets: any && Hostname resolution queue: closed # ࣍ͷϧʔϓͰผͷSelectable addrinfoΛࢼ͢ -> v46c case Selectable addrinfos: any && Connecting sockets: empty && Hostname resolution queue: opened # ࣍ͷϧʔϓͰผͷSelectable addrinfoΛࢼ͢ -> v46c case Selectable addrinfos: any && Connecting sockets: empty && Hostname resolution queue: closed # ࣍ͷϧʔϓͰผͷSelectable addrinfoΛࢼ͢ -> v46c case Selectable addrinfos: empty && Connecting sockets: any && Hostname resolution queue: opened # ࣍ͷϧʔϓͰ઀ଓ໊͔લղܾΛ଴ͭ # Connecting sockets͕͋Δ͏ͪ͸Resolv timeout expires at ͸ߟྀ͠ͳ͍ Connection attempt delay expires at = nil -> v46w case Selectable addrinfos: empty && Connecting sockets: any && Hostname resolution queue: closed # ࣍ͷϧʔϓͰ઀ଓΛ଴ͭ Connection attempt delay expires at = nil -> v46w case Selectable addrinfos: empty && Connecting sockets: empty && Hostname resolution queue: opened case Resolv timeout expires at: ઃఆ͋Γ && Resolv timeout expires at ௒ա -> timeout case ͦΕҎ֎ # ࣍ͷϧʔϓͰ໊લղܾΛ଴ͭ Connection attempt delay expires at = nil -> v46w case Selectable addrinfos: empty && Connecting sockets: empty && Hostname resolution queue: closed -> failure case Local addrinfos: empty ҎԼ΁ਐΉ Connection attempt delay expires at = ݱࡏͷΫϩοΫ࣌ؒ + Connection Attempt Delay case Selectable addrinfos: empty && Connecting sockets: empty && Hostname resolution queue: closed connect case ͦΕҎ֎ connect_nonblock ҎԼ΁ਐΉ case ઀ଓʹ੒ޭ -> success case ઀ଓத Connecting sockets.add Connecting socket -> v46w case SystemCallError Last error = SystemCallError case Selectable addrinfos: any && Connecting Sockets: any && Hostname resolution queue: opened # ࣍ͷϧʔϓͰผͷSelectable addrinfoΛࢼ͢ -> v46c case Selectable addrinfos: any && Connecting Sockets: any && Hostname resolution queue: closed # ࣍ͷϧʔϓͰผͷSelectable addrinfoΛࢼ͢ -> v46c case Selectable addrinfos: any && Connecting Sockets: empty && Hostname resolution queue: opened # ࣍ͷϧʔϓͰผͷSelectable addrinfoΛࢼ͢ -> v46c case Selectable addrinfos: any && Connecting Sockets: empty && Hostname resolution queue: closed # ࣍ͷϧʔϓͰผͷSelectable addrinfoΛࢼ͢ -> v46c case Selectable addrinfos: empty && Connecting Sockets: any && Hostname resolution queue: opened # ࣍ͷϧʔϓͰ໊લղܾ͔઀ଓΛ଴ͭɻ໊લղܾͨ͠৔߹͸͞Βʹ࣍ͷϧʔϓͰv46c΁ɺ઀ଓͨ͠৔߹͸͞Βʹ࣍ͷϧʔϓͰsuccess΁ Connection attempt delay expires at = nil -> v46w case Selectable addrinfos: empty && Connecting Sockets: any && Hostname resolution queue: closed # ࣍ͷϧʔϓͰ઀ଓΛ଴ͭ Connection attempt delay expires at = nil -> v46w case Selectable addrinfos: empty && Connecting Sockets: empty && Hostname resolution queue: opened case Resolv timeout expires at: ઃఆ͋Γ && Resolv timeout expires at ௒ա -> timeout case ͦΕҎ֎ # ࣍ͷϧʔϓͰ໊લղܾΛ଴ͭ Connection attempt delay expires at = nil -> v46w case Selectable addrinfos: empty && Connecting Sockets: empty && Hostname resolution queue: closed -> failure case v46w from - v6c - v4c - v46c - v46w to - v46c - v46w - success - timeout do case Connect timeout expires at ௒ա -> timeoeut case Connect timeout expires at ௒աͰ͸ͳ͍ ҎԼ΁ਐΉ select([Hostname resolution rpipe], Connecting sockets, Connection attempt delay expires at) case Connectable sockets: any while (Connectable socket = Connectable sockets.pop) Connecting sockets.remove Connectable socket getsockopt(<઀ଓΤϥʔͷ֬ೝ>) case Τϥʔͳ͠ Connected socket = Connectable socket -> success case Τϥʔ͋Γ case Connectable sockets: any retry case Connectable sockets: empty ҎԼʹਐΉ case Selectable addrinfos: any && Connecting sockets: any && Hostname resolution queue: opened # ࣍ͷϧʔϓͰConnection attempt delay expires atΛ௒ա͢Δ·Ͱ઀ଓ໊͔લղܾΛ଴ͭ # ઀ଓ͠ͳ͔ͬͨ৔߹ɺ໊લղܾͯ͠΋͠ͳͯ͘΋͞Βʹ࣍ͷϧʔϓͰv46c΁ -> v46w case Selectable addrinfos: any && Connecting sockets: any && Hostname resolution queue: closed # ࣍ͷϧʔϓͰConnection attempt delay expires atΛ௒ա͢Δ·Ͱ઀ଓΛ଴ͭ # ઀ଓ͠ͳ͔ͬͨ৔߹͸͞Βʹ࣍ͷϧʔϓͰv46c΁ -> v46w case Selectable addrinfos: any && Connecting sockets: empty && Hostname resolution queue: opened # ࣍ͷϧʔϓͰConnection attempt delay expires atΛ௒ա͢Δ·Ͱ໊લղܾΛ଴ͭ # ໊લղܾͯ͠΋͠ͳͯ͘΋͞Βʹ࣍ͷϧʔϓͰv46c΁ -> v46w case Selectable addrinfos: any && Connecting sockets: empty && Hostname resolution queue: closed # ࣍ͷϧʔϓͰConnection attempt delay expires atΛ௒ա͢Δ·Ͱ໊લղܾΛ଴ͭ # ͞Βʹ࣍ͷϧʔϓͰv46c΁ -> v46w case Selectable addrinfos: empty && Connecting sockets: any && Hostname resolution queue: opened # ͋ͱ͸઀ଓ໊͔લղܾΛͻͨ͢Β଴ͭ͜ͱ͔͠Ͱ͖ͳ͍ # Connecting sockets͕͋Δ͏ͪ͸Resolv timeout expires at ͸ߟྀ͠ͳ͍ -> v46w case Selectable addrinfos: empty && Connecting sockets: any && Hostname resolution queue: closed # ͋ͱ͸઀ଓΛͻͨ͢Β଴ͭ͜ͱ͔͠Ͱ͖ͳ͍ Connection attempt delay expires at = nil -> v46w case Selectable addrinfos: empty && Connecting sockets: empty && Hostname resolution queue: opened case Resolv timeout expires at: ઃఆ͋Γ && Resolv timeout expires at ௒ա -> timeout case ͦΕҎ֎ # ͋ͱ͸໊લղܾΛͻͨ͢Β଴ͭ͜ͱ͔͠Ͱ͖ͳ͍ Connection attempt delay expires at = nil -> v46w case Selectable addrinfos: empty && Connecting sockets: empty && Hostname resolution queue: closed -> failure case ໊લղܾ Selectable addrinfo = Hostname resolution queue.pop Selectable addrinfos.push Selectable addrinfo # ࣍ͷϧʔϓͰConnection attempt delay expires atΛ௒ա͢Δ·Ͱ଴ͪɺ͞Βʹ࣍ͷϧʔϓͰv46c΁ -> v46w case ໊લղܾΤϥʔ # ࣍ͷϧʔϓͰConnection attempt delay expires atΛ௒ա͢Δ·Ͱ଴ͪɺ͞Βʹ࣍ͷϧʔϓͰϦιʔεͷঢ়ଶʹΑͬͯ෼ذ -> v46w case Connection attempt delay expires at ௒ա case Selectable addrinfos: any && Connecting sockets: any && Hostname resolution queue: opened -> v46c case Selectable addrinfos: any && Connecting sockets: empty && Hostname resolution queue: opened -> v46c case Selectable addrinfos: any && Connecting sockets: empty && Hostname resolution queue: opened -> v46c case Selectable addrinfos: any && Connecting sockets: empty && Hostname resolution queue: closed -> v46c case Selectable addrinfos: empty && Connecting sockets: any && Hostname resolution queue: opened # ͋ͱ͸઀ଓ໊͔લղܾΛͻͨ͢Β଴ͭ͜ͱ͔͠Ͱ͖ͳ͍ # Connecting sockets͕͋Δ͏ͪ͸Resolv timeout expires at ͸ߟྀ͠ͳ͍ Connection attempt delay expires at = nil -> v46w case Selectable addrinfos: empty && Connecting sockets: empty && Hostname resolution queue: opened case Resolv timeout expires at: ઃఆ͋Γ && Resolv timeout expires at ௒ա -> timeout case ͦΕҎ֎ # ͋ͱ͸໊લղܾΛͻͨ͢Β଴ͭ͜ͱ͔͠Ͱ͖ͳ͍ Connection attempt delay expires at = nil -> v46w case Selectable addrinfos: empty && Connecting sockets: any && Hostname resolution queue: closed # ͋ͱ͸઀ଓΛͻͨ͢Β଴ͭ͜ͱ͔͠Ͱ͖ͳ͍ Connection attempt delay expires at = nil -> v46w case Selectable addrinfos: empty && Connecting sockets: empty && Hostname resolution queue: closed -> failure case success from - v46w do cleanup return Connected socket case failure from - start do cleanup raise Last error case timeout from - start do cleanup raise Errno::ETIMEDOUT, 'user specified timeout' UVSOFEPVUMJLFUIJT 8SJUUFOJO+BQBOFTF 5IFBDUVBMQTFVEPDPEFDSFBUFE

)&WTTUBUFUSBOTJUJPO "OZXBZ IBWJOHJEFOUJ fi FEUIFOFDFTTBSZTUBUFTUP JNQMFNFOU)&W *XJMMJOUSPEVDFUIFCBTJDCFIBWJPSTPG )&WBMPOHXJUIUIFN

)&WTTUBUFUSBOTJUJPOTUBSU $POOFDUJOHTPDLFUT 3FTPMWFE*1BEESFTTFT &NQUZ &NQUZ "UUIFTUBSU UIFSFBSFUXPUZQFTPGFNQUZSFTPVSDFT 0OFJTUIFMJTUPGSFTPMWFE*1BEESFTTFT BOEUIFPUIFS JTUIFMJTUPGDPOOFDUJOHTPDLFUT 3FTPVSDFT

)&WTTUBUFUSBOTJUJPOTUBSU *UTUBSUTPVUJOUIFTUBUFDBMMFETUBSU TUBSU 3FTPVSDFT $POOFDUJOHTPDLFUT 3FTPMWFE*1BEESFTTFT &NQUZ &NQUZ

)&WTTUBUFUSBOTJUJPOTUBSU TUBSUJTUIFTUBUFGPSTUBSUJOHIPTUOBNFSFTPMVUJPO )FSF TUBSUOBNFSFTPMVUJPOGPSCPUI*1WBOE*1WJO QBSBMMFMBOEXBJUVOUJMPOFPGUIFN fi OJTIFT %/44FSWFS TUBSU 2VFSJFT*1WBEESFTTFT 8BJUGPSBOZBOTXFS 2VFSJFT*1WBEESFTTFT

)&WTTUBUFUSBOTJUJPOTUBSU 0ODFFJUIFSOBNFSFTPMVUJPOJT fi OJTIFE BEEUIFSFTPMWFEBEESFTTFTUPUIFMJTUPGSFTPMWFE*1 BEESFTTFT TUBSU 3FTPVSDFT $POOFDUJOHTPDLFUT 3FTPMWFE*1BEESFTTFT "OTXFSBOZBEESFTTFT %/44FSWFS "EE ➡︎

)&WTTUBUFUSBOTJUJPOTUBSU ➡︎ WD TUBSU *G*1WBEESFTTFTIBWFCFFOSFTPMWFE USBOTJUJPOUPBTUBUFDBMMFEWD WD "OTXFS*1WBEESFTTFT %/44FSWFS

)&WTTUBUFUSBOTJUJPOWD WDJTUIFTUBUFGPSTUBSUJOHBDPOOFDUJPOBUUFNQUUP BO*1WBEESFTT*XJMMJOUSPEVDFJUJONPSFEFUBJMMBUFS 4UBSUUPDPOOFDU 4FSWFS WD

TUBSU WX 3FUVSOJOHUPTUBSU JGUIFBEESFTTFTPCUBJOFEBGUFS TUBSUJOHOBNFSFTPMVUJPOJT*1WBEESFTTFT JUUSBOTJUJPOTUPBTUBUFDBMMFEWX )&WTTUBUFUSBOTJUJPOTUBSU ➡︎ WX %/44FSWFS "OTXFS*1WBEESFTTFT

)&WTTUBUFUSBOTJUJPOWX WX 8BJUGPS*1WBOTXFSGPSNT WXJTUIFTUBUFGPSXBJUJOHVQUPNTGPSUIF OBNFSFTPMVUJPOPG*1WBEESFTTFT %/44FSWFS

)&WTTUBUFUSBOTJUJPOWX ➡︎ WD "OTXFS*1WBEESFTTFT WX 3FTPVSDFT $POOFDUJOHTPDLFUT 3FTPMWFE*1BEESFTTFT WD *G*1WBEESFTTFTBSFSFTPMWFEXJUIJONT BEEUIFTF*1WBEESFTTFTUPUIFMJTUPGSFTPMWFE*1 BEESFTTFT5IFOUSBOTJUJPOUPBTUBUFDBMMFEWD %/44FSWFS "EE ➡︎

)&WTTUBUFUSBOTJUJPOWX ➡︎ WD WX 0S *GUIFOBNFSFTPMVUJPOPG*1WBEESFTTFTEPFTOPU fi OJTIXJUIJONT FOEUIFXBJUBOEUSBOTJUJPO UPBTUBUFDBMMFEWD WD 3FTPVSDFT $POOFDUJOHTPDLFUT 3FTPMWFE*1BEESFTTFT %/44FSWFS /PUIJOHXBTBOTXFSFE

4PGBS UIFTUBUFTWD WD BOEWDBSFBMMGPS TUBSUJOHBDPOOFDUJPOBUUFNQU 5IFEFTUJOBUJPOGPSFBDITUBUFJTBTGPMMPXT WDUBSHFUT*1WBEESFTTFT WDUBSHFUT*1WBEESFTTFT BOEWDUBSHFUTFJUIFS*1WPS*1WBEESFTTFT WD WD WD )&WTTUBUFUSBOTJUJPOWDWDWD

3FTPVSDFT $POOFDUJOHTPDLFUT 3FTPMWFE*1BEESFTTFT )FSF PCUBJOBOBEESFTTGSPNUIFMJTUPGSFTPMWFE*1 BEESFTTFTBOETUBSUDPOOFDUJOHUPUIBUBEESFTT WD WD WD 4UBSUUPDPOOFDU 4FSWFS )&WTTUBUFUSBOTJUJPOWDWDWD 0CUBJO ⬅︎

*GUIFDPOOFDUJPOJTJNNFEJBUFMZFTUBCMJTIFEBGUFS TUBSUJOHUIFBUUFNQU USBOTJUJPOUPBTUBUFDBMMFETVDDFTT SFUVSOUIFDPOOFDUFETPDLFU BOEDPODMVEFUIFNFUIPE WD WD WD TVDDFTT 4FSWFS 4UBSUUPDPOOFDU $POOFDUJPO0, 3FUVSOUIFDPOOFDUFETPDLFU )&WTTUBUFUSBOTJUJPOWDWDWD

3FTPVSDFT $POOFDUJOHTPDLFUT 3FTPMWFE*1BEESFTTFT 0GUFO UIJTEPFTOPUIBQQFO MFBWJOHUIFDPOOFDUJPO JOQSPHSFTT*OUIJTDBTF UIFVTFETPDLFUJTUIFOBEEFE UPUIFMJTUPGDPOOFDUJOHTPDLFUT 4UBSUUPDPOOFDU WD WD WD 4FSWFS )&WTTUBUFUSBOTJUJPOWDWDWD 4UJMMDPOOFDUJOH "EE ➡︎

WD WD WD 8BJUGPSDPOOFDUJOHTPDLFUT /PX BGUFSTUBSUJOHBDPOOFDUJPOBUUFNQU JUJTOFDFTTBSZUPXBJUNTGPSBOZPGUIFDPOOFDUJPOT UPCFFTUBCMJTIFE 4FSWFS )&WTTUBUFUSBOTJUJPOWDWDWD 4UBSUUPDPOOFDU 4UJMMDPOOFDUJOH

)&WTTUBUFUSBOTJUJPOWDWDWD 8BJUGPS*1W*1WBOTXFS "EEJUJPOBMMZ JGUIFDVSSFOUTUBUFJTFJUIFSWDPSWD JUNFBOTUIFOBNFSFTPMVUJPOGPSBOBEESFTTGBNJMZ IBTOPUZFU fi OJTIFE *OUIJTTJUVBUJPO OFFEUPXBJUGPSCPUIUIFDPOOFDUJPOT BOEUIFOBNFSFTPMVUJPOTJNVMUBOFPVTMZ WD WD ➡︎ *1WOBNFSFTPMVUJPOJOQSPHSFTT ➡︎ *1WOBNFSFTPMVUJPOJOQSPHSFTT %/44FSWFS 4UJMMSFTPMWJOHOBNF

)&WTTUBUFUSBOTJUJPOWDWDWD ➡︎ WX WX 5PXBJUGPSUIFN BGUFSTUBSUJOHBDPOOFDUJPOBUUFNQU JUUSBOTJUJPOTUPBTUBUFDBMMFEWX WD WD WD %/44FSWFS 4FSWFS

)&WTTUBUFUSBOTJUJPOWX WX WXJTUIFTUBUFGPSXBJUJOH )FSF XBJUGPSFJUIFSBDPOOFDUJPOFTUBCMJTINFOUPSB OBNFSFTPMVUJPOUP fi OJTIXJUIJONTCZEFGBVMU 8BJUGPSNT %/44FSWFS 4FSWFS

)&WTTUBUFUSBOTJUJPOWX ➡︎ TVDDFTT *GBOZPGUIFDPOOFDUJPOTJTFTUBCMJTIFEXIJMFXBJUJOH USBOTJUJPOUPTVDDFTT SFUVSOUIFDPOOFDUFETPDLFU BOEDPODMVEFUIFNFUIPE WX TVDDFTT %/44FSWFS "DPOOFDUJPOJTFTUBCMJTIFE 4FSWFS

)&WTTUBUFUSBOTJUJPOWX 0S JGOBNFSFTPMVUJPO fi OJTIFTXIJMFXBJUJOH BEEUIF OFXBEESFTTFTUPUIFMJTUPGSFTPMWFE*1BEESFTTFT "UUIJTQPJOU UIFUJNFMJNJUIBTOPUZFUFMBQTFE WX "SFTPMVUJPOJT fi OJTIFE 3FTPVSDFT $POOFDUJOHTPDLFUT 3FTPMWFE*1BEESFTTFT /PUZFUNTPME %/44FSWFS "EE ➡︎ 4FSWFS

)&WTTUBUFUSBOTJUJPOWX ➡︎ WX 5IFSFGPSF USBOTJUJPOUPWXBHBJOBOE XBJUTGPSUIFSFNBJOEFSPGUIFUJNFMJNJU WX 8BJUGPSSFNBJOEFSPGUIFNT WX 4FSWFS

)&WTTUBUFUSBOTJUJPOWX ➡︎ TVDDFTT *GBOZPGUIFDPOOFDUJPOTJTFTUBCMJTIFEEVSJOH UIJTUJNF USBOTJUJPOUPTVDDFTT WX "DPOOFDUJPOJTFTUBCMJTIFE TVDDFTT 8BJUJOHGPSSFNBJOEFSPGUIFNT 4FSWFS

)&WTTUBUFUSBOTJUJPOWX ➡︎ WD JGOPU USBOTJUJPOUPWDBOETUBSUTBOFXDPOOFDUJPO BUUFNQU WX WD 4UJMMDPOOFDUJOH 4FSWFS

)&WTTUBUFUSBOTJUJPOWX ➡︎ *GOPUIJOHXBTIBQQFOFEXJUIJOUIFUJNFMJNJUJOWX BOEBUJNFPVUPDDVST UIFOFYUTUBUFJTEFUFSNJOFE CZUIFTUBUVTPGUIFSFTPVSDF WX 3FTPVSDFT $POOFDUJOHTPDLFUT 3FTPMWFE*1BEESFTTFT %/44FSWFS /PUIJOHXBTIBQQFOFEXJUIJONT 4FSWFS

)&WTTUBUFUSBOTJUJPOWX ➡︎ WD *GUIFSFBSFTUJMM*1BEESFTTFTUIBUIBWFOPUCFFO BUUFNQUFEGPSDPOOFDUJPO USBOTJUJPOUPWD WX 3FTPVSDFT $POOFDUJOHTPDLFUT 3FTPMWFE*1BEESFTTFT "OZ WD %/44FSWFS 4FSWFS

)&WTTUBUFUSBOTJUJPOWX ➡︎ WX PUIFSXJTF NPWFCBDLUPWXUPDPOUJOVFXBJUJOH GPSDPOOFDUJPOT WX 3FTPVSDFT $POOFDUJOHTPDLFUT 3FTPMWFE*1BEESFTTFT &NQUZ WD %/44FSWFS 4FSWFS

)&WTTUBUFUSBOTJUJPOWX ➡︎ GBJMVSF 6QUPUIJTQPJOU JGBMMOBNFSFTPMVUJPOTPSDPOOFDUJPO BUUFNQUTGBJMBOEUIFSFTPVSDFTCFDPNFFNQUZ USBOTJUJPOUPBTUBUFDBMMFEGBJMVSF 5IFOSBJTFBOFYDFQUJPOBOEFYJUUIFQSPDFTT WX 3FTPVSDFT $POOFDUJOHTPDLFUT 3FTPMWFE*1BEESFTTFT &NQUZ GBJMVSF &NQUZ TUBSU WD

)FSFJTUIFDPNQMFUFPWFSWJFXJODMVEJOHUIFTUBUFTJOUSPEVDFE TPGBSBMPOHXJUIBTUBUFSFQSFTFOUJOHVTFSTQFDJ fi FEUJNFPVUT WD GBJMVSF WX WD WD TUBSU WX )&WTTUBUFUSBOTJUJPO0WFWJFX TVDDFTT UJNFPVU

8JUIVOEFSTUBOEJOHUIJT XFDBOJNQMFNFOUUIFTUBUFUSBOTJUJPOTJODPEF )&WTTUBUFUSBOTJUJPO0WFWJFX WD GBJMVSF WX TVDDFTT WD WD TUBSU WX UJNFPVU

def self.tcp(host, port, ...) # Do something ensure # ... end /PX MFUNFCSJF fl ZJOUSPEVDF UIFBDUVBMDPEFGPS4PDLFUUDQ *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&W

def self.tcp(host, port, ...) # ... loop do case state when :start # ... end end ensure # ... end *OUIJTJNQMFNFOUBUJPO VTF,FSOFMMPPQBOEDBTFTUBUFNFOUTUPQFSGPSN BQQSPQSJBUFBDUJPOTGPSFBDITUBUF *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&W ,FSOFMMPPQ DBTFTUBUFNFOUT

def self.tcp(host, port, ...) # ... state = :start loop do case state when :start # ... end end ensure # ... end 'JSTU TFUDVSSFOUTUBUFUPTUBSUBTBOJOJUJBMTUBUF CFGPSFTUBSUJOHUIFMPPQ *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&W *OJUJBMJ[FTUBUF

case state when :start # ... h hostname_resolution_threads.concat( resolving_family_names.map { |family| thread_args = [family, *hostname_resolution_args] thread = Thread.new(*thread_args) { |*thread_args| hostname_resolution(*thread_args) } Thread.pass thread } ) # ... 5IJTJTTUBSU $SFBUFUISFBETGPSFBDIBEESFTTGBNJMZBOE TUBSUOBNFSFTPMVUJPOXJUIJOFBDIUISFBE *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&WTUBSU hostname_resolution_args = [host, port, hostname_resolution_queue] $SFBUFUISFBETGPSFBDIBEESFTTGBNJMZ &YFDVUFOBNFSFTPMVUJPONFUIPE

case state when :start # ... hostname_resolution_queue = HostnameResolutionQueue.new(...) hostname_resolution_waiting = h # ... remaining = resolv_timeout ? second_to_timeout(...) : nil hostname_resolved, _, = IO.select( # ... 5IFO XBJUGPSFJUIFS*1WPS*1WOBNFSFTPMVUJPO UP fi OJTI)FSF VTF*0TFMFDUUPXBJUGPSOBNF SFTPMVUJPO5IFSFBTPOGPSUIJTXJMMCFFYQMBJOFEMBUFS *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&WTUBSU (hostname_resolution_waiting, nil, nil, remaining) hostname_resolution_queue.waiting_pipe 8BJUGPSOBNFSFTPMVUJPOUP fi OJTI

case state when :start # ... family_name, res = hostname_resolution_queue.get if res.is_a? Exception # ... else state = case family_name when :ipv6 then :v6c when :ipv4 then ? :v4c : :v4w end selectable_addrinfos.add(family_name, res) # ... end # ... next # ... 0ODFOBNFSFTPMVUJPOJT fi OJTIFE BEEUIFPCUBJOFE BEESFTTFTUPUIFMJTUPGSFTPMWFE*1BEESFTTFT *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&WTUBSU "EEUIFPCUBJOFEBEESFTTFT 5IFMJTUPGSFTPMWFE*1BEESFTTFT

case state when :start # ... family_name, res = hostname_resolution_queue.get if res.is_a? Exception # ... else state = case family_name when :ipv6 then :v6c when :ipv4 then < end selectable_addrinfos.add(family_name, res) # ... end # ... next # ... %FUFSNJOFUIFOFYUTUBUFCBTFEPOUIFPCUBJOFE BEESFTT BOEUIFOFOUFSUIFOFYUMPPQ *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&WTUBSU %FUFSNJOFUIFOFYUTUBUF ⬅︎ All name resolutions are finished?> ? :v4c : :v4w

case state when :v4w ipv6_resolved, _, = IO.select( # ... 5IJTJTWX *0TFMFDUJTVTFEBHBJOUP XBJUGPS*1WOBNFSFTPMVUJPOGPSNT *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&WWX (hostname_resolution_waiting, nil, nil, RESOLUTION_DELAY) 8BJUGPSOBNFSFTPMVUJPOUP fi OJTI 3&40-65*0/@%&-":NT

case state when :v4w ipv6_resolved, _, = IO.select( if ipv6_resolved family_name, res = hostname_resolution_queue.get selectable_addrinfos.add(family_name, res) unless res.is_a? E # ... else # ... end # ... *GUIFOBNFSFTPMVUJPOJT fi OJTIFEXJUIJONT BEEUIFOFXMZPCUBJOFEBEESFTTFTUPUIFMJTUPG SFTPMWFE*1BEESFTTFT *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&WWX Exception (hostname_resolution_waiting, nil, nil, RESOLUTION_DELAY) "EEUIFPCUBJOFEBEESFTTFT 5IFMJTUPGSFTPMWFE*1BEESFTTFT

case state when :v4w ipv6_resolved, _, = IO.select( if ipv6_resolved family_name, res = hostname_resolution_queue.get selectable_addrinfos.add(family_name, res) unless res.is_a? E state = :v46c else state = :v4c end next # ... %FUFSNJOFUIFOFYUCBTFEPOXIFUIFSUIFOBNF SFTPMVUJPOXBT fi OJTIFEXJUIJOUIFBMMPUUFEUJNF BOEUIFOFOUFSUIFOFYUMPPQ *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&WWX Exception (hostname_resolution_waiting, nil, nil, RESOLUTION_DELAY) %FUFSNJOFUIFOFYUTUBUF ⬅︎

case state when :v6c, :v4c, v46c # ... WD WD BOEWDBSFEJ ff FSFOUTUBUFT CVUTJODF UIFDPEFTGPSFBDIJTFYBDUMZUIFTBNF UIFZBSFHSPVQFEUPHFUIFSBTBTJOHMFDBTF *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&WWDWDWD

case state when :v6c, :v4c, v46c # ... addrinfo = selectable_addrinfos.get # ... connection_attempt_delay_expires_at = current_clocktime + CONNECTION_ATTEMPT_DELAY # ... socket = Socket.new( socket.bind(local_addrinfo) if local_addrinfo result = socket.connect_nonblock(addrinfo, exception: false) # ... )FSF fi STUPCUBJOBOBEESFTTGSPNUIFMJTUPGSFTPMWFE *1BEESFTTFTBOEUIFOTUBSUBDPOOFDUJPOBUUFNQU *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&WWDWDWD (addrinfo.pfamily, addrinfo.socktype, addrinfo.protocol) 0CUBJOBOBEESFTT 4UBSUBDPOOFDUJPOBUUFNQU 5IFMJTUPGSFTPMWFE*1BEESFTTFT 0CUBJOUJNFPVUQFSJPE

case state when :v6c, :v4c, v46c # ... addrinfo = selectable_addrinfos.get # ... 1FSUIF3'$ BEESFTTFTTIPVMECFTPSUFECFGPSF DPOOFDUJOH5IJTJNQMFNFOUBUJPOTJNQMJ fi FTUIFQSPDFTT CZBMUFSOBUJOHCFUXFFO*1WBOE*1WBEESFTTFT *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&WWDWDWD precedences = case @last_family when :ipv4, nil then [:ipv6, :ipv4] when :ipv6 then [:ipv4, :ipv6] end precedences.each do |family_name| addrinfo = @addrinfo_dict[family_name]&.shift next unless addrinfo @last_family = family_name return addrinfo end 0CUBJOBOBEESFTT GSPNBEJ ff FSFOUBEESFTTGBNJMZ UIBOQSFWJPVTMZTFMFDUFE QSJPSJUJ[JOH*1WJOJUJBMMZ

case state when :v6c, :v4c, v46c # ... case result when 0 connected_socket = socket state = :success when Socket connected_socket = result state = :success when :wait_writable connecting_sockets.add(socket, addrinfo) state = :v46w end # ... next "GUFSTUBSUJOHUIFDPOOFDUJPOBUUFNQU EFUFSNJOFUIF OFYUTUBUFCBTFEPOXIFUIFSUIFDPOOFDUJPOXBTNBEF JNNFEJBUFMZ BOEUIFOFOUFSUIFOFYUMPPQ *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&WWDWDWD %FUFSNJOFUIFOFYUTUBUF ⬅︎

case state when :v6c, :v4c, v46c # ... case result when 0 connected_socket = socket state = :success when Socket connected_socket = result state = :success when :wait_writable connecting_sockets.add(socket, addrinfo) state = :v46w end # ... next *GUIFDPOOFDUJPODBOUCFFTUBCMJTIFEJNNFEJBUFMZ BEEUIFTPDLFUVTFEGPSUIFBUUFNQUUPUIFMJTUPG DPOOFDUJOHTPDLFUTCFGPSFEFUFSNJOJOHUIFOFYUTUBUF *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&WWDWDWD "EEUIFTPDLFUVTFE 5IFMJTUPGDPOOFDUJOHTPDLFUT

case state when :v46w # ... *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&WWX 5IJTJTWX )FSF JUOFFETUPTJNVMUBOFPVTMZXBJUGPSFJUIFS FTUBCMJTINFOUTPGDPOOFDUJPOTPS fi OJTIPGUIF OBNFSFTPMVUJPO

case state when :v46w # ... ...tname_resolved, ...nectable_sockets, = IO.select( # ... *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&WWX *0TFMFDUJTVTFEIFSFBHBJOGPSUIJTQVSQPTF (...tname_resolution_waiting, ...necting_sockets.all, ..., ...aining) *0TFMFDUJTDBMMFE

*0TFMFDUJTBNFUIPEUIBUXBJUTGPSSFBEJOFTTPG*0 PCKFDUT *UUBLFT*0PCKFDUTXBJUJOHGPSSFBEJOHBOE *0PCKFDUTXBJUJOHGPSXSJUJOHBTBSHVNFOUT 5IFNFUIPEXBJUTVOUJMBUMFBTUPOFPGUIFTFPCKFDUT CFDPNFTSFBEZGPSSFBEJOHPSXSJUJOH *0TFMFDU "OBSSBZPG*0PCKFDUTXBJUJOHGPSSFBEJOH "OBSSBZPG*0PCKFDUTXBJUJOHGPSXSJUJOH IO.select(readfds, writefds, nil, timeout)

5IJTNFUIPEBMTPBMMPXTTQFDJGZJOHBUJNFPVUQFSJPEBT BOBSHVNFOU *USFMFBTFTUIFXBJUFWFOJGUIFSFBSFOPPCKFDUTSFBEZGPS SFBEJOHPSXSJUJOHJGJUUJNFTPVU *0TFMFDU IO.select(readfds, writefds, nil, timeout) "UJNFPVUQFSJPE

5IFSFUVSOWBMVFJTTPNFBSSBZTPG*0PCKFDUTUIBUIBWF CFDPNFSFBEZGPSSFBEJOHPSXSJUJOH *GJUUJNFTPVU JUSFUVSOTOJM *0TFMFDU rs, ws, _ = IO.select(readfds, writefds, nil, timeout) [[, ...], [, ...], ...]

case state when :v46w # ... ...tname_resolved, ...nectable_sockets, = IO.select( # ... *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&WWX 4JODFUIF4PDLFUGBNJMZPGDMBTTFTJOIFSJUTGSPN*0 DMBTT *0TFMFDUDBOBMTPXBJUGPS4PDLFUPCKFDUT 6UJMJ[JOHUIJT JOWX UIFDPOOFDUJOHTPDLFUTBSF QBTTFEUPUIJTNFUIPEBT*0PCKFDUTXBJUJOHGPSXSJUJOH (...tname_resolution_waiting, connecting_sockets.all, nil, ...aining) $POOFDUJOHTPDLFUTBTXSJUJOH*0PCKFDUT Socket.ancestors => [Socket, BasicSocket, IO, # ... BasicObject]

case state when :v46w # ... ...tname_resolved, connectable_sockets, = IO.select( # ... *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&WWX 8IFOBDPOOFDUJPOJTFTUBCMJTIFEPSGBJMTPOBOZPG UIFTPDLFUTQBTTFEBTBSHVNFOUT *0TFMFDUDPOTJEFST UIFTFUPCFXSJUBCMF*0PCKFDUT 5IFO*0TFMFDUSFMFBTFTUIFXBJU BOESFUVSOTBOBSSBZ PGUIFSFMFWBOUTPDLFUTBTXSJUBCMF*0PCKFDUT (...tname_resolution_waiting, connecting_sockets.all, nil, ...aining) 4PDLFUTBTXSJUBCMF*0PCKFDUT

case state when :v46w # ... ...tname_resolved, connectable_sockets, = IO.select( # ... *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&WWX 5IJTBMMPXTVTUPXBJUGPSUIFFTUBCMJTINFOUPG DPOOFDUJPOT4P IPXTIPVMEXFXBJUGPSUIF fi OJTIPGUIFOBNFSFTPMVUJPO (...tname_resolution_waiting, connecting_sockets.all, nil, ...aining)

case state when :v46w # ... ...tname_resolved, connectable_sockets, = IO.select( # ... (, connecting_sockets.all, nil, ...aining) *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&WWX 5IFEJ ff i DVMUZJTUIBU UIFOBNFSFTPMVUJPOUISFBETBSFOPU*0PCKFDUTBOE DBOOPUCFXBJUFEGPSJO*0TFMFDU $BOUQBTTOBNFSFTPMVUJPOUISFBET

case state when :v46w # ... ...tname_resolved, connectable_sockets, = IO.select( # ... *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&WWX 5PSFTPMWFUIJT VTF*0QJQF (...tname_resolution_waiting, connecting_sockets.all, nil, ...aining)

*0QJQFSFUVSOTUXPJOUFSDPOOFDUFE*0PCKFDUT 0OFPGUIFTFJTGPSSFBEJOHBOEUIFPUIFSJTGPSXSJUJOH *0QJQF rpipe, wpipe = IO.pipe "O*0PCKFDUGPSSFBEJOH "O*0PCKFDUGPSXSJUJOH

*0QJQF 8IFOZPVXSJUFUPUIFXSJUJOH*0PCKFDU ZPVDBOSFBEUIBUGSPNUIFSFBEJOH*0PCKFDU rpipe, wpipe = IO.pipe Thread.new(wpipe) do |w| w.puts "foo" w.close end p rpipe.gets # => "foo" 8SJUFUIFXSJUJOH*0PCKFDU 5IFOUIFSFBEJOH*0PCKFDUDBOCFSFBE

case state when :start # ... hostname_resolution_queue = HostnameResolutionQueue.new(...) # ... *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&WWX *OUIJTJNQMFNFOUBUJPO *0QJQFXBTDBMMFEBUTUBSUUP DSFBUFBQBJSPG*0PCKFDUT class HostnameResolutionQueue def initialize(size) # ... @rpipe, @wpipe = IO.pipe end # ... $SFBUFBQBJSPG*0PCKFDUT

case state when :start # ... hostname_resolution_queue = HostnameResolutionQueue.new(...) # ... *0QJQF 0GUIFTFUXP*0PCKFDUT UIFPOFGPSXSJUJOHJT class HostnameResolutionQueue # ... def waiting_pipe [@wpipe] end # ... hostname_resolution_waiting = hostname_resolution_queue.waiting_pipe hostname_resolution_args = [host, port, hostname_resolution_queue] 5IFXSJUJOH*0PCKFDU 5IFXSJUJOH*0PCKFDU BOEPUIFSBSHVNFOUT

case state when :start # ... hostname_resolution_queue = HostnameResolutionQueue.new(...) hostname_resolution_threads.concat( resolving_family_names.map { |family| thread_args = [family, *hostname_resolution_args] thread = Thread.new(*thread_args) { |*thread_args| hostname_resolution(*thread_args) } Thread.pass thread } ) # ... *0QJQF QBTTFEBTBOBSHVNFOUUPUIFOBNFSFTPMVUJPO UISFBET hostname_resolution_waiting = hostname_resolution_queue.waiting_pipe hostname_resolution_args = [host, port, hostname_resolution_queue] 1BTTUIFBSHTJODMVEJOHUIFXSJUJOH*0PCKFDU

case state when :start # ... thread = Thread.new(*thread_args) { |*thread_args| hostname_resolution(*thread_args) } *0QJQF 0ODFOBNFSFTPMVUJPOJT fi OJTIFEJOUIFUISFBE JUXSJUFTUPUIFXSJUJOH*0PCKFDUUPOPUJGZDPNQMFUJPO def self.hostname_resolution(family, ..., hostname_resolution_queue) resolved_addrinfos = Addrinfo.getaddrinfo(...) hostname_resolution_queue.add_resolved(family, resolved_addrinfos) # ... def add_resolved(family, resolved_addrinfos) @mutex.synchronize do @queue.push [family, resolved_addrinfos] @wpipe.putc HOSTNAME_RESOLUTION_QUEUE_UPDATED # ... 8SJUFUPUIFXSJUJOH*0PCKFDU

*NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&WWX case state when :v46w # ... ...tname_resolved, connectable_sockets, = IO.select( # ... .FBOXIJMF UIFSFBEJOH*0PCKFDUDSFBUFEXJUI*0QJQF JTQBTTFEUP*0TFMFDUJONBJOUISFBE (hostname_resolution_waiting, connecting_sockets.all, nil, ...aining) 5IFSFBEJOH*0PCKFDU

*NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&WWX case state when :v46w # ... hostname_resolved, connectable_sockets, = IO.select( # ... 5IJT*0PCKFDUXJMMCFSFBEBCMFPODFOBNFSFTPMVUJPO JT fi OJTIFEJOUIFDIJMEUISFBET 5IFO*0TFMFDUXJMMSFMFBTFUIFXBJUBOESFUVSOUIJT SFBEJOH*0PCKFDU (hostname_resolution_waiting, connecting_sockets.all, nil, ...aining) 5IFSFBEJOH*0PCKFDU 3FBEBCMF*0PCKFDUT

*NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&WWX case state when :v46w # ... hostname_resolved, connectable_sockets, = IO.select( # ... 5IJTJTUIFUSJDLUPBMMPXGPSXBJUJOHGPSCPUI UIFDPNQMFUJPOPGDPOOFDUJPOTBOEOBNFSFTPMVUJPO (hostname_resolution_waiting, connecting_sockets.all, nil, ...aining) #PUIDPOOFDUJPOTBOEOBNFSFTPMVUJPODBOCFXBJU

case state when :start # ... hostname_resolution_queue = HostnameResolutionQueue.new(...) hostname_resolution_waiting = h # ... hostname_resolved, _, = IO.select( # ... when :v4w ipv6_resolved, _, = IO.select( # ... (hostname_resolution_waiting, nil, nil, remaining) hostname_resolution_queue.waiting_pipe *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&WTUBSUWX "OEJUJTUIFSFBTPOXIZTUBSUBOEWXVTFE*0TFMFDU UPXBJUGPSOBNFSFTPMVUJPO (hostname_resolution_waiting, nil, nil, RESOLUTION_DELAY) 8BJUXJUIUIFSFBEJOH*0PCKFDU 8BJUXJUIUIFSFBEJOH*0PCKFDU

*NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&WWX case state when :v46w # ... remaining = s hostname_resolved, connectable_sockets, = IO.select( # ... -FUTSFUVSOUPWX 4FUUIFUJNFPVUCZQBTTJOH*0TFMFDUUIFUJNFUPXBJU GPSDPOOFDUJPOT (hostname_resolution_waiting, connecting_sockets.all, nil, remaining) second_to_timeout(connection_attempt_delay_expires_at) 4FUUJNFPVU $BMDVMBUFSFNBJOJOHUJNFGSPNUIFUJNFPVUQFSJPE

case state when :v46w # ... hostname_resolved, connectable_sockets, = IO.select( # ... if connectable_sockets&.any? # ... elsif hostname_resolved&.any? # ... else # ... end # ... next (hostname_resolution_waiting, connecting_sockets.all, nil, remaining) *G*0TFMFDUSFUVSOTBXSJUBCMF*0PCKFDUXJUIJOUIF XBJUJOHQFSJPE JUNFBOTUIBUBTJUVBUJPOIBTBSJTFO XIFSFTPDLFUTIBWFFJUIFSTVDDFTTGVMMZDPOOFDUFEPS GBJMFEUPDPOOFDU *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&WWX 8IFO*0TFMFDUSFUVSOTXSJUBCMF*0PCKFDUT 3FBDIUIJTCMPDL

case state when :v46w # ... if connectable_sockets&.any? while (connectable_socket = connectable_sockets.pop) # ... sockopt = c is_connected = sockopt.int.zero? # ... if is_connected # ... else # ... end # ... next *OUIJTDBTF EFUFSNJOFUIFOFYUTUBUFCBTFEPO XIFUIFSUIFTPDLFUTXFSFDPOOFDUFEPSOPU BOEUIFOFOUFSUIFOFYUMPPQ *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&WWX connectable_socket.getsockopt(Socket::SOL_SOCKET, Socket::SO_ERROR) %FUFSNJOFUIFOFYUTUBUF $IFDLUIFDPOOFDUJPOTUBUVT ⬅︎

case state when :v46w # ... hostname_resolved, connectable_sockets, = IO.select( # ... if connectable_sockets&.any? # ... elsif hostname_resolved&.any? # ... else # ... end # ... next 0SJG*0TFMFDUSFUVSOTSFBEBCMF*0PCKFDUTXJUIJOUIF XBJUJOHQFSJPE JUNFBOTUIBUOBNFSFTPMVUJPOJT fi OJTIFE *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&WWX (hostname_resolution_waiting, connecting_sockets.all, nil, remaining) 8IFO*0TFMFDUSFUVSOTSFBEBCMF*0PCKFDUT 3FBDIUIJTCMPDL

case state when :v46w # ... hostname_resolved, connectable_sockets, = IO.select( # ... if connectable_sockets&.any? # ... elsif hostname_resolved&.any? family_name, res = hostname_resolution_queue.get selectable_addrinfos.add(family_name, res) unless res.is_a? E else # ... end # ... next *OUIJTDBTF BEEUIFPCUBJOFEBEESFTTFTUPUIFMJTUPG SFTPMWFE*1BEESFTTFT *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&WWX Exception (hostname_resolution_waiting, connecting_sockets.all, nil, remaining) "EEUIFPCUBJOFEBEESFTTFT 5IFMJTUPGSFTPMWFE*1BEESFTTFT

case state when :v46w # ... hostname_resolved, connectable_sockets, = IO.select( # ... if connectable_sockets&.any? # ... elsif hostname_resolved&.any? family_name, res = hostname_resolution_queue.get selectable_addrinfos.add(family_name, res) unless res.is_a? E else # ... end # ... next 5PXBJUGPSUIFSFNBJOJOHUJNF LFFQUIFDVSSFOUTUBUF BUWX BOEFOUFSUIFOFYUMPPQ *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&WWX (hostname_resolution_waiting, connecting_sockets.all, nil, remaining) &OUFSUIFOFYUMPPQXJUIWXTUBUF Exception

case state when :v46w # ... hostname_resolved, connectable_sockets, = IO.select( # ... if connectable_sockets&.any? # ... elsif hostname_resolved&.any? family_name, res = hostname_resolution_queue.get selectable_addrinfos.add(family_name, res) unless res.is_a? E else # ... end # ... next 0SJG*0TFMFDUUJNFTPVUBOESFUVSOTOJM JUNFBOTUIBU OFJUIFSBDPOOFDUJPOOPSUIFOBNFSFTPMVUJPOXFSF fi OJTIFEXJUIJOUIFBMMPUUFEUJNF *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&WWX (hostname_resolution_waiting, connecting_sockets.all, nil, remaining) 8IFO*0TFMFDUSFUVSOTOJM 3FBDIUIJTCMPDL Exception

case state when :v46w # ... hostname_resolved, connectable_sockets, = IO.select( # ... if connectable_sockets&.any? # ... elsif hostname_resolved&.any? family_name, res = hostname_resolution_queue.get selectable_addrinfos.add(family_name, res) unless res.is_a? E else # ... end # ... next *OUIJTDBTF EFUFSNJOFUIFOFYUTUBUFCBTFEPOUIF DVSSFOUSFTPVSDFTTUBUVT BOEUIFOFOUFSUIFOFYUMPPQ *NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&WWX (hostname_resolution_waiting, connecting_sockets.all, nil, remaining) %FUFSNJOFUIFOFYUTUBUF ⬅︎ Exception

*NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&WGBJMVSF ret = loop do case state # ... when :success # ... when :failure raise last_error when :timeout # ... end end 5IFTUBUFTJOUSPEVDFEIFSFBGUFSBMMSFQSFTFOUUIF DPNQMFUJPOPGTUBUFUSBOTJUJPOT GBJMVSFXIJDIJTSFBDIFEJGBMMOBNFSFTPMVUJPOTPS BMMDPOOFDUJPOBUUFNQUTGBJM SBJTFBOFYDFQUJPO XJUIUIFMBTUDBQUVSFEFSSPS 3BJTFBOFYDFQUJPO

*NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&WUJNFPVU ret = loop do case state # ... when :success # ... when :failure raise last_error when :timeout raise Errno::ETIMEDOUT, "user specified timeout" end end *GBVTFSTQFDJ fi FEUJNFPVUPDDVST SFBDIUJNFPVU BOESBJTFBOFYDFQUJPOJOEJDBUJOHJU 3BJTFBOFYDFQUJPO

*NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&WTVDDFTT ret = loop do case state # ... when :success break connected_socket when :failure raise last_error when :timeout raise Errno::ETIMEDOUT, "user specified timeout" end end TVDDFTTXIJDIJTSFBDIFEXIFOPOFPGUIFDPOOFDUJPOT JTFTUBCMJTIFE JTIFSF #SFBLUIFMPPQXJUIUIFDPOOFDUFETPDLFU #SFBLUIFMPPQ

*NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&WDMFBOVQ def self.tcp(host, port, ...) # ... ret = loop do # ... end # ... ensure # ... hostname_resolution_threads.each do |thread| thread&.exit end hostname_resolution_queue&.close_all connecting_sockets.each do |connecting_socket| connecting_socket.close unless connecting_socket.closed? end end "GUFSCSFBLJOHPVUPGUIFMPPQ DMFBOVQUISFBET QJQFT BOEPUIFSTPDLFUTJOFBDIDPOOFDUJPOBUUFNQUT $MFBOVQ

*NQMFNFOUBUJPOPG4PDLFUUDQXJUI)&WFYJU def self.tcp(host, port, ...) # ... ret = loop do # ... end if block_given? begin yield ret ensure ret.close end else ret end ensure # ... end SFUVSOUIFDPOOFDUFETPDLFUBOEUIFNFUIPEFYJUT &YFDVUFCMPDLXJUIUIFDPOOFDUFETPDLFU 3FUVSOUIFDPOOFDUFETPDLFU

4PGBS UIFLFZBTQFDUTPGUIF)&WJNQMFNFOUBUJPO PG4PDLFUUDQIBWFCFFOJOUSPEVDFE )PXFWFS GSPNBQSBDUJDBMTUBOEQPJOU UIFSFBSFTPNFBEEJUJPOBMDPOTJEFSBUJPOT UIBUOFFEUPCFBEESFTTFE

"EEJUJPOBMDPOTJEFSBUJPOT 'JSTUPGBMM EVSJOHUIFJNQMFNFOUBUJPO *EJTDPWFSFEBDBTFUIBU XBTOPUDPWFSFECZUIFFBSMJFSTUBUFUSBOTJUJPOEJBHSBN WD GBJMVSF WX WD WD TUBSU WX TVDDFTT UJNFPVU

"EEJUJPOBMDPOTJEFSBUJPOT WX "O*1WBEESFTTSFTPMWFE 4FSWFS %/44FSWFS -FUTDPOTJEFSUIFTJUVBUJPOMJLFUIJT &JUIFS*1WPS*1WOBNFSFTPMVUJPOIBTCFFO fi OJTIFE POFPSUIFPUIFS 3FTPVSDFT $POOFDUJOHTPDLFUT 3FTPMWFE*1BEESFTTFT *1WJTTUJMMSFTPMWJOH &NQUZ "EE ➡︎

"EEJUJPOBMDPOTJEFSBUJPOT WX %/44FSWFS $POOFDUJPOBUUFNQUTIBWFCFFOTUBSUFEUP BMMSFTPMWFE*1BEESFTTFTTPGBS 4UBSUBDPOOFDUJPOUPUIF*1WBEESFTT 3FTPVSDFT $POOFDUJOHTPDLFUT 3FTPMWFE*1BEESFTTFT *1WJTTUJMMSFTPMWJOH &NQUZ 4FSWFS 0CUBJO ⬅︎

"EEJUJPOBMDPOTJEFSBUJPOT WX %/44FSWFS 4VCTFRVFOUMZ BMMPGUIPTFBUUFNQUTIBWFGBJMFE $POOFDUJPOTGBJM 3FTPVSDFT $POOFDUJOHTPDLFUT 3FTPMWFE*1BEESFTTFT &NQUZ *1WJTTUJMMSFTPMWJOH &NQUZ 4FSWFS

"EEJUJPOBMDPOTJEFSBUJPOT WX %/44FSWFS *OUIJTTDFOBSJP UIFGPMMPXJOHTJUVBUJPOPDDVS ɾ5IFMJTUPGSFTPMWFE*1BEESFTTFTBOE ɾUIFMJTUPGDPOOFDUJOHTPDLFUTBSFFNQUZ ɾ"OBNFSFTPMVUJPOGPSUIFPUIFSBEESFTTGBNJMZJT ɾTUJMMJOQSPHSFTTJOUIFCBDLHSPVOE 3FTPVSDFT $POOFDUJOHTPDLFUT 3FTPMWFE*1BEESFTTFT &NQUZ *1WJTTUJMMSFTPMWJOH &NQUZ 4FSWFS

*OUIJTDBTF TIPVMEJUUSBOTJUJPOUPGBJMVSFCFDBVTFUIF SFTPVSDFTBSFOPXFNQUZ 0STIPVMEJUUSBOTJUJPOUPWXUPXBJUGPSUIFSFTPMVUJPOPGUIF PUIFSBEESFTTGBNJMZ "EEJUJPOBMDPOTJEFSBUJPOT WD GBJMVSF WX WD WD TUBSU WX TVDDFTT UJNFPVU

"EEJUJPOBMDPOTJEFSBUJPOT 5IFTQFDJ fi DBUJPOT GPSUIJTDBTFBSFOPUEF fi OFEJO3'$ 5IFSFGPSF JUJTOFDFTTBSZUPDPOTJEFS IPX4PDLFUUDQTIPVMEIBOEMFUIJTTJUVBUJPO

'PMMPXJOHEJTDVTTJPOTXJUI!OBSVTFBOEPUIFS 3VCZDPNNJUUFST XFEFDJEFEUPBMJHOXJUIUIFTQFDJ fi DBUJPOT PGUIFQSFWJPVTWFSTJPOPG4PDLFUUDQBOEDPOUJOVFUPXBJUGPS OBNFSFTPMVUJPOJOWX "EEJUJPOBMDPOTJEFSBUJPOT WD GBJMVSF WX WD WD TUBSU WX TVDDFTT UJNFPVU

"EEJUJPOBMDPOTJEFSBUJPOT "EEJUJPOBMMZ 4PDLFUUDQIBTSFTPMW@UJNFPVULFZXPSE BSHVNFOUUIBUBMMPXTUPTFUBUJNFPVUGPSOBNFSFTPMVUJPO 8IFOUIJTBSHVNFOUJTVTFEBOEBTJUVBUJPOMJLFUIJTBSJTFT USBOTJUJPOUPGBJMVSFBOESBJTFBOFYDFQUJPO WD GBJMVSF WX WD WD TUBSU WX TVDDFTT UJNFPVU

4FDPOEMZ UIJTVQEBUFIBTTJHOJ fi DBOUMZDIBOHFEUIF JOUFSOBMJNQMFNFOUBUJPOPG4PDLFUUDQ XJUIUIFDPEF OPXNPSFUIBOUFOUJNFTMPOHFSUIBOCFGPSF "EEJUJPOBMDPOTJEFSBUJPOT #FGPSF MJOFT "GUFS MJOFT

5IJTJODMVEFTQSPDFTTFTUIBUBSFSFMBUJWFMZDPTUMZJOUFSNTPG FYFDVUJPO TVDIBTDSFBUJOHUISFBETBOEDBMMJOH*0TFMFDU "EEJUJPOBMDPOTJEFSBUJPOT TUBDLQSPGE fl BNFHSBQIJOMPDBMFOWJSPONFOU "QQMF..BY #FGPSF 3VCZ "GUFS DSFBUJOHBOEIBOEMJOHUISFBET *0TFMFDU

"EEJUJPOBMDPOTJEFSBUJPOT 5IFTFFYFDVUJPODPTUTEJSFDUMZJNQBDUSVOUJNF BOEBTBSFTVMU UIFFYFDVUJPOUJNFIBTSPVHIMZEPVCMFE DPNQBSFEUPCFGPSFUIFDIBOHFT Benchmark.bmbm do |x| x.report do 100.times { Socket.tcp("localhost", 9292).close } end end #FGPSF 3VCZ "GUFS *OMPDBMFOWJSPONFOU "QQMF..BY

"EEJUJPOBMDPOTJEFSBUJPOT 0OUIFPUIFSIBOE )&WJTEFTJHOFEUPQSFWFOUUIFXPSTUDBTFTDFOBSJP XIFSFOPDPOOFDUJPOTBSFDPNQMFUFEFWFOBGUFSB QSPMPOHFEQFSJPE 8FDBOBENJUUIBUTPNFEFHSFFPGQFSGPSNBODF EFHSBEBUJPOJTVOBWPJEBCMFJOPSEFSUPBEESFTTUIFTF JTTVFT

"TBDPNQSPNJTFCFUXFFOUIFTFUXPQFSTQFDUJWFT BOPQUJPO UPFOBCMFPSEJTBCMF)&WXBTJOUSPEVDFEBTBGFBUVSF 5IJTDBOCFDPOUSPMMFECZQBTTJOHUSVFPSGBMTFUPUIF GBTU@GBMMCBDLLFZXPSEBSHVNFOUXIFODBMMJOH4PDLFUUDQ "EEJUJPOBMDPOTJEFSBUJPOT @tcp_fast_fallback = true class << self attr_accessor :tcp_fast_fallback end def self.tcp(host, port, local_host = nil, local_port = nil, connect_timeout: nil, resolv_timeout: nil, fast_fallback: tcp_fast_fallback, &block) &OBCMFPSEJTBCMF)&W

"EEJUJPOBMDPOTJEFSBUJPOT #ZEFGBVMU UIFGBTU@GBMMCBDLPQUJPOJTTFUUPUSVF NFBOJOH)&WJTFOBCMFE *GGBMTFJTFYQMJDJUMZQBTTFE JUXJMMJOWPLFUIFDPEFGPS 4PDLFUUDQBTJUXBTCFGPSF)&WXBTJOUSPEVDFE *EFBMMZ UIFQFSGPSNBODFXJMMFWFOUVBMMZJNQSPWFUPUIFQPJOU XIFSFUIJTPQUJPOJTOPMPOHFSOFFEFE CVUGPSOPX JUSFNBJOT BGVUVSFDIBMMFOHF Socket.tcp(HOSTNAME, PORT, fast_fallback: false) do |socket| socket.write "GET / HTTP/1.0\r\n\r\n" print socket.read end

8JUIUIFTFBEKVTUNFOUTNBEF 4PDLFUUDQXJUI)&WTVQQPSUFE JTOPXDPNQMFUF

%FNP

$PEFTGPSEFNP $MJFOU require "socket" HOSTNAME = "localhost" PORT = 4567 Socket.tcp(HOSTNAME, PORT) do |socket| socket.write "Hi\r\n" print socket.read end 5IJTCMPDLXPVMECFFYFDVUFE PODFBDPOOFDUJPOJTFTUBCMJTIFE 4UBOEBSEPVUQVUUIFSFTQPOTFSFUVSOFEGSPNUIFUBSHFUTFSWFS &YFDVUF4PDLFUUDQ

$PEFTGPSEFNP 4FSWFS require "socket" require "optparse" class Server ADDRESS_FAMILIES = { IPv6: [Socket::AF_INET6, "::1"], IPv4: [Socket::AF_INET, "127.0.0.1"], } #... def accept_loop # ... end end if child_pid = fork Server.new(:IPv6).accept_loop Process.waitpid(child_pid) else Server.new(:IPv4).accept_loop end 4UBSUUXPQSPDFTTFTUPIBOEMFSFRVFTUT UPCPUI*1WBOE*1WBEESFTTFT )BOEMFSFRVFTUTXJUIUIJTNFUIPE

$PEFTGPSEFNP 4FSWFS class Server # ... def accept_loop target_family = ARGV.getopts("", "sleep:")["sleep"]&.to_sym sleep if target_family == @version @socket.listen(5) loop do conn, ai = @socket.accept puts "Received #{@version} request" conn.readpartial(128) conn.write("Connection OK: #{ai.ip_address} (#{@version})\n") conn.close # ... end end end 8BJUGPSSFRVFTUT 3FUVSOBSFTQPOTF "DDFQUBSFRVFTU

$PEFTGPSEFNP 4FSWFS class Server # ... def accept_loop target_family = ARGV.getopts("", "sleep:")["sleep"]&.to_sym sleep if target_family == @version @socket.listen(5) loop do conn, ai = @socket.accept puts "Received #{@version} request" conn.readpartial(128) conn.write("Connection OK: #{ai.ip_address} (#{@version})\n") conn.close # ... end end end 8BJUGPSSFRVFTUT 8IFOFYFDVUFEXJUIUIFBEESFTTGBNJMZ *1W*1W BT"3(7 JUPCUBJOTUIFBEESFTTGBNJMZGSPN"3(7 4MFFQUIFTFSWFSQSPDFTTCFGPSF XBJUJOHGPSSFRVFTUT 5IJTTJNVMBUFTBTJUVBUJPOXIFSF BGUFSTUBSUJOHBDPOOFDUJPOBUUFNQUUPBDFSUBJO BEESFTT UIFDPOOFDUJPOJTOPUFTUBCMJTIFETPPO

3VOUIFEFNP

:PVDBOTFFUIFTFDPEFTJOUIF13 *OUSPEVDUJPOPG)BQQZ&ZFCBMMT7FSTJPO 3'$ JO4PDLFUUDQ IUUQTHJUIVCDPNSVCZSVCZQVMM

"OEUIJT13IBTCFFONFSHFEJOUPNBTUFSBOEUIF OFXWFSTJPOPG4PDLFUUDQXJMMCFJODMVEFE JO3VCZ .FSHFE

1MFBTFHJWF 4PDLFUUDQXJUI)&WTVQQPSUFEBUSZ *MPPLGPSXBSEUPIFBSJOHZPVSGFFECBDL

*TJUBIBQQJMZFWFSBGUFSʜ

8FNVTUOPUGPSHFU 5IF5$14PDLFUOFX JNQMFNFOUFEJO$ BMTPOFFET )BQQZ&ZFCBMMTTVQQPSU 5IJTIBTOPUCFFOJNQMFNFOUFE 1BHFPGTMJEFT

3FGIUUQTEBUBUSBDLFSJFUGPSHEPDESBGUQBVMZWPQTIBQQZFZFCBMMTW 4P UIJTJTDVSSFOUMZCFJOHXPSLFEPOBTXFMM *MMDPOUJOVFUPCFBCMFUPVQEBUFZPVXJUIGVSUIFS QSPHSFTT 5IFQBSUPGBDUVBMTPVSDFDPEFTPG5$14PDLFUOFX

5PCFDPOUJOVFE

5IBOLZPVGPSZPVSBUUFOUJPO 4QFDJBMUIBOLTUP FTQFDJBMMZ !OBSVTF !NNBTBLJ!BLS 3VCZDPNNJUUFST !PLVSBNBTBGVNJ BOE 5IF3VCZ"TTPDJBUJPO

'PSXIFOUIFEFNPEPFTOUXPSL

3VOOJOHUIFTFSWFSXJUIPVUPQUJPO XJUIPVUPQUJPO XJUI3VCZ )&WOPUTVQQPSUFE XJUI3VCZTVQQPSUFE)&W #PUIUIFWFSTJPOPG3VCZBOE3VCZXIJDITVQQPSUT )&WXJMMTVDDFTTGVMMZDPOOFDUJNNFEJBUFMZ 4FSWFS XJUIPVUBOZPCTUBDMFTUPDPOOFDUJWJUZ $MJFOU

3VOOJOHUIFTFSWFSXJUI*1WPQUJPO XJUI*1WPQUJPO XJUI3VCZTVQQPSUFE)&W #PUIUIFWFSTJPOPG3VCZBOE3VCZXIJDITVQQPSUT )&WXJMMTVDDFTTGVMMZDPOOFDUUPBO*1WBEESFTT JNNFEJBUFMZ 4FSWFS $POOFDUJPOTUP*1WBEESFTTFTBSFPCTUSVDUFE $MJFOU XJUI3VCZ )&WOPUTVQQPSUFE

3VOOJOHUIFTFSWFSXJUI*1WPQUJPO XJUI*1WPQUJPO 4FSWFS $POOFDUJPOTUP*1WBEESFTTFTBSFPCTUSVDUFE

3VOOJOHUIFTFSWFSXJUI*1WPQUJPO XJUI*1WPQUJPO 4FSWFS $POOFDUJPOTUP*1WBEESFTTFTBSFPCTUSVDUFE $MJFOU XJUI3VCZ )&WOPUTVQQPSUFE 3VCZDBOOPUNBLFBTVDDFTTGVMDPOOFDUJPOBUUFNQU BOEUIFQSPHSBNTUPQT )FSF $USM$JTVTFEUPGPSDFUIFQSPHSBNUPUFSNJOBUF

3VOOJOHUIFTFSWFSXJUI*1WPQUJPO XJUI*1WPQUJPO 4FSWFS $POOFDUJPOTUP*1WBEESFTTFTBSFPCTUSVDUFE $MJFOU XJUI3VCZ )&WOPUTVQQPSUFE )PXFWFS 3VCZXIJDITVQQPSUT)&WTVDDFTTGVMMZ DPOOFDUFEUPUIF*1WBEESFTTJOTUFBEPGUIF*1WBEESFTT JNNFEJBUFMZ