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
228
229
230
231
232
233
234
235
236
237
238
239
240
241
|
<head>
<title>dial(3) - Plan 9 from User Space</title>
<meta content="text/html; charset=utf-8" http-equiv=Content-Type>
</head>
<body bgcolor=#ffffff>
<table border=0 cellpadding=0 cellspacing=0 width=100%>
<tr height=10><td>
<tr><td width=20><td>
<tr><td width=20><td><b>DIAL(3)</b><td align=right><b>DIAL(3)</b>
<tr><td width=20><td colspan=2>
<br>
<p><font size=+1><b>NAME </b></font><br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
dial, announce, listen, accept, reject, netmkaddr, dialparse –
make and break network connections<br>
</table>
<p><font size=+1><b>SYNOPSIS </b></font><br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
<tt><font size=+1>#include <u.h><br>
#include <libc.h>
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
</font></tt>
<tt><font size=+1>int dial(char *addr, char *local, char *dir, int *cfdp)
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
</font></tt>
<tt><font size=+1>int announce(char *addr, char *dir)
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
</font></tt>
<tt><font size=+1>int listen(char *dir, char *newdir)
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
</font></tt>
<tt><font size=+1>int accept(int ctl, char *dir)
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
</font></tt>
<tt><font size=+1>int reject(int ctl, char *dir, char *cause)
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
</font></tt>
<tt><font size=+1>char* netmkaddr(char *addr, char *defnet, char *defservice)
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
</font></tt>
<tt><font size=+1>int dialparse(char *addr, char **net, char **unix,<br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
u32int *host, int *port)<br>
</table>
</table>
</font></tt>
</table>
<p><font size=+1><b>DESCRIPTION </b></font><br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
For these routines, <i>addr</i> is a network address of the form <i>network</i><tt><font size=+1>!</font></tt><i>netaddr</i><tt><font size=+1>!</font></tt><i>service</i>,
<i>network</i><tt><font size=+1>!</font></tt><i>netaddr</i>, or simply <i>netaddr</i>. <i>Network</i> is <tt><font size=+1>tcp</font></tt>, <tt><font size=+1>udp</font></tt>, <tt><font size=+1>unix</font></tt>,
or the special token, <tt><font size=+1>net</font></tt>. <tt><font size=+1>Net</font></tt> is a free variable that stands
for any network in common between the source and the host <i>netaddr</i>.
<i>Netaddr</i> can be a host name, a
domain name, or a network address.
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
On Plan 9, the <i>dir</i> argument is a path name to a <i>line directory</i>
that has files for accessing the connection. To keep the same
function signatures, the Unix port of these routines uses strings
of the form <tt><font size=+1>/dev/fd/</font></tt><i>n</i> instead of line directory paths. These strings
should be treated as opaque data and ignored.
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
<i>Dial</i> makes a call to destination <i>addr</i> on a multiplexed network.
If the network in <i>addr</i> is <tt><font size=+1>net</font></tt>, <i>dial</i> will try in succession all
networks in common between source and destination until a call
succeeds. It returns a file descriptor open for reading and writing
the <tt><font size=+1>data</font></tt> file in the line directory. The <tt><font size=+1>addr</font></tt> file in the line
directory contains the address called. <i>Dial</i>’s <i>local</i>, <i>dir</i>, and
<i>cfdp</i> arguments are not supported and must be zero.
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
<i>Announce</i> and <i>listen</i> are the complements of <i>dial</i>. <i>Announce</i> establishes
a network name to which calls can be made. Like <i>dial</i>, <i>announce</i>
returns an open <tt><font size=+1>ctl</font></tt> file. The <i>netaddr</i> used in announce may be
a local address or an asterisk, to indicate all local addresses,
e.g. <tt><font size=+1>tcp!*!echo</font></tt>. The <i>listen</i> routine takes as its
first argument the <i>dir</i> of a previous <i>announce</i>. When a call is
received, <i>listen</i> returns an open <tt><font size=+1>ctl</font></tt> file for the line the call
was received on. It sets <i>newdir</i> to the path name of the new line
directory. <i>Accept</i> accepts a call received by <i>listen</i>, while <i>reject</i>
refuses the call because of <i>cause</i>. <i>Accept</i> returns a file descriptor
for
the data file opened <tt><font size=+1>ORDWR</font></tt>.
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
<i>Netmkaddr</i> makes an address suitable for dialing or announcing.
It takes an address along with a default network and service to
use if they are not specified in the address. It returns a pointer
to static data holding the actual address to use.
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
<i>Dialparse</i> parses a network address as described above into a network
name, a Unix domain socket address, an IPv4 host address, and
an IPv4 port number.<br>
</table>
<p><font size=+1><b>EXAMPLES </b></font><br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
Make a call and return an open file descriptor to use for communications:<br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
<tt><font size=+1>int callkremvax(void)<br>
{<br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
return dial("kremvax", 0, 0, 0);<br>
</table>
}<br>
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
</font></tt>
</table>
Connect to a Unix socket served by <a href="../man4/acme.html"><i>acme</i>(4)</a>:<br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
<tt><font size=+1>int dialacme(void)<br>
{<br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
return dial("unix!/tmp/ns.ken.:0/acme", 0, 0, 0);<br>
</table>
}<br>
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
</font></tt>
</table>
Announce as <tt><font size=+1>kremvax</font></tt> on TCP/IP and loop forever receiving calls
and echoing back to the caller anything sent:<br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
<tt><font size=+1>int<br>
bekremvax(void)<br>
{<br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
int dfd, acfd, lcfd;<br>
char adir[40], ldir[40];<br>
int n;<br>
char buf[256];<br>
acfd = announce("tcp!*!7", adir);<br>
if(acfd < 0)<br>
return −1;<br>
for(;;){<br>
/* listen for a call */<br>
lcfd = listen(adir, ldir);<br>
if(lcfd < 0)<br>
return −1;<br>
/* fork a process to echo */<br>
switch(fork()){<br>
case −1:<br>
perror("forking");<br>
close(lcfd);<br>
break;<br>
case 0:<br>
/* accept the call and open the data file */<br>
dfd = accept(lcfd, ldir);<br>
if(dfd < 0)<br>
return −1;<br>
/* echo until EOF */<br>
while((n = read(dfd, buf, sizeof(buf))) > 0)<br>
write(dfd, buf, n);<br>
exits(0);<br>
default:<br>
close(lcfd);<br>
break;<br>
}<br>
}<br>
</table>
}<br>
</font></tt>
</table>
</table>
<p><font size=+1><b>SOURCE </b></font><br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
<tt><font size=+1>/usr/local/plan9/src/lib9/dial.c<br>
/usr/local/plan9/src/lib9/announce.c<br>
/usr/local/plan9/src/lib9/_p9dialparse.c<br>
</font></tt>
</table>
<p><font size=+1><b>DIAGNOSTICS </b></font><br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
<i>Dial</i>, <i>announce</i>, and <i>listen</i> return –1 if they fail.<br>
</table>
<p><font size=+1><b>BUGS </b></font><br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
To avoid name conflicts with the underlying system, <i>dial</i>, <i>announce</i>,
<i>listen</i>, <i>netmkaddr</i>, and <i>reject</i> are preprocessor macros defined
as <i>p9dial</i>, <i>p9announce</i>, and so on; see <a href="../man3/intro.html"><i>intro</i>(3)</a>.<br>
</table>
<td width=20>
<tr height=20><td>
</table>
<!-- TRAILER -->
<table border=0 cellpadding=0 cellspacing=0 width=100%>
<tr height=15><td width=10><td><td width=10>
<tr><td><td>
<center>
<a href="../../"><img src="../../dist/spaceglenda100.png" alt="Space Glenda" border=1></a>
</center>
</table>
<!-- TRAILER -->
</body></html>
|