Sockets

Sockets.connect — Method
connect([host], port::Integer) -> TCPSocket

ホスト host のポート port に接続します。

source
Sockets.connect — Method
connect(path::AbstractString) -> PipeEndpoint

名前付きパイプ / UNIX ドメインソケット path に接続します。

Note

Unix では、パスの長さは 92〜108 バイト程度に制限されています(man unix を参照)。

source
Sockets.listen — Method
listen([addr, ]port::Integer; backlog::Integer=BACKLOG_DEFAULT) -> TCPServer

addrで指定したアドレスのポートで待ち受けます。デフォルトでは、localhostのみで待ち受けます。すべてのインターフェースで待ち受けるには、状況に応じてIPv4(0)またはIPv6(0)を渡します。backlogは、サーバーが接続を拒否し始めるまでに保留できる接続数(acceptをまだ呼び出していない接続数)を指定します。backlogのデフォルト値は511です。

source
Sockets.listen — Method
listen(path::AbstractString) -> PipeServer

名前付きパイプ/UNIXドメインソケットを作成して、接続を待ち受けます。

Note

Unixでは、パスの長さは92~108バイト程度に制限されています(man unix)。

source
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"
source
getaddrinfo(host::AbstractString) -> IPAddr

hostの最初に利用可能なIPアドレスを取得します。これはIPv4またはIPv6アドレスのいずれかです。オペレーティングシステムの基盤となるgetaddrinfo実装を使用するため、DNSルックアップが行われる場合があります。

source
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 も参照してください。

source
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")を含めるかどうかを指定します。

Julia 1.2

この関数は Julia 1.2 以降で利用できます。

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。

source
Sockets.islinklocaladdr — Function
islinklocaladdr(addr::IPAddr)

IPアドレスがリンクローカルアドレスかどうかを判定します。リンクローカルアドレスは、ネットワークセグメントを越えて一意であることが保証されないため、ルーターは転送しません。リンクローカルアドレスは、アドレスブロック 169.254.0.0/16 または fe80::/10 に属します。

Examples

filter(!islinklocaladdr, getipaddrs())
source
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"
source
Sockets.DNSError — Type
DNSError

DNS ルックアップでエラーが発生したときにスローされる例外の型です。host フィールドはホストの URL 文字列を示します。code フィールドは libuv に基づくエラーコードを示します。

source
Sockets.getnameinfo — Function
getnameinfo(host::IPAddr) -> String

オペレーティングシステムの基盤となるgetnameinfo実装を使用して、IPアドレスの逆引きを行い、ホスト名とサービスを返します。

Examples

julia> getnameinfo(IPv4("8.8.8.8"))
"google-public-dns-a.google.com"
source
Sockets.getsockname — Function
getsockname(sock::Union{TCPServer, TCPSocket}) -> (IPAddr, UInt16)

指定したソケットがバインドされている IP アドレスとポートを取得します。

source
Sockets.getpeername — Function
getpeername(sock::TCPSocket) -> (IPAddr, UInt16)

指定したソケットが接続しているリモートエンドポイントの IP アドレスとポートを取得します。接続済みの TCP ソケットでのみ有効です。

source
Sockets.IPAddr — Type
IPAddr

IPアドレスの抽象スーパータイプです。IPv4 と IPv6 は、この型のサブタイプです。

source
Sockets.IPv4 — Type
IPv4(host::Integer) -> IPv4

IPアドレス host を Integer としてフォーマットした IPv4 オブジェクトを返します。

Examples

julia> IPv4(3223256218)
ip"192.30.252.154"
source
IPv4(str::AbstractString) -> IPv4

IPv4アドレス文字列をIPv4オブジェクトに解析します。

Examples

julia> IPv4("127.0.0.1")
ip"127.0.0.1"
source
Sockets.IPv6 — Type
IPv6(host::Integer) -> IPv6

IPアドレス host から、Integer としてフォーマットされた IPv6 オブジェクトを返します。

Examples

julia> IPv6(3223256218)
ip"::c01e:fc9a"
source
IPv6(str::AbstractString) -> IPv6

IPv6アドレス文字列をIPv6オブジェクトに解析します。

Examples

julia> IPv6("::1")
ip"::1"
source
Sockets.@ip_str — Macro
@ip_str str -> IPAddr

str を 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"
source
Sockets.TCPSocket — Type
TCPSocket(; delay=true)

libuv を使用して TCP ソケットを開きます。delay が true の場合、libuv は最初の bind 呼び出しまで、ソケットのファイル記述子の作成を遅らせます。TCPSocket には、ソケットの状態と送受信バッファーを示すさまざまなフィールドがあります。

source
Sockets.UDPSocket — Type
UDPSocket()

libuv を使って UDP ソケットを開きます。UDPSocket には、ソケットの状態を示すさまざまなフィールドがあります。

source
Sockets.accept — Function
accept(server[, client])

指定されたサーバーで接続を受け入れ、クライアントへの接続を返します。未初期化のクライアントストリームを指定した場合は、新しいストリームを作成する代わりにそれを使用します。

source
Sockets.listenany — Function
listenany([host::IPAddr,] port_hint; backlog::Integer=BACKLOG_DEFAULT) -> (UInt16, TCPServer)

hint を起点として、任意のポートで TCPServer を作成します。サーバーが実際に作成されたポートとサーバー自体のタプルを返します。backlog 引数は、sockfd の保留中の接続キューの最大長を指定します。

source
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)
false
julia> 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
[...]
source
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 をすべて設定していれば、同じアドレスにエラーなくバインドできます。ただし、トラフィックを受信できるのは最後にバインドしたものだけです。
source
Sockets.send — Function
send(socket::UDPSocket, host::IPAddr, port::Integer, msg)

msg を socket 経由で host:port に送信します。

source
Sockets.recv — Function
recv(socket::UDPSocket)

指定したソケットから UDP パケットを読み取り、受信したバイト列を返します。この呼び出しはブロックします。

source
Sockets.recvfrom — Function
recvfrom(socket::UDPSocket) -> (host_port, data)

指定したソケットから UDP パケットを読み取り、(host_port, data) のタプルを返します。このとき、host_port は、適切な型の InetAddr{IPv4} または InetAddr{IPv6} になります。

Julia 1.3

Julia 1.3 より前のバージョンでは、最初に返される値はアドレス(IPAddr)でした。バージョン 1.3 で InetAddr に変更されました。

source
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)。
source
Sockets.nagle — Function
nagle(socket::Union{TCPServer, TCPSocket}, enable::Bool)

Nagleのアルゴリズムは、複数の小さなTCPパケットをまとめて、より大きなパケットにします。これによりスループットが向上する一方、レイテンシが悪化することがあります。Nagleのアルゴリズムはデフォルトで有効です。この関数は、指定したTCPサーバーまたはソケットでNagleのアルゴリズムを有効にするかどうかを設定します。他の言語では、反対の設定をTCP_NODELAYと呼びます。

Julia 1.3

この関数を使用するには、Julia 1.3以降が必要です。

source
Sockets.quickack — Function
quickack(socket::Union{TCPServer, TCPSocket}, enable::Bool)

Linuxシステムでは、socketでTCP_QUICKACKが無効または有効になります。

source