home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / utils / dirutl / chdir.lbr / CHDIR.MZG / CHDIR.MSG
Text File  |  1987-12-26  |  4KB  |  100 lines
  1. Date: 23 Aug 82 0:33:23-EDT (Mon)
  2. From: Rick Conn
  3. To:   All
  4. Re:   chdir.c
  5.  
  6.         I've recently finished designing and uploading a new pro-
  7. gram called CHDIR.  CHDIR is an extrapolation of the CDIR concept
  8. to  cover  all  disks  with  a  named  directory  structure which
  9. supports priveledged users.  The files for this are:
  10.  
  11.                 CHDIR C
  12.                 CHDIR COM
  13.  
  14.         Documentation is sketchy right now ... I plan to come out
  15. with a HLP file on it soon.  Here is the current documentation:
  16.  
  17.         CHDIR is a program which places onto a CP/M or CP/ZM sys-
  18. tem  a  mnemonic hierarchial directory structure.  Via CHDIR, the
  19. user can create named directories, each such directory supporting
  20. up to 64 named subdirectories accessible under it.  The subdirec-
  21. tory is just another directory, and, hence,  a  subdirectory  can
  22. have  up to 64 named subdirectories under it also.  The result is
  23. a hierarchial type of directory structure.
  24.  
  25.         Each directory is the form of a user area on a particular
  26. disk.   One of the many advantages of CHDIR is that it merges all
  27. of the disks of a microcomputer into one logical file system.  If
  28. the  user, say, has a 20M byte Winchester which is divided into 4
  29. logical drives of 5M byte each (named C, D, E,  and  F),  and  he
  30. also  has  two  floppy  disks (8", 600K each) named A and B, then
  31. this entire system of disks and user areas can  be  placed  under
  32. one  file  directory  system  via CHDIR.  An example based on the
  33. hardware configuration above:
  34.  
  35.         A0: named ROOT
  36.         C0: named HD-ROOT
  37.         D0: named SRC-PAS
  38.         D1: named SRC-C
  39.         D2: named SRC-BAS
  40.         D3: named SRC-ASM
  41.         B0: named SCRATCH
  42.         E0: named DEV1
  43.         F0: named DEV2
  44.  
  45.         The user comes in on A0:, the ROOT.  He then issues CHDIR
  46. HD-ROOT and finds himself on C0:; he can then switch to any named
  47. directory accordingly, regardless of what disk or user number  it
  48. is in.
  49.  
  50.         A second advantage is that CHDIR  provides  a  definition
  51. for  a  System,  or Priveledged, set of directories.  This set is
  52. currently defined to be any reference to a  user  number  greater
  53. than  9.   Whenever  a  user  in a user number 9 or less tries to
  54. display all the directories, all he will see is those directories
  55. in  user  numbers  9 or less.  He may note by the directory count
  56. that more directories exist.  If he knows  the  name  of  one  of
  57. these hidden System directories, he may issue a CHDIR to the sys-
  58. tem directory, at which point CHDIR will see he is coming from  a
  59. non-system directory and ask him for the password.  He must issue
  60. the correct password to enter any system directory.   Once  in  a
  61. system  directory,  the  user  is  priveledged  and may enter any
  62. directory on the machine.
  63.  
  64.         Note that, with the ZCPR USER  command  removed,  leaving
  65. only CHDIR as a medium for changing user numbers, this provides a
  66. way of creating a set of relatively secure directories on a  pub-
  67. lic system, such as an RBBS.
  68.  
  69.         Note the further documentation below, extracted from  the
  70. source to CHDIR.
  71.  
  72. CHDIR performs three functions:
  73.  
  74.                 1) CHDIR allows the user to enter one of the  de-
  75. fined directories; this form of the CHDIR command is
  76.  
  77.                         CHDIR dirname
  78.  
  79. where 'dirname' is the name of the directory (up to 8 characters)
  80.  
  81.                 2) CHDIR allows the user to define a new directo-
  82. ry on the fly; this form of the command is
  83.  
  84.                         CHDIR dirname du
  85.  
  86. where 'dirname' is the name of the directory (up to 8 characters)
  87. and 'du' is a disk/user designator, like A10
  88.  
  89.                    Along the same lines, the CHDIR  Setup  option
  90. allows  the  user  to  define or redefine a number of directories
  91. without invoking CHDIR a number of times; this command is of  the
  92. form
  93.  
  94.                         CHDIR /SETUP
  95.  
  96.                 3) CHDIR displays the names of the  known  direc-
  97. tories to the user; this form of the command is
  98.  
  99.                         CHDIR /DISPLAY
  100.