home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Misc / mtv.lha / MakeLink.TV / MakeLink.doc < prev    next >
Encoding:
Text File  |  1994-11-18  |  3.2 KB  |  88 lines
  1.  
  2.                               makelink.TV 42.1
  3.                               ~~~~~~~~~~~~~~~~
  4.  
  5. Overview:
  6.  
  7.   Well, in the development of AmiNIX I needed a quick program to be capable
  8.   of making soft links (symbolic links under AmiNIX). Since with 3.1 C=
  9.   still hadn't made makelink soft-link capable, I wrote makelink.TV to
  10.   replace it. This functions identically to C='s makelink, except (for now)
  11.   the hard link loop detection isn't implemented. But it's 48 bytes smaller
  12.   than C='s makelink V37, and also supports soft links. This version is also
  13.   pure and can be made resident just like C='s makelink.
  14.  
  15.   I hope to add the loop detection to make it 100% C= makelink compatible,
  16.   but until then you should be smart enough not to link a directory to
  17.   a directory link underneath itself. :)
  18.  
  19.   A note about using soft links: Many programs may fail when using soft
  20.   links as implemented in the V37+ dos.library. Soft links are only
  21.   directly resolved if they are last in the path (i.e. if `link' is a link,
  22.   and you access `link/file', it won't work). But if the program traverses
  23.   the soft link and then locks the file underneath it, it will work. Note
  24.   that soft links to files are therefore fine, but soft links to directories
  25.   may or may not work. It is known that the Workbench and DirWork 2.1 both
  26.   correctly handle soft links to directories. There are PD patches to
  27.   dos.library to fix this bug, but I'm not aware of their names.
  28.  
  29. Files:
  30.  
  31.   MakeLink        Binary
  32.   MakeLink.c        Source code. Do not link with startup modules.
  33.   MakeLink.doc        This file!
  34.   SCOPTIONS        SAS/C 6.x SCOPTIONS; just type sc makelink.c
  35.  
  36. Template:
  37.  
  38.   FROM/A,TO/A,HARD/S,FORCE/S,SOFT/S
  39.  
  40. Usage:
  41.  
  42.   makelink <from> <to> [hard] [force] [soft]
  43.  
  44. Options:
  45.  
  46.   FROM:
  47.     This is the name of the link to create.
  48.  
  49.   TO:
  50.     This is the file/directory to link to. If this is a soft link, this
  51.     should be either an absolute path or a path relative to the FROM's
  52.     directory. If this is a hard link, this can be any path as it is
  53.     resolved at makelink-time.
  54.  
  55.   HARD:
  56.     This switch is basically ignored, but produces an error if you specify
  57.     it and SOFT at the same time. The default is hard links unless you
  58.     specify SOFT.
  59.  
  60.   FORCE:
  61.     This switch must be supplied to create a hard link to a directory.
  62.     NOTE about hard links to dirs! Many directory utilities, DirWork among
  63.     them, will recognize link-dirs as real directories, and if you hit the
  64.     recursive-delete button, it will traverse the directory. However, the
  65.     CLI Delete command handles directory hard links properly (it will delete
  66.     the link only).
  67.  
  68.   SOFT:
  69.     Specify this option to make a soft link. In this case, the keyword
  70.     FORCE is ignored.
  71.  
  72. Revision History:
  73.  
  74.   42.1 (16-Nov-94):
  75.     Internal release. Used version 42.x because this is the popular version
  76.     number for 3.1-compatible commands and utilities of the same name.
  77.  
  78.   42.2 (18-Nov-94):
  79.     First public release.
  80.     Fixed hard link Enforcer hit. Not checking the return value of Lock()
  81.     and attempting to Examine() NULL. :-P
  82.  
  83. The Author:
  84.  
  85.   Todd Vierling (amigagod@grove.ufl.edu).
  86.   As of November 1994 this e-mail address is correct.
  87.   Also, browse me on the WWW: http://grove.ufl.edu/~amigagod/
  88.