From 3bd0b68bfb886ff55778bdf0cc7615a5c71806b3 Mon Sep 17 00:00:00 2001 From: Peter Stephenson Date: Tue, 21 May 2002 13:12:45 +0000 Subject: 17201: add example use of ztcp to manual --- ChangeLog | 2 ++ Doc/Zsh/mod_tcp.yo | 32 ++++++++++++++++++++++++++++++++ 2 files changed, 34 insertions(+) diff --git a/ChangeLog b/ChangeLog index d7c502d51..0071b5ef4 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,5 +1,7 @@ 2002-05-21 Peter Stephenson + * 17201: Doc/Zsh/mod_tcp.yo: add example use of ztcp. + * 17141 plus mods: Src/utils.c, Src/Zle/zle_main.c, Src/Zle/zle_thingy.c, Doc/Zsh/zle.yo: `zle -F fd handler' installs shell function handler for when data becomes available diff --git a/Doc/Zsh/mod_tcp.yo b/Doc/Zsh/mod_tcp.yo index 5cd3aa2d3..7f117601f 100644 --- a/Doc/Zsh/mod_tcp.yo +++ b/Doc/Zsh/mod_tcp.yo @@ -95,3 +95,35 @@ to force such a socket closed, use tt(-f). In order to elicit more verbose output, use tt(-v). ) enditem() + +subsect(Example) +cindex(TCP, example) +Here is how to create a TCP connection between two instances of zsh. We +need to pick an unassigned port; here we use the randomly chosen 5123. + +On tt(host1), +example(zmodload zsh/net/tcp +ztcp -l 5123 +listenfd=$REPLY +ztcp -a $listenfd +fd=$REPLY) +The second from last command blocks until there is an incoming connection. + +Now create a connection from tt(host2) (which may, of course, be the same +machine): +example(zmodload zsh/net/tcp +ztcp host1 5123 +fd=$REPLY) + +Now on each host, tt($fd) contains a file descriptor for talking to the +other. For example, on tt(host1): +example(print This is a message >&$fd) +and on tt(host2): +example(read -r line <&$fd; print -r - $line) +prints `tt(This is a message)'. + +To tidy up, on tt(host1): +example(ztcp -c $listenfd +ztcp -c $fd) +and on tt(host2) +example(ztcp -c $fd) -- cgit 1.4.1