home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / EFFO / pd1.lzh / SYS / HELP / move.hlp < prev    next >
Text File  |  1990-02-03  |  7KB  |  147 lines

  1. @H
  2. @T0
  3. MOVE - Move files logically within the directory structure
  4.  
  5. Important:    This program is public domain and may be used  and  distributed
  6.               freely  as  long  as  the  "Distribution_Rules"  are  met  (see
  7.               subtopic in this help file).
  8.  
  9. Syntax:       MOVE [<options>] <from> [<to>] [<options>]
  10.  
  11.               Note: The syntax is identical to that of the OS9 copy utility.
  12.  
  13. Function:     Moves files from one directory  to  another.  But  rather  than
  14.               copying the file to the new directory and deleting  it  in  the
  15.               original directory, MOVE does *not* copy the file contents, and
  16.               simply  moves  the   file   logically,   thus   avoiding   disk
  17.               fragmentation, even if a lot of files are MOVEd.
  18.               Not only files, but also directories can  be  moved.  To  avoid
  19.               accidental moving of directories when using wildcards,  the  -d
  20.               option must be  specified  to  wildcard-move  directories  (see
  21.               below).
  22.               MOVE is useful to tidy up "messy" disks by putting the existing
  23.               files where they belong.
  24.  
  25. Usage:        MOVE <file>
  26.                      Moves   the   specified   file    into    the    current
  27.                      workingdirectory.
  28.               MOVE <file> <new path>
  29.                      Moves the specified file to the specified new  path.  If
  30.                      the  filename  in  <new  path>  is  different  from  the
  31.                      original  file  name,  the  file  will  be  moved  *and*
  32.                      renamed.
  33.               MOVE  -w=<dir>  <file> ...
  34.                      Moves all the files specified on the command line to the
  35.                      directory given in the "-w" option (see below).
  36.  
  37. Caution:      NEVER kill a working MOVE process, because incomplete operation
  38.               of MOVE may cause invalid disk structure. See help topics "Move
  39.               Troubleshooting" and "Move Notes".
  40. @D1
  41. Options : 2
  42. Examples : 3
  43. Troubleshooting : 4
  44. Notes : 5
  45. Distribution_Rules : 6
  46. @T2
  47.    -?                    Show short help text.
  48.  
  49.    -d                    Move subdirectories too (not only  files,  which  is
  50.                          the default case). This  option  must  be  specified
  51.                          when  moving  directories  with  the  "-w"  wildcard
  52.                          option, to prevent  the  user  from  unintentionally
  53.                          moving directories. If only a  single  directory  is
  54.                          moved, the "-d" option is not required.
  55.  
  56.    -p                    Don't print the names of the files  and  directories
  57.                          being moved (only if "-w" is used).
  58.  
  59.    -r                    Rewrite  destination.  If  a  file  is  moved  to  a
  60.                          directory where another  file  with  the  same  name
  61.                          already exists, the latter will be deleted first.
  62.  
  63.    -w=<destination dir>  All files (directories only if "-d" used)  specified
  64.                          on the command line will be moved to the destination
  65.                          directory. If "-p" is  not  used,  MOVE  displays  a
  66.                          message for each file/directory moved.
  67.  
  68.    -x                    Look  in  the  current   execution   directory   for
  69.                          files/directories  to  be  moved.  Note  that   "-x"
  70.                          doesn't affect the destination path, which is always
  71.                          relative to the current data directory.
  72. @T3
  73.    MOVE  /dd/mydir/myfile
  74.          Moves  the  file  "/dd/mydir/myfile"  into   the   current   working
  75.          directory.
  76.  
  77.    MOVE  /dd/mydir/myfile yourfile
  78.          Moves the file "/dd/mydir/myfile" into the current working directory
  79.          and renames it to "yourfile"
  80.  
  81.    MOVE  /dd/mydir/myfile /dd/yourdir/yourfile
  82.          Moves the file "/dd/mydir/myfile" into the  directory  "/dd/yourdir"
  83.          and renames it to "yourfile"
  84.  
  85.    MOVE  /dd/mydir/* -w=/dd/yourdir
  86.          Moves all files from the directory "/dd/mydir"  into  the  directory
  87.          "/dd/yourdir". The filenames will not be changed.
  88. @T4
  89. If the move procedure cannot be completed due to a  fatal  error  or  because
  90. MOVE was killed accidentally, the moved file isn't lost normally,  but  there
  91. might be a duplicate reference to it (i.e the file is in the source directory
  92. as well as in the destination directory). In this case, first copy  the  file
  93. to another disk, then delete the original file in BOTH source and destination
  94. directories. Then copy the file back from the disk you saved it on.
  95.  
  96. If MOVE gets killed while moving a directory, basically  the  same  procedure
  97. applies: Copy (or move) all the files *contained* in the  diectory  somewhere
  98. else. Then deldir the directory in both source and  destination  directories.
  99. Now you can makdir a new directory and copy (or move) the  original  contents
  100. back. In addition, check (even if the move seems to be completed) whether the
  101. moved directory's parent link ".." is ok: Enter the moved directory with CHD,
  102. leave it with "CHD .." and then check if you are back in the parent directory
  103. (and not somewhere else). If not, the parent link is wrong (pointing  to  the
  104. old parent directory). In this case you should move the  erroneous  directory
  105. somewhere else and then move it back again.
  106.  
  107. After repairing the disk structure as described above, it is a good  idea  to
  108. verify the disk using the OS9 DCHECK utility.
  109. @T5
  110.  
  111. -  OS-9 does not provide system level support  for  moving  files.  Therefore
  112.    MOVE has to open  and  modify  directory  files  directly.  Unlike  system
  113.    supported directory manipulations (deleting or creating files)  which  are
  114.    indivisible (i.e cannot be interrupted by killing a process) the operation
  115.    sequence MOVE performs *can* be aborted by killing the move  process,  but
  116.    it *must not* be aborted to ensure that the disk structure remains intact.
  117.    There is no way for move to  make  the  critical  sequence  of  operations
  118.    indivisible, so it's up to you to prevent move from being killed while  it
  119.    is running.
  120.  
  121. -  Because move does a somewhat  dangerous  task  (see  note  above),  it  is
  122.    programmed to avoid any risk as far as  possible.  This  type  of  careful
  123.    programming is not very fast compared to other risky solutions. So, If you
  124.    think move is too slow, rememeber: it's for safety.
  125. @T6
  126. *****************************************************************
  127. *  MOVE (c) 1988,89,90 by Lukas Zeller, CH-Maennedorf           *
  128. *    email:   zeller@strati.ethz.ch, zeller@ethz.uucp           *
  129. *             ..!mcvax!cernvax!chx400!ethz!zeller               *
  130. *    DECMail: PSI%4991108411::STRATI::ZELLER                    *
  131. *    OS9-BBS: LZELLER                                           *
  132. *****************************************************************
  133.  
  134. This MOVE utility is public domain and may be used and distributed freely  as
  135. long as the following conditions are met:
  136.  
  137.  1.  This Program may only be used for peaceful applications. I do NOT  ALLOW
  138.      using this pogram for anything that has to do with development,  testing
  139.      or manufacturing of weapons of any type.
  140.  
  141.  2.  This text as well as all copyright messages (in  the  source  text,  the
  142.      code and in this help file) must be retained.
  143.  
  144. For bug reports, comments and suggestions, please  contact  the  author  (see
  145. email paths above). Thank you !
  146.  
  147.