svcudp_create Subroutine

Communications Technical Reference, Volume 1

svcudp_create Subroutine

Purpose

Creates a User Datagram Protocol/Internet Protocol (UDP/IP) service transport handle.

Library

C Library (libc.a)

Syntax

#include <rpc/rpc.h>

SVCXPRT *svcudp_create (sock)
int sock;

Description

The svcudp_create subroutine creates a Remote Procedure Call (RPC) service transport handle based on UDP/IP and returns a pointer to it.

The UDP/IP service transport handle is used only for procedures that take up to 8KB of encoded arguments or results.

Parameters

sock

Specifies the socket associated with the service transport handle. If the value specified by the sock parameter is RPC_ANYSOCK, the svcudp_create subroutine creates a new socket and sets the service transport handle socket number to xprt->xp_sock. If the socket is not bound to a local UDP/IP port, then the svcudp_create subroutine binds the socket to an arbitrary port. The port number is set to xprt->xp_port.

Return Values

Upon successful completion, this subroutine returns a valid RPC service transport. If unsuccessful, it returns a value of null.

Implementation Specifics

This subroutine is part of Base Operating System (BOS) Runtime.

Related Information

The registerrpc subroutine, svctcp_create subroutine.

List of RPC Programming References.

TCP/IP Protocols in AIX Version 4.3 System Management Guide: Communications and Networks.

Remote Procedure Call (RPC) Overview for Programming in AIX Communications Programming Concepts.