[ source navigation ] [ identifier search ] [ freetext search ] [ file search ] [ list types ] [ track identifier ]

FreeBSD/Linux Kernel Cross Reference
sys/rpc/

Version: -  FREEBSD  -  FREEBSD10  -  FREEBSD9  -  FREEBSD92  -  FREEBSD91  -  FREEBSD90  -  FREEBSD8  -  FREEBSD82  -  FREEBSD81  -  FREEBSD80  -  FREEBSD7  -  FREEBSD74  -  FREEBSD73  -  FREEBSD72  -  FREEBSD71  -  FREEBSD70  -  FREEBSD6  -  FREEBSD64  -  FREEBSD63  -  FREEBSD62  -  FREEBSD61  -  FREEBSD60  -  FREEBSD5  -  FREEBSD55  -  FREEBSD54  -  FREEBSD53  -  FREEBSD52  -  FREEBSD51  -  FREEBSD50  -  FREEBSD4  -  FREEBSD3  -  FREEBSD22  -  cheribsd  -  linux-2.6  -  linux-2.4.22  -  MK83  -  MK84  -  PLAN9  -  DFBSD  -  NETBSD  -  NETBSD5  -  NETBSD4  -  NETBSD3  -  NETBSD20  -  OPENBSD  -  xnu-517  -  xnu-792  -  xnu-792.6.70  -  xnu-1228  -  xnu-1456.1.26  -  xnu-1699.24.8  -  xnu-2050.18.24  -  OPENSOLARIS  -  minix-3-1-1  -  FREEBSD-LIBC  -  FREEBSD8-LIBC  -  FREEBSD7-LIBC  -  FREEBSD6-LIBC  -  GLIBC27 
SearchContext: -  none  -  3  -  10 

Name Size Last modified (GMT) Description
Back Parent directory 2011-05-22 17:10:56
Folder PSD.doc/ 2011-05-22 16:57:08
File DISCLAIMER 1419 bytes 2011-05-22 16:57:09
File LICENSE 14583 bytes 2011-05-22 16:57:09
File Makefile.inc 5461 bytes 2011-05-22 16:57:09
File README 8180 bytes 2011-05-22 16:57:09
C file auth_des.c 13973 bytes 2011-05-22 16:57:09
C file auth_none.c 4542 bytes 2011-05-22 16:57:09
C file auth_time.c 12950 bytes 2011-05-22 16:57:09
C file auth_unix.c 9229 bytes 2011-05-22 16:57:09
C file authdes_prot.c 2809 bytes 2011-05-22 16:57:09
C file authunix_prot.c 2455 bytes 2011-05-22 16:57:09
File bindresvport.3 2123 bytes 2011-05-22 16:57:09
C file bindresvport.c 4024 bytes 2011-05-22 16:57:09
C file clnt_bcast.c 18412 bytes 2011-05-22 16:57:09
C file clnt_dg.c 22165 bytes 2011-05-22 16:57:09
C file clnt_generic.c 13504 bytes 2011-05-22 16:57:09
C file clnt_perror.c 7747 bytes 2011-05-22 16:57:09
C file clnt_raw.c 8013 bytes 2011-05-22 16:57:09
C file clnt_simple.c 5796 bytes 2011-05-22 16:57:09
C file clnt_vc.c 22632 bytes 2011-05-22 16:57:09
C file crypt_client.c 3477 bytes 2011-05-22 16:57:09
File des_crypt.3 2768 bytes 2011-05-22 16:57:09
C file des_crypt.c 3767 bytes 2011-05-22 16:57:09
C file des_soft.c 2568 bytes 2011-05-22 16:57:09
File getnetconfig.3 4318 bytes 2011-05-22 16:57:09
C file getnetconfig.c 20479 bytes 2011-05-22 16:57:09
File getnetpath.3 3181 bytes 2011-05-22 16:57:09
C file getnetpath.c 8866 bytes 2011-05-22 16:57:09
C file getpublickey.c 4230 bytes 2011-05-22 16:57:09
File getrpcent.3 2202 bytes 2011-05-22 16:57:09
C file getrpcent.c 15826 bytes 2011-05-22 16:57:09
File getrpcport.3 873 bytes 2011-05-22 16:57:09
C file getrpcport.c 2518 bytes 2011-05-22 16:57:09
C file key_call.c 11870 bytes 2011-05-22 16:57:09
C file key_prot_xdr.c 4137 bytes 2011-05-22 16:57:09
C file mt_misc.c 3721 bytes 2011-05-22 16:57:09
File netconfig.5 3285 bytes 2011-05-22 16:57:09
C file netname.c 4017 bytes 2011-05-22 16:57:09
C file netnamer.c 7557 bytes 2011-05-22 16:57:09
C file pmap_clnt.c 3494 bytes 2011-05-22 16:57:09
C file pmap_getmaps.c 2998 bytes 2011-05-22 16:57:09
C file pmap_getport.c 3223 bytes 2011-05-22 16:57:09
C file pmap_prot.c 2197 bytes 2011-05-22 16:57:09
C file pmap_prot2.c 4384 bytes 2011-05-22 16:57:09
C file pmap_rmt.c 4819 bytes 2011-05-22 16:57:09
File publickey.3 1203 bytes 2011-05-22 16:57:09
File publickey.5 1015 bytes 2011-05-22 16:57:09
File rpc.3 13172 bytes 2011-05-22 16:57:09
File rpc.5 1262 bytes 2011-05-22 16:57:09
C file rpc_callmsg.c 6154 bytes 2011-05-22 16:57:09
File rpc_clnt_auth.3 2454 bytes 2011-05-22 16:57:09
File rpc_clnt_calls.3 8387 bytes 2011-05-22 16:57:09
File rpc_clnt_create.3 13709 bytes 2011-05-22 16:57:09
C file rpc_com.h 3267 bytes 2011-05-22 16:57:09
C file rpc_commondata.c 1828 bytes 2011-05-22 16:57:09
C file rpc_dtablesize.c 2326 bytes 2011-05-22 16:57:09
C file rpc_generic.c 18123 bytes 2011-05-22 16:57:09
C file rpc_prot.c 8427 bytes 2011-05-22 16:57:09
File rpc_secure.3 6107 bytes 2011-05-22 16:57:09
File rpc_soc.3 32607 bytes 2011-05-22 16:57:09
C file rpc_soc.c 13954 bytes 2011-05-22 16:57:09
File rpc_svc_calls.3 6813 bytes 2011-05-22 16:57:09
File rpc_svc_create.3 8302 bytes 2011-05-22 16:57:09
File rpc_svc_err.3 2779 bytes 2011-05-22 16:57:09
File rpc_svc_reg.3 4677 bytes 2011-05-22 16:57:09
File rpc_xdr.3 2839 bytes 2011-05-22 16:57:09
C file rpcb_clnt.c 36275 bytes 2011-05-22 16:57:09
C file rpcb_prot.c 8334 bytes 2011-05-22 16:57:09
C file rpcb_st_xdr.c 6522 bytes 2011-05-22 16:57:09
File rpcbind.3 4885 bytes 2011-05-22 16:57:09
C file rpcdname.c 2554 bytes 2011-05-22 16:57:09
File rtime.3 997 bytes 2011-05-22 16:57:09
C file rtime.c 4005 bytes 2011-05-22 16:57:09
C file svc.c 17075 bytes 2011-05-22 16:57:09
C file svc_auth.c 5865 bytes 2011-05-22 16:57:09
C file svc_auth_des.c 13879 bytes 2011-05-22 16:57:09
C file svc_auth_unix.c 4656 bytes 2011-05-22 16:57:09
C file svc_dg.c 16194 bytes 2011-05-22 16:57:09
C file svc_generic.c 8678 bytes 2011-05-22 16:57:09
C file svc_raw.c 6284 bytes 2011-05-22 16:57:09
C file svc_run.c 2780 bytes 2011-05-22 16:57:09
C file svc_simple.c 8714 bytes 2011-05-22 16:57:09
C file svc_vc.c 18832 bytes 2011-05-22 16:57:09

    1 $FreeBSD: stable/6/lib/libc/rpc/README 74462 2001-03-19 12:50:13Z alfred $
    2 
    3 PLEASE READ THE DISCLAIMER FILE.  DO NOT CALL THE SUN MICROSYSTEMS SUPPORT
    4 LINE WITH QUESTIONS ON THIS RELEASE.  THEY CANNOT ANSWER QUESTIONS ABOUT THIS
    5 UNSUPPORTED SOURCE RELEASE.
    6 
    7 TIRPCSRC 2.3 29 Aug 1994
    8 
    9 This distribution contains SunSoft's implementation of transport-independent
   10 RPC (TI-RPC), External Data Representation (XDR), and various utilities and
   11 documentation.  These libraries and programs form the base of Open Network
   12 Computing (ONC), and are derived directly from the Solaris 2.3 source.
   13 
   14 Previous releases of RPC Source based on SunOS 4.x were ported to 4.2BSD and
   15 used Sockets as the transport interface.  These versions were
   16 transport-specific RPC (TS-RPC).
   17 
   18 TI-RPC is an enhanced version of TS-RPC that requires the UNIX System V
   19 Transport Layer Interface (TLI) or an equivalent X/Open Transport Interface
   20 (XTI).  TI-RPC is on-the-wire compatible with the TS-RPC, which is supported
   21 by almost 70 vendors on all major operating systems.  TS-RPC source code
   22 (RPCSRC 4.0) remains available from several internet sites.
   23 
   24 This release is a native source release, that is, it is compatible for
   25 building on Solaris 2.3.  This release was built on Solaris 2.3 using SunPro
   26 SPARCompiler 2.0.1.
   27 
   28 Solaris 2.3 is based on System V, Release 4 (SVR4), and while this release
   29 should be mostly compatible with other SVR4 systems, some Solaris facilities
   30 that are assumed may not be available.  In particular, this release uses the
   31 Makefile format supported by SparcCompiler 2.0.1.  Second, the Secure RPC
   32 routines use the Solaris Name Service Switch to access public-key credential
   33 databases.  This code will need to be ported if your system does not support
   34 the Name Service Switch.  Finally, this release uses the synchronization
   35 interfaces of UI Threads to make certain interfaces thread-safe.  These
   36 interfaces are found in libthread in Solaris 2.3 and later.
   37 
   38 Applications linked with this release's librpc must link with the United
   39 States domestic version of libcrypt in order to resolve the cbc_crypt() and
   40 ecb_crypt() functions.  These routines are used with Secure RPC however all
   41 RPC programs that link with this release's librpc will need to link with the
   42 domestic libcrypt.  Note that the Solaris 2.3 Encryption Kit is only available
   43 within the United States.  (PLEASE NOTE: The RPC implementation found in
   44 Solaris 2.3's libnsl does *not* have this requirement; linking with libcrypt
   45 is only a requirement for the TIRPCSRC 2.3 version of librpc.)
   46 
   47 
   48 DOCUMENTATION NOTE
   49 
   50 The documentation found in the doc directory are derived from the Solaris 2.3
   51 Network Interfaces Programming Guide.  A small number of compile examples are
   52 given, and these use libnsl to link in the RPC library.  This release builds
   53 the RPC library as librpc.  To use this release's librpc, use the link command
   54 "-lrpc -lnsl -lcrypt".  This links the application with TIRPCSRC 2.3's librpc
   55 for RPC routines, Solaris's libnsl for other networking functions, and
   56 libcrypt for the cbc_crypt() and ecb_crypt functions.
   57 
   58 
   59 WHY IS THIS RELEASE BEING DONE?
   60 
   61 This release is being distributed to make the Sun implementation of the ONC
   62 technologies available for reference and porting to non-Solaris platforms.
   63 The current release is a native source distribution, and provides services
   64 that are already available on Solaris 2.3 (such as the RPC headers, the RPC
   65 library in libnsl, rpcbind, rpcinfo, etc.).  It is not our intention to
   66 replace these services.  See the DISCLAIMER for further information about the
   67 legal status of this release.
   68 
   69 
   70 WHAT'S NEW IN THIS RELEASE: TIRPCSRC 2.3
   71 
   72 The previous release was TIRPCSRC 2.0.
   73 
   74 1.      This release is based on Solaris 2.3.  The previous release was
   75         based on Solaris 2.0.  This release contains a siginificant number of
   76         bug fixes and other enhancements over TIRPCSRC 2.0.
   77 
   78 2.      The RPC library is thread safe for all client-side interfaces
   79         (clnt_create, clnt_call, etc.).  The server-side interfaces
   80         (svc_create, svc_run, etc.) are not thread safe in this release. The
   81         server-side interfaces will be made thread safe in the next release of
   82         TIRPCSRC.  Please see the manual pages for details about which
   83         interfaces are thread safe.
   84 
   85 3.      As part of the work to make the RPC library thread-safe, rpcgen has
   86         been enhanced to generate thread-safe RPC stubs (the -M option).  Note
   87         that this modifies the call-signature for the stub functions; the
   88         procedure calling the RPC stub must now pass to the stub a pointer to
   89         an allocated structure where results will be placed by the stub.  See
   90         the rpcgen manual page and the rpcgen Programming Guide for details.
   91 
   92 4.      The Remote Asynchronous Calls (RAC) library is now included.  RAC was
   93         first introduced in TIRPCSRC 1.0, and was bundled with librpc.  It is
   94         now a separate library.  The asynchronous call model that RAC provides
   95         can be achieved by using threads for making client-side RPC calls.
   96         The ONC Technology group recommends using threads (where possible) to
   97         achieve asynchrony rather than RAC.  See the rpc_rac(3n) manual page
   98         for details.
   99 
  100 
  101 ROADMAP
  102 
  103 The directory hierarchy is as follows:
  104 
  105     cmd/        Utilities
  106     cmd/rpcgen      The RPC Language compiler (for .x files)
  107     cmd/rpcbind     The RPC bindery and portmapper
  108     cmd/rpcinfo     RPC bindery query utility
  109     cmd/keyserv     The Secure RPC keyserver
  110     cmd/demo        Some simple ONC demo services
  111 
  112     doc/        Postscript versions of ONC documentation
  113 
  114     head/       Header files
  115     head/rpcsvc     RPCL (.x) specifications for various ONC services, and
  116                     header files.
  117 
  118     lib/        Libraries
  119     lib/librpc      The RPC and XDR library
  120     lib/librac      The Remote Asynchronous Calls (RAC) library
  121 
  122     man/        Manual pages for the RPC library and utilities.
  123 
  124     uts/common/rpc      RPC header files
  125 
  126 
  127 
  128 BUILD INSTRUCTIONS
  129 
  130 Prior to building the release, you must define the SRC environment variable
  131 to be the path to the top-level Makefile.  For example, if /usr/src/tirpcsrc
  132 is where to top-level Makefile is located, execute this command prior to
  133 building the release:
  134 
  135         setenv SRC /usr/src/tirpcsrc        (csh)
  136 or
  137         SRC=/usr/src/tirpcsrc; export SRC   (sh)
  138 
  139 The sources in the lib directory depend on header files installed from head
  140 and uts/common/rpc, and the programs in the cmd directory depend on libraries
  141 from lib.  Therefore, you should do a "make install" to build the release.
  142 
  143 The top-level Makefile builds the release.  The "ROOT" macro defines where the
  144 headers and libraries are installed.  The default for ROOT is "/proto".  You
  145 may change this by either modifiying Makefile.master, or issuing the build
  146 command with a new definition for ROOT:
  147 
  148         make install ROOT=/opt/onc
  149 
  150 You will of course need write privileges for the destination directory.
  151 The headers, libraries and executables will be built and installed under the
  152 ROOT.
  153 
  154 
  155 The demonstration services in the demo directory are not built by the
  156 top-level "make install" command.  To build these, cd to the cmd/demo
  157 directory and enter "make".  The four services will be built.
  158 RPCGEN MUST BE INSTALLED in a path that make can find.  To run the
  159 services, rpcbind must be running, then invoke the service
  160 (you probably will want to put it in the background).  rpcinfo can be
  161 used to check that the service succeeded in getting registered with
  162 rpcbind, and to ping the service (see rpcinfo's man page).  You can
  163 then use the corresponding client program to exercise the service.
  164 
  165 
  166 BUILDING ONC APPLICATIONS
  167 
  168 See the Makefiles in the demonstration services for examples of building
  169 ONC applications with this release.  The $(ROOT)/usr/include directory
  170 must be included in the compiler header file search path (-I), and the
  171 $(ROOT)/usr/lib directory must be included in the linker library file search
  172 path (-L).  Also, to run executables built dynamically, the shared library
  173 search path (LD_LIBRARY_PATH) must also include $(ROOT)/usr/lib.  In addition
  174 to linking in this release's librpc (via -lrpc), you must also link with
  175 Solaris's libnsl (-lnsl) and the US domestic version of libcrypt (-lcrypt).
  176 

[ source navigation ] [ identifier search ] [ freetext search ] [ file search ] [ list types ] [ track identifier ]


This page is part of the FreeBSD/Linux Linux Kernel Cross-Reference, and was automatically generated using a modified version of the LXR engine.