home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / zsus / z3help / p.lbr / PWD.HZP / PWD.HLP
Encoding:
Text File  |  1991-11-18  |  7.9 KB  |  156 lines
  1. ;
  2.                                     PWD.COM                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5. PWD.3OM        4k (25)   A760  2.1        Bruce Morgen 11/91       Z3COM16
  6. PWD.4OM        4k (30)   CEB4  2.1        Bruce Morgen 11/91       Z3COM16
  7. PWD.COM        4k (25)   813E  2.1        Bruce Morgen 11/91       Z3COM16
  8.  
  9.   1- Syntax/Options  2- Notes  3- Error Messages  4- Examples of Use          
  10.  
  11.    PWD displays the names of DU and Directory names with paging.   If  the  /P 
  12. option is included, then the passwords to the directories  will be included in
  13. the display (but only if the  wheel byte is  set).   Display may be limited to
  14. specified drives and/or to automatically wildcarded name specifications.
  15.  
  16.    If the  Wheel Byte  is not implemented for a system, then its address is 0,
  17. where the JMP instruction to  the  Warm  Boot routine  in the BIOS is located.
  18. Since JMP is non-zero in value, the Wheel Byte is TRUE,  and passwords will be
  19. displayed by PWD.  Vs. 1.0 (3/84) by R. Conn. 
  20. :1
  21.  
  22.   Syntax   PWD [<arg>...]  (delimiters are Space/Tab/Comma)
  23.  
  24.          <arg>  Auto-wildcarded names to display
  25.          <arg>: Display names for drives listed in <arg> ONLY
  26.         ~<arg>: Exclude names for drives listed in <arg>
  27.         /<arg>  Honor an option or display help and quit.
  28.                 
  29.  Examples 
  30.  
  31.         <arg>           Displays:
  32.  
  33.         (none)          All Directory Names
  34.         CA              All Dir names starting with "CA"
  35.         D:CA            Dir names "CA??????" for drive D: only
  36.         B-F:            Dir names for drives B,C,D,E, and F
  37.         BCML:           Dir names for drives B,C,M, and L
  38.         ~M:             Dir names for all EXCEPT drive M:
  39.         /P              Directory Names & Passwords (WHEEL only)
  40. :2
  41.  PWD Notes - 1/5 
  42.  
  43.    a. Vs 2.1 updates (11/12/91, Bruce Morgen):
  44.       - Maintenance  update  introducing  Type 4  executable.   Type 4 is well
  45.         under 4K, others slightly smaller than v2.0; no functional changes.
  46.       - Uses ZSLIB highlighting in lieu of much bulkier VLIB equivalents.
  47.       - Adds display of Type number and execution address to banner.  
  48.  
  49.    b. Vs 2.0 updates (9/30/89, Al Hawley):
  50.       - Complete revision replaces dependance on BYE3 with reference to the Z3
  51.         Environment Descriptor  (including the  extended env  introduced  with 
  52.         V4LIBS) and to configurable program  defaults.   The  source  code for 
  53.         PWD2 is written  with  a Type 3 Header,  which means that its load and 
  54.         execution address is whatever the program is linked for.  If linked to 
  55.         load at 100H, then it will be executable in  a CP/M or ZCPR3.0 system. 
  56.         If linked for loading/execution at a higher address,  the program will 
  57.         abort gracefully with an error message if the current operating system 
  58.         does not support Type 3 file  execution.   The  Type 3  provisions are 
  59.         unchanged from V 1.4.
  60.  PWD Notes - 2/5 
  61.  
  62.       - The display is Paged, with  page  length from the Environment.   Added
  63.         Cntl-C user abort at end of each line and at screen pause.
  64.       - The width of the display also  changes according to the  console width
  65.         parameter in the Z3 Environment.
  66.       - ALL elements of the NDR are displayable for a WHEEL,  but command line
  67.         options may be used to limit the entries displayed.
  68.       - Display of DU: is controlled by the  DUOK flag (Z3 environment) if  so
  69.         configured with ZCNFG.  
  70.       - When the wheel byte is reset (no privileges),  the  following options/
  71.         restrictions become active:
  72.         1) Hiding of passworded directories from non  wheels is supported as a
  73.            configurable option.
  74.         2) Passwords are NEVER displayed to non-wheel users.  (no  change from 
  75.            v1.4)
  76.         3) An internal drive vector is  maintained  which inhibits display for
  77.            drives greater than the MAXDRIVE parameter in the environment.   If
  78.            an extended environment is present,  then  the  drive  vector  from 
  79.            there inhibits  display  for  drives  marked not available, even if 
  80.            they are less than the maximum  drive allowed.   The internal drive 
  81.  PWD Notes - 3/5 
  82.  
  83.            vector is configurable  with  ZCNFG.   An  internal  MAXDRIVE is no 
  84.            longer needed; its function is  filled by the  drive vector and the 
  85.            values from the environment.
  86.         4) Display is inhibited for  directories  whose user number is greater
  87.            than MAXUSER from the environment.
  88.       -  A configuration overlay for use with ZCNFG is provided.
  89.       -  A new command syntax allows limiting the display to  Dir Names  which
  90.          satisfy  an  auto-wildcard  argument  and/or  satisfy  a  drive  spec
  91.          expression.  For example,  "PWD C"  displays  only  dirnames starting
  92.          with 'C'.   Drive specs may comprise a list of  drives,  like 'ABMDH'
  93.          (order unimportant).   Only the names for the  drives  listed will be
  94.          displayed.   One or more of the list members  can be a range express-
  95.          ion, like C-G.   Another way to limit the display is to  EXCLUDE  the
  96.          drives listed (including a range) by preceding  the list with a nega-
  97.          tion operator,  a ~ (tilde).   The range and negation  operators  are
  98.          configurable.   Back to basics:  PWD (no argument) does the same dis-
  99.          play as before,  within the  constraints  configured.  The  syntax to
  100.          display passwords has been changed to  '/P',  in  line  with  other Z
  101.          utilities which support options.
  102.  PWD Notes - 4/5 
  103.  
  104.    c. Vs. 1.4 updates (4/3/88, Bruce Morgen):
  105.       - Type 3 format with safety header 
  106.       - smart help screen
  107.       - RAS-oriented  options  (patch  102H  to  80H  for  BYE  detection  and 
  108.         obedience, 01H for hiding passworded directories from non-wheels,  81H 
  109.         for both, or 00H for neither).
  110.  
  111.    d. Vs 1.3 updates (11/21/86, Dave McCord):
  112.       - Translated source to permit assembly with ZAS.  No other changes.
  113.  
  114.    e. Vs 1.2 updates (06/03/85, Bruce Morgen):
  115.       - Consolidated Jay's and Dave's separate PWD11s into a  `universal'  PWD
  116.         for remote use.   Both mods work very well, Jay's  - controlled by the
  117.         `hidepw' equate -  allows the sysop or  privileged user see  all pass-
  118.         worded named directories and their passwords but keeps  non-wheels  in
  119.         the dark, while Dave's - controlled by the  `chkbye'  equate - follows
  120.         what BYE dictates and provides a more  `absolute'  kind  of protection
  121.         since no directory beyond what  BYE  allows shows up regardless of the
  122.         state of the wheel byte.   The  routines  seem  to  co-exist  with  no
  123.         conflict and may be chosen  separately or  together.   
  124.  PWD Notes - 5/5 
  125.  
  126.    f. Vs 1.1 updates (02/13/85-Jay Sage, 10/30/84-Bruce Morgen):
  127.       - Modified to suppress display of  directories that  are passworded when
  128.         the user is not a wheel. 
  129.       - Added findbye routine and other code so that when used in rcp/m appli-
  130.         cation, users will only be shown  directories that they have access to
  131.         under BYE.
  132. :3
  133.  Error Messages   
  134.  
  135.    "Password Request Denied - Not Wheel"  
  136.  
  137.       - P option given but wheel byte not set, so passwords will not be
  138.         displayed
  139.  
  140.  
  141.    "Named Directory Buffer Not Available" 
  142.  
  143.       - Named Directories not implemented
  144. :4
  145.  Examples of Use 
  146.  
  147.    a.  PWD //           <--  displays internal help screen
  148.  
  149.    b.  PWD HBJMF:       <--  displays DU/DIRs for drives H, B, J, M, F
  150.  
  151.    c.  PWD B-FM:        <--  displays DU/DIRs for drives B through F, and M 
  152.  
  153.    d.  PWD ~bc:         <--  displays DU/DIRs for all drives except B and C
  154.  
  155.    e.  PWD A-P: ~lmno:  <--  displays DU/DIRs for all drives except L, M, N, O
  156.