IPC_$OPEN                         Domain/OS                          IPC_$OPEN


NAME
     ipc_$open - open an IPC socket

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

     void ipc_$open(
          char *path_name,
          unsigned short &path_length,
          unsigned short &socket_depth,
          ipc_$socket_handle_t *socket_handle,
          status_$t *status)

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

     procedure ipc_$open(
          in path_name: univ name_$long_pname_t;
          in path_length: pinteger;
          in socket_depth: pinteger;
          out socket_handle: ipc_$socket_handle_t;
          out status: status_$t);

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

           integer*2 path_length, socket_depth
           integer*4 status
           character path_name*1023, socket_handle*20

           call ipc_$open(path_name, path_length, socket_depth,
          &               socket_handle, status)

DESCRIPTION
     Ipc_$open opens the socket at path_name and supplies a handle for it in
     socket_handle.

     path_name
          The pathname of an existing socket.

     path_length
          The number of bytes in path_name.

     socket_depth
          The number of datagrams the socket must be able to hold.  Specify a
          value from 1 to 4.

     socket_handle
          The handle for the opened socket.

     status
          The completion status.

SEE ALSO
     ipc_$close, ipc_$create, ipc_$delete.