summaryrefslogtreecommitdiffstats
path: root/c/src/librpc/src/rpc/README
diff options
context:
space:
mode:
authorJoel Sherrill <joel.sherrill@OARcorp.com>2002-06-25 14:52:37 +0000
committerJoel Sherrill <joel.sherrill@OARcorp.com>2002-06-25 14:52:37 +0000
commit411e387c27b183eb53c9563a8decfb02af73dfd0 (patch)
tree8787b53c4df78702fa6a77cc722ee830ada6a3f7 /c/src/librpc/src/rpc/README
parent2002-06-19 Ralf Corsepius <corsepiu@faw.uni-ulm.de> (diff)
downloadrtems-411e387c27b183eb53c9563a8decfb02af73dfd0.tar.bz2
2002-06-25 Joel Sherrill <joel@OARcorp.com>
* Per PR233, moved librpc to exec. Ralf will patch after move. The patches associated with this PR are out of date. ./include/rpc/.cvsignore, ./include/rpc/Makefile.am, ./include/rpc/auth.h, ./include/rpc/auth_des.h, ./include/rpc/auth_unix.h, ./include/rpc/clnt.h, ./include/rpc/des.h, ./include/rpc/des_crypt.h, ./include/rpc/pmap_clnt.h, ./include/rpc/pmap_prot.h, ./include/rpc/pmap_rmt.h, ./include/rpc/rpc.h, ./include/rpc/rpc_com.h, ./include/rpc/rpc_msg.h, ./include/rpc/svc.h, ./include/rpc/svc_auth.h, ./include/rpc/types.h, ./include/rpc/xdr.h, ./include/.cvsignore, ./include/Makefile.am, ./include/rpcsvc/.cvsignore, ./include/rpcsvc/Makefile.am, ./include/rpcsvc/bootparam_prot.x, ./include/rpcsvc/crypt.x, ./include/rpcsvc/key_prot.x, ./include/rpcsvc/klm_prot.x, ./include/rpcsvc/mount.x, ./include/rpcsvc/nfs_prot.x, ./include/rpcsvc/nis.x, ./include/rpcsvc/nis_cache.x, ./include/rpcsvc/nis_callback.x, ./include/rpcsvc/nis_db.h, ./include/rpcsvc/nis_object.x, ./include/rpcsvc/nis_tags.h, ./include/rpcsvc/nislib.h, ./include/rpcsvc/nlm_prot.x, ./include/rpcsvc/pmap_prot.x, ./include/rpcsvc/rex.x, ./include/rpcsvc/rnusers.x, ./include/rpcsvc/rquota.x, ./include/rpcsvc/rstat.x, ./include/rpcsvc/rwall.x, ./include/rpcsvc/sm_inter.x, ./include/rpcsvc/spray.x, ./include/rpcsvc/yp.x, ./include/rpcsvc/yp_prot.h, ./include/rpcsvc/ypclnt.h, ./include/rpcsvc/yppasswd.x, ./include/rpcsvc/ypupdate_prot.x, ./include/rpcsvc/ypxfrd.x, ./.cvsignore, ./Makefile.am, ./README_RTEMS, ./configure.ac, ./src/rpc/PSD.doc/.cvsignore, ./src/rpc/PSD.doc/Makefile.am, ./src/rpc/PSD.doc/nfs.rfc.ms, ./src/rpc/PSD.doc/rpc.prog.ms, ./src/rpc/PSD.doc/rpc.rfc.ms, ./src/rpc/PSD.doc/rpcgen.ms, ./src/rpc/PSD.doc/xdr.nts.ms, ./src/rpc/PSD.doc/xdr.rfc.ms, ./src/rpc/.cvsignore, ./src/rpc/DISCLAIMER, ./src/rpc/Makefile.am, ./src/rpc/README, ./src/rpc/auth_des.c, ./src/rpc/auth_none.c, ./src/rpc/auth_time.c, ./src/rpc/auth_unix.c, ./src/rpc/authdes_prot.c, ./src/rpc/authunix_prot.c, ./src/rpc/bindresvport.3, ./src/rpc/bindresvport.c, ./src/rpc/clnt_generic.c, ./src/rpc/clnt_perror.c, ./src/rpc/clnt_raw.c, ./src/rpc/clnt_simple.c, ./src/rpc/clnt_tcp.c, ./src/rpc/clnt_udp.c, ./src/rpc/clnt_unix.c, ./src/rpc/crypt_client.c, ./src/rpc/des_crypt.3, ./src/rpc/des_crypt.c, ./src/rpc/des_soft.c, ./src/rpc/get_myaddress.c, ./src/rpc/getpublickey.c, ./src/rpc/getrpcent.3, ./src/rpc/getrpcent.c, ./src/rpc/getrpcport.3, ./src/rpc/getrpcport.c, ./src/rpc/key_call.c, ./src/rpc/key_prot_xdr.c, ./src/rpc/netname.c, ./src/rpc/netnamer.c, ./src/rpc/pmap_clnt.c, ./src/rpc/pmap_getmaps.c, ./src/rpc/pmap_getport.c, ./src/rpc/pmap_prot.c, ./src/rpc/pmap_prot2.c, ./src/rpc/pmap_rmt.c, ./src/rpc/publickey.3, ./src/rpc/publickey.5, ./src/rpc/rpc.3, ./src/rpc/rpc.5, ./src/rpc/rpc_callmsg.c, ./src/rpc/rpc_commondata.c, ./src/rpc/rpc_dtablesize.c, ./src/rpc/rpc_prot.c, ./src/rpc/rpc_secure.3, ./src/rpc/rpcdname.c, ./src/rpc/rstat.1, ./src/rpc/rstat_svc.8, ./src/rpc/rtems_portmapper.c, ./src/rpc/rtems_rpc.c, ./src/rpc/rtime.3, ./src/rpc/rtime.c, ./src/rpc/svc.c, ./src/rpc/svc_auth.c, ./src/rpc/svc_auth_des.c, ./src/rpc/svc_auth_unix.c, ./src/rpc/svc_raw.c, ./src/rpc/svc_run.c, ./src/rpc/svc_simple.c, ./src/rpc/svc_tcp.c, ./src/rpc/svc_udp.c, ./src/rpc/svc_unix.c, ./src/xdr/.cvsignore, ./src/xdr/Makefile.am, ./src/xdr/xdr.3, ./src/xdr/xdr.c, ./src/xdr/xdr_array.c, ./src/xdr/xdr_float.c, ./src/xdr/xdr_mem.c, ./src/xdr/xdr_rec.c, ./src/xdr/xdr_reference.c, ./src/xdr/xdr_sizeof.c, ./src/xdr/xdr_stdio.c, ./src/.cvsignore, ./src/Makefile.am: Moved to exec.
Diffstat (limited to 'c/src/librpc/src/rpc/README')
-rw-r--r--c/src/librpc/src/rpc/README233
1 files changed, 0 insertions, 233 deletions
diff --git a/c/src/librpc/src/rpc/README b/c/src/librpc/src/rpc/README
deleted file mode 100644
index ad9d70f990..0000000000
--- a/c/src/librpc/src/rpc/README
+++ /dev/null
@@ -1,233 +0,0 @@
-RPCSRC 4.0 7/11/89
-
-This distribution contains Sun Microsystem's implementation of the
-RPC and XDR protocols and is compatible with 4.2BSD and 4.3BSD. Also
-included is complete documentation, utilities, RPC service
-specification files, and demonstration services in the format used by
-the RPC protocol compiler (rpcgen). See WHAT'S NEW below for
-details.
-
-NOTE ABOUT SECURE RPC:
-
-This release of RPCSRC contains most of the code needed to implement
-Secure RPC (see "DES Authentication" in the RPC Protocol Specification,
-doc/rpc.rfc.ms). Due to legal considerations, we are unable to
-distribute an implementation of DES, the Data Encryption Standard, which
-Secure RPC requires. For this reason, all of the files, documentation, and
-programs associated with Secure RPC have been placed into a separate
-directory, secure_rpc. The RPC library contained in the main body of this
-release *DOES NOT* support Secure RPC. See secure_rpc/README for more
-details. (A DES library was posted in Volume 18 of comp.sources.unix.)
-
-If you wish to report bugs found in this release, send mail to:
-
-Portable ONC/NFS
-Sun Microsystems, Inc
-MS 12-33
-2550 Garcia Avenue
-Mountain View, CA 94043
-
-or send Email to nfsnet@sun.com (the Internet) or sun!nfsnet (Usenet).
-
-ROADMAP
-
-The directory hierarchy is as follows:
-
- demo/ Various demonstration services
- demo/dir Remote directory lister
- demo/msg Remote console message delivery service
- demo/sort Remote sort service
-
- doc/ Documentation for RPC, XDR and NFS in "-ms" format.
-
- etc/ Utilities (rpcinfo and portmap). portmap must be
- started by root before any other RPC network services are
- used. SEE BELOW FOR BUGFIX TO 4.3BSD COMPILER.
-
- man/ Manual pages for RPC library, rpcgen, and utilities.
-
- rpc/ The RPC and XDR library. SEE BELOW
- FOR BUGFIX TO 4.2BSD COMPILER.
-
- rpcgen/ The RPC Language compiler (for .x files)
-
- rpcsvc/ Service definition files for various services and the
- server and client code for the Remote Status service.
-
- secure_rpc/ The files in this directory are used to build a version of
- the RPC library with DES Authentication. See the README
- file in that directory for more details.
-
-BUILD INSTRUCTIONS
-
-Makefiles can be found in all directories except for man. The
-Makefile in the top directory will cause these others to be invoked
-(except for in the doc, man and demo directories), in turn building the
-entire release.
-
-WARNING! THE DEFAULT INSTALLATION PROCEDURES WILL INSTALL FILES
-IN /usr/include, /usr/lib, /usr/bin and /etc.
-
-The master RPC include file, rpc/rpc.h, is used by all programs and
-routines that use RPC. It includes other RPC and system include files
-needed by the RPC system. PLEASE NOTE: If your system has NFS, it
-may have been based on Sun's NFS Source. The include files installed
-by this package may duplicate include files you will find on your NFS
-system. The RPCSRC 4.0 include files are upwardly compatible to all
-NFS Source include files as of the date of this distribution (not
-including any new definitions or declarations added by your system
-vendor). HOWEVER: Please read the comments towards the end of
-rpc/rpc.h regarding rpc/netdb.h. You may need to uncomment the
-inclusion of that file if the structures it defines are already
-defined by your system's include files.
-
-After making any compiler fixes that are needed (see below), at
-the top directory, type:
-
- make install
-
-For all installations, the Makefile macro DESTDIR is prepended to the
-installation path. It is defined to be null in the Makefiles, so
-installations are relative to root. (You will probably need root
-privileges for installing the files under the default path.) To
-install the files under some other tree (e.g., /usr/local), use the
-command:
-
- make install DESTDIR=/usr/local
-
-This will place the include files in /usr/local/usr/include, the RPC
-library in /usr/local/usr/lib, rpcgen in /usr/local/usr/bin, and the
-utilities in /usr/local/etc. You'll have to edit the Makefiles or
-install the files by hand if you want to do anything other than this
-kind of relocation of the installation tree.
-
-The RPC library will be built and installed first. By default it is
-installed in /usr/lib as "librpclib.a". The directory
-/usr/include/rpc will also be created, and several header files will
-be installed there. ALL RPC SERVICES INCLUDE THESE HEADER FILES.
-
-The programs in etc/ link in routines from librpclib.a. If you change
-where it is installed, be sure to edit etc/'s Makefile to reflect this.
-These programs are installed in /etc. PORTMAP MUST BE RUNNING ON
-YOUR SYSTEM BEFORE YOU START ANY OTHER RPC SERVICE.
-
-rpcgen is installed in /usr/bin. This program is required to build
-the demonstration services in demo and the rstat client and server in
-rpcsvc/.
-
-The rpcsvc/ directory will install its files in the directory
-/usr/include/rpcsvc. The Remote Status service (rstat_svc) will be
-compiled and installed in /etc. If you wish to make this service
-available, you should either start this service when needed or have
-it started at boot time by invoking it in your /etc/rc.local script.
-(Be sure that portmap is started first!) Sun has modified its
-version of inetd to automatically start RPC services. (Use "make
-LIB=" when building rstat on a Sun Workstation.) The Remote Status
-client (rstat) will be installed in /usr/bin. This program queries
-the rstat_svc on a remote host and prints a system status summary
-similar to the one printed by "uptime".
-
-The documentation is not built during the "make install" command.
-Typing "make" in the doc directory will cause all of the manuals to
-be formatted using nroff into a single file. We have had a report
-that certain "troff" equivalents have trouble processing the full
-manual. If you have trouble, try building the manuals individually
-(see the Makefile).
-
-The demonstration services in the demo directory are not built by the
-top-level "make install" command. To build these, cd to the demo
-directory and enter "make". The three services will be built.
-RPCGEN MUST BE INSTALLED in a path that make can find. To run the
-services, start the portmap program as root and invoke the service
-(you probably will want to put it in the background). rpcinfo can be
-used to check that the service succeeded in getting registered with
-portmap, and to ping the service (see rpcinfo's man page). You can
-then use the corresponding client program to exercise the service.
-To build these services on a Sun workstation, you must prevent the
-Makefile from trying to link the RPC library (as these routines are
-already a part of Sun's libc). Use: "make LIB=".
-
-BUGFIX FOR 4.3BSD COMPILER
-
-The use of a 'void *' declaration for one of the arguments in
-the reply_proc() procedure in etc/rpcinfo.c will trigger a bug
-in the 4.3BSD compiler. The bug is fixed by the following change to
-the compiler file mip/manifest.h:
-
-*** manifest.h.r1.1 Thu Apr 30 13:52:25 1987
---- manifest.h.r1.2 Mon Nov 23 18:58:17 1987
-***************
-*** 21,27 ****
- /*
- * Bogus type values
- */
-! #define TNULL PTR /* pointer to UNDEF */
- #define TVOID FTN /* function returning UNDEF (for void) */
-
- /*
---- 21,27 ----
- /*
- * Bogus type values
- */
-! #define TNULL INCREF(MOETY) /* pointer to MOETY -- impossible type */
- #define TVOID FTN /* function returning UNDEF (for void) */
-
- /*
-
-If you cannot fix your compiler, change the declaration in reply_proc()
-from 'void *' to 'char *'.
-
-BUGFIX FOR 4.2BSD COMPILER
-
-Unpatched 4.2BSD compilers complain about valid C. You can make old
-compilers happy by changing some voids to ints. However, the fix to
-the 4.2 VAX compiler is as follows (to mip/trees.c):
-
-*** trees.c.r1.1 Mon May 11 13:47:58 1987
---- trees.c.r1.2 Wed Jul 2 18:28:52 1986
-***************
-*** 1247,1253 ****
- if(o==CAST && mt1==0)return(TYPL+TYMATCH);
- if( mt12 & MDBI ) return( TYPL+LVAL+TYMATCH );
- else if( (mt1&MENU)||(mt2&MENU) ) return( LVAL+NCVT+TYPL+PTMATCH+PUN );
-! else if( mt12 == 0 ) break;
- else if( mt1 & MPTR ) return( LVAL+PTMATCH+PUN );
- else if( mt12 & MPTI ) return( TYPL+LVAL+TYMATCH+PUN );
- break;
---- 1261,1269 ----
- if(o==CAST && mt1==0)return(TYPL+TYMATCH);
- if( mt12 & MDBI ) return( TYPL+LVAL+TYMATCH );
- else if( (mt1&MENU)||(mt2&MENU) ) return( LVAL+NCVT+TYPL+PTMATCH+PUN );
-! /* if right is TVOID and looks like a CALL, is not ok */
-! else if (mt2 == 0 && (p->in.right->in.op == CALL || p->in.right->in.op == UNARY CALL))
-! break;
- else if( mt1 & MPTR ) return( LVAL+PTMATCH+PUN );
- else if( mt12 & MPTI ) return( TYPL+LVAL+TYMATCH+PUN );
- break;
-
-WHAT'S NEW IN THIS RELEASE: RPCSRC 4.0
-
-The previous release was RPCSRC 3.9. As with all previous releases,
-this release is based directly on files from Sun Microsystem's
-implementation.
-
-Upgrade from RPCSRC 3.9
-
-1) RPCSRC 4.0 upgrades RPCSRC 3.9. Improvements from SunOS 4.0 have
- been integrated into this release.
-
-Secure RPC (in the secure_rpc/ directory)
-
-2) DES Authentication routines and programs are provided.
-3) A new manual, "Secure NFS" is provided, which describes Secure RPC
- and Secure NFS.
-4) Skeleton routines and manual pages are provided which describe the
- DES encryption procedures required by Secure RPC. HOWEVER, NO DES
- ROUTINE IS PROVIDED.
-
-New Functionality
-
-5) rpcinfo can now be used to de-register services from the portmapper
- which may have terminated abnormally.
-6) A new client, rstat, is provided which queries the rstat_svc and
- prints a status line similar to the one displayed by "uptime".