| rpc_clnt_create.3 (103429) | rpc_clnt_create.3 (108037) |
|---|---|
| 1.\" @(#)rpc_clnt_create.3n 1.36 93/08/31 SMI; from SVr4 2.\" Copyright 1989 AT&T 3.\" @(#)rpc_clnt_create 1.5 89/07/24 SMI; 4.\" Copyright (c) 1988 Sun Microsystems, Inc. - All Rights Reserved. 5.\" $NetBSD: rpc_clnt_create.3,v 1.2 2000/06/20 00:53:08 fvdl Exp $ | 1.\" @(#)rpc_clnt_create.3n 1.36 93/08/31 SMI; from SVr4 2.\" Copyright 1989 AT&T 3.\" @(#)rpc_clnt_create 1.5 89/07/24 SMI; 4.\" Copyright (c) 1988 Sun Microsystems, Inc. - All Rights Reserved. 5.\" $NetBSD: rpc_clnt_create.3,v 1.2 2000/06/20 00:53:08 fvdl Exp $ |
| 6.\" $FreeBSD: head/lib/libc/rpc/rpc_clnt_create.3 103429 2002-09-16 21:45:37Z fenner $ | 6.\" $FreeBSD: head/lib/libc/rpc/rpc_clnt_create.3 108037 2002-12-18 12:45:11Z ru $ |
| 7.Dd May 7, 1993 8.Dt RPC_CLNT_CREATE 3 9.Os 10.Sh NAME 11.Nm rpc_clnt_create , 12.Nm clnt_control , 13.Nm clnt_create , 14.Nm clnt_create_timed , --- 99 unchanged lines hidden (view full) --- 114.Bl -column CLSET_RETRY_TIMEOUT "struct timeval *" "set total timeout" 115.It Dv CLSET_RETRY_TIMEOUT Ta "struct timeval *" Ta "set the retry timeout" 116.It Dv CLGET_RETRY_TIMEOUT Ta "struct timeval *" Ta "get the retry timeout" 117.It Dv CLSET_CONNECT Ta Vt "int *" Ta use Xr connect 2 118.El 119.Pp 120The retry timeout is the time that RPC 121waits for the server to reply before retransmitting the request. | 7.Dd May 7, 1993 8.Dt RPC_CLNT_CREATE 3 9.Os 10.Sh NAME 11.Nm rpc_clnt_create , 12.Nm clnt_control , 13.Nm clnt_create , 14.Nm clnt_create_timed , --- 99 unchanged lines hidden (view full) --- 114.Bl -column CLSET_RETRY_TIMEOUT "struct timeval *" "set total timeout" 115.It Dv CLSET_RETRY_TIMEOUT Ta "struct timeval *" Ta "set the retry timeout" 116.It Dv CLGET_RETRY_TIMEOUT Ta "struct timeval *" Ta "get the retry timeout" 117.It Dv CLSET_CONNECT Ta Vt "int *" Ta use Xr connect 2 118.El 119.Pp 120The retry timeout is the time that RPC 121waits for the server to reply before retransmitting the request. |
| 122The |
|
| 122.Fn clnt_control | 123.Fn clnt_control |
| 124function |
|
| 123returns 124.Dv TRUE 125on success and 126.Dv FALSE 127on failure. 128.It Fn clnt_create 129Generic client creation routine for program 130.Fa prognum 131and version 132.Fa versnum . 133.Fa host 134identifies the name of the remote host where the server 135is located. 136.Fa nettype 137indicates the class of transport protocol to use. 138The transports are tried in left to right order in 139.Ev NETPATH 140environment variable or in top to bottom order in 141the netconfig database. | 125returns 126.Dv TRUE 127on success and 128.Dv FALSE 129on failure. 130.It Fn clnt_create 131Generic client creation routine for program 132.Fa prognum 133and version 134.Fa versnum . 135.Fa host 136identifies the name of the remote host where the server 137is located. 138.Fa nettype 139indicates the class of transport protocol to use. 140The transports are tried in left to right order in 141.Ev NETPATH 142environment variable or in top to bottom order in 143the netconfig database. |
| 144The |
|
| 142.Fn clnt_create | 145.Fn clnt_create |
| 146function |
|
| 143tries all the transports of the 144.Fa nettype 145class available from the 146.Ev NETPATH 147environment variable and the netconfig database, 148and chooses the first successful one. 149A default timeout is set and can be modified using 150.Fn clnt_control . --- 180 unchanged lines hidden (view full) --- 331in 332.Xr rpc_svc_create 3 ) . 333This allows simulation of RPC and measurement of 334RPC overheads, such as round trip times, 335without any kernel or networking interference. 336This routine returns 337.Dv NULL 338if it fails. | 147tries all the transports of the 148.Fa nettype 149class available from the 150.Ev NETPATH 151environment variable and the netconfig database, 152and chooses the first successful one. 153A default timeout is set and can be modified using 154.Fn clnt_control . --- 180 unchanged lines hidden (view full) --- 335in 336.Xr rpc_svc_create 3 ) . 337This allows simulation of RPC and measurement of 338RPC overheads, such as round trip times, 339without any kernel or networking interference. 340This routine returns 341.Dv NULL 342if it fails. |
| 343The |
|
| 339.Fn clnt_raw_create | 344.Fn clnt_raw_create |
| 345function |
|
| 340should be called after 341.Fn svc_raw_create . 342.It Fn clnt_tli_create 343This routine creates an RPC 344client handle for the remote program 345.Fa prognum 346and version 347.Fa versnum . --- 53 unchanged lines hidden (view full) --- 401service. 402.It Fn clnt_tp_create 403Like 404.Fn clnt_create 405except 406.Fn clnt_tp_create 407tries only one transport specified through 408.Fa netconf . | 346should be called after 347.Fn svc_raw_create . 348.It Fn clnt_tli_create 349This routine creates an RPC 350client handle for the remote program 351.Fa prognum 352and version 353.Fa versnum . --- 53 unchanged lines hidden (view full) --- 407service. 408.It Fn clnt_tp_create 409Like 410.Fn clnt_create 411except 412.Fn clnt_tp_create 413tries only one transport specified through 414.Fa netconf . |
| 415The |
|
| 409.Fn clnt_tp_create | 416.Fn clnt_tp_create |
| 417function |
|
| 410creates a client handle for the program 411.Fa prognum , 412the version 413.Fa versnum , 414and for the transport specified by 415.Fa netconf . 416Default options are set, 417which can be changed using --- 43 unchanged lines hidden (view full) --- 461This routine returns 462.Dv NULL 463if it fails. 464The address 465.Fa svcaddr 466should not be 467.Dv NULL 468and should point to the actual address of the remote program. | 418creates a client handle for the program 419.Fa prognum , 420the version 421.Fa versnum , 422and for the transport specified by 423.Fa netconf . 424Default options are set, 425which can be changed using --- 43 unchanged lines hidden (view full) --- 469This routine returns 470.Dv NULL 471if it fails. 472The address 473.Fa svcaddr 474should not be 475.Dv NULL 476and should point to the actual address of the remote program. |
| 477The |
|
| 469.Fn clnt_vc_create | 478.Fn clnt_vc_create |
| 479function |
|
| 470does not consult the remote rpcbind service for this information. 471.It Xo 472.Vt "struct rpc_createerr" Va rpc_createerr ; 473.Xc 474A global variable whose value is set by any RPC 475client handle creation routine 476that fails. 477It is used by the routine 478.Fn clnt_pcreateerror 479to print the reason for the failure. 480.El 481.Sh SEE ALSO 482.Xr rpc 3 , 483.Xr rpc_clnt_auth 3 , 484.Xr rpc_clnt_calls 3 , 485.Xr rpcbind 8 | 480does not consult the remote rpcbind service for this information. 481.It Xo 482.Vt "struct rpc_createerr" Va rpc_createerr ; 483.Xc 484A global variable whose value is set by any RPC 485client handle creation routine 486that fails. 487It is used by the routine 488.Fn clnt_pcreateerror 489to print the reason for the failure. 490.El 491.Sh SEE ALSO 492.Xr rpc 3 , 493.Xr rpc_clnt_auth 3 , 494.Xr rpc_clnt_calls 3 , 495.Xr rpcbind 8 |