home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 4 / FreshFish_May-June1994.bin / bbs / gnu / fileutils-3.9-src.lha / src / amiga / fileutils-3.9 / README < prev   
Encoding:
Text File  |  1993-06-29  |  4.3 KB  |  85 lines
  1. These are the GNU file management utilities.  Most of these programs
  2. have significant advantages over their Unix counterparts, such as
  3. greater speed, additional options, and fewer arbitrary limits.
  4.  
  5. The programs that can be built with this package are: chgrp, chown,
  6. chmod, cp, dd, df, du, install, ln, dir, vdir, ls, mkdir, mvdir, mkfifo,
  7. mknod, mv, rm, rmdir and touch.  But mvdir is built only on systems
  8. that lack the rename system call.
  9.  
  10. The programs cat, cut, expand, head, paste, split, tac, tail and
  11. unexpand, which used to be part of the fileutils, are now part of the
  12. textutils.  cmp is now part of the diff distribution.
  13.  
  14. See the file NEWS for a list of major changes in the current release.
  15.  
  16. See the file INSTALL for compilation and installation instructions.
  17.  
  18. If your system needs to link with -lPW to get alloca, but has
  19. rename in the C library (so HAVE_RENAME is defined), -lPW might
  20. give you an incorrect version of rename.  On HP-UX this manifests
  21. itself as an undefined data symbol called "Error" when linking cp, ln,
  22. and mv.  If this happens, use `ar x' to extract alloca.o from libPW.a
  23. and `ar rc' to put it in a library liballoca.a, and put that in LIBS
  24. instead of -lPW.  This problem does not occur when using gcc, which
  25. has alloca built in.
  26.  
  27. The fileutils are intended to be POSIX.2 compliant (with BSD and other
  28. extensions), like the rest of the GNU system.  They are almost there,
  29. but a few incompatibilities remain.
  30.  
  31. The comprehensive Texinfo documentation for these programs is not
  32. finished yet, and needs to be rewritten.  In the interim, the skeletal
  33. man pages provided with this distribution will have to serve.
  34.  
  35. The ls, dir, and vdir commands are all separate executables instead of
  36. one program that checks argv[0] because people often rename these
  37. programs to things like gls, gnuls, l, etc.  Renaming a program
  38. file shouldn't affect how it operates, so that people can get the
  39. behavior they want with whatever name they want.
  40.  
  41. On Sequents, the GNU install and chgrp utilities only work when run as
  42. root, because the Sequent chown system call doesn't allow non-root
  43. users to change files' groups, unlike on every other known Unix.
  44. (The Sequent /bin/chgrp is setuid root.  Don't try making GNU chgrp
  45. setuid root unless you add security checks to it.)
  46.  
  47. A warning about du for HP-UX users: GNU du (and I'm sure BSD-derived
  48. versions) counts the st_blocks field of the `struct stat' for each
  49. file.  (It's best to use st_blocks where available, instead of
  50. st_size, because otherwise you get wildly wrong answers for sparse
  51. files like coredumps, and it counts indirect blocks.)  Chris Torek in
  52. a comp.unix.wizards posting stated that in 4BSD st_blocks is always
  53. counted in 512 byte blocks.  On HP-UX filesystems, however, st_blocks
  54. is counted in 1024 byte blocks.  When GNU du is compiled on HP-UX, it
  55. assumes that st_blocks counts 1024-byte blocks, because locally
  56. mounted filesystems do; so to get the number of 512-byte blocks, it
  57. doubles the st_blocks value.  (The HP-UX du seems to do the same
  58. thing.)  This gives the correct numbers on HP-UX filesystems.  But for
  59. 4BSD filesystems mounted on HP-UX machines, it gives twice the correct
  60. numbers; similarly, for HP-UX filesystems, du on 4BSD machines gives
  61. half the correct numbers.  GNU ls with the -s option has the same
  62. problem.  I know of no way to determine for a given filesystem or file
  63. what units st_blocks is measured in.  The f_bsize element of `struct
  64. statfs' does not work, because its meaning varies between different
  65. versions of Unix.
  66.  
  67. The GNU cp, mv, and ln commands can make backups of files that they
  68. are about to overwrite or remove.  Backup file names will end up being
  69. the same as the original file names for files that are at the system's
  70. filename length limit; when that happens, the new file will silently
  71. replace the backup file that was just made.  This happens with GNU
  72. Emacs, also.  I am not aware of a clean, portable solution to this
  73. problem.
  74.  
  75. Special thanks to Jim Meyering, Brian Matthews, Bruce Evans, Karl Berry,
  76. Kaveh Ghazi, and Franc,ois Pinard for help with debugging and porting
  77. these programs.
  78.  
  79. These programs all recognize the `--version' option.  Although the RCS
  80. `ident' command no longer works, using `grep' and `strings -' or `od -s'
  81. on them still works, e.g., `strings - /usr/local/bin/ls | grep fileutils'.
  82.  
  83. Mail suggestions and bug reports for these programs to
  84. bug-gnu-utils@prep.ai.mit.edu.
  85.