home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-1.iso / Patches / WritersFix.README < prev    next >
Encoding:
Text File  |  1993-01-21  |  2.7 KB  |  43 lines

  1. Documentation on writersfix
  2. December 14, 1992
  3. NeXT Computer, Inc.
  4.  
  5. As documented in a recent CERT Advisory, the presence of an _writers property in certain NetInfo directories can open security holes in your system and network.  This shell script, writersfix, can assist system and network administrators in their efforts to close these holes.  The script allows one to examine and, optionally, remove the _writers properties in a NetInfo directory and all immediate subdirectories.  It can operate on one domain, or recursively on a domain and all domains below it in the NetInfo domain hierarchy.
  6.  
  7. writersfix's syntax is:
  8.  
  9. writersfix [-s] [-R] [-remove] [-d directory] [domain]
  10.  
  11. Invoking writersfix with the -help flag produces the following additional information:
  12.  
  13.     -s    Silent
  14.     -R    Recurse through NetInfo domain hierarchy
  15.     -remove    Remove _writers (default is just show)
  16.     -d directory    Directory to check (default: /printers)
  17.     domain    Domain to check (default: /)
  18. The specified directory and its immediate subdirectories are checked.
  19. If -R is used, the domain must be specified as a full path, not a
  20. relative domain name.
  21.  
  22. Here's what the various arguments mean.
  23.  
  24. -s    Normally, writersfix reports on its findings an operations be writing messages to stdout.  With -s, it runs silently, reporting only through its exit status (see below).
  25. -R    By default, writersfix operates only on the specified NetInfo domain.  With -R, it operates recursively, on the entire domain hierarchy beginning with and continuing beneath the specified domain.  If recursive operation is used, the domain, below, must be specified using a full path (e.g., /support), rather than a relative path (e.g., . and ..).
  26. -remove    Instructs writersfix to remove _writers properties found.
  27. -d directory    Operate on the specified NetInfo directory.  The default directory is /printers.
  28. domain    Perform specified functions in the indicated NetInfo domain.  The default domain is / (the root domain).
  29.  
  30. The exit status is set to reflect the operation of writersfix, as follows:
  31.  
  32. 0    No errors occurred, and no -writers properties were found.
  33. 2    Syntax error in invocation.
  34. 3    An invalid domain name was used (for example, a relative domain name with recursive operation).
  35. 4    A NetInfo error occurred during operation (e.g., a domain could not be contacted).
  36. 5    One or more _writers properties was found.
  37.  
  38. Exit status 1 is not used to simplify differentiating between shell-generated errors and errors the script itself generates.
  39.  
  40. To install writersfix, rename writersfix.sh to writersfix, and turn on execute permission as you deem appropriate.
  41.  
  42. This description corresponds to Revision 1.5 (93/01/20 13:11:24) of writersfix.  The checksum of Revision 1.5 (output of the sum(1) command) is 59977 6.
  43.