Sockets
Sockets.Sockets — Module
Sockets.connect — Method
connect([host], port::Integer) -> TCPSocketホスト host のポート port に接続します。
Sockets.connect — Method
connect(path::AbstractString) -> PipeEndpoint名前付きパイプ / UNIX ドメインソケット path に接続します。
Sockets.listen — Method
listen([addr, ]port::Integer; backlog::Integer=BACKLOG_DEFAULT) -> TCPServeraddrで指定したアドレスのポートで待ち受けます。デフォルトでは、localhostのみで待ち受けます。すべてのインターフェースで待ち受けるには、状況に応じてIPv4(0)またはIPv6(0)を渡します。backlogは、サーバーが接続を拒否し始めるまでに保留できる接続数(acceptをまだ呼び出していない接続数)を指定します。backlogのデフォルト値は511です。
Sockets.listen — Method
listen(path::AbstractString) -> PipeServer名前付きパイプ/UNIXドメインソケットを作成して、接続を待ち受けます。
Sockets.getaddrinfo — Function
getaddrinfo(host::AbstractString, IPAddr) -> IPAddr指定されたIPAddr型のhostについて、最初のIPアドレスを取得します。オペレーティングシステムの基盤となるgetaddrinfo実装を使用するため、DNSルックアップが行われる場合があります。
Examples
julia> getaddrinfo("localhost", IPv6)
ip"::1"
julia> getaddrinfo("localhost", IPv4)
ip"127.0.0.1"getaddrinfo(host::AbstractString) -> IPAddrhostの最初に利用可能なIPアドレスを取得します。これはIPv4またはIPv6アドレスのいずれかです。オペレーティングシステムの基盤となるgetaddrinfo実装を使用するため、DNSルックアップが行われる場合があります。
Sockets.getipaddr — Function
getipaddr() -> IPAddrローカルマシンの IP アドレスを取得します。IPv4 アドレスが IPv6 アドレスより優先されます。アドレスがない場合は例外をスローします。
getipaddr(addr_type::Type{T}) where T<:IPAddr -> T指定した種類のローカルマシンの IP アドレスを取得します。指定した種類のアドレスがない場合は例外をスローします。
この関数は、後方互換性のための getipaddrs のラッパーです。新しいアプリケーションでは、代わりに getipaddrs を使用してください。
Examples
julia> getipaddr()
ip"192.168.1.28"
julia> getipaddr(IPv6)
ip"fe80::9731:35af:e1c5:6e49"getipaddrs も参照してください。
Sockets.getipaddrs — Function
getipaddrs(addr_type::Type{T}=IPAddr; loopback::Bool=false) where T<:IPAddr -> Vector{T}ローカルマシンの IP アドレスを取得します。
省略可能な addr_type パラメーターに IPv4 または IPv6 を設定すると、その種類のアドレスのみが返されます。
loopback キーワード引数は、ループバックアドレス(例: ip"127.0.0.1"、ip"::1")を含めるかどうかを指定します。
Examples
julia> getipaddrs()
5-element Vector{IPAddr}:
ip"198.51.100.17"
ip"203.0.113.2"
ip"2001:db8:8:4:445e:5fff:fe5d:5500"
ip"2001:db8:8:4:c164:402e:7e3c:3668"
ip"fe80::445e:5fff:fe5d:5500"
julia> getipaddrs(IPv6)
3-element Vector{IPv6}:
ip"2001:db8:8:4:445e:5fff:fe5d:5500"
ip"2001:db8:8:4:c164:402e:7e3c:3668"
ip"fe80::445e:5fff:fe5d:5500"関連項目: islinklocaladdr。
Sockets.islinklocaladdr — Function
islinklocaladdr(addr::IPAddr)IPアドレスがリンクローカルアドレスかどうかを判定します。リンクローカルアドレスは、ネットワークセグメントを越えて一意であることが保証されないため、ルーターは転送しません。リンクローカルアドレスは、アドレスブロック 169.254.0.0/16 または fe80::/10 に属します。
Examples
filter(!islinklocaladdr, getipaddrs())Sockets.getalladdrinfo — Function
getalladdrinfo(host::AbstractString) -> Vector{IPAddr}host のすべての IP アドレスを取得します。オペレーティングシステムの基盤となる getaddrinfo 実装を使用します。この実装では、DNS ルックアップが行われる場合があります。
Examples
julia> getalladdrinfo("google.com")
2-element Vector{IPAddr}:
ip"172.217.6.174"
ip"2607:f8b0:4000:804::200e"Sockets.DNSError — Type
DNSErrorDNS ルックアップでエラーが発生したときにスローされる例外の型です。host フィールドはホストの URL 文字列を示します。code フィールドは libuv に基づくエラーコードを示します。
Sockets.getnameinfo — Function
getnameinfo(host::IPAddr) -> Stringオペレーティングシステムの基盤となるgetnameinfo実装を使用して、IPアドレスの逆引きを行い、ホスト名とサービスを返します。
Examples
julia> getnameinfo(IPv4("8.8.8.8"))
"google-public-dns-a.google.com"Sockets.getsockname — Function
getsockname(sock::Union{TCPServer, TCPSocket}) -> (IPAddr, UInt16)指定したソケットがバインドされている IP アドレスとポートを取得します。
Sockets.getpeername — Function
getpeername(sock::TCPSocket) -> (IPAddr, UInt16)指定したソケットが接続しているリモートエンドポイントの IP アドレスとポートを取得します。接続済みの TCP ソケットでのみ有効です。
Sockets.IPAddr — Type
Sockets.IPv4 — Type
IPv4(host::Integer) -> IPv4IPアドレス host を Integer としてフォーマットした IPv4 オブジェクトを返します。
Examples
julia> IPv4(3223256218)
ip"192.30.252.154"IPv4(str::AbstractString) -> IPv4IPv4アドレス文字列をIPv4オブジェクトに解析します。
Examples
julia> IPv4("127.0.0.1")
ip"127.0.0.1"Sockets.IPv6 — Type
IPv6(host::Integer) -> IPv6IPアドレス host から、Integer としてフォーマットされた IPv6 オブジェクトを返します。
Examples
julia> IPv6(3223256218)
ip"::c01e:fc9a"IPv6(str::AbstractString) -> IPv6IPv6アドレス文字列をIPv6オブジェクトに解析します。
Examples
julia> IPv6("::1")
ip"::1"Sockets.@ip_str — Macro
@ip_str str -> IPAddrstr を IP アドレスとして解析します。
Examples
julia> ip"127.0.0.1"
ip"127.0.0.1"
julia> @ip_str "2001:db8:0:0:0:0:2:1"
ip"2001:db8::2:1"Sockets.TCPSocket — Type
TCPSocket(; delay=true)libuv を使用して TCP ソケットを開きます。delay が true の場合、libuv は最初の bind 呼び出しまで、ソケットのファイル記述子の作成を遅らせます。TCPSocket には、ソケットの状態と送受信バッファーを示すさまざまなフィールドがあります。
Sockets.UDPSocket — Type
UDPSocket()libuv を使って UDP ソケットを開きます。UDPSocket には、ソケットの状態を示すさまざまなフィールドがあります。
Sockets.accept — Function
accept(server[, client])指定されたサーバーで接続を受け入れ、クライアントへの接続を返します。未初期化のクライアントストリームを指定した場合は、新しいストリームを作成する代わりにそれを使用します。
Sockets.listenany — Function
listenany([host::IPAddr,] port_hint; backlog::Integer=BACKLOG_DEFAULT) -> (UInt16, TCPServer)hint を起点として、任意のポートで TCPServer を作成します。サーバーが実際に作成されたポートとサーバー自体のタプルを返します。backlog 引数は、sockfd の保留中の接続キューの最大長を指定します。
Base.bind — Function
bind(chnl::Channel, task::Task)chnlのライフタイムをタスクに関連付けます。タスクが終了すると、Channel chnlは自動的に閉じられます。タスク内で捕捉されなかった例外は、chnlで待機しているすべてのタスクに伝播します。
chnlオブジェクトは、タスクの終了とは無関係に明示的に閉じることができます。タスクが終了しても、すでに閉じられているChannelオブジェクトには影響しません。
チャネルが複数のタスクに関連付けられている場合、最初に終了したタスクがチャネルを閉じます。複数のチャネルが同じタスクに関連付けられている場合、そのタスクが終了すると、関連付けられているすべてのチャネルが閉じられます。
Examples
julia> c = Channel(0);
julia> task = @async foreach(i->put!(c, i), 1:4);
julia> bind(c,task);
julia> for i in c
@show i
end;
i = 1
i = 2
i = 3
i = 4
julia> isopen(c)
falsejulia> c = Channel(0);
julia> task = @async (put!(c, 1); error("foo"));
julia> bind(c, task);
julia> take!(c)
1
julia> put!(c, 1);
ERROR: TaskFailedException
Stacktrace:
[...]
nested task error: foo
[...]bind(socket::Union{TCPServer, UDPSocket, TCPSocket}, host::IPAddr, port::Integer; ipv6only=false, reuseaddr=false, kws...)socket を指定された host:port にバインドします。0.0.0.0 はすべてのデバイスで待ち受けることに注意してください。
ipv6onlyパラメーターを指定すると、デュアルスタックモードが無効になります。ipv6only=trueの場合、IPv6 スタックのみが作成されます。reuseaddr=trueの場合、複数のスレッドまたはプロセスがreuseaddr=trueをすべて設定していれば、同じアドレスにエラーなくバインドできます。ただし、トラフィックを受信できるのは最後にバインドしたものだけです。
Sockets.send — Function
send(socket::UDPSocket, host::IPAddr, port::Integer, msg)msg を socket 経由で host:port に送信します。
Sockets.recv — Function
recv(socket::UDPSocket)指定したソケットから UDP パケットを読み取り、受信したバイト列を返します。この呼び出しはブロックします。
Sockets.recvfrom — Function
recvfrom(socket::UDPSocket) -> (host_port, data)指定したソケットから UDP パケットを読み取り、(host_port, data) のタプルを返します。このとき、host_port は、適切な型の InetAddr{IPv4} または InetAddr{IPv6} になります。
Sockets.setopt — Function
setopt(sock::UDPSocket; multicast_loop=nothing, multicast_ttl=nothing, enable_broadcast=nothing, ttl=nothing)UDPソケットのオプションを設定します。
multicast_loop: マルチキャストパケットのループバック(デフォルト:true)。multicast_ttl: マルチキャストパケットのTTL(デフォルト:nothing)。enable_broadcast: ソケットをブロードキャストメッセージに使用する場合は、このフラグをtrueに設定する必要があります。設定しないと、UDPシステムからアクセスエラーが返されます(デフォルト:false)。ttl: ソケットから送信されるパケットの生存時間(デフォルト:nothing)。
Sockets.nagle — Function
nagle(socket::Union{TCPServer, TCPSocket}, enable::Bool)Nagleのアルゴリズムは、複数の小さなTCPパケットをまとめて、より大きなパケットにします。これによりスループットが向上する一方、レイテンシが悪化することがあります。Nagleのアルゴリズムはデフォルトで有効です。この関数は、指定したTCPサーバーまたはソケットでNagleのアルゴリズムを有効にするかどうかを設定します。他の言語では、反対の設定をTCP_NODELAYと呼びます。
Sockets.quickack — Function
quickack(socket::Union{TCPServer, TCPSocket}, enable::Bool)Linuxシステムでは、socketでTCP_QUICKACKが無効または有効になります。