home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d1xx / d133 / crc.lha / Crc / rls.man < prev    next >
Text File  |  1988-03-13  |  4KB  |  133 lines
  1.  
  2.  
  3. RLS(1)                  AmigaDos 1.2                  RLS(1)
  4.  
  5. NAME 
  6.    rls - recursively list a directory's contents 
  7.  
  8.  
  9. SYNOPSIS 
  10.    rls [-adqs] directoryname ... 
  11.  
  12.  
  13. REVISION 
  14.    0.010, compiled with Manx 3.4b C compiler. 
  15.  
  16.  
  17. DESCRIPTION 
  18.    For each name passed as an argument, rls will list each
  19.    file name in that directory and for each sub-directory it
  20.    will recursively list any files. Directory names can also
  21.    be listed optionally. The file (and optional directory)
  22.    names are listed with the appropriate path, one name per
  23.    line. 
  24.  
  25.    rls accepts directory or device names as arguments. It
  26.    may also be passed names ASSIGN'ed through the AmigaDOS
  27.    Assign command. 
  28.  
  29.    The user may abort the program by entering control-c from
  30.    the keyboard. All locks and memory are returned to the
  31.    system. 
  32.  
  33.  
  34.    OPTIONS 
  35.       If the first command-line parameter starts with a '-'
  36.       (minus) character, it is interpreted as a list of
  37.       options. Options may only appear in the first
  38.       parameter; this enables directory names that begin
  39.       with the '-' character to be listed in a coherent
  40.       fashion. Current options are: 
  41.  
  42.       -d List directory names separately; normally only
  43.          paths to file names are listed. 
  44.  
  45.       -s Don't substitute volume names for device names in
  46.          the listing. 
  47.  
  48.       -q Enclose any pathnames that include spaces with
  49.          quotes. 
  50.  
  51.       -a Enclose all pathnames with quotes, reguardless of
  52.          spaces. 
  53.  
  54.  
  55. ERRORS 
  56.    Should any errors occur during the scan, an appropriate
  57.    error message is printed. (This message will be on the
  58.    console and will not get re-directed to wherever the
  59.    standard output is going.) An error will cause the
  60.    program to abort, returning an error code of 10. 
  61.  
  62.    A maximum depth of 30 sub-directories is permitted. If
  63.  
  64. (11/14/87)     Copyright 1987, by Don Kindred         Page 1
  65.  
  66.  
  67.  
  68.  
  69. RLS(1)                  AmigaDos 1.2                  RLS(1)
  70.  
  71.    the maximum depth is exceeded, the program aborts. 
  72.  
  73.  
  74. EXAMPLES 
  75.    1>rls >ram:list df0: 
  76.       (If no errors occur, the ouput will go to the file
  77.       ram:list. If an error does occur, a message will
  78.       appear on the console. The actual name of the disk in
  79.       drive df0: will be substituted for "df0:" in the
  80.       listing.) 
  81.  
  82.    1>rls -s df0: 
  83.       (Will list all the files on drive df0:. "df0:" will
  84.       appear in the listing.) 
  85.  
  86.    1>rls this_dir 
  87.       (Will list all the files in directory "this_dir".) 
  88.  
  89.    1>rls - -this_dir 
  90.       (Will list all the files in directory "-this_dir".) 
  91.  
  92.    1>rls -this_dir 
  93.       (Will produce some error message, because "-this_dir"
  94.       is interpreted as a string of options.) 
  95.  
  96.    1>rls -qd df0: 
  97.       (Will list all file and directory directory names on
  98.       df0:. Further, each name that contains a space will be
  99.       quoted.) 
  100.  
  101.    1>rls -a df0: 
  102.       (Will list all file names on df0:. Each name will
  103.       appear inside quotes.) 
  104.  
  105.  
  106. AUTHOR 
  107.    Don Kindred 
  108.  
  109.  
  110. BUGS 
  111.    No major bugs have been reported. 
  112.  
  113.    Better error messages could be implemented for various
  114.    error conditions. 
  115.  
  116.    Currently, error messages only go to the console. If the
  117.    standard output has been redirected to a file, error
  118.    messages will not appear in the file. 
  119.  
  120.    If you find any bugs or would like to hire a good C
  121.    programmer, feel free to drop me a line: 
  122.  
  123.       Don Kindred
  124.       5430 S. Keystone Ave.
  125.       Indpls., IN  46227
  126.  
  127.  
  128.  
  129.  
  130. (11/14/87)     Copyright 1987, by Don Kindred         Page 2
  131.  
  132.  
  133.