1076 lines
372 KiB
Plaintext
1076 lines
372 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Á–æ\‹±Ôcd�-»ùÀTƒ -f86f80b348d33b13Á 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¼1ú iosÁŒ—0ú visionosÁ´®0ú macosÁœÊ0ú tvosÁ”ã0ú watchosÁ¬û0ü‘0‚É IPV6_ADD_MEMBERSHIPÁœÏ@
|
|||
|
|
ú ¼±=ú¶ ¬Î=ú haikuÁœé=úÞ ¬‚>úå Œ�>úô ´´>úˆ œÐ>ú„
|
|||
|
|
¤é>ú—
|
|||
|
|
¬ƒ?ú solarisÁ¬ž?ú™ ”¹?ú© ¬Ñ? ú wasiÁ”ð?î p1ÁŒˆ@œ‡@üï?,ü«=óÉ IPV6_DROP_MEMBERSHIPÁ¤ø@
|
|||
|
|
ú íú¶ ëúú äúÞ âúå àúô Þúˆ Üú„
|
|||
|
|
Úú—
|
|||
|
|
ØúÓ
|
|||
|
|
Ïú™ Íú© Ë ú€Åî‘Á¿½º¼É KEEPALIVE_TIMEÁtïHúå Œ‡Gúô ´žGúˆ œºG ú ntoÁŒ×Gî nto70Á¤îGî nto71Á¤„HüíG,üÖGEú™ ”¡Hú© ¬¹Hü�GÐÉ MAX_BUF_LENÁ\ÑUúå Œ²Túô ´ÉTúˆ œåTú™ ”þTú© ¬–Uú«
|
|||
|
|
¤±Uü¬TœÉ IovLenÁ4ê^ úò œÀYî muslÁœîYî ohosÁœ�Z î uclibcÁ¬´Zû 32ÁÜËZü³Z4üàY‘ü¶YÁú aixÁŒýZú ¼”[ú¶ ¬±[úÊ ¬Ì[úú œç[ú hurdÁ”€\úÞ ¬˜\úå Œ³\úô ´Ê\úˆ œæ\ú„
|
|||
|
|
¤ÿ\ú¥Œ™]ú—
|
|||
|
|
¬°]úÓ
|
|||
|
|
¬Ë]ú™ ”æ]ú© ¬þ]ú espidfÁ¤™^ú vitaÁ”³^ú«
|
|||
|
|
¤Ë^üYµÉ‹
|
|||
|
|
\¤ˆúµ”€ˆÉ 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Á ¡ð1 ¡ü1 ¤ U¦ writeÁ ¦ write_vectoredÁ ¦ flushÁ Uªš2 ª½2 ªÊ2 ªà2 U ¯× sockrefÁ ± ±±±±±±±±± SockRefÁ » 'sÁ »¨ » _lifetimeÁ ± ¿ç3 ¿å ¿´ ±Ãç3 ä Ã÷ ±Ç× 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 àÁ àù3 Éäš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Á �ÒW �ßW �ìW �æ � with_addrÁ � with_buffersÁ � with_controlÁ �
|
|||
|
|
with_flagsÁ – 'nameÁ –ßW –ìW –× MsgHdrMutÁ œÒW œßW œìW œÎ œ„X ¢ÒW ¢ßW ¢ìW ¢æ ¢ºX ¢ËX ¢ßX ¢ flagsÁ ¢ control_lenÁ ¬‰Y ¬ßW ¬ìW ¬× 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 ( ( ï )… j:1oªJõ Ø ³ ³ ýZ ´… µ‘ G·ÌT>:Ý é Ûr“¼”¼ •¼ V4Á –¼ˆ —¼ ˜¼ V6Á™¼ˆ cÌ£•w® é Ûrª¼ª¼ SocketAddrV4Á «¼ ipÁÑS ¬¼ portÁÑS µÃѨbF(Æ é Ûr½¼½¼ SocketAddrV6Á ¾¼œsÑS ¿¼«sÑS À¼ flowinfoÁÑS Á¼ scope_idÁÑS ¸dÛÔ#¹G[ ¿cÛr µßÛrÛr ™Ûr šeÛr ¿c ¸ ¹ ºÇ[ »ˆ ¼ ½á[ ¾ˆ ä9h¬ŒûÉ Š ûu Ûûu Øûu à y y Á zÎ U á@¶|" à š2èv Ÿ!èv Ÿ!™w ¿cèv é èv‡#‡# ˆ# TcpStreamÁ ‰#ˆô" ¤‰?ßøkã é èvŠ#Š# ‹# TcpListenerÁ Œ#ˆô" N� À];óÉ é èvð#ð# ñ# UdpSocketÁ ò#ˆà# ¬ãøàFð™ é Ëwèv é �xèv é ×xèv é! » » Ø3 ½¨ ± ¾ù3 ± ;N3”øNF> ç3 é Ày ç3¤ ¿c » » Ø3 ½¨ ± ¾ù3 ± ;N3”øNF> 8 ¿c ì ì í´^ îˆ UÎðd¥<õ ¿c ø ø ùó úˆ * :Ô#à‹ ¿c „ „ …Â_ †ˆ è
|
|||
|
|
E8¸âÒÆ ¿c � � ‘Ž` ’ˆ ß
|
|||
|
|
ÄK8¯ Ìì à à Ü; âÁ É ãù3 É óëK‚4ûìÏ š2 � Å| ¿c ® ® ÎQ ¯àQ É 8èiÒ"å¼� ¿c × × Œ] Ù©] É Û¿] É ê/œÃ ÷@N Ÿ é!Ë} �,èv «+èv é ö+ö+ OwnedFdÁ ÷+ fdÁä+ Þí¼>XG¸, èv ¯+èv é èv°~ +èv é èv(( ®(
|
|||
|
|
UnixStreamÁ ¯(ˆê% ׶'™g$² é èvã'ã' ä' UnixListenerÁ å'ˆË' Nó:xÔ§eö é èv’'’' “' UnixDatagramÁ ”'ˆñ& ÒÛ0É@ßh é •èv é Ûèv é £€èv Š äz Ûäz Øäz ™äz Ðìäz µßäzäz é äz é äz Š œ{ Ûœ{ Øœ{ ™œ{ Ðìœ{ µßœ{œ{ é œ{ é œ{ Š Ô{ ÛÔ{ ØÔ{ ™Ô{ ÐìÔ{ µßÔ{Ô{ é Ô{ é Ô{ Š Œ| ÛŒ| ØŒ| ™Œ| ÐìŒ| µßŒ|Œ| ¿c ñ ñ òÜ; ôˆ ·j
|
|||
|
|
;nŒâ š2 é!⃠ö!⃠¿c œ œ Û` �ï` žû` Ÿ‹a .¥›2n? ض„ ¿c ‡ ‡ ÄW ‹Î Œ„X Ö
|
|||
|
|
ŒNGEN ‰Y ßW ìW Ìì ‡ ‡ ÄW ‹Î Œ„X Ö
|
|||
|
|
ŒNGEN 8 8 8 ¿c œ œ ±Y Î ¡„X dpŽ]S³ ‰Y ßW ìW Ìì œ œ ±Y Î ¡„X dpŽ]S³ 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Áà 5;TnìÈD4 „±% ±% üï$] ³ Ë% Ò% 2 ü—$» Ûr DÜ$ ªr <¯$ É$ €� ü € …$ ‘( S ìð3
|
|||
|
|
Üð3
|
|||
|
|
À€� + üð3* ™4 üÐ3K 6 Lä3 n + _Á ´†> €� ¢> ; üÒ=P \ð= Ûr ,æ= / ü‡? ´‡? €� & ¥? ü€?' ì ¦? ? < üÑ>\ äz 4ï> â� ,å> � ‹ ; D•@ £@ = üæ?= L�@ â� ,÷? - ü–A( l–A €� ü–AB ªr ×A ÝA ÞA > ü×@‡ Ø“ ´õ@ â� ,ë@ €� ‰ €� ‹ D dòB €� üËB> ( ˆC �C ? ü�B ªr |±B Ûr $¨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Á ™»p·�ƸŠ 4·Õ 3 2 › y w v û"5 ß D¨× t¢× $ ü½ØH » àØ ùØ 9 DÀ× Û › ¼‰Ø ”‰Ø D‰Ø
|
|||
|
|
%<’Ø
|
|||
|
|
Œ~ 2 L’Ø šØ b p ŸØ üÍ×^ » ð× ªØ ŽÙ Î üÜÖ² ü»×p ¡ž \�× Ñ� DñÖ t»× › 8 ! ) " › % durationÁL ÿ¡} ‰ ¬ÑP dÑP Í ü¶P1 Ï ,ÉP %< Í _Á 16Á¼‡a ì |Ža Ÿ üì`3 Ó äz 4þ` %9 Ÿ _Á ´Üb ì tãb ¡@ üÂb1 Ô äz 4Ób %9 ¡@ _Á äˆj 4ˆj
|
|||
|
|
œ‘j „@ £j üƒj" ø ¤j «j Ö üÒiY œ{ $ôi œ{ $ëi ’ ‘ :… „@ $ìn |ìn
|
|||
|
|
Dñn �™ / Tñn ún �o × ü¿nB œ{ $Ýn œ{ $Ôn œ{ w 3 ÜÅr 4År
|
|||
|
|
”Îr ü ßr üÀr! ø àr çr Ø ü‹r\ œ{ $±r œ{ $¨r ’ ‘ :… ü ´œ‡ 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Á ¶ïÔm†Ü¡• D…² Í Ì A @ ð › œ › � ÿ¡x secÁ¡ nsecÁv üóÛ! l†Ü $†Ü
|
|||
|
|
& 4‹Ü
|
|||
|
|
ØQ 3 D‹Ü ’Ü ^
|
|||
|
|
e ”óÛ
|
|||
|
|
Ò r „ “Ü üÙÛB è šÜ �Ü Ë üðÙ èè in_addrÁ é s_addrÁ Iyal'¸} <£Ú ¾º¾º Ipv4AddrÁ ¿º octetsÁ¯Q 5N`h�zØÊ $�Ú ] i Ѻ i addrÁ8 Ð líÝ $íÝ
|
|||
|
|
& 4òÝ
|
|||
|
|
R 3 DòÝ ùÝ üÑÝ0 õ €Þ ƒÞ Í üŽÝu õ õ in6_addrÁ ö s6_addrÁ {i_ùšÆ3 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Á 6x%!Ó³ tµâ Ѻ Lâá ûu 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Á ½¶
|
|||
|
|
v®ø· ^ \ P D 8 �ʪ ªÊ® µÊ² ¶µ ÷ ¤Î@ ì dÕ@ � üµ@. Ð äz 4Å@ %9 � _Á ¬ÆA ì lÍA — üA/ Ñ äz 4½A %9 — _Á ¤éB ì dðB � üÐB. Ò äz 4àB %9 � _Á <þC løC " dØD
|
|||
|
|
Ñ äz d©D
|
|||
|
|
Ð äz õD Ó ü¶C¿ äz 4çC �s <ÏC Œ”D ˜ 7l Ð äz– Ñ äz ´²K ø „·K ÃH ü™K0 Ù œ{ $«K %9 ÃH _Á ¬ÃL ø |ÈL ÄH ü«L. Ú œ{ $¼L %9 ÄH _Á ¤ƒN ø tˆN œ@ üìM, Û œ{ $üM %9 œ@ _Á ÌìO ø œñO ›@ üÐO6 Ü œ{ $åO %9 ›@ _Á œ�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 œ Ñ� ”Þ »… Â… „ ü¼„† ¶„ $ì„ ¶„ $Ó„ › $Ù„ Ñ� µ › ´ ' ï`) Z tôŒ DùŒ Û¼ › �� ü׌I œ Ñ� ”Þ Ÿ� ¦� … ü�Œ– ¶„ $ÈŒ ¶„ $«Œ › D±Œ Ñ� µ › ´ ' û`) Z l” <Ç” Û¼ Δ ü¦”G œ Ñ� Ñ� ì” ó” † üæ“� ¶„ $—” ¶„ $€” <†” ”Þ ³ ± % ‹a( X ,Æü ¸ º & ûu 1 8 ? <ƒý ¸ ½ & ûu 1 Óº 9 @ ŒÅ? ì í % äz 0 7 > |“J ø ù % œ{ 0 7 > œÅV „ … % Ô{ 0 7 > ¤Öe � ‘ % Œ| 0 7 > ü‹k ñ ò ( ñ ñ òÜ; ôˆ ·j
|
|||
|
|
;nŒâ c à à Ü; âÁ É ãù3 É óëK‚4ûìÏ £ ª U±Éñò‡œìí„…œøù�‘À × ² ¤, IoSliceÁ<• æL PhantomDataÁ\€ • Šé – í ç ë MaybeUninitÁ\ú ÑÛ
|
|||
|
|
SocketAddrÁT• “¼ r,° é!
|
|||
|
|
DerefMutÁD· ö! ¬šDÑ Ö c_intÁ,Ê7 ¿¬ Ä üÝ\å7 ' ÆÍLò7 & ÇýZDý7 ³ Èï|‡8 ( ɨ[¼×9 ¸ ÊÁ4€: y ËØ3<™: » ÌŒ]lá: × ÍÎQTË; ® Îüáâ½ üˆ- * 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° é!
|
|||
|
|
žê¨ ö! ¬š§ Ö Îê¢ ¿¬ Ä üÝ¡ ' ÆÍ & ÇýZŸ ³ Èïž ( ɨ[� ¸ ÊÁœ y ËØ3› » ÌŒ]š × ÍÎQ™ ® Î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ßR \½ È É + î ï ü 8â ð ó û 8â <ô 8" 4Ž! •! í! «! , ¬! 8
|
|||
|
|
! °! '±! 8 from_raw_socketÁ |³! Â! Û! 8¨ 4Ã! É! 8 into_raw_socketÁ |Ê! Ù! Ú! % Œ" dé4 Dí4 &'(³Ž$ še Ž e í$$ ë š<* À îéTC “¼ †sdO ª¼ àsd] ½¼ 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 j:1oªJõ )ÌÅ <Å ( ( €�¤ã ª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à Ûr238:;<=>?@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Ûr 1 1
|
|||
|
|
2 …ÕF‘ÞFü«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 DZ <ö1 Ý¡ d‚2 ñ± <“2 Ý¡ <Ÿ2 £úD¹2 —Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
¥Ûrßß þ¤ à… ¬
|
|||
|
|
ÑøÿË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|Â
|
|||
|
|
Ûrÿ¾ 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Ú< © ©Ûr 1 å< 1
|
|||
|
|
: $ê< ¿]4ð< üÒ=) ü«=" Returns this address's family.Á4ß= ª ªÛr 1 æ= 1
|
|||
|
|
; $ç= üÑ>$ ü¨>$ ! Returns this address's `Domain`.Á4Þ> « «Ûr äz 1 å> 1
|
|||
|
|
< $æ> üæ?$ ü³?. + Returns the size of this address in bytes.Á ó? ¬ ¬Ûr 1 ÷? 1
|
|||
|
|
= $ø? ü×@4 ü©@) & Returns a raw pointer to the address.Á4ä@ Ûr Ø“ 1 ë@ 1
|
|||
|
|
> $ì@ ü�B0 üäA' $ Returns the address as the storage.ÁT�B Ûrªr 1 1
|
|||
|
|
? -JüîC# ü•CT Q Returns true if this address is in the `AF_INET` (IPv4) family, false otherwise.Á<ûC ® ®Ûr 1 ƒD 1
|
|||
|
|
@ $„D üºE# üØDJ G Returns true if this address is in the `AF_INET6` (IPv6) family, falseÁ t§E otherwise.Á<ÇE ¯ ¯Ûr 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 ° °Ûr 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 ± ±Ûr ۼݼ޼© ß¼ à¼ÛἈ 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 ² ²Ûr ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙús 1 ýT 1
|
|||
|
|
D $þT üÿV4 ü¡VI F Returns this address as a [`SocketAddrV6`] if it is in the `AF_INET6`Á \ïV ¶Ôt†W ³ ³Ûr ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙÔt 1 •W 1
|
|||
|
|
E $–W ÜèX DëX ´ ´Ûr ´
|
|||
|
|
1 ôX 1
|
|||
|
|
F $õX ü¬[" ÛrH ë H üÕ[% $Ø[ �sÛr G G
|
|||
|
|
H ź$Ý[ ü‡]$ ÛrJ ë J ü²]' $µ] úsÛr I I
|
|||
|
|
J ź$º] üƒg$ ÛrL ë L ü®g' $±g ÔtÛr K K
|
|||
|
|
L ź$¶g ä”s ÛrN Àc N ü·s: ºs µ ¶ · µÛr ¶ c c ˆ ¢cµ
|
|||
|
|
` £cõ£ ` àB¤GS
|
|||
|
|
·œ¥ M ¾s M
|
|||
|
|
N $¿s × Ås Ü©y ÛrP ·ß P üËy" Îy ¸ ¹ ¸Ûr ¹Ûr O Ñy O
|
|||
|
|
P $Òy ¹
|
|||
|
|
,Øy ¤¥z Ûr ´¾z ÛrS ›e S üÛz3 $Þz º » ºÛr » ™ 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Ð4$ã É U iÎê,é ¿¬ U j ü×DTð Å U köDTü È U lX$ˆ Ì U m±YLâ œ U n´^4ù ì U p´^ í U pÂ_D� „ U qÂ_ … U qýZD‹ ³ U r ÈÛ`d• œ 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ë èv á@¶|" z”ø,øU y y °~\� èv|}~€‚ƒ†‡ˆ‰Š‹�Ž��‘’“”•–—˜™š›œ�žŸ ¡¢£¤¥¦§¨©ª üÆ5DÔ èv { {
|
|||
|
|
| @ Ýü’ -4 ¼ ¼èv { § {
|
|||
|
|
} $¨ üõ .Dƒ èv { {
|
|||
|
|
~ $Œ üÁ"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>
|
|||
|
|
Á È" äzœ{ۼݼ޼© ß¼ à¼ÛἈ cSñŸ«‡zÙÔ{Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
èvÿ¾ { {
|
|||
|
|
¶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.Á<ö% äzœ{¥‚ì‚ { {
|
|||
|
|
€ ¶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>
|
|||
|
|
Á »£|ª*ú $»*¼©*ü *"$Î* äzœ{¥‚Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
èvèvÿ¾ { {
|
|||
|
|
‚ ¶4Ü*´ô*®GD†+üÂ.„ ü˜-@à… Ý-ú üå-1¶† »£|¥.ú $¶.¼¤.ü›."DÉ. äzœ{¥‚Ï� { {
|
|||
|
|
ƒ ¶4Û.´ó.®GD…/ ó/ ƒ àÀ „ øÀ „ •Á „ „ ƒ „À† 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 ½ ¾ ½èv ¾Ûr Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
ÿ¾ { Ë2 {
|
|||
|
|
† $Ì2˜<Ò2üÊ:; ü¯3B ? Initiate a connection on this socket to the specified address.Á ö3ú üþ3F C This function directly corresponds to the `connect(2)` function onÁ ¬É4 Windows and Unix.Á ã4ú üë4G 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>
|
|||
|
|
Á û5ú \ƒ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Á üû7E 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`]Á ”ê9 (Cygwin only).Á<Ñ: ¿ À ¿èv ÀÛr Ö› { Ù: {
|
|||
|
|
‡ $Ú:˜<à:ü’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.Á ìAú üôAJ 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 Á  Áèv ÂÛr ›Ö› { ©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 Ã Ãèv Ö› { ÓJ {
|
|||
|
|
‰ $ÔJ backlogÁ<ÚJüÑP6 üµK8 5 Accept a new incoming connection from this listener.Á òKú üúKD A This function uses `accept4(2)` on platforms that support it andÁ üÃL& # `accept(2)` platforms that do not.Á îLú üöLEý† üÀ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©¨ ”ñOú¨4ØP Ä Äèv Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
èvÛrÿ¾ { ßP {
|
|||
|
|
Š $àPüË\: ü¢[8Á¼ ß[ú üç[E B This function directly corresponds to the `accept(2)` function onÁ ¬±\ˆ�TÒ\ Å Åèv ŸÇ { Ý\ {
|
|||
|
|
‹ $Þ\|¯] ‹ àÀ Œ øÀ Œ •Á Œ Œ ‹ Œ ÛríÇ üê`0 üë]@ = 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ñ` Æ Æèv ºÄ { ü` {
|
|||
|
|
� $ý`üÀ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Á ¬íbˆ� øØÇ#Ÿü‡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 Ç Çèv ºÄ { Ñd {
|
|||
|
|
Ž $ÒdüŠf( ü¥eK H Returns the [`Type`] of this socket by checking the `SO_TYPE` option onÁ „õe
|
|||
|
|
this socket.Á4‘f È Èèv Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
œ{ÿ¾ { ˜f {
|
|||
|
|
� $™füØk- üŸgF C Creates a new independently owned handle to the underlying socket.Á êgú \òg¥í ‚hú üŠhI F On Unix this uses `F_DUPFD_CLOEXEC` and thus sets the `FD_CLOEXEC` onÁ ÄØh the returned socket.Á õhú üýhK 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 É Éèv ì‚ { ék {
|
|||
|
|
� $êküèo- üÏ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üþncüõnn\ïo Ê Êèv Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
ÿ¾ { ûo {
|
|||
|
|
‘ $üoüØ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`.Á ôqú üüqD A On Windows this corresponds to calling `ioctlsocket` (un)settingÁ tÅr `FIONBIO`.Á|ßr Ë Ëèv Ö› { ïr {
|
|||
|
|
’ $ðr‹
|
|||
|
|
\örüä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Á üýt= : 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ëu Ì Ìèv ¶M·M¸M‘ß ¹MºM¨ß »M¼M BothÁ lÏÏ‘£A2Í Ö› { ôu {
|
|||
|
|
“ $õu howÁ ûuü›~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>
|
|||
|
|
Á æxú üîx [`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`.Á$¢~ Í Î Íèv Î
|
|||
|
|
ÑÛÑÛ Ïé ÓÛ 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Á ú€”³‚¤²‚ü©‚ „Ô‚ Ï Ð Ïèv Ю†÷† { å‚ {
|
|||
|
|
• $æ‚õ£ ì‚ü÷„� üÛƒL I Identical to [`recv`] but allows for specification of arbitrary flags toÁ ü¬„ the underlying `recv` call.Á Єú ÔØ„Ž‰|þ„ Ñ Ò Ñèv Ò®†÷† { —… {
|
|||
|
|
– $˜…õ£ ¦…¦Z,Ë…üù�w ü³†Fäö üþ†D A connected. Unlike [`recv`] this allows passing multiple buffers.Á LJú üχ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€‘ Ó Ô Õ Óèv Ô
|
|||
|
|
ñ ñ òÜ; ôˆ ·j
|
|||
|
|
;nŒâ ÕÖ¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†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Ä”– Ö × Ø Öèv ×
|
|||
|
|
ñ ñ òÜ; ôˆ ·j
|
|||
|
|
;nŒâ Øùž { ¶– {
|
|||
|
|
˜ $·–ôž$Å–¦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`].Á ›ú ÔÊ›Ž‰$ð› Ù Ú Ùèv Ú®†÷† { õ› {
|
|||
|
|
™ $ö›õ£ ü›üÁŸ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ÈŸ Û Ü Ûèv Ü®†Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
Ûrÿ¾ { ÒŸ {
|
|||
|
|
š $ÓŸõ£ ÙŸüý¡� üÎ H E Identical to [`recv_from`] but allows for specification of arbitraryÁ ü›¡, ) flags to the underlying `recvfrom` call.Á Ì¡ú üÔ¡$ ! [`recv_from`]: Socket::recv_fromÁ¤„¢ Ý Þ Ýèv Þ®†®³ { ¢¢ {
|
|||
|
|
› $£¢õ£ ±¢¦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”˜¨ ß à á ßèv à
|
|||
|
|
ñ ñ òÜ; ôˆ ·j
|
|||
|
|
;nŒâ áÖ¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
Œ|Ûrÿ¾ { ´¨ {
|
|||
|
|
œ $µ¨ôž$èü̧ üÙ©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ìÓ â ã ä âèv ã
|
|||
|
|
ñ ñ òÜ; ôˆ ·j
|
|||
|
|
;nŒâ ä²» { ú {
|
|||
|
|
� $ûôž$‰®¦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Ô¹ å æ åèv 殆®³ { Þ¹ {
|
|||
|
|
ž $ß¹õ£ å¹üó¼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Á\ú¼ ç çèv ºÄ { †½ {
|
|||
|
|
Ÿ $‡½üâÁ^ üÚ½> ; 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<éÁ è é ê ë ì èèv é œ œ ±Y Î ¡„X dpŽ]S³ ê ë ì÷† { ñÁ {
|
|||
|
|
$òÁ 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>
|
|||
|
|
Á$�Å í î íèv îþØ ÷† { •Å {
|
|||
|
|
¡ $–Åõ£ œÅü‹ÇL üïÅ[ X Identical to [`send`] but allows for specification of arbitrary flags to the underlyingÁ „ÏÆ
|
|||
|
|
`send` call.Á äÆú ÔìÆ [`send`]: Socket::sendÁ|’Ç ï ð ïèv ðþØ ÷† { ¢Ç {
|
|||
|
|
¢ $£Çõ£ ©Ç¦Z,µÇüµÉF ü’ÈI F Send data to the connected peer. Returns the amount of bytes written.Á úÀœœîÈú€”ƒÉúßœ¬—ÉüíÈ@üéÈEüàÈPl¼É ñ ò ó ñèv ò
|
|||
|
|
æ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ÄüÌ ô õ ö ôèv õ
|
|||
|
|
æ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³‰ ú€”·Ñ¤¶ÑüÑ „ØÑ ÷ ø ÷èv øþØ ÷† { éÑ {
|
|||
|
|
¥ $êÑõ£ ðÑüÔ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>
|
|||
|
|
Á<´Ô ù ú û ùèv úþØ ûÛr ÷† { ¼Ô {
|
|||
|
|
¦ $½Ôõ£ ÃÔź$ÏÔü×Ö‡ ü°ÕL I Identical to [`send_to`] but allows for specification of arbitrary flagsÁ ü�Ö$ ! to the underlying `sendto` call.Á ªÖú ü²Ö [`send_to`]: Socket::send_toÁ”ÞÖ ü ý þ üèv ýþØ þÛr ÷† { úÖ {
|
|||
|
|
§ $ûÖõ£ ‰×ź$�צZ,¶×üùÙZ ü¢ØH E Send data to a peer listening on `addr`. Returns the amount of bytesÁ dïØ written.Á øÈÇ#Ÿü€Ù òã úÀœœ²Ùú€”ÇÙúßœ¬ÛÙü±Ù@üÙEü¤ÙP„€Ú ÿ € � ‚ ÿèv €
|
|||
|
|
æLæL çLðè éLˆ¦ —óë@M$ T � ‚Ûr ÷† { ‘Ú {
|
|||
|
|
¨ $’Úôž$˜Úź$®Úü½Ýš ü™Û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ÜÄÝ ƒ „ … † ƒèv „
|
|||
|
|
æLæL çLðè éLˆ¦ —óë@M$ T … †Ûr ÷† { éÝ {
|
|||
|
|
© $êÝôž$øÝź$–Þ¦Z,¯ÞüÜàW ü¥ß9 6 Send a message on a socket using a message structure.Á øàÇ#Ÿüãß òã úÀœœ•àú€”ªàúßœ¬¾àü”à@ü�àEü‡àP<ãà ‡ ˆ ‰ Š ‹ ‡èv ˆ ‡ ‡ ÄW ‹Î Œ„X Ö
|
|||
|
|
ŒNGEN ‰ Š ‹ ÷† { ëà {
|
|||
|
|
ª $ìàœÔ òà¦Z,Œáüàâ*|éâ U œ{œ{
|
|||
|
|
« ´}Lü·è9„ºè U èvì‚
|
|||
|
|
¬ ¨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>Á èv®°±²´µ¶·¹º¼½¿ÀÂÃÄÅÇÈÊËÌ ü•�+ üÉÿ? < 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œ� Œ Œèv þé ¦�
|
|||
|
|
® $§�\¼‚ ® àÀ ¯ øÀ ¯ •Á ¯ ¯ ® ¯ ü–„> üí‚? < 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�„ � �èv Ö› «„
|
|||
|
|
° $¬„“"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§ˆ Ž Žèv Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†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ªŒ � �èv þé ´Œ
|
|||
|
|
² $µŒ\É� ² àÀ ³ øÀ ³ •Á ³ ³ ² ³•Ž ü��> üú�; 8 Set value for the `SO_KEEPALIVE` option on this socket.Á ºŽú üÂŽI F Enable sending of keep-alive messages on connection-oriented sockets.Ál—� � �èv Ö› ¥�
|
|||
|
|
´ $¦�Ð"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ê’ ‘ ‘èv Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†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�§ • •èv þé –§
|
|||
|
|
º $—§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Ϫ – –èv Ö› ܪ
|
|||
|
|
¼ $ݪØ#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¢¯ — —èv Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†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ü²zd³³ ˜ ˜èv Ö› À³
|
|||
|
|
¿ $Á³�$Ddzü•·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Á„œ· ™ ™èv ÷† ·
|
|||
|
|
À $®·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.Á¤žº š šèv Ö› ³º
|
|||
|
|
 $´º™$ººüÖ½: ü¦¼: 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ݽ › ›èv ÷› ê½
|
|||
|
|
à $ë½üŽÀ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.Á„•À œ œèv Ñ�Ö› ¦À
|
|||
|
|
Ä $§Àÿ¡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ŸÃ � �èv þé Ã
|
|||
|
|
Å $®Ã<ÃÄ Å àÀ Æ øÀ Æ •Á Æ Æ Å Æ•Ž üŠÇ> üìÄ; 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.ÁŒ‘Ç ž žèv Ö› £Ç
|
|||
|
|
Ç $¤Ç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Á„þÊ Ÿ Ÿèv ÷† �Ë
|
|||
|
|
È $�Ë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.Á¤ýÍ èv Ö› ’Î
|
|||
|
|
Ê $“Ι$™Îü¶Ñ; ü…Ð: 7 Get value for the `SO_SNDTIMEO` option on this socket.Á ÄÐú üÌÐI F If the returned timeout is `None`, then `write` and `send` cal
|
|||
|
|
¤¥‡ú—
|
|||
|
|
¬Ã‡úÀœœâ‡úÓ
|
|||
|
|
¬ÿ‡ú¥Œžˆú£¤¹ˆúµ”׈ú«
|
|||
|
|
¤óˆú€”‘‰úßœ¬‰üĆ„üÀ†‰ü·†”œ×‰ ® ¯ èv ®Óº ¯ûu Ö› Ï ô‰ Ï
|
|||
|
|
Ø $õ‰ÊÅ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Á
|
|||
|
|
úÜŒçŽúú œ‚�úÞ ¬Ÿ�ú„
|
|||
|
|
¤¾�ú—
|
|||
|
|
¬Ü�úÀœœû�úÓ
|
|||
|
|
¬˜�ú¥Œ·�ú£¤Ò�úµ”ð�ú«
|
|||
|
|
¤Œ‘ú€”ª‘úßœ¬Æ‘üÝŽ„üÙŽ‰üÐŽ”¤ð‘ ° ± ² °èv ±Óº ²ûu Ö› Ï Ž’ Ï
|
|||
|
|
Ù $�’ÊÅ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Ùñ ú ¼›™úú œ¼™ú›”Ù™ú„
|
|||
|
|
¤õ™ú—
|
|||
|
|
¬“šúÀœœ²šúÊ ¬Ïšú¥Œîšú£¤‰›úµ”§›ú€”Ûúßœ¬ß›ü‘™éü�™îü„™ù\‰œ ³ ´ µ ¶ ³èv ´Óº µÓº ¶Óº Ö› Ï žœ Ï
|
|||
|
|
Ú $Ÿœ 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–¥ · ¸ ¹ º ·èv ¸Óº ¹Óº ºÓº Ö› Ï ¬¥ Ï
|
|||
|
|
Û $¥Ÿ…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„ç« » »èv þé Ï ø« Ï
|
|||
|
|
Ü $ù«,“ Ü àÀ Ý øÀ Ý •Á Ý Ý Ü Ý•Ž ü›²? ü¸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¤¢² ¼ ¼èv Ö› Ï ·² Ï
|
|||
|
|
Þ $¸²£ ¾²ü´¶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Á ú€”š¶¤™¶ü�¶ |»¶ ½ ½èv Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†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.Á ú€”•¹¤”¹ü‹¹ œ¶¹ ¾ ¿ ¾èv ¿Óº Ö› Ï Ê¹ Ï
|
|||
|
|
à $˹àÅ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ÁŒì½ À Àèv þé Ï þ½ Ï
|
|||
|
|
á $ÿ½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.Á¬Á Á Áèv Ö› Ï ÃÁ Ï
|
|||
|
|
ã $ÄÁ 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Á„¯Å  Âèv Ô´ Ï ÀÅ Ï
|
|||
|
|
ä $ÁÅ,ÙÆ ä àÀ å øÀ å •Á å å ä 墶 üõÉ> ü€Ç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.Á Éú üµÉ;잤üÉ Ã Ãèv Ö› Ï ‘Ê Ï
|
|||
|
|
æ $’Ê ttlÁ ˜ÊüÄÍ' ü‡Ì9 6 Get the value of the `IP_TTL` option for this socket.Á ÅÌú üÍÌ? < For more informatio
|
|||
|
|
¤µàú—
|
|||
|
|
¬ÓàúÀœœòàúÓ
|
|||
|
|
¬�áúú œ®áú¥ŒËáú£¤æáúµ”„âú«
|
|||
|
|
¤ âú€”¾âúßœ¬Úâü•ßàü‘ßåüˆßð|„ã È Èèv Ö› Ï ”ã Ï
|
|||
|
|
í $•ã 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Á úÜŒöæú ¼‘çúÊ ¬²çú›”ÑçúÞ ¬íçú„
|
|||
|
|
¤Œèú—
|
|||
|
|
¬ªèúÀœœÉèúÓ
|
|||
|
|
¬æèúú œ…éú¥Œ¢éú£¤½éúµ”Ûéú«
|
|||
|
|
¤÷éú€”•êúßœ¬±êüìæàüèæåüßæð\Ûê É Éèv þé Ï çê Ï
|
|||
|
|
î $èêTûë î àÀ ï øÀ ï •Á ï ï î ï•Ž üÁî5 ü©ìB ? Get the value for the `SO_ORIGINAL_DST` option on this socket.Á »£|ƒíúŒ ¬íúÊ ¬Ðíúò œóíú⬔îüŸí•üùìÁüðìÌ|Èî Ê Êèv ºÄ Ï Øî Ï
|
|||
|
|
ð $Ùî\îñ ü®ï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>Á èvòôõ÷øùúüýÿ€‚ƒ…†ˆ‰‹ŒŽ�‘’ üÂö4 ü€ò<�× Áòú üÉòK H For more information about this option, see [`set_header_included_v6`].Á ™óú ü¡ó> ; [`set_header_included_v6`]: Socket::set_header_included_v6Á »£|÷óúÀœœ¥ôú£¤Æôú—
|
|||
|
|
¬èôú¶ ¬‹õú ¼®õú„
|
|||
|
|
¤Óõú€”õõúßœ¬•öü—ô�ü“ô¢üíóÎüäóÙ”Éö Ë Ëèv þé ñ Üö ñ
|
|||
|
|
ò $ÝöTò÷ ò àÀ ó øÀ ó •Á ó ó ò ó•Ž ü¸ÿF ü¡ø<¹Û âøú üêøI�Ü ü¸ùKáÜ üˆúJ G When this flag is enabled, the values set by `IP_OPTIONS` are ignored.Á ×úú ÜßúÂÞ üÿú>èÞ »£|íüúÀœœ›ýú£¤¼ýú—
|
|||
|
|
¬Þýú¶ ¬�þú ¼¤þú„
|
|||
|
|
¤Éþú€”ëþúßœ¬‹ÿü�ý�ü‰ý¢üãüÎüÚüÙ ´¿ÿ Ì Ìèv Ö› ñ Öÿ ñ
|
|||
|
|
ô $×ÿ½á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Œ“… Í Íèv þé ñ ¥… ñ
|
|||
|
|
õ $¦…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¬«Ž Î Îèv Ö› ñ ÁŽ ñ
|
|||
|
|
÷ $ÂŽž\ÈŽüô“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).Á ú¥ŒÛ“œÚ“ôÑ“Œû“ Ï Ð Ïèv к½ Ö› ñ �” ñ
|
|||
|
|
ø $Ž”ÊÅ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Á ú¥Œ¦šœ¥šôœš”Æš Ñ Ò Ñèv Òº½ Ö› ñ Ùš ñ
|
|||
|
|
ù $ÚšÊÅ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Á ú€”´ ¤³ üª ŒÕ Ó Óèv Ô´ ñ ç ñ
|
|||
|
|
ú $è 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ý¤ üœ¤>Ò¥ ú€”餤è¤üߤ ¬Š¥ Ô Ôèv Ö› ñ ¥ ñ
|
|||
|
|
ü $¡¥ 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„Á© Õ Õèv þé ñ Ò© ñ
|
|||
|
|
ý $Ó©,ñª ý àÀ þ øÀ þ •Á þ þ ý þ•Ž üý¯? ü–«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¤„° Ö Öèv Ö› ñ ™° ñ
|
|||
|
|
ÿ $š°£ °üœ´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_multicast_if_v6Á ú€”‚´¤�´üø³ |£´
|
|||
|
|
¤ÎÓú—
|
|||
|
|
¬ìÓúÀœœ‹ÔúÓ
|
|||
|
|
¬¨Ôúú œÇÔú›”äÔú£¤€Õúµ”žÕú€”ºÕúßœ¬ÖÕüåÒŒüáÒ‘üØÒœt€Ö ß ßèv þé ñ �Ö ñ
|
|||
|
|
Œ $�Ö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.Á
|
|||
|
|
ú ¼þÙúÊ ¬ŸÚúÞ ¬¾Úú„
|
|||
|
|
¤ÝÚú—
|
|||
|
|
¬ûÚúÀœœšÛúÓ
|
|||
|
|
¬·Ûúú œÖÛú›”óÛú£¤�Üúµ”Üú€”ÉÜúßœ¬åÜüôÙŒüðÙ‘üçÙœ”�Ý à àèv Ö› ñ ¢Ý ñ
|
|||
|
|
Ž $£Ý 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Á »£|£áâ <Ñáú ¼æáúÊ ¬‹âúÞ ¬®âú„
|
|||
|
|
¤Ñâú—
|
|||
|
|
¬óâúÀœœ–ãúÓ
|
|||
|
|
¬·ãúú œÚãú›”ûãú£¤›äúµ”½äú«
|
|||
|
|
¤Ýäú€”ÿäúßœ¬ŸåüÃáûü¿á€ü™á¬ü�á·„Óå á áèv þé ñ äå ñ
|
|||
|
|
� $åå|�ç � àÀ � øÀ � •Á � � � �•Ž üèí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:Á »£|¿éâ <íéú ¼‚êúÊ ¬§êúÞ ¬Êêú„
|
|||
|
|
¤íêú—
|
|||
|
|
¬�ëúÀœœ²ëúÓ
|
|||
|
|
¬Óëúú œöëú›”—ìú£¤·ìúµ”Ùìú«
|
|||
|
|
¤ùìú€”›íúßœ¬»íüßéûüÛé€üµé¬ü¬é·¤ïí â âèv Ö› ñ „î ñ
|
|||
|
|
‘ $…î
|
|||
|
|
recv_hoplimitÁl‹îüÝñ5 ü’ðG D Get the value for the `IP6T_SO_ORIGINAL_DST` option on this socket.Á »£|ñðúŒ ¬Žñúò œ¥ñú⬺ñü�ñCüçðoüÞðz|äñ ã ãèv ºÄ ñ ôñ ñ
|
|||
|
|
’ $õñ\øô üÊò@ = 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>Á èv”•—™šœ ü¦ø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.Á »£|õöâ <£÷úú œ¸÷ú—
|
|||
|
|
¬Ù÷úµ”ü÷ü•÷ƒü‘÷ˆüëö´üâö¿”ø ä äèv Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†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Á »£|†ûúŒ ¬°ûú ¼Óûú¶ ¬øûúÊ ¬›üúÞ ¬¾üúå Œáüúô ´€ýúò œ¤ýúˆ œÅýú„
|
|||
|
|
¤æýú™ ”ˆþú© ¬¨þú«
|
|||
|
|
¤Ëþ ú€”ñþî‘Œ‰ÿœˆÿüðþ,ü¢û…üüú±üóú¼´»ÿ å åèv �ž “ Òÿ “
|
|||
|
|
• $Óÿ4î€ • àÀ – øÀ – •Á – – • – ˜Ž › üæ‡6 ü¬�= : Get the value of the `TCP_KEEPCNT` option on this socket.Á î�ú üö�Fñž Á‚ú üÉ‚4ÏŸ »£|•ƒúŒ ¬¿ƒú ¼âƒú¶ ¬‡„úÊ ¬ª„úÞ ¬Í„úå Œð„úô ´�…úò œ³…úˆ œÔ…ú„
|
|||
|
|
¤õ…ú™ ”—†ú© ¬·†ú«
|
|||
|
|
¤Ú†úâ¬ü† ú€”£‡î‘Œ»‡œº‡ü¢‡,ü±ƒ¨ü‹ƒÔü‚ƒß¬í‡ æ æèv Ô´ “ ƒˆ “
|
|||
|
|
— $„ˆL˜‰ — àÀ ˜ øÀ ˜ •Á ˜ ˜ — ˜¢¶ üò•H üljD 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Ë•Œú <Þ•£ú ê•úŒù• ç è çèv 趄 Ö› “ ‹– “
|
|||
|
|
™ $Œ– 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Á\ø˜ é éèv þé “ „™ “
|
|||
|
|
š $…™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.Á|ä� ê êèv Ö› “ ô� “
|
|||
|
|
œ $õ� nodelayÁ<û�¤ç¢ èvžŸ á â ž Ÿ ü‚£7$…£ ë ì ëèv ìþØ÷† � Š£ �
|
|||
|
|
ž $�£õ£ •£ü�¦M úÀœœÉ¥ú€”Þ¥úßœ¬ò¥üÈ¥@üÄ¥Eü»¥Pl“¦ í î ï íèv î
|
|||
|
|
ö ö ÷ Ôß ù ˆ¦ èóÇãp9Ü ï÷† � ¡¦ �
|
|||
|
|
Ÿ $¦¦ôž$¬¦Dšª Ÿ àÀ øÀ •Á Ÿ ÇŸ 䯪 š2 ¢ ¢ ™w£¤ á â £ ¤ ´ªüÒª7$Õª ð ñ ð™w ñþØ÷† ¡ Úª ¡
|
|||
|
|
£ š2$ߪõ£ åªü„M úÀœœ½¬ú€”Ò¬úßœ¬æ¬ü¼¬@ü¸¬Eü¯¬Pl‡ ò ó ô ò™w ó
|
|||
|
|
ö ö ÷ Ôß ù ˆ¦ èóÇãp9Ü ô÷† ¡ • ¡
|
|||
|
|
¤ š2$šôž$ D�¯ ¤àÀ ¥ øÀ ¥ •Á ¥ ¥ ¤ ¥ •Â ¬¢¯ èv§¨© ! ¡! ¤! ¨ © § ü¾¯4,Á¯ õ ö õèv öþØ ÷† ¦ ǯ ¦
|
|||
|
|
§ $̯õ£ Ò¯üì°G úÀœœ¥°ú€”º°úßœ¬Î°ü¤°@ü °Eü—°Ptï° ÷ ø ù ÷èv ø
|
|||
|
|
æLæL çLðè éLˆ¦ —óë@M$ T ù ÷† ¦ þ° ¦
|
|||
|
|
¨ $ƒ±ôž$‰±üâ±%,å± ú úèvÖ› ¦ ë± ¦
|
|||
|
|
© $ð±ì¢² š2 « « ™w¬® ! ¡! ¤! ¬ ® §²üƲ4,ɲ û ü û™w üþØ ÷† ª ϲ ª
|
|||
|
|
¬ š2$Ô²õ£ Ú²üô³G úÀœœ³ú€”³úßœ¬Ö³ü¬³@ü¨³EüŸ³Pt÷³ ý þ ÿ ý™w þ
|
|||
|
|
æLæL çLðè éLˆ¦ —óë@M$ T ÿ ÷† ª †´ ª
|
|||
|
|
š2$‹´ôž$‘´üê´%,í´ € € ™wÖ› ª ó´ ª
|
|||
|
|
® š2$ø´Ôªµ èv° Àc ° ü˵8 ε � ‚ ƒ � èv ‚ 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¹ñ± <ÆÝ¡ <Σú <á ç3 ¼ ¼ Ày ;N3”øNF> ½¾éä«4«± » » ÃÛÃÛ åÏ ÅÛ»¬ „ µÜÀ,�%*èvüê"Lê± » » • • – Šé Fu\»Ÿ ç3èv ô‘ ç3 À À ÀyÁ ê! ë!  –\¶4» ¿ ¿ èvüÑ ,Ô „ „ Ày „ Ày ê! ¿ Ú ¿
|
|||
|
|
 ç3$Ûü£: ü’M J On Windows, a corresponding `From<&impl AsSocket>` implementation exists.Á ú $ê ú€”ôî‘ŒŒœ‹üó,üé7üàB ç3 Ä ¤ Å Ä Å Íì�z ¬ �,�z $ØÀyÆ ë Æ ¨') ô� üä4 1 The caller must ensure `S` is actually a socket.Á$ ŠzÀy à Ã
|
|||
|
|
Æ ç3�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º
|
|||
|
|
²– É ×™Ð$Ú
|
|||
|
|
�, É Ù²Ð<à
|
|||
|
|
«+ É Ú
|
|||
|
|
BorrowedFdÁTé
|
|||
|
|
ÎN É ÛáàLõ
|
|||
|
|
+ É ÜýàL€ ¯+ É Ýº}<‹ ö+ É Þ RawFdÁ,” ª+ É ß OsStrExtÁDÔ Ï$ É à±dš ’' É âé~d¨ ã' É ã£~T¶ ( É äÂ�$ò …0 É åµ �
|
|||
|
|
“ É æ¬šD–
|
|||
|
|
Ö É è InstantÁ<
|
|||
|
|
óT É éì�´
|
|||
|
|
¦ É ëž,¸
|
|||
|
|
ë1 É ì ssize_tÁ<ø É í€¼DŒ õ É ïœ¹<– è É ðï|Ì ( É ñ É´^4é ì É ó´^ í É óÂ_Dñ „ É ôÂ_ … É ôýZDû ³ É õ ÈÛ`d… œ É öó$“ ø É ÷ó ù É ÷ÄW4÷ ‡ É ù±YLÿ œ É úŽ`LŠ � É ûŽ` ‘ É ûÎê,° ¿¬ ü”‘<‚ � ý©’<¡ � ÿÈ’Dª — € SOCK_DCCPÁL� œ@ � SOCK_RAWÁDÜ í ‚ SOCK_SEQPACKETÁtí ›@ ƒ
|
|||
|
|
SOCK_DGRAMÁT“ ÄH … SOCK_STREAMÁ\Ÿ ÃH † IPPROTO_DCCPÁd‹ £ ‡
|
|||
|
|
IPPROTO_MPTCPÁlÊ ¶ ˆ IPPROTO_SCTPÁd¼ ° ‰ IPPROTO_UDPLITEÁ|Œ ² Š IPPROTO_ICMPÁdÓ Ë Œ IPPROTO_ICMPV6Átá Ì � IPPROTO_TCPÁ\ˆ Í � IPPROTO_UDPÁ\• Î �Ý\Ê Å ’æD× � “Ì‘\á ˜ ”î‘dî ¥ •ŠŒ„ü € –ÍLŽ Ü — MSG_TRUNCÁLÂ Þ ˜ SO_OOBINLINEÁdœ ÄO ™ Ipv6MreqÁD€ ˆ š IPV6_HDRINCLÁdÑ Ú › IPV6_RECVHOPLIMITÁŒÏ$ Ý œ IPV6_RECVTCLASSÁ|Ü' é �
|
|||
|
|
IP_HDRINCLÁT¯) ñ ž
|
|||
|
|
IP_RECVTOSÁTý, û Ÿ IP_TOSÁ4Í. ï Î Lý/ ÇO ¡ SO_PASSCREDÁ\“2 ÊO ¢ SO_PRIORITYÁ\¤3 ÆO £ IpMreqÁ4×3 ð ¥û"4ß3 » ¦
|
|||
|
|
IPPROTO_IPÁTç3 Ï § IPPROTO_IPV6Ádó3 Ð ¨ IPV6_MULTICAST_LOOPÁœ�4 Î © IPV6_UNICAST_HOPSÁŒ–4 Ë ª IPV6_V6ONLYÁ\4 Õ « IP_ADD_MEMBERSHIPÁŒº4 ‹ ¬ IP_DROP_MEMBERSHIPÁ”Í4 Œ IP_MULTICAST_LOOPÁŒá4 Š ® IP_MULTICAST_TTLÁ„ô4 ‰ ¯ IP_TTLÁ4Š5 ð ° MSG_PEEKÁD’5 Û ±
|
|||
|
|
SOL_SOCKETÁTœ5 »O ² SO_BROADCASTÁd¨5 ÀO ³ SO_ERRORÁD¶5 ¾O ´ SO_KEEPALIVEÁdÀ5 ÃO µ SO_RCVBUFÁLÎ5 ÂO ¶ SO_RCVTIMEOÁ\Ù5 €Q · SO_REUSEADDRÁdê5 ¼O ¸ SO_SNDBUFÁLø5 ÁO ¹ SO_SNDTIMEOÁ\ƒ6 �Q º SO_TYPEÁ<�6 ½O » TCP_NODELAYÁ\™6 ñ ¼ IpMreqSourceÁdœ9 ƒ ¾ IP_ADD_SOURCE_MEMBERSHIPÁĪ9 � ¿ IP_DROP_SOURCE_MEMBERSHIPÁÌÄ9 � ÀÁ œö< Ï Â¤‹= Ð Ã IPV6_MULTICAST_HOPSÁœÇA Í Å IPV6_MULTICAST_IFÁŒÜA Ì Æ IP_MULTICAST_IFÁ|ïA ˆ Ç MSG_OOBÁ<€B Ú È TCP_KEEPCNTÁ\•F ö Ê
|
|||
|
|
TCP_KEEPINTVLÁl¢F õ ËãtÆK ô É Í msghdrÁ4Œ¯ C ïlå½ |˜ª „þ› Ä”Œ D²h ·Z ] J M ”Þ= Dö. 1 ¤Ú ´°
|