.\"send a message from a socket
.DT
socket_write
$MUDNAME$ driver help
socket_write

.SH Name
.SI 5
socket_write() - send a message from a socket
.EI

.SH Synopsis
.SI 5
#include <socket_errors.h>

int socket_write( int s, mixed message );
int socket_write( int s, mixed message,
		  string address );
.EI

.SH Description
.SP 5 5
socket_write() sends a message on a socket `s'.  If the socket `s' is of type
STREAM or MUD, the socket must already be connected and the address is not
specified.  If the socket is of type DATAGRAM, `address' must be specified.

The address is of the form: "127.0.0.1 23".

socket_write() returns EESUCCESS on success, and a negative value indicated
below on error.
.EP

.SH Errors
.SI 5
These errors are in <socket_errors.h>:
.EI

.SO 10 15 45
	EEFDRANGE	Descriptor out of range.
	EEBADF	Descriptor is invalid.
	EESECURITY	Security violation attempted.
	EENOADDR	Socket not bound to an address.
	EEBADADDR	Problem with address format.
	EENOTCONN	Socket not connected.
	EEALREADY	Operation already in progress.
	EETYPENOTSUPP	Object type not supported.
	EEBADDATA	Sending data with too many nested levels.
	EESENDTO	Problem with sendto.
	EEMODENOTSUPP	Socket mode not supported.
	EEWOULDBLOCK	Operation would block.
	EESEND	Problem with send.
	EECALLBACK	Wait for callback.
.EO

.SH See also
.SI 5
socket_connect(), socket_create()
.EI
