home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1992 #31 / NN_1992_31.iso / spool / comp / unix / aix / 12759 < prev    next >
Encoding:
Text File  |  1992-12-22  |  11.3 KB  |  347 lines
  1. Newsgroups: comp.unix.aix
  2. Path: sparky!uunet!pmafire!news.dell.com!natinst.com!cs.utexas.edu!geraldo.cc.utexas.edu!portal.austin.ibm.com!awdprime.austin.ibm.com!ekhadafi.austin.ibm.com!curt
  3. From: curt@ekhadafi.austin.ibm.com (Curt Finch 903 2F021 curt@aixwiz.austin.ibm.com 512-838-2806)
  4. Subject: Re: PCNFSD-2 implementation for AIX?
  5. Sender: news@austin.ibm.com (News id)
  6. Message-ID: <BzMqHt.2sMI@austin.ibm.com>
  7. Date: Mon, 21 Dec 1992 22:01:05 GMT
  8. References: <1992Dec21.140126.27697@bmw.mayo.edu>
  9. Organization: IBM AWD, Austin
  10. Lines: 335
  11.  
  12. In article <1992Dec21.140126.27697@bmw.mayo.edu> fisk@mayo.edu writes:
  13. >
  14. >Is there a PCNFSD-2 implementation for AIX V3.2?  If so, how does one go about
  15. >acquiring it?
  16.  
  17. Order IX32823 from defect support.  It has the newest pcnfsd v2 which
  18. works with PCNFSv4 on the PC.
  19.  
  20. Here are the docs that go with it......
  21.  
  22.  
  23. -----------------------------------------------------------------------
  24.  
  25. Two documents follow.  The first describes the new port of the pcnfsd
  26. daemon.  The second describes it's configuration file, the
  27. /etc/pcnfsd.conf file.
  28.  
  29. The most important thing to note is that pcnfsd no longer has arguments
  30. on the command line.  They are now in the /etc/pcnfsd.conf file.
  31.  
  32. This documentation should be distributed to anyone who is receiving or
  33. has received the latest version of pcnfsd in any of the following PTFs
  34. for 3.2:
  35.  
  36.     U412556 U409761 U413311
  37.  
  38. -----------------------------------------------------------------------
  39. pcnfsd Daemon
  40.  
  41.  
  42.     Purpose
  43.  
  44. Handles service requests from PC-NFS (Personal Computers Network File
  45. System) clients.
  46.  
  47.  
  48.     Syntax
  49.  
  50. /usr/sbin/rpc.pcnfsd
  51.  
  52.  
  53.     Description
  54.  
  55. The pcnfsd daemon handles requests from PC-NFS clients for
  56. authentication services on remote machines.  These services include
  57. authentication for mounting and for print spooling.  The PC-NFS program
  58. allows personal computers running DOS to be networked with machines
  59. running NFS. The pcnfsd daemon supports Versions 1 and 2 of the pcnfsd
  60. protocol.
  61.  
  62. When a PC-NFS client makes a request, the inetd daemon starts the
  63. pcnfsd daemon (if the  inetd.conf file contains the appropriate
  64. entry).  The pcnfsd  daemon reads the  /etc/pcnfsd.conf configuration
  65. file, if present, then services RPC requests directed to program number
  66. 150001.   Once the pcnfsd daemon is started, all print requests go to
  67. the default print spooling directory  (/var/spool/pcnfs) .
  68.  
  69.  
  70.     Authentication
  71.  
  72. When it receives a PCNFSD_AUTH or PCNFSD2_AUTH  request, the pcnfsd
  73. daemon logs in a user by first validating the user name and password,
  74. and then returning the corresponding UID, GIDS, home directory, and
  75. umask specifications.  A record of logins is appended to the
  76. /var/adm/wtmp file.  To disable the login record feature, add the
  77. following line to the /etc/pcnfsd.conf file:
  78.  
  79. wtmp off
  80.  
  81.  
  82.     Printing
  83.  
  84. The pcnfsd daemon uses the Network File System (NFS) to transfer print
  85. data between clients and servers.  The client system first issues a
  86. PCNFSD_PR_INIT or PCNFSD2_PR_INIT request.  The server then returns the
  87. spool directory path for the client to use.
  88.  
  89. Note: The spool directory must be exported by NFS, using the  exportfs
  90. command and the  /etc/exports file.
  91.  
  92. The pcnfsd daemon creates a subdirectory for each of its clients.  The
  93. default parent directory is /var/spool/pcnfs , and the subdirectory is
  94. the host name of the client system.  To use a different parent
  95. directory, add the following line to the /etc/pcnfsd.conf file:
  96.  
  97. spooldir pathname
  98.  
  99.  
  100.  
  101. Once it has mounted the spool directory and transferred print data to a
  102. file in this directory, the client issues a PCNFSD_PR_START  or
  103. PCNFSD2_PR_START request.  The pcnfsd daemon handles this (and most
  104. other print-related requests) by constructing an   enq command.  The
  105. daemon adopts the identity of the personal computer user to execute the
  106. print request command.  Since constructing and executing the command
  107. involves user ID privileges, the pcnfsd daemon must be run as a root
  108. process.
  109.  
  110. All print requests from clients include the name of the printer to be
  111. used.  The printer name is represented by queue and device definitions
  112. in the /etc/qconfig file.  Additionally, the pcnfsd daemon provides a
  113. method for defining PC-NFS virtual printers recognized only by pcnfsd
  114. clients.  Each PC-NFS virtual printer is defined in the
  115. /etc/pcnfsd.conf  file with a line similar to the following:
  116.  
  117. printer name alias-for command
  118.  
  119. In this format, name  specifies the name of the printer to be defined,
  120. and alias-for is the name of an existing printer that will do the
  121. work.  For example, a request to show the queue for name will translate
  122. into a queue command at the alias-for printer.  To define a printer
  123. name with no existing printer, use a single - (minus sign) in place of
  124. the alias-for parameter.  The command parameter specifies a command run
  125. when a file is printed on the name printer.  This command is executed
  126. by the Bourne shell, using the -c option.  For complex operations,
  127. replace the command parameter with an executable shell script.
  128.  
  129. The following list of tokens and substitution values can be used in the
  130. command parameter:
  131.  
  132.  
  133.     Token Substitution
  134.  
  135. $FILE Replaced by the full path name of the print data file.  After the
  136. command has executed, the file is unlinked.
  137.  
  138. $USER Replaced by the user name of the user logged-in to the client.
  139.  
  140. $HOST Replaced by the host name of the client system.
  141.  
  142.  
  143.     Example
  144.  
  145. The following example /etc/pcnfsd.conf file configures a virtual
  146. printer on the first line and a null device for testing on the second
  147. line:
  148.  
  149. printer rotated lw /bin/enscript -2r $FILE
  150. printer test - /usr/bin/cp $FILE /usr/tmp/$HOST-$USER
  151.  
  152. The first line stipulates that if a client system prints a job on the
  153. rotated  printer, the enscript utility will be called to preprocess the
  154. $FILE file.  The -2r option causes the file to be printed in
  155. two-column, rotated format on the default PostScript printer.  If a
  156. client requests a list of the print queue for the rotated printer, the
  157. pcnfsd daemon translates this request into a request for a similar
  158. listing for the lw  printer.
  159.  
  160. The second line establishes a printer test.  Files sent to the test
  161. printer will be copied into the /usr/tmp directory.  Requests to the
  162. test printer to list the queue, check the status, or perform similar
  163. printer operations, will be rejected because - (minus sign) is
  164. specified in place of the alias-for parameter.
  165.  
  166.     Implementation Specifics
  167.  
  168. This daemon is part of NFS in Network Support Facilities in Base
  169. Operating System (BOS) Runtime.
  170.  
  171.     Files
  172.  
  173. /etc/inetd.conf  TCP/IP configuration file that starts RPC daemons and
  174. other TCP/IP daemons.
  175.  
  176. /etc/pcnfsd.conf pcnfsd daemon configuration file.
  177.  
  178. /var/spool/pcnfs   Default print-spooling directory.
  179.  
  180.  
  181.     Suggested Reading
  182.  
  183.         Prerequisite Information
  184.  
  185. Network File  System (NFS) Overview for System Management.
  186.  
  187.         Related Information
  188.  
  189. The  enq  command,  last  command.
  190. The   inetd daemon.
  191. Printer  Overview for System Management.
  192. List of NFS Commands.
  193.  
  194.  
  195.  
  196. -----------------------------------------------------------------------
  197. pcnfsd.conf Configuration File
  198.  
  199.  
  200.     Purpose
  201.  
  202. Provides configuration options for the pcnfsd daemon.
  203.  
  204.  
  205.     Description
  206.  
  207. The /etc/pcnfsd.conf file is an ASCII file written by users to add
  208. options to the operation of the  pcnfsd daemon, which takes no
  209. command-line flags.
  210.  
  211. When started, the pcnfsd daemon checks for the presence of the
  212. pcnfsd.conf  configuration file and conforms its performance to the
  213. specified arguments.  The following options can be entered in the
  214. /etc/pcnfsd.conf file:
  215.  
  216. aixargs -B CharacterPair : Controls the printing of burst pages
  217.     according to the value of the CharacterPair variable, as listed
  218.     below.  The first character applies to the header and the
  219.     second character to the trailer.  Possible values are n
  220.     (never), a (always), and g (group).
  221.  
  222. HT Description
  223.  
  224. nn No headers, no trailers
  225.  
  226. na No headers, trailer on every file
  227.  
  228. ng No header, trailer at the end of the job
  229.  
  230. an Header on every file, no trailers
  231.  
  232. aa Headers and trailers on every file in the job
  233.  
  234. ag Header on every file, trailer after job
  235.  
  236. gn Header at beginning of job, no trailer
  237.  
  238. ga Header at beginning of job, trailer after every file
  239.  
  240. gg Header at beginning of job, trailer at end of job.
  241.  
  242. The header and trailer stanzas in the  /etc/qconfig file define the
  243. default treatment of burst pages.
  244.  
  245. Note: The -B flag works exactly like the -B  flag in the  enq command.
  246. Unlike the enq command, however, the pcnfsd daemon does not allow
  247. spaces between the -B flag and the CharacterPair variable.
  248.  
  249.  
  250. getjobnum off :  Disables the pcnfsd daemon feature that returns job
  251.     numbers when print jobs are submitted.
  252.  
  253. printer Name AliasFor Command :  Defines a PC-NFS virtual printer,
  254.     recognized only by pcnfsd daemon clients.  Each virtual printer
  255.     is defined on a separate line in the pcnfsd.conf file.
  256.  
  257. Name Name :  of the PC-NFS virtual printer to be defined.
  258.  
  259. AliasFor Name :   of an existing printer that performs the print job.
  260.  
  261. Note: To define a Name printer associated with no existing printer, use
  262. a single - (minus sign) in place of the AliasFor parameter.
  263.  
  264. Command Command :  run when a file is printed on the Name printer.  This
  265.     command is executed by the Bourne shell, using the -c  option.
  266.     For complex operations, replace the Command parameter with an
  267.     executable shell script.
  268.  
  269. The following list of tokens and substitution values can be used in the
  270. command parameter:
  271.  
  272.  
  273.     Token Substitution
  274.  
  275. $FILE Replaced by the full path name of the print data file.  After the
  276. command has executed, the file will be unlinked.
  277.  
  278. $USER Replaced by the user name of the user logged-in to the client.
  279.  
  280. $HOST Replaced by the host name of the client system.
  281.  
  282. spooldir PathName  Designates a new parent directory, PathName, where
  283. the pcnfsd daemon stores the subdirectories it creates for each of its
  284. clients.  The default parent directory is /var/spool/pcnfs.
  285.  
  286. wtmp off Disables the login record-keeping feature of the pcnfsd
  287. daemon.  By default, the daemon appends to the   /var/adm/wtmp file a
  288. record of user logins.
  289.  
  290.  
  291.     Example
  292.  
  293. The following sample pcnfsd.conf  configuration file demonstrates the
  294. effects some options have on the operation of the pcnfsd daemon:
  295.  
  296. printer test - /usr/bin/cp $FILE /usr/tmp/$HOST-$USER
  297. printer sandman san ls -l $FILE
  298. wtmp off
  299.  
  300. The first line establishes a printer test.  Files sent to the test
  301. printer will be copied into the /usr/tmp directory.  Requests to the
  302. test PC-NFS virtual printer to list the queue, check the status, or
  303. similar printer operations, will be rejected because - (minus sign) has
  304. been given for the Alias-For parameter.
  305.  
  306. The second line establishes a PC-NFS virtual printer called sandman
  307. that lists, in long form, the file specifications for the print data
  308. file.
  309.  
  310. The third line turns off the pcnfsd  daemon feature that records user
  311. logins.
  312.  
  313.  
  314.     Implementation Specifics
  315.  
  316. This file is part of NFS in Network Support Facilities in Base
  317. Operating System (BOS) Runtime.
  318.  
  319.  
  320.     Files
  321.  
  322.  /etc/qconfig  Configures a printer queuing system.
  323.  
  324. /var/adm/wtmp  Describes formats for user and accounting information.
  325.  
  326.  
  327.     Suggested Reading
  328.  
  329.         Prerequisite Information
  330.  
  331. Network File System (NFS)  Overview for System Management.
  332.  
  333.         Related Information
  334.  
  335. The  enq command.
  336. The  pcnfsd  daemon.
  337. Using the Bourne Shell.  
  338. List of NFS Files.
  339.  
  340. In the LPP bosnet, the following PTFs shipped the following things:
  341.  
  342.  
  343. -- 
  344. curt@aixwiz.austin.ibm.com (Curt L. Finch) | AIX NFS/NIS Field Quality 
  345. My views are unrelated to my employer's    |        Austin, TX
  346.  There'll be too many elderly in 30 years for your kids to afford all the FICA.
  347.