Welcome to mirror list, hosted at ThFree Co, Russian Federation.

cygwin.com/git/newlib-cygwin.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorCorinna Vinschen <corinna@vinschen.de>2010-03-02 17:29:36 +0300
committerCorinna Vinschen <corinna@vinschen.de>2010-03-02 17:29:36 +0300
commit180044b3867145dbbe8ce421dbeff0df425b74ce (patch)
treed1b7548f3666d9375a3fcadf8751402e827672fd /newlib/libc/xdr/README
parent8acb1969b5f891221ca8ed9fafabb49af6cda8eb (diff)
* libc/xdr/README: Correct grammatical errors.
* libc/include/rpc/types.h: Add public types used by RPC implementations. * libc/include/rpc/xdr.h: Add defines used by RPC implementations. * libc/xdr/Makefile.am: Eliminate automake warning. * libc/xdr/Makefile.in: Regenerate.
Diffstat (limited to 'newlib/libc/xdr/README')
-rw-r--r--newlib/libc/xdr/README36
1 files changed, 19 insertions, 17 deletions
diff --git a/newlib/libc/xdr/README b/newlib/libc/xdr/README
index 51870f818..eaae28364 100644
--- a/newlib/libc/xdr/README
+++ b/newlib/libc/xdr/README
@@ -1,9 +1,10 @@
INTRODUCTION
======================
-This directory contains a port of the Sun RPC code (derived
-from the relicensed -- to 3-clause BSD -- implementation in
-Fedora 11's libtirpc package version 0.1.10-7). It has been
-adapted for newlib in the following ways:
+This directory contains a port of eXternal Data Representation
+(XDR) code from SunRPC (derived from the relicensed -- to
+3-clause BSD -- implementation in Fedora 11's libtirpc package
+version 0.1.10-7). It has been adapted for newlib in the
+following ways:
1) xdr_* functions for fixed-width integral types have been
added, such as xdr_int32_t() and similar. The implementation
@@ -58,7 +59,7 @@ xdr_float.c:
...
#elif defined(__vax__)
#include "xdr_float_vax.c"
- +#else defined(__my_platform__)
+ +#elif defined(__my_platform__)
+#include "xdr_float_my_platform.c"
#endif
@@ -121,7 +122,7 @@ The desired callback can be registered by calling:
The return value is the "old" function pointer, which may
be NULL.
-However, neither the typedef or the registration function
+However, neither the typedef nor the registration function
are declared in the public headers. Clients wishing to use
them must either declare the necessary symbols manually,
or #include "xdr_private.h". More on this point, below.
@@ -143,13 +144,13 @@ For instance:
...
}
-Will cause xdr-generated error messages to go to stderr.
+will cause xdr-generated error messages to go to stderr.
It is not expected that end-user applications will make use
of this facility. Rather, it is expected that IF certain
*platforms* desire that these error messages be recorded,
-rather expecting client apps print error messages as
-necessary, then those platforms will, in their startup
+instead of expecting client apps to print error messages as
+necessary (*), then those platforms will, in their startup
objects or static initialization, direct these messages to
a logging facility, strace debug facility, etc.
@@ -158,14 +159,15 @@ Therefore, the platform startup code, if part of newlib, can
from that file.
However, most newlib targets will probably be satisfied with
-the default (silent) behavior. Note that the original Sun RPC,
-as well as the glibc implementation, print these error messages
-to stderr. Cygwin, for greater similarity to glibc, registers
-an error message handler similar to the example above, within
-its startup code.
+the default (silent) behavior. Note that the original Sun RPC
+implementation of XDR, as well as the glibc implementation,
+print these error messages to stderr. Cygwin, for greater
+similarity to glibc, registers an error message handler similar
+to the example above, within its startup code.
-(*) Client apps should already check for FALSE return values;
- in this case they would then check errno and act appropriately.
+(*) Client apps should already check for FALSE return values.
+ In this case when xdr function return FALSE, the client
+ app would then check errno and act appropriately.
LICENSING AND PEDIGREE
@@ -185,7 +187,7 @@ As documented in the libtirpc rpm.spec file from Fedora 11:
So, in the XDR implementation from Fedora 11's libtirpc package,
after the modification above by Tom Callaway, each file carries
-the 3-clause BSD license, and not the so-called "SunRPC" license.
+the 3-clause BSD license and not the so-called "SunRPC" license.
It is from this version that the newlib implementation here was
derived, with the modifications described in the introduction,
above.