1042 lines
373 KiB
Plaintext
1042 lines
373 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Á SOCKADDR_IN6_0Átø â <Á testsÁ,Ð{ ‚ $Å{ U
|
|||
|
|
FromRawSocketÁl³â <ŽU
|
|||
|
|
IntoRawSocketÁlÂâ "U set_common_accept_flagsÁ¼Úó ú androidÁ¬åñú dragonflyÁ¼€òú freebsdÁ¬�òú fuchsiaÁ¬¸òú illumosÁ¬Óòú linuxÁœîòú netbsdÁ¤‡óú openbsdÁ¬¡óú cygwinÁ¤¼óüßñôüÛñù± AsRawSocketÁ\øâ <Ó± AsSocketÁD…â ±§l�â .0É IPPROTO_DIVERTÁtŸ ú¶ ¬Ùú—
|
|||
|
|
¬ðüØ.É SO_LINGERÁLŠ2ú iosÁŒå0ú visionosÁ´ü0ú macosÁœ˜1ú tvosÁ”±1ú watchosÁ¬É1üß0‚É IPV6_ADD_MEMBERSHIPÁœ¶A
|
|||
|
|
ú ¼˜>ú¶ ¬µ>ú haikuÁœÐ>úÞ ¬é>úå Œ„?úô ´›?úˆ œ·?ú„
|
|||
|
|
¤Ð?ú—
|
|||
|
|
¬ê?ú solarisÁ¬…@ú™ ” @ú© ¬¸@ ú wasiÁ”×@î p1ÁŒï@œî@üÖ@,ü’>óÉ IPV6_DROP_MEMBERSHIPÁ¤ßA
|
|||
|
|
ú íú¶ ëúú äúÞ âúå àúô Þúˆ Üú„
|
|||
|
|
Úú—
|
|||
|
|
ØúÓ
|
|||
|
|
Ïú™ Íú© Ë ú€Åî‘Á¿½º¼É KEEPALIVE_TIMEÁt•Júå ŒHúô ´ÄHúˆ œàH ú ntoÁŒýHî nto70Á¤”Iî nto71Á¤ªIü“I,üüHEú™ ”ÇIú© ¬ßIü§HÐÉ MAX_BUF_LENÁ\÷Vúå ŒØUúô ´ïUúˆ œ‹Vú™ ”¤Vú© ¬¼Vú«
|
|||
|
|
¤×VüÒUœÉ IovLenÁ4®` úò œæZî muslÁœ”[î ohosÁœµ[ î uclibcÁ¬Ú[û 32ÁÜñ[üÙ[4ü†[‘üÜZÁú aixÁŒ£\ú ¼º\ú
|
|||
|
|
emscriptenÁÄ×\ú¶ ¬õ\úÊ ¬�]úú œ«]ú hurdÁ”Ä]úÞ ¬Ü]úå Œ÷]úô ´Ž^úˆ œª^ú„
|
|||
|
|
¤Ã^ú¥ŒÝ^ú—
|
|||
|
|
¬ô^úÓ
|
|||
|
|
¬�_ú™ ”ª_ú© ¬Â_ú espidfÁ¤Ý_ú vitaÁ”÷_ú«
|
|||
|
|
¤�`üÓZÓÉå4ß`ú nuttxÁœÄ`É‹
|
|||
|
|
\�‹úË”ëŠÉ set_nonblockingÁ|‘�úË”îŽ À
|
|||
|
|
|
|||
|
|
impl_debugÁ ÷ sockaddrÁ
|
|||
|
|
|
|||
|
|
socklen_tÁ sa_family_tÁ SockAddrStorageÁ ( storageÁ * zeroedÁ *š * view_asÁ -¥ /× 1æ 1 try_initÁ 3— 3¥ 3 STORAGE_SIZEÁ 3 1ú 8¡ 1
|
|||
|
|
set_lengthÁ 1 familyÁ 1 domainÁ 1‘ 1 as_ptrÁ 1
|
|||
|
|
as_storageÁ 1 is_ipv4Á 1 is_ipv6Á 1 is_unixÁ 1 as_socketÁ 1 as_socket_ipv4Á 1 as_socket_ipv6Á 1 as_bytesÁ G÷ I÷ K÷ M× O� R§ S™ socketÁ U UUUUUUUUU U
|
|||
|
|
U U U
|
|||
|
|
UUUUUUUUUUUUUUU U U U U U!U"U SocketÁ y innerÁ U { from_rawÁ { as_rawÁ { into_rawÁ {æ { new_rawÁ € { pairÁ { pair_rawÁ ƒ ƒ { bindÁ { connectÁ { connect_timeoutÁ { listenÁ { acceptÁ {
|
|||
|
|
accept_rawÁ ‹ {
|
|||
|
|
local_addrÁ { peer_addrÁ {! { try_cloneÁ {‹
|
|||
|
|
{¡ { shutdownÁ { recvÁ { recv_out_of_bandÁ { recv_with_flagsÁ {
|
|||
|
|
recv_vectoredÁ { recv_vectored_with_flagsÁ { peekÁ { recv_fromÁ { recv_from_with_flagsÁ { recv_from_vectoredÁ { recv_from_vectored_with_flagsÁ { peek_fromÁ { peek_senderÁ { recvmsgÁ { sendÁ { send_with_flagsÁ {
|
|||
|
|
send_vectoredÁ { send_vectored_with_flagsÁ { send_out_of_bandÁ { send_toÁ { send_to_with_flagsÁ { send_to_vectoredÁ { send_to_vectored_with_flagsÁ { sendmsgÁ U set_common_typeÁ U set_common_flagsÁ U broadcastÁ ®
|
|||
|
|
set_broadcastÁ
|
|||
|
|
take_errorÁ keepaliveÁ ²
|
|||
|
|
set_keepaliveÁ lingerÁ
|
|||
|
|
set_lingerÁ out_of_band_inlineÁ · set_out_of_band_inlineÁ passcredÁ º set_passcredÁ priorityÁ ½ set_priorityÁ recv_buffer_sizeÁ À set_recv_buffer_sizeÁ read_timeoutÁ set_read_timeoutÁ
|
|||
|
|
reuse_addressÁ Å set_reuse_addressÁ send_buffer_sizeÁ È set_send_buffer_sizeÁ
|
|||
|
|
write_timeoutÁ set_write_timeoutÁ U from_lingerÁ U into_lingerÁ UÏ header_included_v4Á Ð Ï set_header_included_v4Á Ï ip_transparent_v4Á Ó Ï set_ip_transparent_v4Á Ï join_multicast_v4Á Ï leave_multicast_v4Á Ï join_multicast_v4_nÁ Ï leave_multicast_v4_nÁ Ï join_ssm_v4Á Ï leave_ssm_v4Á Ï multicast_all_v4Á Ü Ï set_multicast_all_v4Á Ï multicast_if_v4Á Ï set_multicast_if_v4Á Ï multicast_loop_v4Á á Ï set_multicast_loop_v4Á Ï multicast_ttl_v4Á ä Ï set_multicast_ttl_v4Á Ï ttl_v4Á ç Ï
|
|||
|
|
set_ttl_v4Á Ï
|
|||
|
|
set_tos_v4Á Ï tos_v4Á ë Ï set_recv_tos_v4Á Ï recv_tos_v4Á î Ï original_dst_v4Á Uñ header_included_v6Á ò ñ set_header_included_v6Á ñ ip_transparent_v6Á õ ñ set_ip_transparent_v6Á ñ join_multicast_v6Á ñ leave_multicast_v6Á ñ multicast_hops_v6Á ú ñ set_multicast_hops_v6Á ñ multicast_all_v6Á ý ñ set_multicast_all_v6Á ñ multicast_if_v6Á € ñ set_multicast_if_v6Á ñ multicast_loop_v6Á ƒ ñ set_multicast_loop_v6Á ñ unicast_hops_v6Á † ñ set_unicast_hops_v6Á ñ only_v6Á ‰ ñ set_only_v6Á ñ recv_tclass_v6Á Œ ñ set_recv_tclass_v6Á ñ recv_hoplimit_v6Á � ñ set_recv_hoplimit_v6Á ñ original_dst_v6Á U“ tcp_keepalive_timeÁ “ tcp_keepalive_intervalÁ • “ tcp_keepalive_retriesÁ — “ set_tcp_keepaliveÁ “ tcp_nodelayÁ š “ set_tcp_nodelayÁ U� readÁ �
|
|||
|
|
read_vectoredÁ Ÿ U¡ 'aÁ ¡¢2 ¡®2 ¤ U¦ writeÁ ¦ write_vectoredÁ ¦ flushÁ UªÌ2 ªï2 ªü2 ª’3 U ¯× sockrefÁ ± ±±±±±±±±± SockRefÁ » 'sÁ »Ú » _lifetimeÁ ± ¿™4 ¿å ¿´ ±Ã™4 ä Ã÷ ±Ç× sysÁ É ÉÉÉÉÉÉÉÉÉ É
|
|||
|
|
É É É
|
|||
|
|
ÉÉÉÉÉÉÉÉÉÉÉÉÉÉÉ É É É É É!É"É#É$É%É&É'É(É)É*É+É,É-É.É/É0É1É2É3É4É5É6É7É8É9É:É;É<É=É>É?É@ÉAÉBÉCÉDÉEÉFÉGÉHÉIÉJÉKÉLÉMÉNÉOÉPÉQÉRÉSÉTÉUÉVÉWÉXÉYÉZÉ[É\É]É^É_É`ÉaÉbÉcÉdÉeÉfÉgÉhÉiÉjÉkÉlÉmÉnÉoÉpÉqÉrÉsÉtÉuÉvÉwÉxÉyÉzÉ{É|É}É~ÉÉ€É�ÉX É‚É syscallÁ Éÿ É TCP_CA_NAME_MAXÁ Éå É Ò PACKETÁ Ò VSOCKÁ ÉÕ‹
|
|||
|
|
Õ cloexecÁ Õ _cloexecÁ ÉÙ is_end_of_recordÁ Ù is_out_of_bandÁ Ù
|
|||
|
|
is_confirmÁ Ù is_dontrouteÁ ÉÞ× É MaybeUninitSliceÁ àÌ2 àÁ à«4 ÉäÌ2 ÉæÌ2 ÉèÌ2 èæ è as_sliceÁ è as_mut_sliceÁ É offset_of_pathÁ É
|
|||
|
|
unix_sockaddrÁ ÉƒÉ set_msghdr_nameÁ É set_msghdr_iovÁ É set_msghdr_controlÁ É set_msghdr_flagsÁ É msghdr_flagsÁ É msghdr_control_lenÁ Éö vsockÁ ö as_vsock_addressÁ Éù
|
|||
|
|
is_unnamedÁ ú ù as_sockaddr_unÁ ü ù path_lenÁ ù
|
|||
|
|
path_bytesÁ ù as_unixÁ ù as_pathnameÁ � ‚ ù as_abstract_namespaceÁ „ … Éó É RawSocketÁ É socket_from_rawÁ É
|
|||
|
|
socket_as_rawÁ É socket_into_rawÁ ÉÚ É
|
|||
|
|
socketpairÁ � � Éù � É„ ’ É poll_connectÁ ɨ • ɵ — É getsocknameÁ ™ ™ É getpeernameÁ œ œ Éÿ É‹
|
|||
|
|
É¡ É� ¢ ɬ ¤ É¢ ¦ § Éš © Éä ÉÍ ¬ ɬ ® ɺ ° ÉÛ É¥! ³ ÉÌ! É…" ¶ É timeout_optÁ É from_timevalÁ É set_timeout_optÁ É into_timevalÁ É÷0 ¼ ÉÖ1 É into_secsÁ É fcntl_getÁ É fcntl_addÁ Á É fcntl_removeÁ à É
|
|||
|
|
getsockoptÁ Å¥ Å É
|
|||
|
|
setsockoptÁ È¥ È É
|
|||
|
|
to_in_addrÁ É from_in_addrÁ É to_in6_addrÁ É
|
|||
|
|
from_in6_addrÁ É to_mreqnÁ Éä+ Ð Ð ÉÜ0 Ó Ó É Ö accept4Á Ö _accept4Á Ø Ö set_cloexecÁ Ö _set_cloexecÁ Ö tcp_mssÁ Ü Ö set_tcp_mssÁ Ö is_listenerÁ ß Öè Ö protocolÁ â Ö markÁ ä Ö set_markÁ Ö tcp_corkÁ ç Ö set_tcp_corkÁ Ö tcp_quickackÁ ê Ö set_tcp_quickackÁ Ö tcp_thin_linear_timeoutsÁ í Ö set_tcp_thin_linear_timeoutsÁ Ö tcp_notsent_lowatÁ ð Ö set_tcp_notsent_lowatÁ Ö deviceÁ ó Ö bind_deviceÁ õ Ö bind_device_by_index_v4Á Ö bind_device_by_index_v6Á Ö device_index_v4Á Ö device_index_v6Á Ö cpu_affinityÁ û Ö set_cpu_affinityÁ Ö
|
|||
|
|
reuse_portÁ þ Ö set_reuse_portÁ Ö freebind_v4Á � Ö set_freebind_v4Á Ö freebind_v6Á „ Ö set_freebind_v6Á Ö sendfileÁ ‡— Ö _sendfileÁ ‰ Ö set_tcp_user_timeoutÁ ‹ Ö tcp_user_timeoutÁ � Ö
|
|||
|
|
attach_filterÁ Ö
|
|||
|
|
detach_filterÁ Ö cookieÁ Ö tclass_v6Á ’ Ö
|
|||
|
|
set_tclass_v6Á Ö tcp_congestionÁ • • • Ö set_tcp_congestionÁ ™ Ö set_dccp_serviceÁ Ö dccp_serviceÁ Ö
|
|||
|
|
set_dccp_ccidÁ Ö dccp_tx_ccidÁ Ö dccp_xx_ccidÁ Ö set_dccp_server_timewaitÁ Ö dccp_server_timewaitÁ Ö set_dccp_send_cscovÁ Ö dccp_send_cscovÁ Ö set_dccp_recv_cscovÁ Ö dccp_recv_cscovÁ Ö set_dccp_qpolicy_txqlenÁ Ö dccp_qpolicy_txqlenÁ Ö dccp_available_ccidsÁ ¨Ÿ ¨ Ö dccp_cur_mpsÁ Ö busy_pollÁ Ö
|
|||
|
|
set_busy_pollÁ É
|
|||
|
|
SockFilterÁ ® filterÁ É
|
|||
|
|
°æ É ²× É ´Ÿ ´å ´´ É
|
|||
|
|
¸ as_fdÁ ɺ as_raw_fdÁ ɼ÷ ɾ into_raw_fdÁ ÉÀ÷ É from_raw_fdÁ
|
|||
|
|
Ï IPV4Á Ï IPV6Á Ï UNIXÁ Ï for_addressÁ Ô÷ Ö÷ Ø STREAMÁ Ø DGRAMÁ Ø DCCPÁ Ø SEQPACKETÁ Ø RAWÁ Þ÷ à÷ â ICMPV4Á â ICMPV6Á â TCPÁ â UDPÁ â MPTCPÁ âçT â SCTPÁ â UDPLITEÁ ë÷ í÷ ï is_truncatedÁ Ž< ñ
|
|||
|
|
ñÌ2 ñˆ
|
|||
|
|
õÌ2 õ× øÌ2 øæ ûÌ2 ûå û´
|
|||
|
|
ÿÌ2 ÿ¶ ‚æ ‚ with_timeÁ ‚
|
|||
|
|
with_intervalÁ ‚ with_retriesÁ MsgHdrÁ ‡ 'addrÁ ‡ 'bufsÁ ‡ 'controlÁ ‡€ ‡
|
|||
|
|
_lifetimesÁ �„X �‘X �žX �æ � with_addrÁ � with_buffersÁ � with_controlÁ �
|
|||
|
|
with_flagsÁ – 'nameÁ –‘X –žX –× MsgHdrMutÁ œ„X œ‘X œžX œ€ œ¶X ¢„X ¢‘X ¢žX ¢æ ¢ìX ¢ýX ¢‘Y ¢ flagsÁ ¢ control_lenÁ ¬»Y ¬‘X ¬žX ¬× man_linksÁ SockAddrÁ ³· ³‘
|
|||
|
|
¶ƒ U InterfaceIndexOrAddressÁ ¸ IndexÁ ¹
|
|||
|
|
¹ˆ ¸ AddressÁ ¼
|
|||
|
|
¼ˆ U
|
|||
|
|
¿× U U U
|
|||
|
|
à UÅ÷ UÇ÷ UÉ÷ UË÷ UÍ÷ UÏ÷ ÉÑ× ÉÓ× ÉÕ× É
|
|||
|
|
CcidEndpointsÁ ן × endpointsÁ Ù × lengthÁ ÉÜŸ Ü Ü× Éà÷ Éâ÷ Éä÷ Éæ÷ Éè÷ É ê÷ DomainÁ ì
|
|||
|
|
ìˆ ñƒ óÖ ö� ó ø
|
|||
|
|
øˆ ýƒ ÿÖ ‚� ProtocolÁ „
|
|||
|
|
„ˆ ! " #‰ƒ $‹Ö % &Ž� RecvFlagsÁ �
|
|||
|
|
�ˆ ' ( )•ƒ *—Ö + ,š� TcpKeepaliveÁ œ timeÁ œ intervalÁ œ retriesÁ - × .¢ƒ ,
|
|||
|
|
-
|
|||
|
|
0
|
|||
|
|
0
|
|||
|
|
0
|
|||
|
|
:
|
|||
|
|
;
|
|||
|
|
<
|
|||
|
|
=
|
|||
|
|
>
|
|||
|
|
@
|
|||
|
|
A
|
|||
|
|
B
|
|||
|
|
C
|
|||
|
|
D
|
|||
|
|
E
|
|||
|
|
F
|
|||
|
|
N
|
|||
|
|
N
|
|||
|
|
N
|
|||
|
|
P
|
|||
|
|
P
|
|||
|
|
S
|
|||
|
|
S
|
|||
|
|
}
|
|||
|
|
†
|
|||
|
|
†
|
|||
|
|
‡
|
|||
|
|
‡
|
|||
|
|
ˆ
|
|||
|
|
ˆ
|
|||
|
|
‰
|
|||
|
|
Š
|
|||
|
|
‹
|
|||
|
|
�
|
|||
|
|
Ž
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
‘
|
|||
|
|
’
|
|||
|
|
“
|
|||
|
|
”
|
|||
|
|
”
|
|||
|
|
•
|
|||
|
|
•
|
|||
|
|
–
|
|||
|
|
–
|
|||
|
|
—
|
|||
|
|
—
|
|||
|
|
—
|
|||
|
|
˜
|
|||
|
|
˜
|
|||
|
|
˜
|
|||
|
|
™
|
|||
|
|
™
|
|||
|
|
š
|
|||
|
|
š
|
|||
|
|
›
|
|||
|
|
›
|
|||
|
|
œ
|
|||
|
|
œ
|
|||
|
|
œ
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
ž
|
|||
|
|
ž
|
|||
|
|
Ÿ
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
¡
|
|||
|
|
¡
|
|||
|
|
¢
|
|||
|
|
¢
|
|||
|
|
£
|
|||
|
|
£
|
|||
|
|
£
|
|||
|
|
¤
|
|||
|
|
¤
|
|||
|
|
¤
|
|||
|
|
¥
|
|||
|
|
¥
|
|||
|
|
¦
|
|||
|
|
¦
|
|||
|
|
¦
|
|||
|
|
§
|
|||
|
|
§
|
|||
|
|
§
|
|||
|
|
¨
|
|||
|
|
¨
|
|||
|
|
¨
|
|||
|
|
¨
|
|||
|
|
©
|
|||
|
|
©
|
|||
|
|
©
|
|||
|
|
©
|
|||
|
|
ª
|
|||
|
|
ª
|
|||
|
|
ª
|
|||
|
|
ª
|
|||
|
|
ª
|
|||
|
|
®
|
|||
|
|
°
|
|||
|
|
±
|
|||
|
|
²
|
|||
|
|
´
|
|||
|
|
µ
|
|||
|
|
¶
|
|||
|
|
·
|
|||
|
|
¹
|
|||
|
|
º
|
|||
|
|
¼
|
|||
|
|
½
|
|||
|
|
¿
|
|||
|
|
À
|
|||
|
|
Â
|
|||
|
|
Ã
|
|||
|
|
Ä
|
|||
|
|
Å
|
|||
|
|
Ç
|
|||
|
|
È
|
|||
|
|
Ê
|
|||
|
|
Ë
|
|||
|
|
Ì
|
|||
|
|
Ð
|
|||
|
|
Ò
|
|||
|
|
Ó
|
|||
|
|
Õ
|
|||
|
|
Ö
|
|||
|
|
Ö
|
|||
|
|
Ö
|
|||
|
|
×
|
|||
|
|
×
|
|||
|
|
×
|
|||
|
|
Ø
|
|||
|
|
Ø
|
|||
|
|
Ø
|
|||
|
|
Ù
|
|||
|
|
Ù
|
|||
|
|
Ù
|
|||
|
|
Ú
|
|||
|
|
Ú
|
|||
|
|
Ú
|
|||
|
|
Ú
|
|||
|
|
Û
|
|||
|
|
Û
|
|||
|
|
Û
|
|||
|
|
Û
|
|||
|
|
Ü
|
|||
|
|
Þ
|
|||
|
|
ß
|
|||
|
|
à
|
|||
|
|
à
|
|||
|
|
á
|
|||
|
|
ã
|
|||
|
|
ä
|
|||
|
|
æ
|
|||
|
|
ç
|
|||
|
|
é
|
|||
|
|
ê
|
|||
|
|
ë
|
|||
|
|
í
|
|||
|
|
î
|
|||
|
|
ð
|
|||
|
|
ò
|
|||
|
|
ô
|
|||
|
|
õ
|
|||
|
|
÷
|
|||
|
|
ø
|
|||
|
|
ø
|
|||
|
|
ù
|
|||
|
|
ù
|
|||
|
|
ú
|
|||
|
|
ü
|
|||
|
|
ý
|
|||
|
|
ÿ
|
|||
|
|
€
|
|||
|
|
‚
|
|||
|
|
ƒ
|
|||
|
|
…
|
|||
|
|
†
|
|||
|
|
ˆ
|
|||
|
|
‰
|
|||
|
|
‹
|
|||
|
|
Œ
|
|||
|
|
Ž
|
|||
|
|
�
|
|||
|
|
‘
|
|||
|
|
’
|
|||
|
|
”
|
|||
|
|
•
|
|||
|
|
—
|
|||
|
|
™
|
|||
|
|
™
|
|||
|
|
š
|
|||
|
|
œ
|
|||
|
|
ž
|
|||
|
|
ž
|
|||
|
|
Ÿ
|
|||
|
|
Ÿ
|
|||
|
|
Ÿ
|
|||
|
|
£
|
|||
|
|
£
|
|||
|
|
¤
|
|||
|
|
¤
|
|||
|
|
¤
|
|||
|
|
§
|
|||
|
|
§
|
|||
|
|
¨
|
|||
|
|
¨
|
|||
|
|
¨
|
|||
|
|
©
|
|||
|
|
¬
|
|||
|
|
¬
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
®
|
|||
|
|
°
|
|||
|
|
°
|
|||
|
|
°
|
|||
|
|
Â
|
|||
|
|
Ç
|
|||
|
|
È
|
|||
|
|
È
|
|||
|
|
È
|
|||
|
|
ß
|
|||
|
|
ß
|
|||
|
|
ß
|
|||
|
|
ë
|
|||
|
|
ì
|
|||
|
|
í
|
|||
|
|
î
|
|||
|
|
ð
|
|||
|
|
ð
|
|||
|
|
ñ
|
|||
|
|
ò
|
|||
|
|
ó
|
|||
|
|
ô
|
|||
|
|
õ
|
|||
|
|
ø
|
|||
|
|
ú
|
|||
|
|
ü
|
|||
|
|
þ
|
|||
|
|
þ
|
|||
|
|
ÿ
|
|||
|
|
ÿ
|
|||
|
|
€
|
|||
|
|
�
|
|||
|
|
„
|
|||
|
|
Š
|
|||
|
|
�
|
|||
|
|
’
|
|||
|
|
”
|
|||
|
|
¤
|
|||
|
|
¦
|
|||
|
|
«
|
|||
|
|
«
|
|||
|
|
¬
|
|||
|
|
¬
|
|||
|
|
®
|
|||
|
|
®
|
|||
|
|
®
|
|||
|
|
®
|
|||
|
|
°
|
|||
|
|
²
|
|||
|
|
²
|
|||
|
|
³
|
|||
|
|
³
|
|||
|
|
µ
|
|||
|
|
µ
|
|||
|
|
µ
|
|||
|
|
¶
|
|||
|
|
¶
|
|||
|
|
¶
|
|||
|
|
¶
|
|||
|
|
¾
|
|||
|
|
Ë
|
|||
|
|
Í
|
|||
|
|
Ï
|
|||
|
|
Ï
|
|||
|
|
×
|
|||
|
|
Ø
|
|||
|
|
Ú
|
|||
|
|
Û
|
|||
|
|
Ü
|
|||
|
|
Þ
|
|||
|
|
ß
|
|||
|
|
á
|
|||
|
|
â
|
|||
|
|
ä
|
|||
|
|
æ
|
|||
|
|
ç
|
|||
|
|
é
|
|||
|
|
ê
|
|||
|
|
ì
|
|||
|
|
í
|
|||
|
|
ï
|
|||
|
|
ð
|
|||
|
|
ò
|
|||
|
|
ó
|
|||
|
|
õ
|
|||
|
|
õ
|
|||
|
|
÷
|
|||
|
|
ø
|
|||
|
|
ù
|
|||
|
|
ú
|
|||
|
|
û
|
|||
|
|
ý
|
|||
|
|
þ
|
|||
|
|
€
|
|||
|
|
�
|
|||
|
|
ƒ
|
|||
|
|
„
|
|||
|
|
†
|
|||
|
|
‡
|
|||
|
|
‡
|
|||
|
|
‰
|
|||
|
|
‹
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
‘
|
|||
|
|
’
|
|||
|
|
”
|
|||
|
|
•
|
|||
|
|
™
|
|||
|
|
™
|
|||
|
|
›
|
|||
|
|
œ
|
|||
|
|
�
|
|||
|
|
ž
|
|||
|
|
Ÿ
|
|||
|
|
|
|||
|
|
¡
|
|||
|
|
¢
|
|||
|
|
£
|
|||
|
|
¤
|
|||
|
|
¥
|
|||
|
|
¦
|
|||
|
|
§
|
|||
|
|
¨
|
|||
|
|
«
|
|||
|
|
¬
|
|||
|
|
|
|||
|
|
³
|
|||
|
|
³
|
|||
|
|
³
|
|||
|
|
·
|
|||
|
|
¹
|
|||
|
|
»
|
|||
|
|
÷
|
|||
|
|
÷
|
|||
|
|
÷
|
|||
|
|
þ
|
|||
|
|
�
|
|||
|
|
“
|
|||
|
|
š
|
|||
|
|
š
|
|||
|
|
š
|
|||
|
|
›
|
|||
|
|
›
|
|||
|
|
›
|
|||
|
|
¨
|
|||
|
|
ª
|
|||
|
|
«
|
|||
|
|
°
|
|||
|
|
°
|
|||
|
|
°
|
|||
|
|
±
|
|||
|
|
±
|
|||
|
|
±
|
|||
|
|
·
|
|||
|
|
À
|
|||
|
|
À
|
|||
|
|
À
|
|||
|
|
Ä
|
|||
|
|
Ò
|
|||
|
|
Ò
|
|||
|
|
Ò
|
|||
|
|
Ô
|
|||
|
|
Ô
|
|||
|
|
Ô
|
|||
|
|
Ö
|
|||
|
|
Ö
|
|||
|
|
Ö
|
|||
|
|
ß
|
|||
|
|
ß
|
|||
|
|
ß
|
|||
|
|
ò
|
|||
|
|
ô
|
|||
|
|
÷
|
|||
|
|
÷
|
|||
|
|
þ
|
|||
|
|
€
|
|||
|
|
ƒ
|
|||
|
|
ƒ
|
|||
|
|
Š
|
|||
|
|
Œ
|
|||
|
|
�
|
|||
|
|
�
|
|||
|
|
–
|
|||
|
|
˜
|
|||
|
|
›
|
|||
|
|
›
|
|||
|
|
¡
|
|||
|
|
¡
|
|||
|
|
¡
|
|||
|
|
£
|
|||
|
|
¿c ( ( ¡ )· +#ií?‡Ò3 Ø ³ ³ ¯[ ´· µ‘ ?Æ'OJ"Pž é �s“¼”¼ •¼ V4Á –¼ˆ —¼ ˜¼ V6Á™¼ˆ cÌ£•w® é �sª¼ª¼ SocketAddrV4Á «¼ ipÁÑS ¬¼ portÁÑS µÃѨbF(Æ é �s½¼½¼ SocketAddrV6Á ¾¼ÎsÑS ¿¼ÝsÑS À¼ flowinfoÁÑS Á¼ scope_idÁÑS ¸dÛÔ#¹G[ ¿c�s µß�s�s ™�s še�s ¿c ¸ ¹ ºù[ »ˆ ¼ ½“\ ¾ˆ $šÞÞX ¥Ü Š v Ûv Øv à y y ó z€ U ýÎ}AƒÏ à Ì2šw Ÿ!šw Ÿ!Ëw ¿cšw é šw‡#‡# ˆ# TcpStreamÁ ‰#ˆô" ¤‰?ßøkã é šwŠ#Š# ‹# TcpListenerÁ Œ#ˆô" N� À];óÉ é šwð#ð# ñ# UdpSocketÁ ò#ˆà# ¬ãøàFð™ é ýwšw é Âxšw é ‰yšw é! » » Š4 ½Ú ± ¾«4 ± ÇSZä ·‹ˆ ™4 é òy ™4¤ ¿c » » Š4 ½Ú ± ¾«4 ± ÇSZä ·‹ˆ 8 ¿c ì ì íæ^ îˆ éH<[îÔ„ƒ ¿c ø ø ùó úˆ Ð ×õ*ž ¿c „ „ …ô_ †ˆ “3Nîйþ ¿c � � ‘À` ’ˆ ¥õÚlÆ Z Ìì à à Ž< âÁ É ã«4 É (ýÍå�– ! Ì2 � ÷| ¿c ® ® €R ¯’R É ‹íhÒx#» ¿c × × ¾] ÙÛ] É Ûñ] É rDÒ!ŸTa Ÿ é!ý} �,šw «+šw é ö+ö+ OwnedFdÁ ÷+ fdÁä+ Þí¼>XG¸, šw ¯+šw é šwâ~ +šw é šw(( ®(
|
|||
|
|
UnixStreamÁ ¯(ˆê% ׶'™g$² é šwã'ã' ä' UnixListenerÁ å'ˆË' Nó:xÔ§eö é šw’'’' “' UnixDatagramÁ ”'ˆñ& ÒÛ0É@ßh é Çšw é �€šw é Õ€šw Š –{ Û–{ Ø–{ ™–{ Ðì–{ µß–{–{ é –{ é –{ Š Î{ ÛÎ{ ØÎ{ ™Î{ ÐìÎ{ µßÎ{Î{ é Î{ é Î{ Š †| Û†| ؆| ™†| Ðì†| µß†|†| é †| é †| Š ¾| Û¾| ؾ| ™¾| Ðì¾| µß¾|¾| ¿c ñ ñ òŽ< ôˆ ëp%×—µí Ì2 é!•„ ö!•„ ¿c œ œ �a �¡a ža Ÿ½a ŽŽj„à1À Øé„ ¿c ‡ ‡ öW ‹€ Œ¶X KDÑ[6õ\ »Y ‘X žX Ìì ‡ ‡ öW ‹€ Œ¶X KDÑ[6õ\ 8 8 8 ¿c œ œ ãY € ¡¶X œB6I‰æG »Y ‘X žX Ìì œ œ ãY € ¡¶X œB6I‰æG 8 8 8 / (M ³¿ ¸¯ yÇ »Ñ ìÓ øÕ „Þ �² ®Ü ×õ ñ œ– ‡¬ œ¶ ³Ã ¸ñ ìý ø‰ „• �¢ œG ³I ³K ³Å yÇ yÉ yˇ#ÍŠ#Ïð#à »¼ö+À yà yâ yä yæ(èã'ê’'Ô ìÖÞ øàë „íO ³ö ì‚ øŽ „š �Q ³ó ìÿ ø‹ „— �R ³Á ¸ï ìû ø‡ „“ � ¸ð ìü øˆ „” �� y¡
|
|||
|
|
¦ yª
|
|||
|
|
¿ »´ ×û ñä à› ‡± œæ ภyº y¾ y yõ ì� ø� „™ �ÿ ñ¿cÀØeé 1µß˜™"še"Š Û#à #Ÿ! é! Ìì� �,«+¯++Ðìö! |�% Ë Ë sockaddr_storageÁ Ì ss_familyÁ Í __ss_pad2ÁŒ Ï
|
|||
|
|
__ss_alignÁŒ ‡^³bAÉ C „±% ±% üï$] ³ Ë% Ò% 2 ü—$» �s DÜ$ Ür <¯$ É$ ³� ü € ·$ ‘( S ìð3
|
|||
|
|
Üð3
|
|||
|
|
À³� + üð3* ™4 üÐ3K 6 Lä3 n + _Á ´†> ³� ¢> ; üÒ=P \ð= �s ,æ= / ü‡? ´‡? ³� & ¥? ü€?' ì ¦? ? < üÑ>\ –{ 4ï> •‘ ,å> � ‹ ; D•@ £@ = üæ?= L�@ •‘ ,÷? - ü–A( l–A ³� ü–AB Ür ×A ÝA ÞA > ü×@‡ ‹” ´õ@ •‘ ,ë@ ³� ‰ ³� ‹ D dòB ³� üËB> ( ˆC �C ? ü�B Ür |±B �s $¨B ³� h 4 ´œD ³� ´¶D <¶D Ø üœD0 ËD ÒD @ üîCd $�D •‘ ,ƒD � y : Ø ´èE ³� ¼‚F D‚F à üèE1 ˜F ŸF A üºEe $ÙE •‘ ,ÏE � y : à ¯æ ´æ l´æ
|
|||
|
|
|
|||
|
|
D·æ
|
|||
|
|
Ø 4 T·æ Àæ §ç ªç «ç « üúâ± ü«æ€ Î{ $ ã Î{ “ã Î{ ® Î{ ¬ ´ ´Ì U œƒÖ tƒÖ ! •Ö @ ! $¡Ö Û¼ ÖÖ DurationÁ ®Ö secsÁâ} ¯Ö nanosÁâ} :²Zµ–²ª ü€Ör ˜ üÀÖ+ ´ÔÖ |ÔÖ ! éÖ B
|
|||
|
|
I œÀÖ
|
|||
|
|
€~ U g êÖ ü»Ö1 Û¼Ó› ëÖ ñÖ ôÖ Í ü¼Õ¸ ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙÓ› „éÕ …… # † l_onoffÁ ‡ l_lingerÁ š~~‚A¨ 4ÑÕ 3 2 Ó› y w v #5 ß DÂ× t¼× $ ü×ØH … úØ “Ù 9 DÚ× Û Ó› ¼£Ø ”£Ø D£Ø
|
|||
|
|
%<¯
|
|||
|
|
Œ~ 2 L¬Ø ´Ø b p ¹Ø üç×^ … ŠØ ÄØ ¨Ù Î üöÖ² üÕ×p Ôž \ª× „ž D‹× tÕ× Ó› 8 ! ) " Ó› % durationÁL ²¢} ‰ ¬÷Q d÷Q Í üÜQ1 Ï ,ïQ %< Í _Á 16Á¼„c ì |‹c è üéb3 Ó –{ 4ûb %9 è _Á ´Ùd ì tàd ÔA ü¿d1 Ô –{ 4Ðd %9 ÔA _Á ä«l 4«l
|
|||
|
|
œ´l ·A Æl ü¦l" ø Çl Îl Ö üõkY Î{ $—l Î{ $Žl ’ ‘ :… ·A $µq |µq
|
|||
|
|
Dºq À™ / Tºq Ãq Êq × üˆqB Î{ $¦q Î{ $�q Î{ w 3 Ü°u 4°u
|
|||
|
|
”¹u Å Êu ü«u! ø Ëu Òu Ø üöt\ Î{ $œu Î{ $“u ’ ‘ :… Å ´‡Š 4‡Š ! l�Š © œŠ ܇Š ¡Š ¨Š Ú üщW $ø‰ ¾| $ï‰ ž <‘ © ´ØŒ 4ØŒ ! lጠ£ íŒ ÜØŒ òŒ ùŒ Û ü¤ŒU $ÉŒ ¾| $ÀŒ ž <‘ £ Ô§� 4§� ! Œ°� À� ü§� Å� Ì� Ü ü÷�U $˜� ¾| $�� ¡ Ÿ <’ äÜ“ 4Ü“ ! œå“ ¥ ÷“ üÜ“! ü“ ƒ” Ý üª“Y $Í“ ¾| $Ä“ ¡ Ÿ <’ ¥ 2Á 8Á ¤¦µ |¦µ ! ¹µ D % ¬¾µ „¾µ ! Òµ D % $Þµ Û¼ Ó› ü£µØ R ¸ üµ |‚¶ ´‚¶ —¶ $¦¶ ̶ „®¶
|
|||
|
|
|
|||
|
|
!
|
|||
|
|
Ŷ
|
|||
|
|
ü¶ $ɶ è # $ è E ̶ Äܶ ê¶
|
|||
|
|
|
|||
|
|
$ï¶ 1
|
|||
|
|
8lܶ
|
|||
|
|
ÿ}
|
|||
|
|
E 6 [ ó¶
|
|||
|
|
ô׶ Û¼Ó› ô¶ ú¶ ¦ ý¶ ¹ üÚ´£ üøµƒ ü¢¶Y „ž „Œµ timevalÁ ® tv_secÁ ¯ tv_usecÁ ,áÆ;ïÄ› Dð´ Í Ì A @ ð Ó› œ › � ²¢x secÁ¡ nsecÁv ü�ß! l°ß $°ß
|
|||
|
|
& 4µß
|
|||
|
|
ØQ 3 Dµß ¼ß ^
|
|||
|
|
e ”�ß
|
|||
|
|
Ò r „ ½ß üƒßB ³ Äß Çß Ë üšÝ ³³ in_addrÁ ´ s_addrÁ F â1–œöÏ <ÍÝ ¾º¾º Ipv4AddrÁ ¿º octetsÁ¯Q 5N`h�zØÊ $¹Ý ] i „» i addrÁ8 Ð l—á $—á
|
|||
|
|
& 4χ
|
|||
|
|
R 3 Dœá £á üûà0 ¿ ªá á Í ü¸àu ¿¿ in6_addrÁ À s6_addrÁ ÆŒRUN‰� Dìà ̺̺ Ipv6AddrÁ ͺ¤º¯Q É¢}ÝÏÆÚ $Øà + ë½ + øº-  Lúå |ôå % L·è “\ †» ¬ñè Lüè
|
|||
|
|
&Tñè
|
|||
|
|
Ë 3 D L¼æ ù[ ¬öæ L�ç
|
|||
|
|
&Töæ ë¿ 1 B Šç ü¦ç" ´±ç Ï „» % 2 I
|
|||
|
|
PT¦ç ë¿ Z l Çç |ãç Tãç
|
|||
|
|
|
|||
|
|
$
|
|||
|
|
2 ñç
|
|||
|
|
üÊæ³ Ä üç ! ) …é ¬¡é L¬é
|
|||
|
|
&T¡é ë¿ 1 B µé üÅè˜ Ä Ñé Üé æé Ï üêäü üŽæï ü‡èÖ ÄÄ ip_mreqnÁ Å
|
|||
|
|
imr_multiaddrÁ Æ imr_addressÁ Ç imr_ifindexÁ BfÈI^‚ã tßå „» LŒå v L¦å üŽæ8 î ź × „» × Åº š „» ™ „» ¢ †» ¬²ç F N G „» ° ź ˜ „» ˜ ź Ü „» Ü „» û multiaddrÁ¿ interfaceÁÈ “Ƭ “Æ" �£ ÖQ †» ¸ À ÖQ †» x ‡ Ï Ó „» ¤ †» µ ÖQ †» libc::IFNAMSIZÁ TCP_CA_NAME_MAXÁ TCP_CA_NAME_MAXÁü·‡% $ˇ ч Õ‡ Ù‡ Z „ Û‡ ü–‡Q ® æ‡ í‡ ± üʆ£
|
|||
|
|
È} T�‡ $Û† æ† î† ö† „ „ sock_filterÁ … codeÁ † jtÁ ‡ jfÁ ˆ ¶ +[©Û$iÁ ^ \ P D 8 Ðʪ ÝÊ® èʲ ¶µ ÷ ¤Î@ ì dÕ@ Ø üµ@. Ð –{ 4Å@ %9 Ø _Á ¬ÆA ì lÍA à üA/ Ñ –{ 4½A %9 à _Á ¤éB ì dðB Ö üÐB. Ò –{ 4àB %9 Ö _Á <þC løC " dØD
|
|||
|
|
Ñ –{ d©D
|
|||
|
|
Ð –{ õD Ó ü¶C¿ –{ 4çC Ïs <ÏC Œ”D ˜ 7l Ð –{– Ñ –{ ´²K ø „·K ¥J ü™K0 Ù Î{ $«K %9 ¥J _Á ¬ÃL ø |ÈL ¦J ü«L. Ú Î{ $¼L %9 ¦J _Á ¤ƒN ø tˆN ÏA üìM, Û Î{ $üM %9 ÏA _Á ÌìO ø œñO ÎA üÐO6 Ü Î{ $åO %9 ÎA _Á œ�R ø l¢R ¶ ü‡R* Ý Î{ $–R %9 ¶ _Á ÜãW „ ŒìW � üÆW9 ã †| DØW %9 � _Á ìòX „ œûX ‘ üÕX; ä †| DçX %9 ‘ _Á ÔÙY „ „âY ’ ü¿Y5 å †| DÎY %9 ’ _Á Ô½Z „ „ÆZ “ ü£Z5 æ †| D²Z %9 “ _Á äÅ[ „ ”Î[ ÿ ü©[9 ç †| Dº[ %9 ÿ _Á Üã\ „ Œì\ ì üÈ\7 è †| DØ\ %9 ì _Á Üœ^ „ Œ¥^ ù ü�^7 é †| D‘^ %9 ù _Á ôÚ` „ ¤ã` û ü¼`= ê †| DÏ` %9 û _Á ¼Øi 4Øi tái § îi äØi ói úi ð ü¦iT $Éi ¾| $Ài – • 9‰ §
|
|||
|
|
$§z Û¼ Ó› $š} Û¼ Ó› $Œ€ Û¼ ü†z• œ š€ ¡€ ƒ üÙyÈ é„ dïy „ž º „ž ¤ ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙ Ò u T”… $™… Û¼Ó› �… üû„A œ „ž ÇÞ »… Â… „ ü¼„† é„ $ì„ é„ $Ó„ Ó› $Ù„ „ž µ Ó› ´ ' ¡a) Z t³� D¸� Û¼Ó› À� ü–�I œ „ž ÇÞ Þ� å� … üÏŒ– é„ $‡� é„ $êŒ Ó› DðŒ „ž µ Ó› ´ ' a) Z lÈ• <Í• Û¼ Ô• ü¬•G œ „ž „ž ò• ù• † üì”� é„ $�• é„ $†• <Œ• ÇÞ ³ ± % ½a( X ,àü ¸ º & v 1 8 ? <�ý ¸ ½ & v 1 †» 9 @ ŒÅ? ì í % –{ 0 7 > |“J ø ù % Î{ 0 7 > œÅV „ … % †| 0 7 > ¤Öe � ‘ % ¾| 0 7 > ü‹k ñ ò ( ñ ñ òŽ< ôˆ ëp%×—µí c à à Ž< âÁ É ã«4 É (ýÍå�– ! £ ª U±Éñò‡œìí„…œøù�‘À × ² ¤, IoSliceÁ<• æL PhantomDataÁ\€ • ½é – í ç ë MaybeUninitÁ\ú ÑÛ
|
|||
|
|
SocketAddrÁT• “¼ r,° é!
|
|||
|
|
DerefMutÁD· ö! ßšDÑ Ö c_intÁ,Ê7 ¿¬ Ä ü�\å7 ' ÆÿLò7 & ǯ[Dý7 ³ È¡|‡8 ( ÉÚ[¼×9 ¸ Êó4€: y ËŠ4<™: » ̾]lá: × Í€RTË; ® Îüáè¾ üˆ- * Utilities for creating and using sockets.Á ¶ú üºG D The goal of this crate is to create and use a socket using advancedÁ ü‚K H configuration options (those that are not available in the types in theÁ üÎ4 1 standard library) without using any unsafe code.Á ƒú ü‡D A This crate provides as direct as possible access to the system'sÁ üÌB ? functionality for sockets, this means little effort to provideÁ ü�M J cross-platform utilities. It is up to the user to know how to use socketsÁ üÝJ G when using this crate. *If you don't know how to create a socket usingÁ ü¨H E libc/system calls then this crate is not for you*. Most, if not all,Á üñI F functions directly relate to the equivalent system call with no errorÁ ü»P M handling applied, so no handling errors such as [`EINTR`]. As a result usingÁ üŒ P M this crate can be a little wordy, but it should give you maximal flexibilityÁ üÝ " over configuration of sockets.Á €
|
|||
|
|
ú ü„
|
|||
|
|
. + [`EINTR`]: std::io::ErrorKind::InterruptedÁ ³
|
|||
|
|
ú t·
|
|||
|
|
# ExamplesÁ Æ
|
|||
|
|
ú lÊ
|
|||
|
|
|
|||
|
|
```no_runÁ üØ
|
|||
|
|
( % # fn main() -> std::io::Result<()> {Á ü� , ) use std::net::{SocketAddr, TcpListener};Á ü® ( % use socket2::{Socket, Domain, Type};Á × ú üÛ 4 1 // Create a TCP listener bound to two addresses.Á ü� @ = let socket = Socket::new(Domain::IPV6, Type::STREAM, None)?;Á Ñ ú üÕ socket.set_only_v6(false)?;Á üõ = : let address: SocketAddr = "[::1]:12345".parse().unwrap();Á ü³
|
|||
|
|
" socket.bind(&address.into())?;Á ÄÖ
|
|||
|
|
socket.listen(128)?;Á ï
|
|||
|
|
ú üó
|
|||
|
|
. + let listener: TcpListener = socket.into();Á T¢ // ...Á ¬ # drop(listener);Á tà # Ok(()) }Á <Ò ```Á Úú |Þ ## FeaturesÁ îú üòP M This crate has a single feature `all`, which enables all functions even onesÁ üÃ& # that are not available on all OSs.Á t• U±Éñò‡œìí„…œøù�‘À× ×Ø ¤, £éÑ æL ½éÆ • ½éÙ – íÆ ë ‚ê» ÑÛ ¡ê± “¼ r° é!
|
|||
|
|
Ñê¨ ö! ßš§ Ö �ë¢ ¿¬ Ä ü�¡ ' Æÿ & ǯ[Ÿ ³ È¡ž ( ÉÚ[� ¸ Êóœ y ËŠ4› » ̾]š × Í€R™ ® ÎR U X DO „Œ< Äó% Dâ ¬ðî
|
|||
|
|
¤‹×
|
|||
|
|
D¥Ë
|
|||
|
|
Î
|
|||
|
|
¶
|
|||
|
|
¹
|
|||
|
|
œÆ¬
|
|||
|
|
¼ªT·  ä È � , Œ 8! $� & ‘ 8õ
|
|||
|
|
$“ $ — , ¡ ¢ � , ° ± Â + ² ³ Á , ´ 8ê 4µ & » 8û $½
|
|||
|
|
à , ê 8– $ë & ï 8¼ ,ñ '÷ , ú 8 flagÁ $û & ÿ 8¼ ,� $ � ‘ , “ ” – $ •
|
|||
|
|
— *Ÿ ¢ á
|
|||
|
|
8 $¬ 8À ± '´ 8× ¶ '¹ 8p ,» 8
|
|||
|
|
Á , Å 8! $Æ Ë Û
|
|||
|
|
8 Ù 8× Ü ß † à 8 $á $ å 8± ç & è ê 8 ë 8À ï 'ò 8× ô '÷ 8ˆ Lù ‚ :8 ƒ … (ˆ 8À ‹ 'Ž 8× � '“ 8Í 4• œ Ñ
|
|||
|
|
8 ® 8 stringÁ 4² ¹ 8 ,» 8 $Á Å 7ˆ Æ È ž
|
|||
|
|
, Þ ß Ù
|
|||
|
|
, ù ú … + û ü „ , ý 8ê 4þ
|
|||
|
|
† , 8– $¡ '¦ , © 8…‚ $ª *¯ 8Ô L² » ¼  , ½ 8…‚ $¾ $ Ã Ú 8¹ ð *ò 8 4õ 8ï2 ,ü � ‚ ‹ 8± ƒ $ „ 7 {n}Á ,† $ Œ % Ÿ 8± ± ² 8ñ L³ ¼ à 8»… 4½ % â Œž $« ° Ž" ¶ Ê , · 8÷ $¸ & ¼ 8´ ¾ $ À ,  8
|
|||
|
|
à & Æ 8´ È *Ì Ï ‹"
|
|||
|
|
8 $Ù 8Š $Þ â , ã 8÷ $ä è 8
|
|||
|
|
ê , î 8
|
|||
|
|
ï ó …" 8 � 8÷ $„ ˆ – 8Ú 4‰ & � , ‘ 8÷ $’ (˜ , › 8
|
|||
|
|
œ û! + ² ³ ó 8â ´ · ò 8º ¸ » ñ 8ú $¼ $ À 8£  Šð 8ú LÆ Ð 7€ 4Ò $ Ø 8”
|
|||
|
|
Ú Ý ï 8î TÞ é 7‘ $ë 8" 4… Œ Ü ¢ , £ 8
|
|||
|
|
¤ § '¨ 8¶S \ª µ Ê 8Ú 4¶ ¼ 8‘S \½ È É + î ï ü 8â ð ó û 8â <ô 8" 4Ž! •! í! «! , ¬! 8
|
|||
|
|
! °! '±! 8 from_raw_socketÁ |³! Â! Û! 8Ú 4Ã! É! 8 into_raw_socketÁ |Ê! Ù! Ú! % Œ" dé4 Dí4 &'(³Ž$ še Ž e í$$ ë š<* À ¡êTC “¼ ¸sdO ª¼ ’td] ½¼ PathÁ$› …0 × « ¤, ioÁ° ¦ µ ´ “ AF_UNIXÁ<¹ Ö ý�ë,Ó ¿¬ ü sockaddr_inÁ\Ú ã ” sockaddr_in6Ádç ð ! •½Œ„õ Ë " – AF_INETÁ<‡ Ø # ÿ AF_INET6ÁD� à $ €æ^4¦ ì %æ^ í %| ÎD ° ¤§D8 š���€ƒ|� s ¥ gjX[KNœ ;TÆ ), ïñÛÝÁÃ¥§lŸ •”� ü¯> ; The integer type used with `getsockname` on this platform.ÁL– ¤š üº@ = The integer type for the `ss_family` field on this platform.Á\£ Ô¤ üË2 / Rust version of the [`sockaddr_storage`] type.Á þ ú ü‚a ^ This type is intended to be used with with direct calls to the `getsockname` syscall. See theÁ üä4 1 documentation of [`SockAddr::new`] for examples.Á ™ ú ü�^ [ This crate defines its own `sockaddr_storage` type to avoid semver concerns with upgradingÁ ”ü `windows-sys`.Á |¯ Ür +#ií?‡Ò3 )ÌÅ <Å ( ( ³�¤ã Ür+,- ¼Â üþ1 . Construct a new storage containing all zeros.Á4É Ür * *
|
|||
|
|
+ üõ
|
|||
|
|
" ü½
|
|||
|
|
% " Returns the size of this storage.Á<ü
|
|||
|
|
¤ ¤Ür * „ *
|
|||
|
|
, $… üó- üÌ # View this type as another type.Á ô ú dü # SafetyÁ � ú ü• P M The type `T` must be one of the `sockaddr_*` types defined by this platform.Á ê ú tò šõ <…
|
|||
|
|
Öú Ì‘
|
|||
|
|
# #[allow(dead_code)]Á ü¯
|
|||
|
|
% " # #[cfg(unix)] mod unix_example {Á ìÙ
|
|||
|
|
# use core::mem::size_of;Á üû
|
|||
|
|
use libc::sockaddr_storage;Á üŸ8 5 use socket2::{SockAddr, SockAddrStorage, socklen_t};Á Ü ú üäK H fn from_sockaddr_storage(recv_address: &sockaddr_storage) -> SockAddr {Á ü´4 1 let mut storage = SockAddrStorage::zeroed();Á üíL I let libc_address = unsafe { storage.view_as::<sockaddr_storage>() };Á ü¾& # *libc_address = *recv_address;Á üéU R unsafe { SockAddr::new(storage, size_of::<sockaddr_storage>() as socklen_t) }Á ,à }Á <Í # }Á <Ù Öú<� ¥ ¥Ür ¥ ¥ * ¥ . . Œ * ÍìØ£ ‰
|
|||
|
|
-Ø£$‘ ü¦( Ür0 Àc 0 üÕB Ø ¦ § ¨ ¦Ür § c c ˆ ¢cµ
|
|||
|
|
` £c bufÁ ` àB¤GS
|
|||
|
|
¨Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
ŸÈŸÈ È ErrorÁ O˜éBL / Ü /
|
|||
|
|
0 $Ý ± ã là �s238:;<=>?@ABCDEF ü—$M üôC @ Create a `SockAddr` from the underlying storage and its length.Á ¼ ú dÄ û› Õ ú üÝK H Caller must ensure that the address family and length match the type ofÁ üK H storage address. For example if `storage.ss_family` is set to `AF_INET`Á üýK H the `storage` must be initialised as `sockaddr_in`, setting the contentÁ ìÍ and length appropriately.Á ï ú t÷ šõ Š ú <’ Öú üž ( Ôõ ¤Ë # #[cfg(unix)] {Á „ä
|
|||
|
|
use std::io;Á ìù use std::os::fd::AsRawFd;Á › ú ü£ C @ use socket2::{SockAddr, SockAddrStorage, Socket, Domain, Type};Á ë ú üó @ = let socket = Socket::new(Domain::IPV4, Type::STREAM, None)?;Á ¸ ú üÀ = : // Initialise a `SocketAddr` by calling `getsockname(2)`.Á ü‚ 5 2 let mut addr_storage = SockAddrStorage::zeroed();Á ü¼ ) & let mut len = addr_storage.size_of();Á ê ú üò E B // The `getsockname(2)` system call will initialize `storage` forÁ ü¼ / , // us, setting `len` to the correct length.Á ´ð let res = unsafe {Á Ô‹! libc::getsockname(Á üª! socket.as_raw_fd(),Á üÎ!# addr_storage.view_as(),Á ¬ö! &mut len,Á L�" )Á 4ž" };Á ”©" if res == -1 {Á üÀ"/ , return Err(io::Error::last_os_error());Á ,ô" ‚¢ þ" ú ü†#> ; let address = unsafe { SockAddr::new(addr_storage, len) };Á ¤É# # drop(address);Á <â# �¢ dî# # Ok(())Á <ÿ# �¢ <‹$ Öú «$ Ür�s 1 1
|
|||
|
|
2 ·G‘Gü«2– üØ%; 8 Initialise a `SockAddr` by calling the function `init`.Á ˜& ú ü &L I The type of the address storage and length passed to the function `init`Á üñ& is OS/architecture specific.Á –' ú üž'F C The address is zeroed before `init` is called and is thus valid toÁ üé'K H dereference and read from. The length initialised to the maximum lengthÁ œ¹( of the storage.Á Ñ( ú dÙ( û› ê( ú üò(K ¦§ üÂ)K û§ ü’*K Ш ìâ* ¤© „+ ú tŒ+ šõ Ÿ+ ú <§+ Öú ü³+( Ôõ ¤à+ Šª „ù+ §ª ìŽ, Àª °, ú ü¸,2 / use socket2::{SockAddr, Socket, Domain, Type};Á ï, ú ü÷,@ Ì« ¼- ú üÄ-= ¢¬ ü†. let (_, address) = unsafe {Á üª.0 - SockAddr::try_init(|addr_storage, len| {Á üß.M J // The `getsockname(2)` system call will initialize `storage` forÁ ü±/7 4 // us, setting `len` to the correct length.Á üí/V S if libc::getsockname(socket.as_raw_fd(), addr_storage.cast(), len) == -1 {Á üÈ0/ , Err(io::Error::last_os_error())Á ¤ü0 } else {Á ´•1 Ok(())Á l°1
|
|||
|
|
}Á TÂ1 })Á <Ñ1 }?;Á ¤Ý1 ú± <ö1 �¢ d‚2 ¤² <“2 �¢ <Ÿ2 ÖúD¹2 —Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
¥�sßß ±¥ à… ¬
|
|||
|
|
ÑøÿËO Ÿ 1 — 4 ¥ 5 5 4 1 ÍìÕ¾ Â2 Í쪿 Å2 –"Õ¾ Ür üƒ3= Õ¾·À˜" Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
ª¿²¿l³3
|
|||
|
|
3Õ¾ª¿ initÁ$È2 ²´ ®° ìÐ3 dÖ3 ,·7 3 <closure_kind>Á 7 <closure_signature>Á 7 <upvars>Á 7 7 3 7Õ¾ª¿ ª¿¨¿ èÅÜrü�:Q üÑ8L I Constructs a `SockAddr` with the family `AF_UNIX` and the provided path.Á ¢9 ú üª9: 7 Returns an error if the path is longer than `SUN_LEN`.Á ú€”ó9 ¤ò9 üé9 $”: ¡Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
�s²¿ 1 ¡ 9 9 1 ÍìèÄ ™: à èÄ…0…0 õ� †0€ ß- bªŸðcÂ^ \Ò:
|
|||
|
|
8èÄõ
|
|||
|
|
$œ: SU üÌ<6 ü¡;" Set the length of the address.Á È; ú dÐ; û› á; ú üé;I F Caller must ensure that the address up to `length` bytes are properlyÁ „·<
|
|||
|
|
initialised.ÁTÚ< © ©�s 1 å< 1
|
|||
|
|
: $ê< ñ]4ð< üÒ=) ü«=" Returns this address's family.Á4ß= ª ª�s 1 æ= 1
|
|||
|
|
; $ç= üÑ>$ ü¨>$ ! Returns this address's `Domain`.Á4Þ> « «�s –{ 1 å> 1
|
|||
|
|
< $æ> üæ?$ ü³?. + Returns the size of this address in bytes.Á ó? ¬ ¬�s 1 ÷? 1
|
|||
|
|
= $ø? ü×@4 ü©@) & Returns a raw pointer to the address.Á4ä@ �s ‹” 1 ë@ 1
|
|||
|
|
> $ì@ ü�B0 üäA' $ Returns the address as the storage.ÁT�B �sÜr 1 1
|
|||
|
|
? `JüîC# ü•CT Q Returns true if this address is in the `AF_INET` (IPv4) family, false otherwise.Á<ûC ® ®�s 1 ƒD 1
|
|||
|
|
@ $„D üºE# üØDJ G Returns true if this address is in the `AF_INET6` (IPv6) family, falseÁ t§E otherwise.Á<ÇE ¯ ¯�s 1 ÏE 1
|
|||
|
|
A $ÐE ìéG ü¥F\ Y Returns true if this address is of a unix socket (for local interprocess communication),Á ü†G: 7 i.e. it is from the `AF_UNIX` family, false otherwise.Á ú€”ÏG ¤ÎG üÅG <ðG ° °�s 1 øG 1
|
|||
|
|
B $ùG üÜI- üÍHK H Returns this address as a `SocketAddr` if it is in the `AF_INET` (IPv4)Á ü�I: 7 or `AF_INET6` (IPv6) family, otherwise returns `None`.ÁLãI ± ±�s ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙÏs 1 íI 1
|
|||
|
|
C $îI üçT4 üŠTH E Returns this address as a [`SocketAddrV4`] if it is in the `AF_INET`Á \×T family.ÁtîT ² ²�s ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙ¬t 1 ýT 1
|
|||
|
|
D $þT üÿV4 ü¡VI F Returns this address as a [`SocketAddrV6`] if it is in the `AF_INET6`Á \ïV éÔt†W ³ ³�s ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙ†u 1 •W 1
|
|||
|
|
E $–W ÜèX DëX ´ ´�s ´
|
|||
|
|
1 ôX 1
|
|||
|
|
F $õX ü¬[" �sH ë H üÕ[% $Ø[ Ïs�s G G
|
|||
|
|
H øº$Ý[ ü‡]$ �sJ ë J ü²]' $µ] ¬t�s I I
|
|||
|
|
J øº$º] üƒg$ �sL ë L ü®g' $±g †u�s K K
|
|||
|
|
L øº$¶g ä”s �sN Àc N ü·s: ºs µ ¶ · µ�s ¶ c c ˆ ¢cµ
|
|||
|
|
` £c¨¤ ` àB¤GS
|
|||
|
|
·Ï¥ M ¾s M
|
|||
|
|
N $¿s × Ås Ü©y �sP ·ß P üËy" Îy ¸ ¹ ¸�s ¹�s O Ñy O
|
|||
|
|
P $Òy ¹
|
|||
|
|
,Øy ¤¥z �s ´¾z �sS ›e S üÛz3 $Þz º » º�s » ™ R ™ T T ùz R Íì˜ß ãz ¢e˜ß Œæz
|
|||
|
|
S˜ß$úz º,€{ +- T÷4 4û4 y«¬ÍÎ¸× ê ¤, U VŸ‘$ý ¦ U X ReadÁ$ƒ à U Y WriteÁ,‰ Ÿ! U Z£é<ð æL U \
|
|||
|
|
IoSliceMutÁTù ö U ]‚ê\” ÑÛ U ^ù¼Dè ̺ U _ netÁ$� ž" U a’ºD‡ ¾º U b ShutdownÁD‘ ¶M U c FromRawFdÁLñ + U e IntoRawFdÁLü ¯+ U fßšDá Ö U g‚5$ý É U i�ë,ƒ ¿¬ U j ü‰ETŠ Å U k¨ET– È U lX$¢ Ì U mãYLü œ U næ^4“ ì U pæ^ í U pô_D› „ U qô_ … U q¯[D¥ ³ U r È�ad¯ œ U só$½ ø U tó ù U tŽ<„¡ ñ U vŽ< ò U vöW4³ ‡ U wÀ`L» � U xÀ` ‘ U xDå·<óªøš�ˆ‹<æ~�gj¬Š]”ÞODö? û25 \ã
|
|||
|
|
|
|||
|
|
ô÷œÖêTðÝ ÷ÐÓ¾Á±´¥¨„õœ,‹�“psPS?B25,™ öøçéŒú üÈ ) & Owned wrapper around a system socket.Á ò ú üö M J This type simply wraps an instance of a file descriptor (`c_int`) on UnixÁ üÄ
|
|||
|
|
M J and an instance of `SOCKET` on Windows. This is the main type exported byÁ ü’ H E this crate and is intended to mirror the raw semantics of sockets onÁ üÛ F C platforms as closely as possible. Almost all methods correspond toÁ ü¢ I F precisely one libc or OS API call which is essentially just a "RusticÁ üì ! translation" of what's below.Á Ž
|
|||
|
|
ú ü’
|
|||
|
|
) & ## Converting to and from other typesÁ ¼
|
|||
|
|
ú üÀ
|
|||
|
|
M J This type can be freely converted into the network primitives provided byÁ üŽK H the standard library, such as [`TcpStream`] or [`UdpSocket`], using theÁ üÚ* ' [`From`] trait, see the example below.Á …ú ü‰& # [`TcpStream`]: std::net::TcpStreamÁ ü°& # [`UdpSocket`]: std::net::UdpSocketÁ ×ú \Û # NotesÁ çú üëM J Some methods that set options on `Socket` require two system calls to setÁ ü¹K H their options without overwriting previously set options. We do this byÁ ü…N K first getting the current settings, applying the desired changes, and thenÁ üÔP M updating the settings. This means that the operation is **not** atomic. ThisÁ ü¥N K can lead to a data race when two threads are changing options in parallel.Á ôú tøšõ l‡½õ ü•(Ôõ ü¾,†ö üë(¼ö ”ú ä˜ // create a TCP listenerÁ üµ@¸÷ öú üú=·ø ü¸! let address = address.into();Á ÜÚ socket.bind(&address)?;Á Äö©ù �ú ü“.×ù TÂŽú ¬Í¡ú tã¿ú <òÖú 4… šw ýÎ}AƒÏ z”’,’U y y â~\© šw|}~€‚ƒ†‡ˆ‰Š‹�Ž��‘’“”•–—˜™š›œ�žŸ ¡¢£¤¥¦§¨©ª üà5Dî šw { {
|
|||
|
|
| @ ÷ü¬ -4º ¼ ¼šw { Á {
|
|||
|
|
} $ ü� .D� šw { {
|
|||
|
|
~ $¦ üÛ"V üô / , Creates a new socket and sets common flags.Á ¨ ú ü° H E This function corresponds to `socket(2)` on Unix and `WSASocketW` onÁ dý Windows.Á Ž ú ü– J G On Unix-like systems, the close-on-exec flag is set on the new socket.Á üå I F Additionally, on Apple platforms `SOCK_NOSIGPIPE` is set. On Windows,Á ü³!' $ the socket is made non-inheritable.Á ß!ú üç!L I [`Socket::new_raw`] can be used if you don't want these flags to be set.Á ø3Ç#Ÿô¸"
|
|||
|
|
|
|||
|
|
Additional documentation can be found in manual of the OS:
|
|||
|
|
|
|||
|
|
* DragonFly BSD: <https://man.dragonflybsd.org/?command=socket§ion=2>
|
|||
|
|
* FreeBSD: <https://www.freebsd.org/cgi/man.cgi?query=socket&sektion=2>
|
|||
|
|
* Linux: <https://man7.org/linux/man-pages/man2/socket.2.html>
|
|||
|
|
* macOS: <https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/socket.2.html> (archived, actually for iOS)
|
|||
|
|
* NetBSD: <https://man.netbsd.org/socket.2>
|
|||
|
|
* OpenBSD: <https://man.openbsd.org/socket.2>
|
|||
|
|
* iOS: <https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/socket.2.html> (archived)
|
|||
|
|
* illumos: <https://illumos.org/man/3SOCKET/socket>
|
|||
|
|
* Windows: <https://docs.microsoft.com/en-us/windows/win32/api/winsock2/nf-winsock2-socket>
|
|||
|
|
Á â" –{Î{ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙ†|Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
šw²¿ { {
|
|||
|
|
è4æ"´ö"àGD€#ü‰&Z ü®$0 - Creates a new socket ready to be configured.Á ã$ú üë$Hå÷ ü¸%L I Windows and simply creates a new socket, no other configuration is done.Á<�& –{Î{Ø‚Ÿƒ { {
|
|||
|
|
€ è4˜&´¨&àGD²& �' € “Á � «Á � ÈÁ � � € � †| üá*€ üé'@ = Creates a pair of sockets which are connected to each other.Á ®(ú ü¶(1 . This function corresponds to `socketpair(2)`.Á ì(ú üô(E B This function sets the same flags as in done for [`Socket::new`],Á ü¾)J G [`Socket::pair_raw`] can be used if you don't want to set those flags.Á øHÅ%hü�*( ã
|
|||
|
|
|
|||
|
|
Additional documentation can be found in manual of the OS:
|
|||
|
|
|
|||
|
|
* DragonFly BSD: <https://man.dragonflybsd.org/?command=socketpair§ion=2>
|
|||
|
|
* FreeBSD: <https://www.freebsd.org/cgi/man.cgi?query=socketpair&sektion=2>
|
|||
|
|
* Linux: <https://man7.org/linux/man-pages/man2/socketpair.2.html>
|
|||
|
|
* macOS: <https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/socketpair.2.html> (archived, actually for iOS)
|
|||
|
|
* NetBSD: <https://man.netbsd.org/socketpair.2>
|
|||
|
|
* OpenBSD: <https://man.openbsd.org/socketpair.2>
|
|||
|
|
* iOS: <https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/socketpair.2.html> (archived)
|
|||
|
|
* illumos: <https://illumos.org/man/3SOCKET/socketpair>
|
|||
|
|
Á »£|Ä*ú $Õ*¼Ã*üº*"$è* –{Î{Ø‚Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
šwšw²¿ { {
|
|||
|
|
‚ è4ö*´Ž+àGD +üÜ.„ ü²-@“† ÷-ú üÿ-1é† »£|¿.ú $Ð.¼¾.üµ."Dã. –{Î{Ø‚‚� { {
|
|||
|
|
ƒ è4õ.´�/àGDŸ/ �0 ƒ “Á „ «Á „ ÈÁ „ „ ƒ „ó† DÚ0 ƒ “Á … «Á … ÈÁ … … ƒ … Ð� üÙ28 üš1/ , Binds this socket to the specified address.Á Î1ú üÖ1K H This function directly corresponds to the `bind(2)` function on WindowsÁ l¦2
|
|||
|
|
and Unix.Á ø`Ç#Ÿä¸2 Ž
|
|||
|
|
|
|||
|
|
Additional documentation can be found in manual of the OS:
|
|||
|
|
|
|||
|
|
* DragonFly BSD: <https://man.dragonflybsd.org/?command=bind§ion=2>
|
|||
|
|
* FreeBSD: <https://www.freebsd.org/cgi/man.cgi?query=bind&sektion=2>
|
|||
|
|
* Linux: <https://man7.org/linux/man-pages/man2/bind.2.html>
|
|||
|
|
* macOS: <https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/bind.2.html> (archived, actually for iOS)
|
|||
|
|
* NetBSD: <https://man.netbsd.org/bind.2>
|
|||
|
|
* OpenBSD: <https://man.openbsd.org/bind.2>
|
|||
|
|
* iOS: <https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/bind.2.html> (archived)
|
|||
|
|
* illumos: <https://illumos.org/man/3SOCKET/bind>
|
|||
|
|
* Windows: <https://docs.microsoft.com/en-us/windows/win32/api/winsock2/nf-winsock2-bind>
|
|||
|
|
Á$à2 ½ ¾ ½šw ¾�s Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
²¿ { å2 {
|
|||
|
|
† $æ2˜<ì2üä:; üÉ3B ? Initiate a connection on this socket to the specified address.Á �4ú ü˜4F C This function directly corresponds to the `connect(2)` function onÁ ¬ã4 Windows and Unix.Á ý4ú ü…5G D An error will be returned if `listen` or `connect` has already beenÁ ÜÑ5 called on this builder.Á øxÇ#Ÿüñ5 ©
|
|||
|
|
|
|||
|
|
Additional documentation can be found in manual of the OS:
|
|||
|
|
|
|||
|
|
* DragonFly BSD: <https://man.dragonflybsd.org/?command=connect§ion=2>
|
|||
|
|
* FreeBSD: <https://www.freebsd.org/cgi/man.cgi?query=connect&sektion=2>
|
|||
|
|
* Linux: <https://man7.org/linux/man-pages/man2/connect.2.html>
|
|||
|
|
* macOS: <https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/connect.2.html> (archived, actually for iOS)
|
|||
|
|
* NetBSD: <https://man.netbsd.org/connect.2>
|
|||
|
|
* OpenBSD: <https://man.openbsd.org/connect.2>
|
|||
|
|
* iOS: <https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/connect.2.html> (archived)
|
|||
|
|
* illumos: <https://illumos.org/man/3SOCKET/connect>
|
|||
|
|
* Windows: <https://docs.microsoft.com/en-us/windows/win32/api/winsock2/nf-winsock2-connect>
|
|||
|
|
Á •6ú \�6Øí 6ú üµ6A > When using a non-blocking connect (by setting the socket intoÁ üû6K H non-blocking mode before calling this function), socket option can't beÁ üË7E B set *while connecting*. This will cause errors on Windows. SocketÁ ü•8E B options can be safely set before and after connecting the socket.Á ß8ú üç8K H On Cygwin, a Unix domain socket connect blocks until the server acceptsÁ ü·9H E it. If the behavior is not expected, try [`Socket::set_no_peercred`]Á ”„: (Cygwin only).Á<ë: ¿ À ¿šw À�s ‰œ { ó: {
|
|||
|
|
‡ $ô:˜<ú:ü¬CS üÚ;G D Initiate a connection on this socket to the specified address, onlyÁ ü¦<F C only waiting for a certain period of time for the connection to beÁ „ñ<
|
|||
|
|
established.Á †=ú üŽ=J G Unlike many other methods on `Socket`, this does *not* correspond to aÁ üÝ=K H single C function. It sets the socket to nonblocking mode, connects viaÁ ü>J G connect(2), and then waits for the connection to complete with poll(2)Á üü>G D on Unix and select on Windows. When the connection is complete, theÁ üÈ?E B socket is set back to blocking mode. On Unix, this will loop overÁ œ’@ `EINTR` errors.Á ª@ú t²@ # WarningsÁ Å@ú üÍ@I F The non-blocking state of the socket is overridden by this function -Á ü›AL I it will be returned in blocking mode on success, and in an indeterminateÁ ¬ìA state on failure.Á †Bú üŽBJ G If the connection request times out, it may still be processing in theÁ üÝBJ G background - a second call to `connect` or `connect_timeout` may fail.Á|³C Á  Ášw Â�s Ó›‰œ { ÃC {
|
|||
|
|
ˆ $ÄCøº$ÊC timeoutÁ<ÛCüßJ6 üòGG D Mark a socket as ready to accept incoming connection requests usingÁ ̾H [`Socket::accept()`].Á ÜHú üäHE B This function directly corresponds to the `listen(2)` function onÁ ¬®I»� ÈIú üÐIGæ� ÜœJ¶ž ø�Ç#Ÿô¼J
|
|||
|
|
|
|||
|
|
Additional documentation can be found in manual of the OS:
|
|||
|
|
|
|||
|
|
* DragonFly BSD: <https://man.dragonflybsd.org/?command=listen§ion=2>
|
|||
|
|
* FreeBSD: <https://www.freebsd.org/cgi/man.cgi?query=listen&sektion=2>
|
|||
|
|
* Linux: <https://man7.org/linux/man-pages/man2/listen.2.html>
|
|||
|
|
* macOS: <https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/listen.2.html> (archived, actually for iOS)
|
|||
|
|
* NetBSD: <https://man.netbsd.org/listen.2>
|
|||
|
|
* OpenBSD: <https://man.openbsd.org/listen.2>
|
|||
|
|
* iOS: <https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/listen.2.html> (archived)
|
|||
|
|
* illumos: <https://illumos.org/man/3SOCKET/listen>
|
|||
|
|
* Windows: <https://docs.microsoft.com/en-us/windows/win32/api/winsock2/nf-winsock2-listen>
|
|||
|
|
Á4æJ à Úw ‰œ { íJ {
|
|||
|
|
‰ $îJ backlogÁ<ôJüëP6 üÏK8 5 Accept a new incoming connection from this listener.Á ŒLú ü”LD A This function uses `accept4(2)` on platforms that support it andÁ üÝL& # `accept(2)` platforms that do not.Á ˆMú ü�ME°‡ üÚML I [`Socket::accept_raw`] can be used if you don't want to set those flags.Á ø¨Ç#Ÿô«N
|
|||
|
|
|
|||
|
|
Additional documentation can be found in manual of the OS:
|
|||
|
|
|
|||
|
|
* DragonFly BSD: <https://man.dragonflybsd.org/?command=accept§ion=2>
|
|||
|
|
* FreeBSD: <https://www.freebsd.org/cgi/man.cgi?query=accept&sektion=2>
|
|||
|
|
* Linux: <https://man7.org/linux/man-pages/man2/accept.2.html>
|
|||
|
|
* macOS: <https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/accept.2.html> (archived, actually for iOS)
|
|||
|
|
* NetBSD: <https://man.netbsd.org/accept.2>
|
|||
|
|
* OpenBSD: <https://man.openbsd.org/accept.2>
|
|||
|
|
* iOS: <https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/accept.2.html> (archived)
|
|||
|
|
* illumos: <https://illumos.org/man/3SOCKET/accept>
|
|||
|
|
* Windows: <https://docs.microsoft.com/en-us/windows/win32/api/winsock2/nf-winsock2-accept>
|
|||
|
|
Á ÎNú \ÖNØí æNú üîNK‡¨ ü¾OHܨ ”‹P©4òP Ä Äšw Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
šw�s²¿ { ùP {
|
|||
|
|
Š $úPüå\: ü¼[8ô¼ ù[ú ü�\E B This function directly corresponds to the `accept(2)` function onÁ ¬Ë\»�Tì\ Å Åšw ÒÇ { ÷\ {
|
|||
|
|
‹ $ø\|É] ‹ “Á Œ «Á Œ ÈÁ Œ Œ ‹ Œ �s È ü„a0 ü…^@ = Returns the socket address of the local half of this socket.Á Ê^ú üÒ^J G This function directly corresponds to the `getsockname(2)` function onÁ ¬¡_»� øÀÇ#Ÿü»_# Í
|
|||
|
|
|
|||
|
|
Additional documentation can be found in manual of the OS:
|
|||
|
|
|
|||
|
|
* DragonFly BSD: <https://man.dragonflybsd.org/?command=getsockname§ion=2>
|
|||
|
|
* FreeBSD: <https://www.freebsd.org/cgi/man.cgi?query=getsockname&sektion=2>
|
|||
|
|
* Linux: <https://man7.org/linux/man-pages/man2/getsockname.2.html>
|
|||
|
|
* macOS: <https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/getsockname.2.html> (archived, actually for iOS)
|
|||
|
|
* NetBSD: <https://man.netbsd.org/getsockname.2>
|
|||
|
|
* OpenBSD: <https://man.openbsd.org/getsockname.2>
|
|||
|
|
* iOS: <https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/getsockname.2.html> (archived)
|
|||
|
|
* illumos: <https://illumos.org/man/3SOCKET/getsockname>
|
|||
|
|
* Windows: <https://docs.microsoft.com/en-us/windows/win32/api/winsock2/nf-winsock2-getsockname>
|
|||
|
|
Á ã_ú \ë_Øí û_ú üƒ`E B Depending on the OS this may return an error if the socket is notÁ dÍ` [bound].Á Þ`ú Ìæ` [bound]: Socket::bindÁT‹a Æ Æšw íÄ { –a {
|
|||
|
|
� $—aüÚd/ üêaA > Returns the socket address of the remote peer of this socket.Á °bú ü¸bJ G This function directly corresponds to the `getpeername(2)` function onÁ ¬‡c»� øØÇ#Ÿü¡c# Í
|
|||
|
|
|
|||
|
|
Additional documentation can be found in manual of the OS:
|
|||
|
|
|
|||
|
|
* DragonFly BSD: <https://man.dragonflybsd.org/?command=getpeername§ion=2>
|
|||
|
|
* FreeBSD: <https://www.freebsd.org/cgi/man.cgi?query=getpeername&sektion=2>
|
|||
|
|
* Linux: <https://man7.org/linux/man-pages/man2/getpeername.2.html>
|
|||
|
|
* macOS: <https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/getpeername.2.html> (archived, actually for iOS)
|
|||
|
|
* NetBSD: <https://man.netbsd.org/getpeername.2>
|
|||
|
|
* OpenBSD: <https://man.openbsd.org/getpeername.2>
|
|||
|
|
* iOS: <https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/getpeername.2.html> (archived)
|
|||
|
|
* illumos: <https://illumos.org/man/3SOCKET/getpeername>
|
|||
|
|
* Windows: <https://docs.microsoft.com/en-us/windows/win32/api/winsock2/nf-winsock2-getpeername>
|
|||
|
|
Á Écú \ÑcØí ácú üéc= : This returns an error if the socket is not [`connect`ed].Á «dú ü³d" [`connect`ed]: Socket::connectÁLád Ç Çšw íÄ { ëd {
|
|||
|
|
Ž $ìdü¤f( ü¿eK H Returns the [`Type`] of this socket by checking the `SO_TYPE` option onÁ „�f
|
|||
|
|
this socket.Á4«f È Èšw Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
Î{²¿ { ²f {
|
|||
|
|
� $³füòk- ü¹gF C Creates a new independently owned handle to the underlying socket.Á „hú \ŒhØí œhú ü¤hI F On Unix this uses `F_DUPFD_CLOEXEC` and thus sets the `FD_CLOEXEC` onÁ Äòh the returned socket.Á �iú ü—iK H On Windows this uses `WSA_FLAG_NO_HANDLE_INHERIT` setting inheriting toÁ Tçi false.Á öiú üþiD A On Windows this can **not** be used function cannot be used on aÁ ÜÇj QOS-enabled socket, seeÁ üçjb _ <https://docs.microsoft.com/en-us/windows/win32/api/winsock2/nf-winsock2-wsaduplicatesocketw>.Á ú€”Øk¤×küÎk Lùk É Éšw Ÿƒ { ƒl {
|
|||
|
|
� $„lü‚p- üélL I Returns true if this socket is set to nonblocking mode, false otherwise.Á ºmú \ÂmØí Òmú üÚmF C On Unix this corresponds to calling `fcntl` returning the value ofÁ Œ¥n `O_NONBLOCK`.Á »nú üÃnG D On Windows it is not possible retrieve the nonblocking mode status.Á »£|¢oú $¿o ú€”Éoî‘ŒáoœàoüÈo,ü¾o7ü˜ocü�on\‰p Ê Êšw Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
²¿ { •p {
|
|||
|
|
‘ $–püòrB üåp6 3 Moves this socket into or out of nonblocking mode.Á qú \¨qØí ¸qú üÀqI F On Unix this corresponds to calling `fcntl` (un)setting `O_NONBLOCK`.Á Žrú ü–rD A On Windows this corresponds to calling `ioctlsocket` (un)settingÁ tßr `FIONBIO`.Á|ùr Ë Ëšw ‰œ { ‰s {
|
|||
|
|
’ $Šs‹
|
|||
|
|
\�süþu7 üûsB ? Shuts down the read, write, or both halves of this connection.Á Âtú üÊtH E This function will cause all pending and future I/O on the specifiedÁ ü—u= : portions to return immediately with an appropriate value.Á øðÇ#ŸüÙu ²
|
|||
|
|
|
|||
|
|
Additional documentation can be found in manual of the OS:
|
|||
|
|
|
|||
|
|
* DragonFly BSD: <https://man.dragonflybsd.org/?command=shutdown§ion=2>
|
|||
|
|
* FreeBSD: <https://www.freebsd.org/cgi/man.cgi?query=shutdown&sektion=2>
|
|||
|
|
* Linux: <https://man7.org/linux/man-pages/man2/shutdown.2.html>
|
|||
|
|
* macOS: <https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/shutdown.2.html> (archived, actually for iOS)
|
|||
|
|
* NetBSD: <https://man.netbsd.org/shutdown.2>
|
|||
|
|
* OpenBSD: <https://man.openbsd.org/shutdown.2>
|
|||
|
|
* iOS: <https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/shutdown.2.html> (archived)
|
|||
|
|
* illumos: <https://illumos.org/man/3SOCKET/shutdown>
|
|||
|
|
* Windows: <https://docs.microsoft.com/en-us/windows/win32/api/winsock2/nf-winsock2-shutdown>
|
|||
|
|
ÁD…v Ì Ìšw ¶M·M¸MÄß ¹MºMÛß »M¼M BothÁ lÏÏ‘£A2Í ‰œ { Žv {
|
|||
|
|
“ $�v howÁ •vüµ~D üívF C Receives data on the socket from the remote address to which it isÁ t¸w connected.Á Ëwú üÓwH E The [`connect`] method will connect this socket to a remote address.Á ü x: 7 This method might fail if the socket is not connected.Á øˆÇ#Ÿäßx Ž
|
|||
|
|
|
|||
|
|
Additional documentation can be found in manual of the OS:
|
|||
|
|
|
|||
|
|
* DragonFly BSD: <https://man.dragonflybsd.org/?command=recv§ion=2>
|
|||
|
|
* FreeBSD: <https://www.freebsd.org/cgi/man.cgi?query=recv&sektion=2>
|
|||
|
|
* Linux: <https://man7.org/linux/man-pages/man2/recv.2.html>
|
|||
|
|
* macOS: <https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/recv.2.html> (archived, actually for iOS)
|
|||
|
|
* NetBSD: <https://man.netbsd.org/recv.2>
|
|||
|
|
* OpenBSD: <https://man.openbsd.org/recv.2>
|
|||
|
|
* iOS: <https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/recv.2.html> (archived)
|
|||
|
|
* illumos: <https://illumos.org/man/3SOCKET/recv>
|
|||
|
|
* Windows: <https://docs.microsoft.com/en-us/windows/win32/api/winsock2/nf-winsock2-recv>
|
|||
|
|
Á €yú üˆy [`connect`]: Socket::connectÁ yú dµyû› Æyú üÎyG D Normally casting a `&mut [u8]` to `&mut [MaybeUninit<u8>]` would beÁ üšzJ G unsound, as that allows us to write uninitialised bytes to the buffer.Á üézL I However this implementation promises to not write uninitialised bytes toÁ üº{F C the `buf`fer and passes it directly to `recv(2)` system call. ThisÁ ü…|H E promise ensures that this function can be called using a `buf`fer ofÁ ¬Ò| type `&mut [u8]`.Á ì|ú üô|L I Note that the [`io::Read::read`] implementation calls this function withÁ üÅ}K H a `buf`fer of type `&mut [u8]`, allowing initialised buffers to be usedÁ Ü•~ without using `unsafe`.Á$¼~ Í Î Íšw Î
|
|||
|
|
ÑÛÑÛ ‚ê ÓÛ uninitÁÝ ÔÛ»Ý Íõƒ«%9Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
²¿ { Á~ {
|
|||
|
|
” $Â~¨¤ È~üç‚P ü¬L I Receives out-of-band (OOB) data on the socket from the remote address toÁ üýF C which it is connected by setting the `MSG_OOB` flag for this call.Á È€ú üЀ? < For more information, see [`recv`], [`out_of_band_inline`].Á ”�ú Ôœ� [`recv`]: Socket::recvÁ ü»�6 3 [`out_of_band_inline`]: Socket::out_of_band_inlineÁ ú€”Í‚¤Ì‚ü „î‚ Ï Ð Ïšw Ðᆪ‡ { ÿ‚ {
|
|||
|
|
• $€ƒ¨¤ †ƒü‘…� üõƒL I Identical to [`recv`] but allows for specification of arbitrary flags toÁ üÆ„ the underlying `recv` call.Á ê„ú Ôò„Á‰|˜… Ñ Ò Ñšw Òᆪ‡ { ±… {
|
|||
|
|
– $²…¨¤ À…ØZ,å…ü“‘w ü͆F—÷ ü˜‡D A connected. Unlike [`recv`] this allows passing multiple buffers.Á á‡ú üé‡HŠø ü¶ˆ:Üø õˆú üýˆL I In addition to the number of bytes read, this function returns the flagsÁ üΉJ G for the received message. See [`RecvFlags`] for more information aboutÁ ¼�Š the returned flags.Á ø Ç#Ÿü¹Š ©
|
|||
|
|
|
|||
|
|
Additional documentation can be found in manual of the OS:
|
|||
|
|
|
|||
|
|
* DragonFly BSD: <https://man.dragonflybsd.org/?command=recvmsg§ion=2>
|
|||
|
|
* FreeBSD: <https://www.freebsd.org/cgi/man.cgi?query=recvmsg&sektion=2>
|
|||
|
|
* Linux: <https://man7.org/linux/man-pages/man2/recvmsg.2.html>
|
|||
|
|
* macOS: <https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/recvmsg.2.html> (archived, actually for iOS)
|
|||
|
|
* NetBSD: <https://man.netbsd.org/recvmsg.2>
|
|||
|
|
* OpenBSD: <https://man.openbsd.org/recvmsg.2>
|
|||
|
|
* iOS: <https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/recvmsg.2.html> (archived)
|
|||
|
|
* illumos: <https://illumos.org/man/3SOCKET/recvmsg>
|
|||
|
|
* Windows: <https://docs.microsoft.com/en-us/windows/win32/api/winsock2/nf-winsock2-recvmsg>
|
|||
|
|
Á ÝŠú ÔåŠÁ‰ ü„‹ Îÿ ©‹ú d±‹û› ‹ú üÊ‹K H Normally casting a `IoSliceMut` to `MaybeUninitSlice` would be unsound,Á üšŒI F as that allows us to write uninitialised bytes to the buffer. HoweverÁ üèŒH E this implementation promises to not write uninitialised bytes to theÁ üµ�K H `bufs` and passes it directly to `recvmsg(2)` system call. This promiseÁ ü…ŽG D ensures that this function can be called using `bufs` of type `&mutÁ ”ÑŽ [IoSliceMut]`.Á èŽú üðŽG D Note that the [`io::Read::read_vectored`] implementation calls thisÁ ü¼�J G function with `buf`s of type `&mut [IoSliceMut]`, allowing initialisedÁ ü‹�. + buffers to be used without using `unsafe`.Á ú redoxÁœÌ�ú€”á�ú horizonÁ¬õ�üË�@üÇ�Eü¾�Plš‘ Ó Ô Õ Óšw Ô
|
|||
|
|
ñ ñ òŽ< ôˆ ëp%×—µí ÕÖ¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
¾|²¿ { ±‘ {
|
|||
|
|
— $²‘ bufsÁ$À‘ü§–˜ üÇ’L I Identical to [`recv_vectored`] but allows for specification of arbitraryÁ ü˜“5 2 flags to the underlying `recvmsg`/`WSARecv` call.Á Ò“ú üÚ“, ) [`recv_vectored`]: Socket::recv_vectoredÁ ‹”ú d“”û› ¤”ú ü¬”J G `recv_from_vectored` makes the same safety guarantees regarding `bufs`Á Ìû” as [`recv_vectored`].Á ™•ú ü¡•,é úóœœà•ú€”õ•ú’�¬‰–üß•@üÛ•EüÒ•PÄ®– Ö × Ø Öšw ×
|
|||
|
|
ñ ñ òŽ< ôˆ ëp%×—µí جŸ { Ж {
|
|||
|
|
˜ $Ñ–§Ÿ$ß–ØZ,Š—üƒœD ü„˜F—÷ üϘE B connected, without removing that data from the queue. On success,Á ü™™' $ returns the number of bytes peeked.Á Å™ú üÍ™J G Successive calls return the same data. This is accomplished by passingÁ üœš> ; `MSG_PEEK` as a flag to the underlying `recv` system call.Á ßšú dçšû› øšú ü€›E B `peek` makes the same safety guarantees regarding the `buf`fer asÁ lÊ›
|
|||
|
|
[`recv`].Á Ü›ú Ôä›Á‰$Šœ Ù Ú Ùšw Úᆪ‡ { �œ {
|
|||
|
|
™ $�œ¨¤ –œüÛŸU ü†�J G Receives data from the socket. On success, returns the number of bytesÁ üÕ�3 0 read and the address from whence the data came.Á ø¸Ç#Ÿü�ž ²
|
|||
|
|
|
|||
|
|
Additional documentation can be found in manual of the OS:
|
|||
|
|
|
|||
|
|
* DragonFly BSD: <https://man.dragonflybsd.org/?command=recvfrom§ion=2>
|
|||
|
|
* FreeBSD: <https://www.freebsd.org/cgi/man.cgi?query=recvfrom&sektion=2>
|
|||
|
|
* Linux: <https://man7.org/linux/man-pages/man2/recvfrom.2.html>
|
|||
|
|
* macOS: <https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/recvfrom.2.html> (archived, actually for iOS)
|
|||
|
|
* NetBSD: <https://man.netbsd.org/recvfrom.2>
|
|||
|
|
* OpenBSD: <https://man.openbsd.org/recvfrom.2>
|
|||
|
|
* iOS: <https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/recvfrom.2.html> (archived)
|
|||
|
|
* illumos: <https://illumos.org/man/3SOCKET/recvfrom>
|
|||
|
|
* Windows: <https://docs.microsoft.com/en-us/windows/win32/api/winsock2/nf-winsock2-recvfrom>
|
|||
|
|
Á ²žú dºžû› Ëžú üÓžJ G `recv_from` makes the same safety guarantees regarding the `buf`fer asÁ l¢Ÿ‰¨ ´Ÿú Ô¼ŸÁ‰LâŸ Û Ü Ûšw Üá†Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
�s²¿ { ìŸ {
|
|||
|
|
š $ퟨ¤ óŸü—¢� üè H E Identical to [`recv_from`] but allows for specification of arbitraryÁ üµ¡, ) flags to the underlying `recvfrom` call.Á æ¡ú üî¡$ ! [`recv_from`]: Socket::recv_fromÁ¤ž¢ Ý Þ Ýšw Þá†á³ { ¼¢ {
|
|||
|
|
› $½¢¨¤ Ë¢ØZ,ð¢ü«¨† üä£H E Receives data from the socket. Returns the amount of bytes read, theÁ ü±¤H E [`RecvFlags`] and the remote address from the data is coming. UnlikeÁ üþ¤7 4 [`recv_from`] this allows passing multiple buffers.Á øÐÇ#Ÿüº¥ »� Þ¥ú üæ¥$Žµ �¦ú d—¦û› ¨¦ú ü°¦JÈ¡ Ìÿ¦œ¢ �§ú ü¥§,é úóœœä§ú€”ù§ú’�¬�¨üã§@üߧEüÖ§P”²¨ ß à á ßšw à
|
|||
|
|
ñ ñ òŽ< ôˆ ëp%×—µí áÖ¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
¾|�s²¿ { Ψ {
|
|||
|
|
œ $Ϩ§Ÿ$ݨüæ§ üó©G D Identical to [`recv_from_vectored`] but allows for specification ofÁ ü¿ªC @ arbitrary flags to the underlying `recvmsg`/`WSARecvFrom` call.Á ‡«ú ü�«6 3 [`recv_from_vectored`]: Socket::recv_from_vectoredÁ Ê«ú dÒ«û› ã«ú üë«JÈ¡ ̺¬œ¢ جú üà¬,é ú󜜟ú€”´ú’�¬Èüž@üšEü‘Pìí â ã ä âšw ã
|
|||
|
|
ñ ñ òŽ< ôˆ ëp%×—µí äå» { ”® {
|
|||
|
|
� $•®§Ÿ$£®ØZ,ήüç¹U üׯF C Receives data from the socket, without removing it from the queue.Á ¢°ú üª°Jô¥ üù°B ? `MSG_PEEK` as a flag to the underlying `recvfrom` system call.Á À±ú üȱG D On success, returns the number of bytes peeked and the address fromÁ Ì”² whence the data came.Á ²²ú dº²û› ˲ú üÓ²J G `peek_from` makes the same safety guarantees regarding the `buf`fer asÁ l¢³‰¨ ´³ú ä¼³ # Note: Datagram SocketsÁ üݳP M For datagram sockets, the behavior of this method when `buf` is smaller thanÁ ü²´M J the datagram at the head of the receive queue differs between Windows andÁ ü„µN K Unix-like platforms (Linux, macOS, BSDs, etc: colloquially termed "*nix").Á ×µú üßµH E On *nix platforms, the datagram is truncated to the length of `buf`.Á ¬¶ú ü´¶I F On Windows, an error corresponding to `WSAEMSGSIZE` will be returned.Á ‚·ú üŠ·^ [ For consistency between platforms, be sure to provide a sufficiently large buffer to avoidÁ üí·K H truncation; the exact size required depends on the underlying protocol.Á ½¸ú üŸI F If you just want to know the sender of the data, try [`peek_sender`].Á “¹ú Ô›¹Á‰ üº¹( % [`peek_sender`]: Socket::peek_senderÁLî¹ å æ åšw æá†á³ { ø¹ {
|
|||
|
|
ž $ù¹¨¤ ÿ¹ü�½1 ü€»F C Retrieve the sender for the data at the head of the receive queue.Á Ë»ú üÓ»I F This is equivalent to calling [`peek_from`] with a zero-sized buffer,Á ü¡¼6 3 but suppresses the `WSAEMSGSIZE` error on Windows.Á ܼú üä¼$ ! [`peek_from`]: Socket::peek_fromÁ\”½ ç çšw íÄ { ½ {
|
|||
|
|
Ÿ $¡½üüÁ^ üô½> ; Receive a message from a socket using a message structure.Á ·¾ú ü¿¾K H This is not supported on Windows as calling `WSARecvMsg` (the `recvmsg`Á ü�¿7 4 equivalent) is not straight forward on Windows. SeeÁ üË¿› ˜ <https://github.com/microsoft/Windows-classic-samples/blob/7cbd99ac1d2b4a0beffbaba29ea63d024ceff700/Samples/Win7Samples/netds/winsock/recvmsg/rmmc.cpp>Á äëÀ for an example (in C++).Á øèÇ#ŸüŒÁ »� ú $ºÁúóœœÈÁú’�¬ÝÁüÇÁ,üÃÁ1ü¹Á<ü°ÁG<ƒÂ è é ê ë ì èšw é œ œ ãY € ¡¶X œB6I‰æG ê ë 쪇 { ‹Â {
|
|||
|
|
$ŒÂ msgÁ ’ÂØZ,³Âü£Å3 ü˜Ã1 . Sends data on the socket to a connected peer.Á ÎÃú üÖÃH E This is typically used on TCP sockets or datagram sockets which haveÁ œ£Ä been connected.Á »Äú üÃÄ: 7 On success returns the number of bytes that were sent.Á ø€Ç#Ÿä‚Å Ž
|
|||
|
|
|
|||
|
|
Additional documentation can be found in manual of the OS:
|
|||
|
|
|
|||
|
|
* DragonFly BSD: <https://man.dragonflybsd.org/?command=send§ion=2>
|
|||
|
|
* FreeBSD: <https://www.freebsd.org/cgi/man.cgi?query=send&sektion=2>
|
|||
|
|
* Linux: <https://man7.org/linux/man-pages/man2/send.2.html>
|
|||
|
|
* macOS: <https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/send.2.html> (archived, actually for iOS)
|
|||
|
|
* NetBSD: <https://man.netbsd.org/send.2>
|
|||
|
|
* OpenBSD: <https://man.openbsd.org/send.2>
|
|||
|
|
* iOS: <https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/send.2.html> (archived)
|
|||
|
|
* illumos: <https://illumos.org/man/3SOCKET/send>
|
|||
|
|
* Windows: <https://docs.microsoft.com/en-us/windows/win32/api/winsock2/nf-winsock2-send>
|
|||
|
|
Á$ªÅ í î íšw î±Ù ª‡ { ¯Å {
|
|||
|
|
¡ $°Å¨¤ ¶Åü¥ÇL ü‰Æ[ X Identical to [`send`] but allows for specification of arbitrary flags to the underlyingÁ „éÆ
|
|||
|
|
`send` call.Á þÆú  [`send`]: Socket::sendÁ|¬Ç ï ð ïšw ð±Ù ª‡ { ¼Ç {
|
|||
|
|
¢ $½Ç¨¤ ÃÇØZ,ÏÇüÏÉF ü¬ÈI F Send data to the connected peer. Returns the amount of bytes written.Á ú󜜈Éú€”�Éú’�¬±Éü‡É@üƒÉEüúÈPlÖÉ ñ ò ó ñšw ò
|
|||
|
|
æLæL çL£é éLˆ¦ —óë@M$ T ó ª‡ { äÉ {
|
|||
|
|
£ $åɧŸ$ëÉü�Í~ üÒÊL I Identical to [`send_vectored`] but allows for specification of arbitraryÁ ü£Ë5 2 flags to the underlying `sendmsg`/`WSASend` call.Á ø˜Ç#ŸüÝË ©
|
|||
|
|
|
|||
|
|
Additional documentation can be found in manual of the OS:
|
|||
|
|
|
|||
|
|
* DragonFly BSD: <https://man.dragonflybsd.org/?command=sendmsg§ion=2>
|
|||
|
|
* FreeBSD: <https://www.freebsd.org/cgi/man.cgi?query=sendmsg&sektion=2>
|
|||
|
|
* Linux: <https://man7.org/linux/man-pages/man2/sendmsg.2.html>
|
|||
|
|
* macOS: <https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/sendmsg.2.html> (archived, actually for iOS)
|
|||
|
|
* NetBSD: <https://man.netbsd.org/sendmsg.2>
|
|||
|
|
* OpenBSD: <https://man.openbsd.org/sendmsg.2>
|
|||
|
|
* iOS: <https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/sendmsg.2.html> (archived)
|
|||
|
|
* illumos: <https://illumos.org/man/3SOCKET/sendmsg>
|
|||
|
|
* Windows: <https://docs.microsoft.com/en-us/windows/win32/api/winsock2/nf-winsock2-sendmsg>
|
|||
|
|
Á �Ìú ü‰Ì, ) [`send_vectored`]: Socket::send_vectoredÁ úóœœÈÌú€”ÝÌú’�¬ñÌüÇÌ@üÃÌEüºÌPÄ–Í ô õ ö ôšw õ
|
|||
|
|
æLæL çL£é éLˆ¦ —óë@M$ T ö ª‡ { ¸Í {
|
|||
|
|
¤ $¹Í§Ÿ$ÇÍØZ,åÍüëÑ? üÒÎ@ = Sends out-of-band (OOB) data on the socket to connected peerÁ ü—Ï0 - by setting the `MSG_OOB` flag for this call.Á ÌÏú üÔÏ? < For more information, see [`send`], [`out_of_band_inline`].Á ˜Ðú Ô Ð ß ü¿Ð6æ‰ ú€”ÑѤÐÑüÇÑ „òÑ ÷ ø ÷šw ø±Ù ª‡ { ƒÒ {
|
|||
|
|
¥ $„Ò¨¤ ŠÒüÇÔG üèÒJ G Sends data on the socket to the given address. On success, returns theÁ ä·Ó number of bytes written.Á ØÓú üàÓ? < This is typically used on UDP or datagram-oriented sockets.Á ø°Ç#Ÿô¤Ô
|
|||
|
|
|
|||
|
|
Additional documentation can be found in manual of the OS:
|
|||
|
|
|
|||
|
|
* DragonFly BSD: <https://man.dragonflybsd.org/?command=sendto§ion=2>
|
|||
|
|
* FreeBSD: <https://www.freebsd.org/cgi/man.cgi?query=sendto&sektion=2>
|
|||
|
|
* Linux: <https://man7.org/linux/man-pages/man2/sendto.2.html>
|
|||
|
|
* macOS: <https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/sendto.2.html> (archived, actually for iOS)
|
|||
|
|
* NetBSD: <https://man.netbsd.org/sendto.2>
|
|||
|
|
* OpenBSD: <https://man.openbsd.org/sendto.2>
|
|||
|
|
* iOS: <https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/sendto.2.html> (archived)
|
|||
|
|
* illumos: <https://illumos.org/man/3SOCKET/sendto>
|
|||
|
|
* Windows: <https://docs.microsoft.com/en-us/windows/win32/api/winsock2/nf-winsock2-sendto>
|
|||
|
|
Á<ÎÔ ù ú û ùšw ú±Ù û�s ª‡ { ÖÔ {
|
|||
|
|
¦ $×Ô¨¤ ÝÔøº$éÔüñÖ‡ üÊÕL I Identical to [`send_to`] but allows for specification of arbitrary flagsÁ ü›Ö$ ! to the underlying `sendto` call.Á ÄÖú üÌÖ [`send_to`]: Socket::send_toÁ”øÖ ü ý þ üšw ý±Ù þ�s ª‡ { ”× {
|
|||
|
|
§ $•×¨¤ £×øº$·×ØZ,Ð×ü“ÚZ ü¼ØH E Send data to a peer listening on `addr`. Returns the amount of bytesÁ d‰Ù written.Á øÈÇ#ŸüšÙ ¥ä úóœœÌÙú€”áÙú’�¬õÙüËÙ@üÇÙEü¾ÙP„šÚ ÿ € � ‚ ÿšw €
|
|||
|
|
æLæL çL£é éLˆ¦ —óë@M$ T � ‚�s ª‡ { «Ú {
|
|||
|
|
¨ $¬Ú§Ÿ$²Úøº$ÈÚü×Ýš ü³ÛE B Identical to [`send_to_vectored`] but allows for specification ofÁ üýÛA > arbitrary flags to the underlying `sendmsg`/`WSASendTo` call.Á ÃÜú üËÜ2 / [`send_to_vectored`]: Socket::send_to_vectoredÁ úóœœ�Ýú€”¥Ýú’�¬¹Ýü�Ý@ü‹ÝEü‚ÝPÜÞÝ ƒ „ … † ƒšw „
|
|||
|
|
æLæL çL£é éLˆ¦ —óë@M$ T … †�s ª‡ { ƒÞ {
|
|||
|
|
© $„Þ§Ÿ$’Þøº$°ÞØZ,ÉÞüöàW ü¿ß9 6 Send a message on a socket using a message structure.Á øàÇ#Ÿüýß ¥ä ú󜜯àú€”Äàú’�¬Øàü®à@üªàEü¡àP<ýà ‡ ˆ ‰ Š ‹ ‡šw ˆ ‡ ‡ öW ‹€ Œ¶X KDÑ[6õ\ ‰ Š ‹ ª‡ { …á {
|
|||
|
|
ª $†áÏÔ ŒáØZ,¦áüúâ*|ƒã U Î{Î{
|
|||
|
|
« ´°LüÑè9„Ôè U šwŸƒ
|
|||
|
|
¬ Ú4åè\Ñÿ ü³ý. + Socket options get/set using `SOL_SOCKET`.Á âýú üæýE B Additional documentation can be found in documentation of the OS.Á ü¬þB ? * Linux: <https://man7.org/linux/man-pages/man7/socket.7.html>Á üïþa ^ * Windows: <https://docs.microsoft.com/en-us/windows/win32/winsock/sol-socket-socket-options>Á šw®°±²´µ¶·¹º¼½¿ÀÂÃÄÅÇÈÊËÌ ü¯�+ üãÿ? < Get the value of the `SO_BROADCAST` option for this socket.Á §€ú ü¯€B ? For more information about this option, see [`set_broadcast`].Á ö€ú üþ€, ) [`set_broadcast`]: Socket::set_broadcastÁL¶� Œ Œšw ±ê À�
|
|||
|
|
® $Á�\Ö‚ ® “Á ¯ «Á ¯ ÈÁ ¯ ¯ ® ¯ ü°„> ü‡ƒ? < Set the value of the `SO_BROADCAST` option for this socket.Á ˃ú üÓƒG D When enabled, this socket is allowed to send packets to a broadcastÁ dŸ„ address.Ál·„ � �šw ‰œ Å„
|
|||
|
|
° $Æ„Å"LÌ„üºˆ9 üĆ: 7 Get the value of the `SO_ERROR` option on this socket.Á ƒ‡ú ü‹‡J G This will retrieve the stored error in the underlying socket, clearingÁ üÚ‡L I the field in the process. This can be useful for checking errors betweenÁ T«ˆ calls.ÁTÁˆ Ž Žšw Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙ²¿²¿ ̈
|
|||
|
|
± $͈ü½Œ+ üòŠ> ; Get the value of the `SO_KEEPALIVE` option on this socket.Á µ‹ú ü½‹B ? For more information about this option, see [`set_keepalive`].Á „Œú üŒŒ, ) [`set_keepalive`]: Socket::set_keepaliveÁLÄŒ � �šw ±ê ÎŒ
|
|||
|
|
² $ÏŒ\ã� ² “Á ³ «Á ³ ÈÁ ³ ³ ² ³ÈŽ üª�> ü”Ž; 8 Set value for the `SO_KEEPALIVE` option on this socket.Á ÔŽú üÜŽI F Enable sending of keep-alive messages on connection-oriented sockets.Ál±� � �šw ‰œ ¿�
|
|||
|
|
´ $À�‚#LÆ�üý’4 ü¾‘; 8 Get the value of the `SO_LINGER` option on this socket.Á þ‘ú ü†’? < For more information about this option, see [`set_linger`].Á Ê’ú üÒ’& # [`set_linger`]: Socket::set_lingerÁ4„“ ‘ ‘šw Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
„ž²¿ ‹“
|
|||
|
|
µ $Œ“üõ™D üÒ”8 5 Set value for the `SO_LINGER` option on this socket.Á �•ú ü—•H E If `linger` is not `None`, a close(2) or shutdown(2) will not returnÁ üä•K H until all queued messages for the socket have been successfully sent orÁ ü´–D A the linger timeout has been reached. Otherwise, the call returnsÁ üý–J G immediately and the closing is done in the background. When the socketÁ üÌ—F C is closed as part of exit(2), it always lingers in the background.Á —˜ú \Ÿ˜Øí ¯˜ú ü·˜H E On most OSs the duration only has a precision of seconds and will beÁ ¼„™ silently truncated.Á ™ú ü¨™H E On Apple platforms (e.g. macOS, iOS, etc) this uses `SO_LINGE
|
|||
|
|
oob_inlineÁT§£ü §* ü¡¥: 7 Get value for the `SO_PASSCRED` option on this socket.Á à¥ú üè¥A > For more information about this option, see [`set_passcred`].Á ®¦ú ü¶¦* ' [`set_passcred`]: Socket::set_passcredÁ úò œï¦ú«
|
|||
|
|
¤„§üî¦+üå¦6D§§ • •šw ±ê °§
|
|||
|
|
º $±§TŨ º “Á » «Á » ÈÁ » » º »ÈŽ üâª< üô¨: 7 Set value for the `SO_PASSCRED` option on this socket.Á ³©ú ü»©M J If this option is enabled, enables the receiving of the `SCM_CREDENTIALS`Á ¬�ª control messages.Á úò œ±ªú«
|
|||
|
|
¤Æªü°ª+ü§ª6déª – –šw ‰œ öª
|
|||
|
|
¼ $÷ªŠ$Dýªüµ¯) üò¬: 7 Get value for the `SO_PRIORITY` option on this socket.Á ±ú ü¹A > For more information about this option, see [`set_priority`].Á ÿú ü‡®* ' [`set_priority`]: Socket::set_priorityÁ »£|É®úò œæ®úŒ ¬û®úÊ ¬’¯üå®Cü¿®oü¶®zD¼¯ — —šw Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
²¿ ů
|
|||
|
|
½ $Ư4Ù° ½ “Á ¾ «Á ¾ ÈÁ ¾ ¾ ½ ¾ ËŽ üƳ; ü‚±: 7 Set value for the `SO_PRIORITY` option on this socket.Á Á±ú üɱ\ Y Packets with a higher priority may be processed earlier depending on the selected deviceÁ Ī² queueing discipline.Á »£|Ú²úò œ÷²úŒ ¬Œ³úÊ ¬£³üö²CüвoüDzzdͳ ˜ ˜šw ‰œ Ú³
|
|||
|
|
¿ $Û³³$Dá³ü¯·3 üÕµ8 5 Get value for the `SO_RCVBUF` option on this socket.Á ’¶ú üš¶I F For more information about this option, see [`set_recv_buffer_size`].Á è¶ú üð¶: 7 [`set_recv_buffer_size`]: Socket::set_recv_buffer_sizeÁ„¶· ™ ™šw ª‡ Ç·
|
|||
|
|
À $È·4Û¸ À “Á Á «Á Á ÈÁ Á Á À Á ËŽ ü±ºA ü†¹8 5 Set value for the `SO_RCVBUF` option on this socket.Á ùú ü˹H E Changes the size of the operating system's receive buffer associatedÁ ¤˜º with the socket.Á¤¸º š ššw ‰œ ͺ
|
|||
|
|
 $κ™$Ôºüð½: üÀ¼: 7 Get value for the `SO_RCVTIMEO` option on this socket.Á ÿ¼ú ü‡½H E If the returned timeout is `None`, then `read` and `recv` calls willÁ ¼Ô½ block indefinitely.Ád÷½ › ›šw ªœ „¾
|
|||
|
|
à $…¾ü¨ÀL üƒ¿: 7 Set value for the `SO_RCVTIMEO` option on this socket.Á ¿ú üÊ¿C @ If `timeout` is `None`, then `read` and `recv` calls will blockÁ Œ’À indefinitely.Á„¯À œ œšw „ž‰œ ÀÀ
|
|||
|
|
Ä $ÁÀ²¢DÇÀü²Ã/ üÛÁ> ; Get the value of the `SO_REUSEADDR` option on this socket.Á žÂú ü¦ÂF C For more information about this option, see [`set_reuse_address`].Á ñÂú üùÂ4 1 [`set_reuse_address`]: Socket::set_reuse_addressÁl¹Ã � �šw ±ê ÇÃ
|
|||
|
|
Å $ÈÃ<ÝÄ Å “Á Æ «Á Æ ÈÁ Æ Æ Å ÆÈŽ ü¤Ç> ü†Å; 8 Set value for the `SO_REUSEADDR` option on this socket.Á ÆÅú üÎÅH E This indicates that further calls to `bind` may allow reuse of localÁ ü›ÆK H addresses. For IPv4 sockets this means that a socket may bind even whenÁ üëÆ4 1 there's a socket already listening on this port.ÁŒ«Ç ž žšw ‰œ ½Ç
|
|||
|
|
Ç $¾ÇA,ÄÇü‘Ë3 ü´É; 8 Get the value of the `SO_SNDBUF` option on this socket.Á ôÉú üüÉI F For more information about this option, see [`set_send_buffer_size`].Á ÊÊú üÒÊ: 7 [`set_send_buffer_size`]: Socket::set_send_buffer_sizeÁ„˜Ë Ÿ Ÿšw ª‡ ©Ë
|
|||
|
|
È $ªË4½Ì È “Á É «Á É ÈÁ É É È É“½ ü�ÎA üèÌ8 5 Set value for the `SO_SNDBUF` option on this socket.Á ¥Íú üÍJ G Changes the size of the operating system's send buffer associated withÁ |üÍ the socket.Á¤—Î šw ‰œ ¬Î
|
|||
|
|
Ê $Ι$³ÎüÐÑ; üŸÐ: 7 Get value for the `SO_SNDTIMEO` option on this socket.Á ÞÐú üæÐI F If the returned timeout is `None`, then `write` and `send` cal
|
|||
|
|
¤�ˆú—
|
|||
|
|
¬Ÿˆú󜜾ˆúÓ
|
|||
|
|
¬Ûˆú¥Œúˆú¹¤•‰úË”³‰ú«
|
|||
|
|
¤Ï‰ú€”í‰ú’�¬‰Šü ‡„üœ‡‰ü“‡”œ³Š ® ¯ šw ®†» ¯v ‰œ Ï ÐŠ Ï
|
|||
|
|
Ø $ÑŠýÅLߊ“ÆLýŠüÅ’Ž üÀ�Möó ’Žú üšŽH E For more information about this option, see [`join_multicast_v4_n`].Á çŽú üïŽ8 5 [`join_multicast_v4_n`]: Socket::join_multicast_v4_nÁ
|
|||
|
|
úÜŒÃ�úú œÞ�úÞ ¬û�ú„
|
|||
|
|
¤š�ú—
|
|||
|
|
¬¸�úóœœ×�úÓ
|
|||
|
|
¬ô�ú¥Œ“‘ú¹¤®‘ú˔̑ú«
|
|||
|
|
¤è‘ú€”†’ú’�¬¢’ü¹�„üµ�‰ü¬�”¤Ì’ ° ± ² °šw ±†» ²v ‰œ Ï ê’ Ï
|
|||
|
|
Ù $ë’ýÅLù’“ÆL—“üÞœ� üÛ•X U Join a multicast SSM channel using `IP_ADD_SOURCE_MEMBERSHIP` option on this socket.Á ¸–ú üÀ–L I This function specifies a new multicast channel for this socket to join.Á ü‘—] Z The group must be a valid SSM group address, the source must be the address of the senderÁ üó—_ \ and `interface` is the address of the local interface with which the system should join theÁ üטJÑñ ü¦™5¦ò ú ¼÷™úú œ˜šú±”µšú„
|
|||
|
|
¤Ñšú—
|
|||
|
|
¬ïšú󜜎›úÊ ¬«›ú¥ŒÊ›ú¹¤å›úË”ƒœú€”Ÿœú’�¬»œüí™éüé™îüà™ù\åœ ³ ´ µ ¶ ³šw ´†» µ†» ¶†» ‰œ Ï úœ Ï
|
|||
|
|
Ú $ûœ sourceÁ4‰� groupÁ,¤�“ÆL¾�ü륎 ü’¡T Q Leave a multicast group using `IP_DROP_SOURCE_MEMBERSHIP` option on this socket.Á ë¡ú üó¡@ = For more information about this option, see [`join_ssm_v4`].Á ¸¢ú üÀ¢( % [`join_ssm_v4`]: Socket::join_ssm_v4Á ú ¼„£úú œ¥£ú±”£ú„
|
|||
|
|
¤Þ£ú—
|
|||
|
|
¬ü£ú󜜛¤úÊ ¬¸¤ú¥Œ×¤ú¹¤ò¤úË”�¥ú€”¬¥ú’�¬È¥üú¢éüö¢îüí¢ùdò¥ · ¸ ¹ º ·šw ¸†» ¹†» º†» ‰œ Ï ˆ¦ Ï
|
|||
|
|
Û $‰¦ì…4—¦û…,²¦“ÆL̦ü¼¬2 ü¡ªC @ Get the value of the `IP_MULTICAST_ALL` option for this socket.Á éªú üñªI F For more information about this option, see [`set_multicast_all_v4`].Á ¿«ú üÇ«: 7 [`set_multicast_all_v4`]: Socket::set_multicast_all_v4Á »£|�¬úò œ¡¬ü�¬&ü†¬1„ì » »šw ±ê Ï Ô¬ Ï
|
|||
|
|
Ü $Õ¬,ï Ü “Á Ý «Á Ý ÈÁ Ý Ý Ü ÝÈŽ ü÷²? ü”®C @ Set the value of the `IP_MULTICAST_ALL` option for this socket.Á Ü®ú üä®< 9 This option can be used to modify the delivery policy ofÁ ü¥¯2 / multicast messages. The argument is a booleanÁ üܯ@ = (defaults to true). If set to true, the socket will receiveÁ ü¡°6 3 messages from all the groups that have been joinedÁ üÜ°= : globally on the whole system. Otherwise, it will deliverÁ üž±; 8 messages only from the groups that have been explicitlyÁ üÞ±> ; joined (for example via the `IP_ADD_MEMBERSHIP` option) onÁ Ü¡² this particular socket.Á »£|˲úò œÜ²üʲ&üÁ²1¤þ² ¼ ¼šw ‰œ Ï “³ Ï
|
|||
|
|
Þ $”³£ š³ü�·5 ü‹µB ? Get the value of the `IP_MULTICAST_IF` option for this socket.Á Òµú üÚµH E For more information about this option, see [`set_multicast_if_v4`].Á §¶ú ü¯¶8 5 [`set_multicast_if_v4`]: Socket::set_multicast_if_v4Á ú€”ö¶¤õ¶üì¶ |—· ½ ½šw Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
†»²¿ Ï §· Ï
|
|||
|
|
ß $¨·ü‹ºI üÒ¸B ? Set the value of the `IP_MULTICAST_IF` option for this socket.Á ™¹ú ü¡¹A > Specifies the interface to use for routing multicast packets.Á ú€”ñ¹¤ð¹üç¹ œ’º ¾ ¿ ¾šw ¿†» ‰œ Ï ¦º Ï
|
|||
|
|
à $§º“ÆLºüÁ¾3 üؼD A Get the value of the `IP_MULTICAST_LOOP` option for this socket.Á ¡½ú ü©½J G For more information about this option, see [`set_multicast_loop_v4`].Á ø½ú ü€¾< 9 [`set_multicast_loop_v4`]: Socket::set_multicast_loop_v4ÁŒÈ¾ À Àšw ±ê Ï Ú¾ Ï
|
|||
|
|
á $Û¾Lõ¿ á “Á â «Á â ÈÁ â â á âÈŽ ü‚ÂD ü¢ÀD A Set the value of the `IP_MULTICAST_LOOP` option for this socket.Á ëÀú üóÀJ G If enabled, multicast packets will be looped back to the local socket.Á üÂÁ; 8 Note that this may not have any affect on IPv6 sockets.Á¬‰Â Á Ášw ‰œ Ï ŸÂ Ï
|
|||
|
|
ã $  loop_v4Á<¦Âü„Æ1 üŸÄC @ Get the value of the `IP_MULTICAST_TTL` option for this socket.Á çÄú üïÄI F For more information about this option, see [`set_multicast_ttl_v4`].Á ½Åú üÅÅ: 7 [`set_multicast_ttl_v4`]: Socket::set_multicast_ttl_v4Á„‹Æ  šw ‡µ Ï œÆ Ï
|
|||
|
|
ä $�Æ,µÇ ä “Á å «Á å ÈÁ å å ä åÕ¶ üÑÊ> üÜÇC @ Set the value of the `IP_MULTICAST_TTL` option for this socket.Á ¤Èú ü¬ÈF C Indicates the time-to-live value of outgoing multicast packets forÁ ü÷ÈJ G this socket. The default value is 1 which means that multicast packetsÁ üÆÉ> ; don't leave the local network unless explicitly requested.Á ‰Êú ü‘Ê;¹Ÿ¤ØÊ Ã Ãšw ‰œ Ï íÊ Ï
|
|||
|
|
æ $îÊ ttlÁ ôÊü Î' üãÌ9 6 Get the value of the `IP_TTL` option for this socket.Á ¡Íú ü©Í? < For more informatio
|
|||
|
|
¤Óàú—
|
|||
|
|
¬ñàúóœœ�áúÓ
|
|||
|
|
¬áúú œÌáú¥Œéáú¹¤„âúøœ¢âúË”¿âú«
|
|||
|
|
¤Ûâú€”ùâú’�¬•ãü³ßýü¯ß‚ü¦ß�|¿ã È Èšw ‰œ Ï Ïã Ï
|
|||
|
|
í $Ðã recv_tosÁDÖãü¬ë- üÊå= : Get the value of the `IP_RECVTOS` option for this socket.Á Œæú ü”æD A For more information about this option, see [`set_recv_tos_v4`].Á Ýæú üåæ0 - [`set_recv_tos_v4`]: Socket::set_recv_tos_v4Á úÜŒ±çú ¼ÌçúÊ ¬íçú±”ŒèúÞ ¬¨èú„
|
|||
|
|
¤Çèú—
|
|||
|
|
¬åèú󜜄éúÓ
|
|||
|
|
¬¡éúú œÀéú¥ŒÝéú¹¤øéúøœ–êúË”³êú«
|
|||
|
|
¤Ïêú€”íêú’�¬‰ëü§çýü£ç‚üšç�\³ë É Éšw ±ê Ï ¿ë Ï
|
|||
|
|
î $ÀëTÓì î “Á ï «Á ï ÈÁ ï ï î ïÈŽ ü™ï5 ü�íB ? Get the value for the `SO_ORIGINAL_DST` option on this socket.Á »£|ÛíúŒ ¬…îúÊ ¬¨îúò œËîúâ¬ìîü÷í•üÑíÁüÈíÌ| ï Ê Êšw íÄ Ï °ï Ï
|
|||
|
|
ð $±ï\Æò ü†ðP M Socket options for IPv6 sockets, get/set using `IPPROTO_IPV6` or `SOL_IPV6`.Á ×ðú üÛðE⇠ü¡ñ@ = * Linux: <https://man7.org/linux/man-pages/man7/ipv6.7.html>Á üâñc ` * Windows: <https://docs.microsoft.com/en-us/windows/win32/winsock/ipproto-ipv6-socket-options>Á šwòôõ÷øùúüýÿ€‚ƒ…†ˆ‰‹ŒŽ�‘’ ü»÷4 üØò<Ð× ™óú ü¡óK H For more information about this option, see [`set_header_included_v6`].Á ñóú üùó> ; [`set_header_included_v6`]: Socket::set_header_included_v6Á »£|Ïô úóœœýôú¹¤žõúøœÀõú—
|
|||
|
|
¬áõú¶ ¬„öú ¼§öú„
|
|||
|
|
¤Ìöú€”îöú’�¬Ž÷üïô¾üëôÃüÅôïü¼ôú”Â÷ Ë Ëšw ±ê ñ Õ÷ ñ
|
|||
|
|
ò $Ö÷Tëø ò “Á ó «Á ó ÈÁ ó ó ò óÈŽ üÒ€F üšù<ùÛ Ûùú üãùIÍÜ ü±úK¡Ý ü�ûJ G When this flag is enabled, the values set by `IP_OPTIONS` are ignored.Á Ðûú ÜØû‚ß üøû>¨ß »£|æý ú󜜔þú¹¤µþúøœ×þú—
|
|||
|
|
¬øþú¶ ¬›ÿú ¼¾ÿú„
|
|||
|
|
¤ãÿú€”…€ú’�¬¥€ü†þ¾ü‚þÃüÜýïüÓýú ´Ù€ Ì Ìšw ‰œ ñ ð€ ñ
|
|||
|
|
ô $ñ€ŠâD÷€ü¦†3 üíƒB ? Get the value of the `IPV6_TRANSPARENT` option on this socket.Á ´„ú ü¼„J G For more information about this option, see [`set_ip_transparent_v6`].Á ‹…ú ü“…< 9 [`set_ip_transparent_v6`]: Socket::set_ip_transparent_v6Á »£|Þ…úò œó…úŒ ¬ˆ†üò…,üÝ…BüÔ…MŒ† Í Íšw ±ê ñ ¿† ñ
|
|||
|
|
õ $À†l܇ õ “Á ö «Á ö ÈÁ ö ö õ öÈŽ ü¾�H ü‘ˆB ? Set the value of the `IPV6_TRANSPARENT` option on this socket.Á ؈ú üàˆ<ùæ ü¡‰:Àç üà‰<…è ü¡Š=Ìè üãŠ<”é ü¤‹=Ûé üæ‹7£ê ü¢Œ= : hosting the application that employs the IPV6_TRANSPARENTÁ üäŒ9«ë ü¢�:ïë á�ú üé�;Áì ü©Ž>‡í »£|öŽúò œ‹�úŒ ¬ �üŠ�,üõŽBüìŽM¬Å� ΠΚw ‰œ ñ Û� ñ
|
|||
|
|
÷ $Ü�ž\â�ü¨•W üå‘M J Join a multicast group using `IPV6_ADD_MEMBERSHIP` option on this socket.Á ·’ú ü¿’3 0 Some OSs use `IPV6_JOIN_GROUP` for this option.Á ÷’ú üÿ’JÕï üΓIªð üœ”J G index of the interface to join/leave (or 0 to indicate any interface).Á ú¥Œù”úøœŒ•üø”(üô”-üë”8Œ¯• Ï Ð Ïšw Ðí½ ‰œ ñ Á• ñ
|
|||
|
|
ø $•ýÅLÈ•“ÆLÞ•ü�œX ü§™O L Leave a multicast group using `IPV6_DROP_MEMBERSHIP` option on this socket.Á û™ú üƒš4 1 Some OSs use `IPV6_LEAVE_GROUP` for this option.Á ¼šú üÄšF C For more information about this option, see [`join_multicast_v6`].Á �›ú ü—›4 1 [`join_multicast_v6`]: Socket::join_multicast_v6Á ú¥ŒÞ›úøœñ›üÝ›(üÙ›-üЛ8””œ Ñ Ò Ñšw Òí½ ‰œ ñ §œ ñ
|
|||
|
|
ù $¨œýÅL®œ“ÆLÄœüœ¢2 üŽ E B Get the value of the `IPV6_MULTICAST_HOPS` option for this socketÁ Ø ú üà J G For more information about this option, see [`set_multicast_hops_v6`].Á ¯¡ú ü·¡< 9 [`set_multicast_hops_v6`]: Socket::set_multicast_hops_v6Á ú€”‚¢¤�¢üø¡ Œ£¢ Ó Óšw ‡µ ñ µ¢ ñ
|
|||
|
|
ú $¶¢4Ó£ ú “Á û «Á û ÈÁ û û ú ûÕ¶ üѦ@ üü£E B Set the value of the `IPV6_MULTICAST_HOPS` option for this socketÁ Ƥú üΤH E Indicates the number of "routers" multicast packets will transit forÁ ü›¥JÊ¥ üê¥>Ÿ¦ ú€”·¦¤¶¦ü¦ ¬Ø¦ Ô Ôšw ‰œ ñ î¦ ñ
|
|||
|
|
ü $ï¦ hopsÁ$õ¦üˆ«2 üë¨E B Get the value of the `IPV6_MULTICAST_ALL` option for this socket.Á µ©ú ü½©I F For more information about this option, see [`set_multicast_all_v6`].Á ‹ªú ü“ª: 7 [`set_multicast_all_v6`]: Socket::set_multicast_all_v6Á »£|ܪúò œíªüÛª&üÒª1„�« Õ Õšw ±ê ñ « ñ
|
|||
|
|
ý $¡«,¿¬ ý “Á þ «Á þ ÈÁ þ þ ý þÈŽ ü˱? üä¬E B Set the value of the `IPV6_MULTICAST_ALL` option for this socket.Á ®ú ü¶<¼� ü÷2ƒ� ü®®@À� üó®6‹‘ ü®¯=Ì‘ üð¯;”’ ü°°@ = joined (for example via the `IPV6_ADD_MEMBERSHIP` option) onÁ Üõ°¢“ »£|Ÿ±úò œ°±üž±&ü•±1¤Ò± Ö Öšw ‰œ ñ ç± ñ
|
|||
|
|
ÿ $è±£ î±üêµ0 üã³D A Get the value of the `IPV6_MULTICAST_IF` option for this socket.Á ¬´ú ü´´H E For more information about this option, see [`set_multicast_if_v6`].Á �µú ü‰µ8 5 [`set_multicast_if_v6`]: Socket::set_mu
|
|||
|
|
¤œÕú—
|
|||
|
|
¬ºÕúóœœÙÕúÓ
|
|||
|
|
¬öÕúú œ•Öú±”²Öú¹¤ÎÖúøœìÖúË”‰×ú€”¥×ú’�¬Á×ü³Ô©ü¯Ô®ü¦Ô¹të× ß ßšw ±ê ñ ú× ñ
|
|||
|
|
Œ $û×l•Ù Œ “Á � «Á � ÈÁ � � Œ �ÈŽ ü�ßE üÉÙB ? Set the value of the `IPV6_RECVTCLASS` option for this socket.Á �Úú ü˜ÚK H If enabled, the `IPV6_TCLASS` ancillary message is passed with incomingÁ üèÚJ G packets. It contains a byte which specifies the traffic class field ofÁ ´·Û the packet header.Á ú ¼éÛúÊ ¬ŠÜúÞ ¬©Üú„
|
|||
|
|
¤ÈÜú—
|
|||
|
|
¬æÜú󜜅ÝúÓ
|
|||
|
|
¬¢Ýúú œÁÝú±”ÞÝú¹¤úÝúøœ˜ÞúË”µÞú€”ÑÞú’�¬íÞüßÛ©üÛÛ®üÒÛ¹”—ß à àšw ‰œ ñ ªß ñ
|
|||
|
|
Ž $«ß recv_tclassÁ\±ßüÔç2 ü²áD A Get the value of the `IPV6_RECVHOPLIMIT` option for this socket.Á ûáú üƒâI F For more information about this option, see [`set_recv_hoplimit_v6`].Á Ñâú üÙâ: 7 [`set_recv_hoplimit_v6`]: Socket::set_recv_hoplimit_v6Á »£|«ãâ <Ùãú ¼îãúÊ ¬“äúÞ ¬¶äú„
|
|||
|
|
¤Ùäú—
|
|||
|
|
¬ûäú󜜞åúÓ
|
|||
|
|
¬¿åúú œâåú±”ƒæú¹¤£æúË”Åæú«
|
|||
|
|
¤åæú€”‡çú’�¬§çüËãûüÇã€ü¡ã¬ü˜ã·„Ûç á ášw ±ê ñ ìç ñ
|
|||
|
|
� $íç|‰é � “Á � «Á � ÈÁ � � � �ÈŽ üðïI üÀéD A Set the value of the `IPV6_RECVHOPLIMIT` option for this socket.Á ‰êú ü‘êE B The received hop limit is returned as ancillary data by recvmsg()Á üÛêD A only if the application has enabled the IPV6_RECVHOPLIMIT socketÁ \¤ë option:Á »£|Çëâ <õëú ¼ŠìúÊ ¬¯ìúÞ ¬Òìú„
|
|||
|
|
¤õìú—
|
|||
|
|
¬—íú󜜺íúÓ
|
|||
|
|
¬Ûíúú œþíú±”Ÿîú¹¤¿îúË”áîú«
|
|||
|
|
¤�ïú€”£ïú’�¬Ãïüçëûüãë€ü½ë¬ü´ë·¤÷ï â âšw ‰œ ñ Œð ñ
|
|||
|
|
‘ $�ð
|
|||
|
|
recv_hoplimitÁl“ðüåó5 üšòG D Get the value for the `IP6T_SO_ORIGINAL_DST` option on this socket.Á »£|ùòúŒ ¬–óúò œóúâ¬Âóü•óCüïòoüæòz|ìó ã ãšw íÄ ñ üó ñ
|
|||
|
|
’ $ýó\€÷ üÒô@ = Socket options for TCP sockets, get/set using `IPPROTO_TCP`.Á “õú ü—õE⇠üÝõ? < * Linux: <https://man7.org/linux/man-pages/man7/tcp.7.html>Á ü�öb _ * Windows: <https://docs.microsoft.com/en-us/windows/win32/winsock/ipproto-tcp-socket-options>Á šw”•—™šœ ü®ú8 ü’÷> ; Get the value of the `TCP_KEEPIDLE` option on this socket.Á Õ÷ú üÝ÷^ [ This returns the value of `TCP_KEEPALIVE` on macOS and iOS and `TCP_KEEPIDLE` on all otherÁ üÀø% " supported Unix operating systems.Á »£|ýøâ <«ùúú œÀùú—
|
|||
|
|
¬áùúË”„úü�ùƒü™ùˆüóø´üêø¿”µú ä äšw Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
Ó›²¿ “ Èú “
|
|||
|
|
” $Éúüƒ‚< ü£û? < Get the value of the `TCP_KEEPINTVL` option on this socket.Á çûú üïûF C For more information about this option, see [`set_tcp_keepalive`].Á ºüú üÂü4 1 [`set_tcp_keepalive`]: Socket::set_tcp_keepaliveÁ »£|ŽýúŒ ¬¸ýú ¼Ûýú÷Ä€þú¶ ¬¦þúÊ ¬ÉþúÞ ¬ìþúå Œ�ÿúô ´®ÿúò œÒÿúˆ œóÿú„
|
|||
|
|
¤”€ú™ ”¶€ú© ¬Ö€ú«
|
|||
|
|
¤ù€úøœ›� ú€”À�î‘ŒØ�œ×�ü¿�,üªýÌü„ýøüûüƒ´Š‚ å åšw ¿Ÿ “ ¡‚ “
|
|||
|
|
• $¢‚4½ƒ • “Á – «Á – ÈÁ – – • – ËŽÓ› üüŠ6 üûƒ= : Get the value of the `TCP_KEEPCNT` option on this socket.Á ½„ú üÅ„F �…ú ü˜…4þ »£|ä…úŒ ¬Ž†ú ¼±†ú÷ÄÖ†ú¶ ¬ü†úÊ ¬Ÿ‡úÞ ¬Â‡úå Œå‡úô ´„ˆúò œ¨ˆúˆ œÉˆú„
|
|||
|
|
¤êˆú™ ”Œ‰ú© ¬¬‰ú«
|
|||
|
|
¤Ï‰úâ¬ñ‰úøœ”Š ú€”¹Šî‘ŒÑŠœÐŠü¸Š,ü€†ïüÚ…›üÑ…¦¬ƒ‹ æ æšw ‡µ “ ™‹ “
|
|||
|
|
— $š‹L®Œ — “Á ˜ «Á ˜ ÈÁ ˜ ˜ — ˜Õ¶ üˆ™H üÝŒD A Set parameters configuring TCP keepalive probes for this socket.Á ¦�ú ü®�D A The supported parameters depend on the operating system, and areÁ ü÷�K H configured using the [`TcpKeepalive`] struct. At a minimum, all systemsÁ üÇŽI F support configuring the [keepalive time]: the time after which the OSÁ ü•�@ = will start sending keepalive messages on an idle connection.Á Ú�ú üâ�- * [keepalive time]: TcpKeepalive::with_timeÁ ”�ú \œ�Øí ¬�ú ü´�J G * This will enable `SO_KEEPALIVE` on this socket, if it is not alreadyÁ tƒ‘ enabled.Á ü–‘H E * On some platforms, such as Windows, any keepalive parameters *not*Á üã‘L I configured by the `TcpKeepalive` struct passed to this function may beÁ ü´’L I overwritten with their default values. Therefore, this function shouldÁ ü…“J G either only be called once per socket, or the same parameters shouldÁ üÔ“( % be passed every time it is called.Á �”ú t‰”šõ œ”ú <¤”Öú ä°” use std::time::Duration;Á Ñ”ú üÙ”6 3 use socket2::{Socket, TcpKeepalive, Domain, Type};Á ”•ú üœ•(Ôõ üÉ•@Ì« üŽ–' $ let keepalive = TcpKeepalive::new()Á üº–+ ( .with_time(Duration::from_secs(4));Á üê–K H // Depending on the target operating system, we may also be able toÁ üº—F C // configure the keepalive probe interval and/or the number ofÁ ü…˜ // retries here as well.Á ª˜ú ü²˜* ' socket.set_tcp_keepalive(&keepalive)?;Á tᘿú <ô˜Öú €™úŒ�™ ç è çšw èé„ ‰œ “ ¡™ “
|
|||
|
|
™ $¢™ paramsÁ4¨™ü‡œ- ü·š= : Get the value of the `TCP_NODELAY` option on this socket.Á ùšú ü�›D A For more information about this option, see [`set_tcp_nodelay`].Á Ê›ú üÒ›0 - [`set_tcp_nodelay`]: Socket::set_tcp_nodelayÁ\Žœ é éšw ±ê “ šœ “
|
|||
|
|
š $›œL¯� š “Á › «Á › ÈÁ › › š ›ÈŽ üó > üÜ�= : Set the value of the `TCP_NODELAY` option on this socket.Á žžú ü¦žE B If set, this option disables the Nagle algorithm. This means thatÁ üðžI F segments are always sent as soon as possible, even if there is only aÁ ü¾ŸI F small amount of data. When not set, data is buffered until there is aÁ üŒ K H sufficient amount to send out, thereby avoiding the frequent sending ofÁ ”Ü small packets.Á|ú ê êšw ‰œ “ Š¡ “
|
|||
|
|
œ $‹¡ nodelayÁ<‘¡¤ý¥ šwžŸ á â ž Ÿ ü˜¦7$›¦ ë ì ëšw ì±Ùª‡ � ¦ �
|
|||
|
|
ž $¥¦¨¤ «¦ü¦©M úóœœß¨ú€”ô¨ú’�¬ˆ©üÞ¨@üÚ¨EüѨPl©© í î ï íšw î
|
|||
|
|
ö ö ÷ ‡à ù ˆ¦ èóÇãp9Ü ïª‡ � ·© �
|
|||
|
|
Ÿ $¼©§Ÿ$©D° Ÿ “Á «Á ÈÁ Ÿ úŸ äÅ Ì2 ¢ ¢ Ëw£¤ á â £ ¤ Êüè7$ë ð ñ ðËw ñ±Ùª‡ ¡ ð ¡
|
|||
|
|
£ Ì2$õ¨¤ ûüš°M úóœœÓ¯ú€”è¯ú’�¬ü¯üÒ¯@üίEüůPl�° ò ó ô òËw ó
|
|||
|
|
ö ö ÷ ‡à ù ˆ¦ èóÇãp9Ü ôª‡ ¡ «° ¡
|
|||
|
|
¤ Ì2$°°§Ÿ$¶°D£² ¤“Á ¥ «Á ¥ ÈÁ ¥ ¥ ¤ ¥ øà ¬¸² šw§¨© ! ¡! ¤! ¨ © § üÔ²4,ײ õ ö õšw ö±Ù ª‡ ¦ ݲ ¦
|
|||
|
|
§ $Ⲩ¤ è²ü‚´G ú󜜻³ú€”гú’�¬ä³üº³@ü¶³Eü³Pt…´ ÷ ø ù ÷šw ø
|
|||
|
|
æLæL çL£é éLˆ¦ —óë@M$ T ù ª‡ ¦ ”´ ¦
|
|||
|
|
¨ $™´§Ÿ$Ÿ´üø´%,û´ ú úšw‰œ ¦ �µ ¦
|
|||
|
|
© $†µì¸µ Ì2 « « Ëw¬® ! ¡! ¤! ¬ ® ½µüܵ4,ßµ û ü ûËw ü±Ù ª‡ ª åµ ª
|
|||
|
|
¬ Ì2$굨¤ ðµüŠ·G úóœœÃ¶ú€”ضú’�¬ì¶ü¶@ü¾¶Eüµ¶Pt�· ý þ ÿ ýËw þ
|
|||
|
|
æLæL çL£é éLˆ¦ —óë@M$ T ÿ ª‡ ª œ· ª
|
|||
|
|
Ì2$¡·§Ÿ$§·ü€¸%,ƒ¸ € € Ëw‰œ ª ‰¸ ª
|
|||
|
|
® Ì2$Ž¸ÔÀ¸ šw° Àc ° üá¸8 ä¸ � ‚ ƒ � šw ‚ c c ˆ ¢cµ
|
|||
|
|
` £c¨¤ ` àB¤GS
|
|||
|
|
ƒ Ï¥ ¯ è¸ ¯
|
|||
|
|
° $鸱 ï¸\ƒ5 <‡5 »× ¤, ± ²½é\ • ± ³½é – ± ³ ManuallyDropÁd: ÃÛ ± ´r,V é! ± µ AsFdÁ$² �, ± · AsRawFdÁ<¸ «+ ± ¸”áLÁ + ± ¹ó4« y ± º ËDÖÄÆ´0•|L†\¤tv\^JLl¤=´Ö ü´P M A reference to a [`Socket`] that can be used to configure socket types otherÁ ü…" than the `Socket` type itself.Á ¨ú ü¬N K This allows for example a [`TcpStream`], found in the standard library, toÁ üûO L be configured using all the additional methods found in the [`Socket`] API.Á Ëú üÏJ G `SockRef` can be created from any socket type that implements [`AsFd`]Á üšG D (Unix) or [`AsSocket`] (Windows) using the [`From`] implementation.Á âú üæ&íì üÖH E [`AsFd`]: https://doc.rust-lang.org/stable/std/os/fd/trait.AsFd.htmlÁ üŸX U [`AsSocket`]: https://doc.rust-lang.org/stable/std/os/windows/io/trait.AsSocket.htmlÁ øú tüšõ ‹ú ü�I F Below is an example of converting a [`TcpStream`] into a [`SockRef`].Á Ùú <ÝÖú üå* ' use std::net::{TcpStream, SocketAddr};Á � ú Ì” use socket2::SockRef;Á ® ú ü² ; 8 # fn main() -> Result<(), Box<dyn std::error::Error>> {Á üî 4 1 // Create `TcpStream` from the standard library.Á ü£
|
|||
|
|
8 5 let address: SocketAddr = "127.0.0.1:1234".parse()?;Á üÜ
|
|||
|
|
? < # let b1 = std::sync::Arc::new(std::sync::Barrier::new(2));Á Ôœ # let b2 = b1.clone();Á ü· / , # let handle = std::thread::spawn(move || {Á üç F C # let listener = std::net::TcpListener::bind(address).unwrap();Á œ® # b2.wait();Á ü 6 3 # let (stream, _) = listener.accept().unwrap();Á üù B ? # std::thread::sleep(std::time::Duration::from_millis(10));Á ´¼
|
|||
|
|
# drop(stream);Á LÓ
|
|||
|
|
# });Á „Ý
|
|||
|
|
|
|||
|
|
# b1.wait();Á üî
|
|||
|
|
. + let stream = TcpStream::connect(address)?;Á �ú ü¡. + // Create a `SockRef`erence to the stream.Á üÐ, ) let socket_ref = SockRef::from(&stream);Á üý3 0 // Use `Socket::set_tcp_nodelay` on the stream.Á ü±& # socket_ref.set_tcp_nodelay(true)?;Á ¬Ø drop(socket_ref);Á îú üò( % assert_eq!(stream.nodelay()?, true);Á ì› # handle.join().unwrap();Á d¹¤² <Æ�¢ <ÎÖú <á ™4 ¼ ¼ òy ÇSZä ·‹ˆ ½¾éä«4«± » » ÃÛÃÛ ÈÑ ÅÛ»¬ „ µÜÀ,�%*šwüê"Lê± » » • • – ½é Fu\»Ÿ ™4šw ô‘ ™4 À À òyÁ ê! ë!  –\¶4» ¿ ¿ šwüÑ ,Ô „ „ òy „ òy ê! ¿ Ú ¿
|
|||
|
|
 ™4$Ûü£: ü’M J On Windows, a corresponding `From<&impl AsSocket>` implementation exists.Á ú $ê ú€”ôî‘ŒŒœ‹üó,üé7üàB ™4 Ä ¤ Å Ä Å ÍìÂz ¬ �,Âz $ØòyÆ ë Æ ¨') ô� üä4 1 The caller must ensure `S` is actually a socket.Á$ ¼zòy à Ã
|
|||
|
|
Æ ™4ÂzÚ4¥ü· 8 … … ÐzÈ Àc È üÝ 8 à † ‡ ˆ † Ðz ‡ c c ˆ ¢cµ
|
|||
|
|
` £c¨¤ ` àB¤GS
|
|||
|
|
ˆ Ï¥ Ç ä Ç
|
|||
|
|
È 8$å ± ë <§6 «6 ÌÏÐÑàíîðñòóôõ‡ˆ‰Š‹Œ��’”•—™œŸ ¡¢¤¦©«¬®°²³µ¶¸¹º»¼¾¿ÀÁÃÅÈËÌÍÎÏÐÓ®× minÁ ï Å É Ê OsStrÁ,¢ ˆ É Ë£é<‡ æL É Ì½é\¡ • É Í½é – É Íí$½ ë É Ïš<à À É Ð‚ê\Ì ÑÛ É ÑùàDè ¶M É Ò’ºD� ¾º É Ôù¼D‹ ̺ É Õ
|
|||
|
|
NonZeroU32ÁTä �• É Ö NonZeroUsizeÁdº
|