1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
|
.\" socket.doc - -*- Indented-Text -*- created at: Thu Mar 23 20:29:02 JST 1995
** Socket(クラス)
SuperClass: BasicSocket
ソケットそのものに対するシステムコールレベルのアクセスを提供するクラス．
Perlのソケットに対するアクセスと同レベルの機能を提供している．このクラ
スではソケットアドレスはpackされた文字列で，指定する．UDPソケットはこ
のクラスを使って利用する．
Methods:
accept
新しい接続を受け付けて，新しい接続に対するソケットとアドレスの
ペアを返す．accept(2)を参照．
bind(addr)
bind(2)と同じ働きをする．addrはpackされたソケットアドレス構造
体である．
connect(addr)
connect(2)と同じ働きをする．addrはpackされたソケットアドレス構
造体である．
listen(backlog)
listen(2)と同じ働きをする．
recv(len[, flags])
ソケットからデータを受け取り，文字列として返す．lenは受け取る
最大の長さを指定する．flagsについてはrecv(2)を参照．flagsのデ
フォルト値は0である．
recvfrom(len[, flags])
recvと同様にソケットからデータを受け取るが，戻り値は文字列と相
手ソケットのアドレスのペアである．引数についてはrecvと同様．
send(mesg, flags[, to])
ソケットを介してデータを送る．flagsに関してはsend(2)を参照の事．
connectしていないソケットに対しては送り先であるtoを指定する必
要がある．実際に送ったデータの長さを返す．
Single Methods:
open(domain, type, protocol)
new(domain, type, protocol)
新しいソケットを生成する．domain，type，protocolはインクルード
ファイルで定義されている定数値で指定する．domainとtypeに関して
は，文字列で指定できるが，すべてをカバーしている保証はない．
socketpair(domain, type, protocol)
ソケットのペアを返す．引数の指定は openと同じである．
** BasicSocket(クラス)
ソケットを表す抽象クラス．具体的なソケット操作はサブクラスで定義される．
例えばインターネットドメインの場合はTCPsocketを用いる．
SuperClass: IO
Methods:
getopt(level, optname)
ソケットのオプションを取得する．getsockopt(2)を参照のこと．取
得したオプションの内容を含む文字列を返す．
getpeername
接続の相手先のソケットの情報を得る．パックされたsockaddr構造体
をベタにダンプした文字列が返される．getpeername(2)を参照のこと．
getsockname
ソケットの情報を得る．パックされたsockaddr構造体をベタにダンプ
した文字列が返される．getsockname(2)を参照のこと．
setopt(level, optname, optval)
ソケットのオプションを設定する．setsockopt(2)を参照のこと．
shutdown(how)
ソケットの以降の接続を終了させる．howが0である時，以降の受信が，
howが1である時は，以降の送信が拒否される．howが2の時には，それ
以降の送信，受信ともに拒否される．shutdown(2)を参照．
** TCPserver(クラス)
TCP/IPストリーム型接続のサーバ側のソケットのクラス．このクラスによって
簡単にソケットを利用したサーバのプログラミングができる．例えばechoサー
バは以下のようになる．
gs = TCPserver.open(4444)
socks = [gs]
while TRUE
nsock = select(socks);
if nsock == nil; continue end
for s in nsock[0]
if s == gs
socks.push(s.accept)
else
if s.eof
s.close
socks.delete(s)
else
str = s.gets
s.write(str)
end
end
end
end
SuperClass: TCPsocket
Methods:
accept
クライアントからの接続要求を受け付け，接続したTCPsocketのイン
スタンスを返す．
Single Methods:
new([host, ]service)
open([host, ]service)
serviceは/etc/services(またはNIS)に登録されているサービス名か
ポート番号で指定する．hostを指定した時は指定したホストからの接
続だけを受け付ける．省略時は全てのホストからの接続要求を受け付
ける．
** TCPsocket
インターネットドメインのストリーム型ソケットのクラス．通常のIOクラスの
サブクラスと同様の入出力ができる．このクラスによってソケットを用いたク
ライアントを簡単に記述できる．ユーザの入力をそのままサーバに転送するプ
ログラムは以下のようになる．
s = TCPsocket("localhost", 4444)
while gets()
s.write($_)
print(s.read)
end
SuperClass: BasicSocket
Methods:
addr
ソケットの接続情報を表す配列を返す．その配列の各要素は第1要素
が文字列 "AF_INET"，第2要素がport番号，第3要素がホストを表す文
字列である．
peeraddr
接続相手先ソケットの情報を表す配列を返す．その配列の各要素は
addrメソッドが返す配列と同じである．
Single Methods:
open(host, service)
new(host, service)
hostで指定したホストのserviceで指定したポートと接続したソケッ
トを返す．hostはホスト名，またはインターネットアドレスを示す文
字列，serviceは/etc/services(またはNIS)に登録されているサービ
ス名かポート番号である．
** UNIXserver
UNIXストリーム型接続のサーバ側のソケットのクラス．
SuperClass: UNIXsocket
Methods:
accept
クライアントからの接続要求を受け付け，接続したUNIXsocketのイン
スタンスを返す．
** UNIXsocket
UNIXドメインのストリーム型ソケットのクラス．通常のIOクラスのサブクラス
と同様の入出力ができる．
SuperClass: BasicSocket
Methods:
addr
ソケットの接続情報を表す配列を返す．その配列の各要素は第1要素
が文字列 "AF_UNIX"，第2要素がpathである．
path
UNIXソケットのパスを返す．
peeraddr
接続相手先ソケットの情報を表す配列を返す．その配列の各要素は
addrメソッドが返す配列と同じである．
Single Methods:
open(path)
new(path)
pathで指定したパス名を用いて接続したソケットを返す．
-------------------------------------------------------
Local variables:
fill-column: 70
end:
|
