Socket

ソケットそのものに対するシステムコールレベルのアクセスを提供するクラス。Perlのソケットに対するアクセスと同レベルの機能を提供してます。このクラスではソケットアドレスは pack された文字列で指定します (ソケットアドレス構造体を pack した文字列を参照)。

一般的なソケットプログラミングはより高レベルの TCPSocketクラスや TCPServerクラスを用いて行われることが多く、このクラスはあまり用いられません。

クラスメソッド:

Socket.open(domain, type, protocol)

Socket.new(domain, type, protocol)

新しいソケットを生成します。domain、type、 protocol はインクルードファイルにある定数で指定します。ほとんどの定数は Socket::AF_INET のように Socket クラスの定数として定義されています。domain とtype に関しては、"AF_INET", "SOCK_STREAM" のように文字列でも指定できますが、文字列ですべての機能を指定できる保証はありません。

Socket.for_fd(fd)

ファイルディスクリプタ fd に対する新しいソケットを生成します。

ruby 1.7 feature: このメソッドは BasicSocket に移動しました。

Socket.getaddrinfo(nodename, servname[, family[, socktype[, protocol[, flags]]]])

RFC 2553で定義された getaddrinfo()の機能を提供するクラスメソッド。この関数は gethostbyname()やgetservbyname()の代わりとして用意されており、 IPのバージョンに依存しないプログラムを書くための標準的なAPIです。

アドレス情報の配列を返します。アドレス情報とは7つの要素からなる次の形の配列です。

第0要素 - アドレスファミリー(String)。
第1要素 - ポート番号(Integer)。
第2要素 - ホスト名(String)。
第3要素 - アドレス(String)。
第4要素 - アドレスファミリーに対応するInteger。
第5要素 - ソケットタイプに対応するInteger。
第6要素 - プロトコルに対応するInteger。

必須引数の意味は以下の通りです。

nodename - ホスト名。 (ホスト指定形式を参照)
servname - サービス名。 (サービス指定形式を参照)

残りの引数は省略可能です。

family - アドレスファミリー。 Socket::AF_INET など、アドレスファミリーにある定数を指定します。
socktype - ソケットタイプ。 Socket::SOCK_STREAM など、ソケットタイプにある定数を指定します。
protocol - プロトコル。 Socket::IPPROTO_IP など、プロトコルにある定数を指定します。
flags - getaddrinfo(3)の第3引数に指定するaddrinfo構造体の ai_flags メンバに相当するFixnum。 Socket::AI_PASSIVE、 Socket::AI_CANONNAME、 Socket::AI_NUMERICHOST が用意されている場合があります。

引数に指定できる定数の意味については getaddrinfo(3) を参照して下さい。

例: ^*1

p Socket.getaddrinfo(Socket.gethostname, "ftp")
#=> [["AF_INET", 21, "helium.ruby-lang.org", "210.251.121.214", 2, 1, 6]]

pp Socket.getaddrinfo(Socket.gethostname, nil)
#=> [["AF_INET", 0, "helium.ruby-lang.org", "210.251.121.214", 2, 1, 6],
#    ["AF_INET", 0, "helium.ruby-lang.org", "210.251.121.214", 2, 2, 17],
#    ["AF_INET", 0, "helium.ruby-lang.org", "210.251.121.214", 2, 3, 0]]

Socket.getnameinfo(sa[, flags])

RFC 2553 で定義されたgetnameinfo() の機能を提供するクラスメソッド。 gethostbyaddr() や getservbyport() の代わりとして用意されています。IPのバージョンに依存しないプログラムを書くための標準的なAPIです。

配列を返し、その要素はアドレスとポートを表す文字列です。

引数 sa には文字列か配列を与えます。文字列の場合は sockaddr 構造体のパック文字列を与えます。具体的には getsockaddr の値が利用できます。配列を与える場合には、要素が3つの場合と4つの場合があります。

要素が3つの場合:

[アドレスファミリー, サービス, ホスト]

要素が4つの場合:

[アドレスファミリー, サービス, 任意, アドレスを表す文字列]

アドレスファミリーには Socket::AF_INET 等の定数の他に文字列で "AF_INET" もしくは "AF_INET6" もしくは nil が指定できます。ただしIPv6が使えないようにコンパイルされている場合は "AF_INET6" は無効な指定となります。アドレスファミリーに nil を指定することは Socket::AF_UNSPEC を指定することと等価です。

サービス、ホストの指定に関してはサービス指定形式、ホスト指定形式を参照してください。

要素が3つの場合でも、ホストにはアドレスを指定できますが、要素が4つの場合には、最後の要素を名前解決しないことが保証されます。^*2

省略可能な第2引数 flags には getnameinfo(3) の第7番目の引数に指定する flags に相当する Fixnum を与えます。

引数flagsを構成するための定数として Socket::NI_MAXHOST、 Socket::NI_MAXSERV、 Socket::NI_NOFQDN、 Socket::NI_NUMERICHOST、 Socket::NI_NAMEREQD、 Socket::NI_NUMERICSERV、 Socket::NI_DGRAM が用意されている場合があります。

これらの定数の意味については getnameinfo(3)を参照して下さい。

例:

Socket.getnameinfo(Socket.sockaddr_in('21','127.0.0.1'))
#=> ["localhost", "ftp"]

Socket.getnameinfo([nil, 21,'127.0.0.1'])
#=> ["localhost", "ftp"]

Socket.gethostbyaddr(host[, type])

sockaddr 構造体をパックした文字列からホスト情報を返します。ホスト情報の構造は Socket.gethostbynameと同じです。 type には、アドレスタイプ(デフォルトは Socket::AF_INET)を指定します。

Socket.gethostbyname(host)

ホスト名またはIPアドレス(指定方法に関してはホスト指定形式を参照) からホストの情報を返します。ホスト情報は以下の 4 要素の配列で表現されています。

ホスト名
ホストの別名の配列
ホストのアドレスタイプ (整数定数)
ホストのアドレス

第四要素のホストのアドレスは、各アドレスタイプに対応する C のアドレス構造体を pack した文字列として表現されています。例えばアドレスタイプが AF_INET (定数 2) ならば Socket.unpack_sockaddr_in で unpack できます。

例:
irb(main):009:0> Socket.gethostbyname("210.251.121.214")
["helium.ruby-lang.org", ["helium"], 2, "\322\373y\326"]

irb(main):009:0> Socket.unpack_sockaddr_in(Socket.gethostbyname("210.251.121.214")[3])[1]
"210.251.121.214"

Socket.gethostname

システムの標準のホスト名を取得します。ホストの別名やアドレスなど他の情報を得るには Socket.getaddrinfo を使ってください。

p Socket.gethostname   #=> "helium.ruby-lang.org"

Socket.getservbyname(service[, proto])

service, protoに対応するポート番号を返します。protoの省略値は"tcp"です。

Socket.sockaddr_in(port, host) ((<ruby 1.7 feature>))

Socket.pack_sockaddr_in(port, host) ((<ruby 1.7 feature>))

指定したアドレスをソケットアドレス構造体を pack した文字列で返します。port は、ポート番号を表す Fixnum あるいは、ポート番号、サービス名を表す文字列です。

require 'socket'
p Socket.pack_sockaddr_in("echo", "localhost")
=> "\002\000\000\a\177\000\000\001\000\000\000\000\000\000\000\000"

Socket.sockaddr_un(path) ((<ruby 1.7 feature>))

Socket.pack_sockaddr_un(path) ((<ruby 1.7 feature>))

指定したアドレスをソケットアドレス構造体を pack した文字列で返します。

require 'socket'
p Socket.pack_sockaddr_un("/tmp/.X11-unix/X0")
=> "\001\000/tmp/.X11-unix/X0\000...."

Socket.pair(domain, type, protocol)

Socket.socketpair(domain, type, protocol)

相互に結合されたソケットのペアを含む2要素の配列を返します。引数の指定はSocket.openと同じです。

Socket.unpack_sockaddr_in(addr) ((<ruby 1.7 feature>))

ソケットアドレス構造体を pack した文字列を unpack したアドレスを返します。返される値は [port, ipaddr] の配列です。

require 'socket'
p Socket.unpack_sockaddr_in(Socket.pack_sockaddr_in("echo", "localhost"))
=> [7, "127.0.0.1"]

Socket.unpack_sockaddr_un(addr) ((<ruby 1.7 feature>))

ソケットアドレス構造体を pack した文字列を unpack したソケットパス名をを返します。

require 'socket'
p Socket.unpack_sockaddr_un(Socket.pack_sockaddr_un("/tmp/.X11-unix/X0"))
=> "/tmp/.X11-unix/X0"

メソッド:

accept: 新しい接続を受け付けて、新しい接続に対するソケットとアドレスのペアを返します。accept(2)を参照。
bind(addr): ソケットをaddrに結合します。bind(2) と同じ働きをします。addrはソケットアドレス構造体を pack した文字列です。
connect(addr): connect(2)と同じ働きをします。addr は、ソケットアドレス構造体を pack した文字列です。
listen(backlog): listen(2)と同じ働きをします。
recvfrom(len[, flags]): recvと同様にソケットからデータを受け取りますが、戻り値は文字列と相手ソケットのアドレスのペアです。引数についてはrecvと同様です。
sysaccept ((<ruby 1.7 feature>)): 接続したクライアントのファイル記述子とアドレスのペアを返すことを除けば accept と同じです。

^*1 Linuxではservnameにポート番号(0や21や"0"や"21"など)は getaddrinfo: Servname not supported for ai_socktype (SocketError)になって使えないようです。
^*24つの場合の3番目の引数ってなんだか変なインタフェースですね。4番目の引数が nil の場合は要素3つと同じ扱いになるんですね。どういうわけでこうなってるのかがよくわかりません。ホスト指定は常に3番目の要素にして [アドレスファミリー, サービス, ホスト, フラグ] として4番目の要素で名前解決うんぬんを指定するんじゃダメだったんでしょうかね？-あらい 2002-01-01

Socket

スーパークラス:

クラスメソッド:

メソッド: