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