ipc_$resolve — Apollo

IPC_$RESOLVE                      Domain/OS                       IPC_$RESOLVE


NAME
     ipc_$resolve - get an IPC socket handle

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

     void ipc_$resolve(
          char *path_name,
          unsigned short &path_length,
          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_$resolve(
          in path_name: univ name_$long_pname_t;
          in path_length: 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
           integer*4 status
           character path_name*1023, socket_handle*20

           call ipc_$resolve(path_name, path_length,
          &                  socket_handle, status)

DESCRIPTION
     Ipc_$resolve returns the handle for the open socket at path_name.

     path_name
          The pathname of an IPC socket.

     path_length
          The number of bytes in path_name.

     socket_handle
          The handle for the socket at path_name.

     status
          The completion status.  Ipc_$resolve returns with the status
          ipc_$socket_not_open if the socket at path_name is not open.
Museum
