initial checkin
[platform/upstream/libtirpc.git] / README
1 LIBTIRPC 0.1 FROM SUN'S TIRPCSRC 2.3 29 Aug 1994
2
3 This package contains SunLib's implementation of transport-independent
4 RPC (TI-RPC) documentation.  This library forms a piece of the base of Open Network
5 Computing (ONC), and is derived directly from the Solaris 2.3 source.
6
7 TI-RPC is an enhanced version of TS-RPC that requires the UNIX System V
8 Transport Layer Interface (TLI) or an equivalent X/Open Transport Interface
9 (XTI).  TI-RPC is on-the-wire compatible with the TS-RPC, which is supported
10 by almost 70 vendors on all major operating systems.  TS-RPC source code
11 (RPCSRC 4.0) remains available from several internet sites.
12
13 This release was a native source release, compatible for
14 building on Solaris 2.3. It had been ported from FreeBSD 5.2.1 to GNU/Linux 
15 in 2004.
16
17 Applications linked with this release's librpc must link with the United
18 States domestic version of libcrypt in order to resolve the cbc_crypt() and
19 ecb_crypt() functions.  These routines are used with Secure RPC however all
20 RPC programs that link with this release's librpc will need to link with the
21 domestic libcrypt.  
22
23 WHAT'S NEW IN THIS RELEASE: TIRPCSRC 2.3 FROM SUN
24
25 The previous release was TIRPCSRC 2.0.
26
27 1.      This release is based on Solaris 2.3.  The previous release was
28         based on Solaris 2.0.  This release contains a siginificant number of
29         bug fixes and other enhancements over TIRPCSRC 2.0.
30
31 2.      The RPC library is thread safe for all client-side interfaces
32         (clnt_create, clnt_call, etc.).  The server-side interfaces
33         (svc_create, svc_run, etc.) are not thread safe in this release. The
34         server-side interfaces will be made thread safe in the next release of
35         TIRPCSRC.  Please see the manual pages for details about which
36         interfaces are thread safe.
37
38 3.      As part of the work to make the RPC library thread-safe, rpcgen has
39         been enhanced to generate thread-safe RPC stubs (the -M option).  Note
40         that this modifies the call-signature for the stub functions; the
41         procedure calling the RPC stub must now pass to the stub a pointer to
42         an allocated structure where results will be placed by the stub.  See
43         the rpcgen manual page and the rpcgen Programming Guide for details.
44