README
1======================================
2FreeDCE RPC and DCOM Toolkit for Linux
3======================================
4
5This package provides support for developing DCE RPC and Microsoft RPC
6applications on the Linux platform. The source code and binaries are
7freely-redistributable provided you maintains the copyright notice of the
8source components.
9
10This package could be ported to other platforms as well, provided that you can
11implement the semantics of the DCE Exceptions and DCE Threads on the target
12platforms' thread layer.
13
14FreeDCE for Linux relies on GNU Libc 2.x and LinuxThreads Pthreads. DCE
15Threads and DCE Exceptions are emulated using LinuxThreads, allowing for
16multithreaded RPC client and server applications to coexist with other
17threaded and non-threaded library components in the Linux development
18environment.
19
20Inventory of Goods:
21-------------------
22* OSF DCE 1.1 IDL compiler
23* DCE RPC runtime and development libraries/headers
24* `uuid' tool for generating and manipulating DCE UUIDs
25* rpcd - the host endpoint mapper for DCE RPC applications
26* Performance, Interoperability and Functionality test suite
27* some demonstration code for writing clients and servers
28
29How to Build:
30-------------
31This package uses autoconf, so `say' the following at a prompt:
32
33 % ./configure
34 % make
35 % su
36 # make install
37
38Note that things will install in /opt/dce by default. To change this, pass the
39--prefix argument to configure.
40
41What the install process doesn't do is arrange for the rpcd to run at startup;
42check out the rc.dce-clean and rc.dcerpcd scripts and install them: for RedHat
43use a set of commands like this:
44
45 # ln -s /etc/rc.d/init.d/rc.dcerpcd /etc/rc.d/rc0.d/K30dcerpcd
46 # ln -s /etc/rc.d/init.d/rc.dce-clear /etc/rc.d/rc3.d/S60dce-clean
47 # ln -s /etc/rc.d/init.d/rc.dcerpcd /etc/rc.d/rc3.d/S61dcerpcd
48
49You might also need to add /opt/dce/lib to your /etc/ld.so.conf
50
51How to build your own programs that use DCE RPC
52-----------------------------------------------
53
54CFLAGS +=-D_REENTRANT -D_GNU_SOURCE
55LIBS += -ldcepthreads
56If you are using the uuid library, you will also need:
57LIBS += -luuid
58
59----------------------
60
61Notes for AIX:
62----------------------
63
64- You must install GNU find otherwise dcelib will not link correctly.
65 This took a lot of tracking down!
66- You should use GNU Bison 1.35 - newer versions appear not to work
67- You must install your own libtool and it MUST have been built with
68 LDFLAGS=-Wl,-brtl
69- You must use the native linker, not the GNU ld
70
71Todo:
72----------------------
73
74- support for rpc_if registration flags
75- correlation robustness in [transmit_as] unmarshalling code
76- check max_rpc_size
77- support for security callbacks
78- explicit support for type pickling (without MIDL_COMPAT)
79
80Maintainers:
81 Luke Howard, lukeh@novell.com
82
83Contributors:
84 Jim Doyle, jrd@bu.edu
85 Wez Furlong, wez@thebrainroom.com
86 Miroslaw Dobrzanski-Neumann, mne@mosaic-ag.com
87
88
README.local