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