Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
MSEND(3)		    libdill Library Functions			MSEND(3)

NAME
     msend - sends a message

SYNOPSIS
	    #include <libdill.h>

	    int msend(
		int s,
		const void* buf,
		size_t len,
		int64_t deadline);

DESCRIPTION
     This function sends a message to a socket.  It is a blocking operation that
     unblocks only after entire message is sent.  There is no such thing as par-
     tial  send.  If a problem, including timeout, occurs while sending the mes-
     sage error is returned to the user and the socket cannot be used for  send-
     ing from that point on.

     s: The socket to send the message to.

     buf: Message to send.

     len: Size of the message, in bytes.

     deadline:	A point in time when the operation should time out, in millisec-
     onds.  Use the now function to get your current point in time.  0 means im-
     mediate timeout, i.e., perform the operation if possible or return  without
     blocking  if  not.  -1 means no deadline, i.e., the call will block forever
     if the operation cannot be performed.

RETURN VALUE
     In case of success the function returns 0.  In case of error it returns  -1
     and sets errno to one of the values below.

ERRORS
     * EBADF: Invalid handle.

     * EBUSY: The handle is currently being used by a different coroutine.

     * ECANCELED: Current coroutine was canceled.

     * ECONNRESET: Broken connection.

     * EINVAL: Invalid argument.

     * EMSGSIZE: The message is too long.

     * ENOTSUP: The handle does not support this operation.

     * EPIPE: Closed connection.

     * ETIMEDOUT: Deadline was reached.

EXAMPLE
	    int rc = msend(s, "ABC", 3, -1);

SEE ALSO
     mrecv(3) mrecvl(3) msendl(3) now(3)

libdill 								MSEND(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=msend&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help