Difference between revisions of "Sockudp"
From Scriptwiki
m (Why did I think there was a /udpread) |
m |
||
Line 36: | Line 36: | ||
[[Category:UDP Sockets]] | [[Category:UDP Sockets]] | ||
[[Category:Socket]] | [[Category:Socket]] | ||
+ | [[Category:Commands]] |
Latest revision as of 19:26, 30 January 2011
SockUDP is the command used to send UDP packets to a destination host. In this, it is like the TCP sockwrite command.
SockUDP however is also used to begin listening for UDP packets on a specified local port. In this, it is like the TCP sockopen command.
sockudp [-bntkd] [bindip] <name> [localport] [ipaddress remoteport] [numbytes] [text|%var|&binvar]
- Switches
- -b means you are specifying the number of bytes to send. If you specify a number of bytes (numbytes) the data will be truncated to this length.
- -n will append $crlf to the end of the packet. For most protocols, you should not use this! Appending two extra bytes may not work with the protocol you are using.
- -t means you are sending text (in literal or %var form). In other words, &binvars are not evaluated as binary variables.
- -k means you wish for this socket to remain open on localport to listen for incoming UDP data.
- -d is used when a bindip is being specified. If you use this, you must specify a bindip and visa versa.
- Parameters
- bindip is used with the -d switch. The UDP socket will bind to this ip. This is optional, otherwise all IPs are bound to this socket.
- name is required. It is the name that this socket will be referred to by.
- localport is optional and is used with -k. If -k and localport are specified, the socket will wait for incoming UDP data on the specified port.
- ipaddress is the ip of the remote computer you wish to send the data to. This is not required if you are merely opening a socket (-k)
- remoteport is the port of the remote computer you wish to send the data to. This is only required where ipaddress is required.
- numbytes is the number of bytes to send, and is used with the -b switch. If this is specified, only numbytes bytes will be sent. Any other data after this $ord(numbytes)) byte is lost.
- text, %var, &binvar contain the data to be sent.
Examples
sockudp -ktb myudpsocket 5078 host.com 5077 8 You will see this. But not this.
This
- Trunicates " But not this." because it is past the 8th byte
- Sends "You will see this." to host.com at port 5077
- Listens for UDP packets on port 5078
The socket is named myudpsocket, this is the name that would be used in On udpread to read from the socket.