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

FreeBSD Manual Pages

  
 
  

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  partial send.	 If a problem, including timeout, occurs while
       sending the message error is returned to	the user and the socket	cannot
       be used for sending 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 mil-
       liseconds.  Use the now function	to get your current point in time.   0
       means immediate timeout,	i.e., perform the operation if possible	or re-
       turn 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
       o EBADF:	Invalid	handle.

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

       o ECANCELED: Current coroutine was canceled.

       o ECONNRESET: Broken connection.

       o EINVAL: Invalid argument.

       o EMSGSIZE: The message is too long.

       o ENOTSUP: The handle does not support this operation.

       o EPIPE:	Closed connection.

       o 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)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | EXAMPLE | SEE ALSO

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

home | help