home *** CD-ROM | disk | FTP | other *** search
/ The UNIX CD Bookshelf / OREILLY_TUCB_UNIX_CD.iso / upt / examples / SOURCES / DELETE / PART01.Z / PART01 / README < prev    next >
Encoding:
Text File  |  1998-07-24  |  3.4 KB  |  96 lines
  1.                    OVERVIEW
  2.  
  3. This archive contains the sources for five programs (well, actually,
  4. four, since one is a symbolic link):
  5.  
  6.     delete
  7.     undelete
  8.     expunge
  9.     purge
  10.     lsdel
  11.  
  12. The programs were written at Project Athena in response to the problem
  13. which many novice Unix users have with accidentally deleting files
  14. they didn't want to delete (Hell, I've done it :-).
  15.  
  16.  
  17.              SUPPORTED PLATFORMS
  18.  
  19. I've personally compiled these sources under Vax 4.3BSD, IBM AOS 4.3,
  20. Mach on the NeXT Machine (with the "-bsd" flag to the compiler),
  21. Ultrix 3.1 on the DECstation 3100, SunOS 4.0, A/UX, and HP-UX, and I
  22. assume they should compile with minimal trouble on other
  23. architectures.  If you make it compile on another platform and you
  24. have to make changes, please send me patches.
  25.  
  26.  
  27.              WHAT YOU NEED TO DO
  28.  
  29. 1. Compile the com_err library (see below for more details) and
  30.    install it if you want to (you'll have to modify the delete
  31.    Makefile a bit if you don't).
  32.  
  33. 2. Edit the Makefile to fit your site.  See below for details.
  34.  
  35. 3. Compile away!  Type "make" to make without installing, or "make
  36.    install" to install binaries and man pages in the locations you
  37.    specified when you edited the Makefile.
  38.  
  39.  
  40.                CUSTOMIZING THE MAKEFILE
  41.  
  42. You are probably going to have to do one or more of the following to
  43. make the Makefile work for you.
  44.  
  45. 1. Change the install binary directory and install man page directory
  46.    (and possibly man section).
  47.  
  48. 2. Change the ETINCS and ETLDFLAGS variables to point to the right
  49.    place.  Also, change the COMPILE_ET variable to point to a
  50.    compile_et executable if you haven't installed it somewhere in your
  51.    search path.
  52.  
  53. 3. If you want to be able to build dependencies, then change DEPEND to
  54.    the name of the program on your system that knows how to do that.
  55.  
  56. 4. If your system is SYSV-like (e.g. it uses strchr and strrchr
  57.    instead of index and rindex, or it has memcpy and doesn't have
  58.    bcopy), and your compile doesn't define the symbol SYSV
  59.    automatically, then put "-DSYSV" in the DEFINES variable.
  60.  
  61. 5. If you want to support Andrew File System (AFS) mountpoint
  62.    detection, and you have AFS include files and libraries available
  63.    to you, then uncomment the variables starting with "AFS" and set
  64.    them appropriately.
  65.  
  66.  
  67.                COM_ERR LIBRARY
  68.  
  69. In order to compile delete, you need to get your hands on the com_err
  70. package, which was written by members of the MIT Student Information
  71. Processing Board (SIPB).  If com_err isn't available from the place
  72. from which you got the delete sources, you can get it from volume 22
  73. of the comp.sources.unix archives, under the name "et".  You should
  74. compile the library and compile_et utility that comes with it and then
  75. either install them in a "standard location" on your machine or modify
  76. the delete Makefile so that it knows where they are.  The delete
  77. Makefile does not compile them by default, since they are already
  78. compiled and installed at Athena, so you should compile and install
  79. them separately from delete.
  80.  
  81.  
  82.                  FINAL NOTES
  83.  
  84. As usual, suggestions and bug fixes are always welcomed.
  85.  
  86. My address:
  87.  
  88. Jonathan Kamens                          USnail:
  89. MIT Project Athena                11 Ashford Terrace
  90. jik@Athena.MIT.EDU                Allston, MA  02134
  91. Office: 617-253-8085                  Home: 617-782-0710
  92.  
  93. P.S. Please see the file "mit-copyright.h" for copying and
  94. redistribution information.  Copyright 1991 Massachusetts Institute of
  95. Technology.  All Rights Reserved.  Etc.
  96.