Expand PMF_FN_* macros.
[netbsd-mini2440.git] / usr.sbin / rpc.pcnfsd / README
blob00004a6fbf347bc35a142ab72606d6201e3f4ea7
1 #       $NetBSD: README,v 1.2 1995/07/25 22:20:22 gwr Exp $
4 July 1995 -  Ported to NetBSD by Gordon Ross <gwr@NetBSD.org>
6 Note: to build clnt.pcnfsd use the command:
7         make -f Makefile.clnt
9 Text of original README file from Sun follows:
10 ----------------------------------------------------------------------
12 This is version @(#)README      1.6 1/28/92 of the pcnfsd README file.
13 ----------------------------------------------------------------------
14 This is the second cut at PCNFSD v2. All printing now uses the same
15 SVR4 based printing model: lp, lpstat, cancel. This implies SunOS 4.1
16 or later on a Sun. The printing hasn't been properly tested on SVR4,
17 since my SVR4 system is a bit quirky, but authentication via shadow
18 passwords works fine.
20 The Makefile supplied will build either SunOS 4.1 or SVR4 versions;
21 however you will need to tweak a couple of definitions. See the
22 Makefile for details.
24 For this round, I have frozen the rpcgen'd code and modified it by hand
25 to get around a few rpcgen deficiencies. If in doubt, you can take the
26 pcnfsd.x file included here off to a separate directory, rpcgen everything
27 up and diff against the versions given here.
29 You should also be sure to read the man page. I haven't tried [nt]roff'ing
30 this anywhere outside SunOS, so let me know if there are any quirks.
31 Note especially the /etc/pcnfsd.conf configuration model.
33 Standard disclaimers. Read the source for more of the same.
35 Geoff Arnold (Geoff.Arnold@Sun.COM)
36 May 2, 1991
38 ----------------------------------------------------------------------
39 This is the first major spin since the version I posted in May.
40 Changes are described in the SCCS deltas, but anyone analysing
41 or porting this should watch for the following:
43 - Lots of SVR4 stuff. Look at the Makefile and common.h; you will
44   need to make sure that SVR4 is defined to build a version for SVR4.
45 - Fixed a major bug whereby aliased printers (a.k.a. virtual printers)
46   didn't show up in the printer list.
47 - Since some commands (especially lpq) can hang up forever if, say,
48   the host of a remote printer is down, the su_popen mechanism now
49   includes a watchdog timer. I HAVE NOT HAD A CHANCE TO TEST THIS
50   LOGIC ON SVR4 YET! The code was derived from the System V compatiility
51   section of the AnswerBook, so it _should_ be OK, but I can't wait to
52   test it before posting this.
53 - I've mades lots of lint-suggested improvements. It doesn't lint
54   100% cleanly yet, but it's a lot better.
55 - The client testbed has been tightened up a bit and the reporting
56   is somewhat clearer. Please run it.
58 Feedback is solicited.
60 Geoff Arnold (Geoff.Arnold@Sun.COM)
61 July 24, 1991
63 ----------------------------------------------------------------------------
65 This version includes support for TCP as well as UDP, both in the
66 server and in the test client.  Some of the calls can have long
67 responses, in which case TCP is the preferred transport.
69 Jon Dreyer
70 January 28, 1992
72 ----------------------------------------------------------------------------
74 This release incorporates minor bug fixes occasioned by internal testing
75 against preliminary versions of PC-NFS subsystems which actually use the
76 V2 protocol features. It also addresses a security hole which was identified:
77 see the comment in pcnfsd_print.c for details. This is the version
78 of the daemon which we expect to send out for beta testing.
80 Geoff Arnold
81 November 16, 1991
83 ----------------------------------------------------------------------------
85 Several people pointed out that if I was going to fix the security
86 hole, I should *REALLY* fix it. So this revision checks every argument
87 for every shell metacharacter. This means that if your print subsystem
88 allows such characters in printer names, print job id's, user names,
89 etc. you're going to have to relax the restrictions or tighten up
90 elsewhere. The routine "suspicious()" in pcnfsd_print.c is the starting
91 point for this.
93 Geoff Arnold
94 November 21, 1991
96 ----------------------------------------------------------------------------
98 This version includes one more tweak on the previous security fix, plus
99 a fix for the "user shell" security hole.
101 Geoff Arnold
102 December 17, 1991
104 ----------------------------------------------------------------------------
106 Fix a stupid bug - the secondary groups array wasn't static, so it
107 got overwritten, resulting in the corruption of some GIDs.
109 Geoff Arnold
110 December 18, 1991