create-async-io-state-and-connected-udp-socket

create-async-io-state-and-connected-udp-socket Function

Summary

Creates an async-io-state where the object is a connected UDP socket.

Package

comm

Signature

create-async-io-state-and-connected-udp-socket collection hostspec service &key queue-output name errorp ipv6 read-timeout write-timeout user-info local-address local-port => async-io-state

Arguments

`collection`⇩	A wait-state-collection to associate with the result.
`hostspec`⇩, `service`⇩	Specify the socket address to connect to in the standard way.
`queue-output`⇩	A boolean.
`name`⇩	A Lisp object.
`errorp`⇩	A boolean.
`ipv6`⇩	One of `nil`, `t` or the keyword `:any`.
`read-timeout`⇩	`nil` or a positive real.
`write-timeout`⇩	`nil` or a positive real.
`user-info`⇩	A Lisp object.
`local-address`⇩, `local-port`⇩
	Specify the local socket address in the standard way.

Values

async-io-state⇩

An async-io-state.

Description

The function create-async-io-state-and-connected-udp-socket creates a new UDP socket, connects it to the socket address specified by hostspec and service, optionally binds it if local-port or local-address are non-nil, and then creates and returns an async-io-state object that can be used to perform I/O operations on the socket. The I/O operations are done using async-io-state-receive-message and async-io-state-send-message.

async-io-state is associated with collection.

hostspec and service are interpreted as described in 25.4 Specifying the target for connecting and binding a socket.

local-address and local-port are also interpreted as described in 25.4 Specifying the target for connecting and binding a socket. Both values can be nil.

Connecting the socket affects the destination of messages sent using the async-io-state, and also restricts the origin of received messages.

When ipv6 is :any, the system selects whether to use an IPv4 or IPv6 socket (normally it will be IPv4). When ipv6 is t it forces using IPv6, and nil forces IPv4. The default value of ipv6 is :any.

queue-output controls what happens if you try to perform a write operation on the state while another write operation is ongoing. When queue-output is nil, this will cause an error. When queue-output is non-nil, the second write operation is queued and actually executed later. The default value of queue-output is t.

read-timeout, write-timeout, user-info and name are set in async-io-state using the corresponding accessors async-io-state-read-timeout, async-io-state-write-timeout, async-io-state-user-info and async-io-state-name.

The default value of name is a string "Connected UDP".

When errorp is nil, create-async-io-state-and-connected-udp-socket returns nil for run time errors rather than signaling an error. The default value of errorp is t.

Notes

If you need an unconnected socket, use create-async-io-state-and-udp-socket.
The call to create-async-io-state-and-connected-udp-socket itself is synchronous.
You cannot use async-io-state-send-message-to-address with the result of create-async-io-state-and-connected-udp-socket (because the socket address to send to is already specified by connecting.)