summary refs log tree commit diff
path: root/Doc/Zsh/mod_tcp.yo
blob: 5cd3aa2d30b36869df38973cd296b359907ec6aa (plain) (blame)
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
COMMENT(!MOD!zsh/net/tcp
Manipulation of TCP sockets
!MOD!)
The tt(zsh/net/tcp) module makes available one builtin command:

startitem()
findex(ztcp)
cindex(TCP)
cindex(sockets, TCP)
item(tt(ztcp) [ tt(-acdfltv) ] [ var(args) ])(
tt(ztcp) is implemented as a builtin to allow full use of shell
command line editing, file I/O, and job control mechanisms.

If tt(ztcp) is run with no options, it will output
the contents of its session table.
)
enditem()

subsect(Outbound Connections)
cindex(sockets, outbound TCP)

startitem()
item(tt(ztcp) [ tt(-v) ] [ tt(-d) var(fd) ] var(host) [ var(port) ])(
Open a new TCP connection to var(host).  If the var(port) is
omitted, it will default to port 23.  The connection will
be added to the session table and the shell parameter
tt(REPLY) will be set to the file descriptor associated
with that connection.

If tt(-d) is specified, the first non-option argument
will be taken as the target file descriptor for the
connection.

In order to elicit more verbose output, use tt(-v).
)
enditem()

subsect(Inbound Connections)
cindex(sockets, inbound TCP)

startitem()
item(tt(ztcp) tt(-l) [ tt(-v) ] [ tt(-d) var(fd) ] var(port))(
tt(ztcp -l) will open a socket listening on TCP
var(port).  The socket will be added to the
session table and the shell parameter tt(REPLY)
will be set to the file descriptor associated
with that listener.

If tt(-d) is specified, the first non-option argument
will be taken as the target file descriptor for
the connection.

In order to elicit more verbose output, use tt(-v).
)
item(tt(ztcp) tt(-a) [ tt(-tv) ] [ tt(-d) var(targetfd) ] var(listenfd))(
tt(ztcp -a) will accept an incoming connection
to the port associated with var(listenfd).
The connection will be added to the session
table and the shell parameter tt(REPLY) will
be set to the file descriptor associated with
the inbound connection.

If tt(-d) is specified, the first non-option argument
will be taken as the target file descriptor for the
connection.

If tt(-t) is specified, tt(ztcp) will return
if no incoming connection is pending.  Otherwise
it will wait for one.

In order to elicit more verbose output, use tt(-v).
)
enditem()

subsect(Closing Connections)
cindex(sockets, closing TCP)

startitem()
xitem(tt(ztcp) tt(-cf) [ tt(-v) ] [ var(fd) ])
item(tt(ztcp) tt(-c) [ tt(-v) ] [ var(fd) ])(
tt(ztcp -c) will close the socket associated
with var(fd).  The socket will be removed from the
session table.  If var(fd) is not specified,
tt(ztcp) will close everything in the session table.

Normally, sockets registered by zftp (see
ifzman(\
zmanref(zshmodules)
)\
ifnzman(\
noderef(The zsh/zftp Module)
)) cannot be closed this way.  In order
to force such a socket closed, use tt(-f).

In order to elicit more verbose output, use tt(-v).
)
enditem()