ipc_send() — Apollo

IPC_$SEND                         Domain/OS                          IPC_$SEND


NAME
     ipc_$send - send an IPC datagram

SYNOPSIS (C)
     #include <apollo/base.h>
     #include <apollo/ipc.h>

     void ipc_$send(
          ipc_$socket_handle_t to_socket,
          ipc_$socket_handle_t from_socket,
          void *header_buffer,
          unsigned short &header_size,
          void *data_buffer,
          unsigned short &data_size,
          status_$t *status)

SYNOPSIS (Pascal)
     %include '/sys/ins/base.ins.pas';
     %include '/sys/ins/ipc.ins.pas';

     procedure ipc_$send(
          in to_socket: ipc_$socket_handle_t;
          in from_socket: ipc_$socket_handle_t;
          in header_buffer: univ ipc_$hdr_info_t;
          in header_size: pinteger;
          in data_buffer: univ ipc_$data_t;
          in data_size: pinteger;
          out status: status_$t);

SYNOPSIS (FORTRAN)
     %include '/sys/ins/base.ins.ftn'
     %include '/sys/ins/ipc.ins.ftn'

           integer*2 header_size, data_size
           integer*4 status
           character to_socket*20, from_socket*20
           character header_buffer*128, data_buffer*1024

           call ipc_$send(to_socket, from_socket,
          &               header_buffer, header_size,
          &               data_buffer, data_size, status)

DESCRIPTION
     Ipc_$send sends a datagram to the socket on to_socket.

     to_socket
          The handle for the destination socket.  The destination socket is
          the socket ipc_$send sends the datagram to.

     from_socket
          The handle for the reply socket.  The handle in from_socket is
          passed in the datagram sent to the destination socket, and is usu-
          ally the socket the calling process expects a reply on.

     header_buffer
          The header for the datagram that ipc_$send sends.  It can contain up
          to 128 bytes.

     header_size
          The number of significant bytes in header_buffer.

     data_buffer
          The data for the datagram that ipc_$send sends.  It can contain up
          to 1024 bytes.

     data_size
          The number of bytes in data_buffer.

     status
          The completion status.  A completion status of status_$ok is no
          guarantee that the datagram arrived at the destination socket.

SEE ALSO
     ipc_$sar.
Museum
