clntraw_create(3)                   CLIX                   clntraw_create(3)



  NAME

    clntraw_create, svcraw_create - Library functions for remote procedure
    calls

  LIBRARY

    Berkeley Software Distribution Library (libsd.a)

  SYNOPSIS

    CLIENT * clntraw_create(
      ulong prognum ,
      ulong versnum );

    SVCXPRT * svcraw_create(
      void );

  PARAMETERS

    prognum   Specifies the program number for the remote server to which the
              created client communicates.

    versnum   Specifies the version number for the target server.

  DESCRIPTION

    The clntraw_create() and svcraw_create() functions allow C programs to
    make procedure calls on other machines across the network.  First, the
    client calls a procedure to send a data packet to the server.  Upon
    receipt of the packet, the server calls a dispatch routine to perform the
    requested service, and then sends back a reply.  Finally, the procedure
    call returns to the client.

    The clntraw_create() function creates a toy RPC client for the remote
    program prognum, version versnum.  The transport used to pass messages to
    the service is actually a buffer within the process's address space, so
    the corresponding RPC server should live in the same address space.  (See
    svcraw_create().)  This allows simulation of RPC and acquisition of RPC
    overheads, such as round trip times, without any kernel interference.

    The svcraw_create() function creates a toy RPC service transport, to which
    it returns a pointer.  The transport is really a buffer within the process
    address space, so the corresponding RPC client should live in the same
    address space.  (See clntraw_create().)  This function allows simulation
    of RPC and acquisition of RPC overheads (such as round trip times),
    without any kernel interference.

  RETURN VALUES

    The clntraw_create() and svcraw_create() functions return NULL if



  2/94 - Intergraph Corporation                                              1

  clntraw_create(3)                   CLIX                   clntraw_create(3)



    unsuccessful.
     If successful, clntraw_create() returns a valid client handle, and
    svcraw_create() creates a valid service transport handle.

  RELATED INFORMATION

    Functions:  xdr_int(3), xdr_bytes(3), xdr_getpos(3), xdr_pointer(3),
    xdrrec_create(3), xdr_array(3), xdr_destroy(3), xdr_free(3),
    xdr_inline(3), xdrmem_create(3), xdr_opaque(3), xdr_union(3),
    xdr_vector(3), xdr_void(3)

    CLIX Programming Guide










































  2                                              Intergraph Corporation - 2/94