home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d5xx / d547 / findname.lha / FindName / FindName.doc < prev    next >
Text File  |  1991-09-19  |  3KB  |  119 lines
  1.  
  2.                              //
  3.                          \\ // FindName V1.0
  4.                           \//
  5.  
  6.                                1991
  7.                                 by
  8.                           Preben Nielsen
  9.  
  10.  
  11.  
  12. WHAT IS FINDNAME ?
  13.  
  14.     FindName is a little program which could sometimes be useful in scripts.
  15.   It allows you to check whether certain structures are present in RAM or not.
  16.   It will currently let you search (by name) for:
  17.  
  18.     devices
  19.     libraries
  20.     memory
  21.     messageports
  22.     resources
  23.     tasks
  24.  
  25.  
  26.     FindName returns OK (0) if it finds what it is searching for, and WARN (5)
  27.   if it doesn't. If you specify invalid arguments, then FindName will return
  28.   ERROR (10).
  29.  
  30.  
  31.  
  32. HOW TO USE FINDNAME
  33.  
  34.    The usage is 'FindName  -d|l|m|p|r|t SearchName' where
  35.  
  36.      -d makes Findname scan the device-list
  37.      -l makes Findname scan the library-list
  38.      -m makes Findname scan the memory-list
  39.      -p makes Findname scan the messageport-list
  40.      -r makes Findname scan the resource-list
  41.      -t makes Findname scan the task-lists
  42.  
  43.    and
  44.  
  45.      SearchName is the name to search for.
  46.  
  47.      Notice that FindName is case-sensitive. 'Narrator.device' is NOT the
  48.      same as 'narrator.device'.
  49.  
  50.  
  51.     Now follows an example of a script using FindName.
  52.  
  53. ; Start of script
  54.  
  55. ; Find a device
  56.     FindName -d narrator.device
  57.     IF WARN
  58.       echo "The narrator device is not present"
  59.     ENDIF
  60.  
  61. ; Find a library
  62.     FindName -l gadtools.library
  63.     IF WARN
  64.       echo "No gadtools library. We are not runnning under Kickstart 2.x"
  65.     ENDIF
  66.  
  67. ; Find a memory-header
  68.     FindName -m "zkick memory"
  69.     IF NOT WARN
  70.       echo "You used zkick to install Kickstart 2.x"
  71.     ENDIF
  72.  
  73. ; Find a messageport
  74.     FindName -p REXX
  75.     IF NOT WARN
  76.       echo "arexx is running"
  77.     ENDIF
  78.  
  79. ; Find a resource
  80.     FindName -r potgo.resource
  81.     IF NOT WARN
  82.       echo "potgo resource is always present"
  83.     ENDIF
  84.  
  85. ; Find a task
  86.     FindName -t Workbench
  87.     IF NOT WARN
  88.       echo "Jubii, I found the workbench task"
  89.     ENDIF
  90.  
  91. ; End of script
  92.  
  93.  
  94.  
  95. COMPATABILITY !
  96.  
  97.     FindName has been tested under kickstart 1.2, 1.3 and 2.x on a
  98.   2.5 MB 68000 based Amiga 1000 (0.5 MB chip-ram). If any problems
  99.   is encountered with other configurations then let me know.
  100.  
  101.  
  102.  
  103. COPYRIGHT NOTICE !!
  104.  
  105.   FindName is Public Domain.
  106.  
  107.  
  108.  
  109. =====================================================================
  110.    Send bug-reports, suggestions, comments etc. to:
  111.  
  112.         ///
  113.        ///  Preben Nielsen
  114.  \\\  ///  Oehlenschlægersgade 72 st. T.V.
  115.   \\\///  1663 Copenhagen V.
  116.    \///  Denmark
  117.     Phone: (009 45) 31 21 55 09
  118.  
  119.