home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / unix / unixcmds_1 / ReadMe
Encoding:
Text File  |  1993-10-23  |  4.7 KB  |  146 lines
  1. UnixCmds Version 2.00, Copyright October 1993, Alun Jones
  2.  
  3. These utilities are Freeware. You may distribute them freely with the 
  4. proviso that this file accomanies the distribution. You may not charge more 
  5. than a nominal copying cost for their distribution and if you place them on 
  6. a PD library disk I'd quite like a copy of the disk... These programs may 
  7. NOT be distributed as part of a magazine disk without my permission and may 
  8. not be distributed by Risc Developments or Beebug. I don't guarantee their 
  9. suitability for any purpose and disclaim any responsibility for damage 
  10. caused by their use or misuse.
  11.  
  12. Is that enough legalese ?
  13.  
  14. You can contact me at auj@aber.ac.uk, or 
  15.  
  16. Alun Jones,
  17. Sunny Bank,
  18. Tregynon,
  19. Newtown, 
  20. Powys SY16 3EH
  21.  
  22. I'd be very interested to hear from anyone suggesting additions to this 
  23. collection, though my workload is currently (Oct 93) sky high with thesis 
  24. work, so don't bet on a fast reaction :-(
  25.  
  26. Bug reports will get a faster reaction as I use these utilities constantly 
  27. and don't like working with buggy programs [especially my own...]
  28.  
  29. Anyway, to business. The following programs are supplied. Note that some of 
  30. them require perl to be in your Run$Path. These have filetype 097, a totally 
  31. arbitary type that may clash with anything. I use 
  32. Set Alias$@RunType_097 %perl %*0
  33. In my !Boot file to set these up.
  34.  
  35. The remaining programs were written in either assembler or C. I'm using GCC 
  36. 2.4.5 (1.Beta.1), so there may be bugs inherited from this early release.
  37. Future compilations will hopefully use newer versions of GCC as they arrive.
  38.  
  39. Many of the programs use a simple translation scheme to get from Unix 
  40. pathnames to RISC OS ones, so that rm /bin/ls will translate to rm $.bin.ls
  41. You may use either the RISC OS filename or the Unix one and most of the time 
  42. it will get the translation right. It fails where / is part of a filename, 
  43. and doesn't handle file.c -> c.file mapping.
  44.  
  45. Here's a summary of the programs:
  46.  
  47. chunky        - Chop a file into chunks of a specified size.
  48.               Usage: chunky [Chunk_Size_K] filename
  49.  
  50. splice        - Join files together.
  51.               Usage: splice out_file in_file [in_file ...]
  52.  
  53. glob        - Do Unix globbing on a wildcarded name.
  54.               Note that this will interface to perl to provide Unix
  55.               style expansions using the <> perl operation.
  56.               Usage: glob [-s|n] wildcard [wildcard ...]
  57.  
  58. ls            - Clone of Unix ls
  59.               Usage: ls [-lR1F] wildcard [wildcard ...]
  60.  
  61. strings        - Find strings in a binary file.
  62.               Usage: strings file
  63.  
  64. time        - Time a command.
  65.               Usage: time "command [command_args] [command_redirection]"
  66.  
  67. unsqueeze    - Unpack squeezed binaries.
  68.               This program is heavily based on UnSqueeze, the Basic program
  69.               by Colin R. Smale
  70.             /* Reverse the effect of squeeze
  71.              * Works by loading compressed file into memory, calling
  72.              * the decompression routine and saving the result with *save
  73.              * The call to the decompression routine is first surrounded by
  74.              * register-saving code.  The BL to the decompression code MUST be
  75.              * the first instruction of the image as it uses R14 (return addr)
  76.              * to find the data it needs.
  77.              * Copyright (C) 1989 Colin R. Smale
  78.              *
  79.              * C conversion Oct 1993, Alun Jones
  80.              */
  81.               Usage: unsqueeze file [out_file]
  82.              [Does anyone have a PD clone of squeeze or similar ? I'd like 
  83.               one ;-)]
  84.  
  85. xargs        - Do a command, globbing arguments.
  86.               Usage: xargs "cmd [options] [redirection]" wildcard [wildcard ...]
  87.  
  88. cat            - List a file (PERL).
  89.               Usage: cat [-s] file [file...]
  90.  
  91. head        - List first few lines of a file (PERL).
  92.               Usage: head [-lines] file [file...]
  93.  
  94. tail        - List last few lines of a file (PERL).
  95.               Usage: tail [-lines] file [file...]
  96.  
  97. mv            - Move a file (PERL).
  98.               Usage: mv from to
  99.  
  100. dirs        - List the directory stack (PERL).
  101.               Usage: dirs
  102.  
  103. popd        - Pop a directory from the stack (PERL).
  104.               Usage: popd
  105.  
  106. pushd        - Push a directory to the stack (PERL).
  107.               Usage: pushd dirname
  108.  
  109. tr            - Translate characters (PERL).
  110.               Usage: tr from_letters to_letters
  111.  
  112. unalias        - Unset an alias (PERL).
  113.               Usage: unalias alias_name
  114.  
  115. alias        - Set an alias (PERL).
  116.               Usage: alias [alias_name] [alias_content]
  117.  
  118. which        - List the command run when a command name is typed (PERL).
  119.               Usage: which command
  120.  
  121. cd            - Change directory.
  122.               Usage: cd dirname
  123.  
  124. df            - List free space on a filesystem.
  125.               Usage: df [fs_name:[:disk_name]]
  126.  
  127. du            - List disk usage.
  128.               Usage: du [-a] dirname
  129.  
  130. fclose        - List open files / close named file (RISC OS 3.XX only!).
  131.               Usage: fclose -l
  132.                        fclose filename
  133.                       
  134. mkdir        - Create a directory [tree]
  135.               Usage: mkdir [-p] dirname
  136.  
  137. reboot        - Reboot the machine (-h does a hard reboot).
  138.               Usage: reboot [-h] 
  139.  
  140. rm            - Remove files.
  141.               Usage: rm [-rif] file [file...]
  142.  
  143. rmdir        - Remove directory.
  144.               Usage: rmdir dirname
  145.  
  146.