Skip to content
master
Switch branches/tags
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
rpc
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README

===
libdrpc
===
What is it?
This is a port of Android librpc to more regular libc versions 
(should build with musl, uclibc, or (e)glibc; klibc and dietlibc might work).
It needs <linux/poll.h> for POLLRDHUP; at this point musl does not define 
this macro under any condition, and Android <poll.h> uses <linux/poll.h>.

partwake.c, which is not built, contains partial wakelock support.
If you want this, you will need to port libpower.

Why?
The standard solution for RPC outside libc, libtirpc, really isn't:
it expects several headers in rpcsvc/ that it doesn't provide, and needs NIS.
The build system is enough of a maze that it was faster to port librpc from 
Android than to fish the proper code out of glibc and patch it into libtirpc.

I could probably have used OpenBSD's xdr/, yp/, and rpc/ source 
(from /usr/src/lib/libc) instead, but this was faster to get and I knew it 
would work on Linux. If someone ports OpenBSD's RPC implementation, I'll 
deprecate this.

How can I use this?
It's Apache licensed, so just about however you want.
This does have one limitation inherited from Android: only one outstanding 
RPC request is permitted at one time.

To build all libraries with gcc, type "make CC=gcc".
(CC defaults to musl-gcc)

libdrpc.a and libdrpc.so are the targets to use for building static and shared
libraries. Installation targets are install, insthdr (installs the headers), 
inst-sh (installs shared libraries), and inst-static (installs libdrpc.a).

Default values for variables that affect compilation and  installation:
CC=musl-gcc
CFLAGS+=-D_BSD_SOURCE -D_XOPEN_SOURCE=600 -I. -I./rpc -DRPC_OFFSET=0
PREFIX?=/usr/local
INCDIR?=${PREFIX}/include/drpc
LIBDIR?=${PREFIX}/lib
SYSLIBDIR?=${LIBDIR}

If you use the default install directories, you will need these changes:
CPPFLAGS+=	-I/usr/local/include/drpc
LDFLAGS	+=	-L/usr/local/lib -ldrpc

How can I help?
-If you add new functions, please add them to new source files. The existing
structure bloats statically linked binaries. (LTO may be able to partially make 
up for this, but optimizing for LTO is self-defeating)
-If you want to adjust the makefile, please respect the .POSIX: rule!
I'm aiming for a Makefile that could be used with any POSIX-compatible make.
-Patches welcome, as long as there's a reason for them.
-Yes, splitting up the source code for better behavior when static linking
is desirable. Just remember the copyright headers.
-Make sure changes are under a license compatible with the Apache license:
permissive with no advertising clause.

About

No description, website, or topics provided.

Resources

License

Releases

No releases published

Packages

No packages published