| 1 |
.TH pdreceive 1 "1996 Mar 20" GNU |
| 2 |
.SH NAME |
| 3 |
pdreceive \- receive messages from pd on this or a remote machine |
| 4 |
.SH SYNOPSIS |
| 5 |
.B pdreceive |
| 6 |
\fIport-number\fR [udp|tcp] |
| 7 |
.SH DESCRIPTION |
| 8 |
Pdreceive opens a socket (with the specified port number) and |
| 9 |
waits for messages to arrive from one or more instances of pd(1). Each |
| 10 |
message received is printed to the standard output with a trailing semicolon. |
| 11 |
The protocol used is easy to implement and is called FUDI. |
| 12 |
.PP |
| 13 |
The \fIport number\fR should agree with the port number of a "netsend" object |
| 14 |
within pd. The protocol is "tcp" by default; this does a handshake |
| 15 |
to |
| 16 |
guarantee that all messages arrive complete and in their correct order; if you |
| 17 |
are sending messages locally or point-to-point you can often get away with |
| 18 |
the faster udp protocol instead. |
| 19 |
.PP |
| 20 |
You can also use this to get messages from a Max "pdnetsend" object or even |
| 21 |
just a |
| 22 |
"pdsend" in another shell. If you're writing another program you're welcome |
| 23 |
to just grab the sources for pdsend/pdreceive and adapt them to your own ends; |
| 24 |
they're part of the Pd distribution. |
| 25 |
.SH SEE ALSO |
| 26 |
pd(1), pdsend(1) |