TECHNICAL INFORMATION DOCUMENT TITLE: PTF267 - Expand number of addresses for NFS-share rw=,ro=,root= options DATE: 13JUN95 README FOR: PTF267 PRODUCT and VERSION: UnixWare 1.1 Installation Instructions: DATATYPE: datastream 1. Download the ptf267 and ptf267.txt files to the /tmp directory on your machine. 2. Read the release notes contained in this file and follow the instuctions to add the package to your system. 3. Now become root, and add the package to your system using the following commands: $ su # pkgadd -d /tmp/ptf267 ENGINEERING REALEASE NOTES -------------------------- Title ----- PTF267 - Expand number of addresses for NFS-share rw=,ro=,root= options Product And Version -------------------- UnixWare 1.1.2, UnixWare 1.1.3, and UnixWare 1.1.4 Abstract -------- This PTF contains updates to the UnixWare NFS file-system commands to allow longer lists of addresses to be recognized in the NFS-specific 'rw=', 'ro=' and 'root=' option strings. Symptoms -------- The argument string to the 'share' command is truncated after 1024 bytes. Options and addresses specified after the first 1024 bytes are ignored. Of primary concern are the NFS-specific options 'rw=', 'ro=' and 'root='. Each of thes options may contain hundreds of addresses, easily overflowing the 1024 byte limit. If a machine's address is specified after the 1024th byte of the share command for an NFS resource, that machine will be denied access to that resource. Machines whose addresses are listed before the 1024th byte of the share command will be granted the appropriate access. A share command shorter than 1024 bytes may also fail with the error message: UX:nfs share: ERROR: list is too long (maximum 256) even though the number of machines specified is less than 256. This is because a machine is listed once for each of its applicable transports. Thus, if two transports are available (e.g. udp and ipx) a maximum of 128 machines would be accepted in each NFS 'rw=', 'ro=' or 'root=' option. SOLUTION SPECIFICS ------------------ General Description ------------------- Increase the maximum line length to 8192 bytes when reading the /etc/dfs/sharetab file for the generic 'share' command and the NFS-specific 'share', 'unshare' and 'mountd' commands. Also, allow the user to specify on which transports the resource should be shared. New Features ------------ The NFS-specific 'share' command advertises its resource on applicable transports specified in the NETPATH environment variable, rather than choosing from all transports that apply in /etc/netconfig. If the NETPATH environment variable is not specified or is NULL, the NFS 'share' command will scan /etc/netconfig to find all appropriate transports. Specifying just one transport to the 'share' command will allow up to 256 addresses to be specified for each of the 'rw=', 'ro=' and 'root=' options. If two transports are used, a maximum of 128 addresses can be specified. For example, to share the local directory /usr/share/man as an NFS resource available only on the 'udp' transport available read-only to 'greg', 'peter' and 'bobby', read-write to 'marsha', 'jan' and 'cindy' and with root access available to 'alice', type the command ('#' is the shell prompt and '>' is the continuation shell prompt): # NETPATH=udp share -F nfs -o \ > ro=greg:peter:bobby,rw=marsha:jan:cindy,root=alice \ > /usr/share/man The prefix 'NETPATH=udp' sets the 'NETPATH' environment variable to 'udp' and exports it to the share command only. The user's shell environment is unchanged after the 'share' command has been executed. Specifying 'NETPATH' in this manner is recommended because other networking commands read the 'NETPATH' environment variable. Software Notes and Recommendations. ---------------------------------- This PTF can be installed on UnixWare 1.1.2, 1.1.3 and 1.1.4 systems. The Distributed File System Utilities (dfs) and Network File System Utilities (nfs) packages must be installed on the system to install ptf267. Testing of the modified software contained in this package has been conducted only to the extent necessary to confirm that it resolves the problem(s) stated above ("Symptom"). Such testing consists of recreating the problem conditions and verifying that the problem no longer occurs. No other testing of this software has been done. Hardware Notes and Recommendations. ---------------------------------- This PTF is targeted for the i386, i486 and Pentium CPU's. Installation Instructions. ------------------------- After you have installed ptf267, you must stop and restart NFS before the updated binaries will be run. To do this: # cd /etc/init.d # sh nfs stop # sh nfs start