home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 594b.lha / Dautostart / dautostart.doc.pp / dautostart.doc
Text File  |  1991-10-21  |  4KB  |  106 lines
  1.  
  2.                 DAUTOSTART.DOC
  3.  
  4.     NOTE!!  You must use 'lharc -r -x -a x dautostart' to properly
  5.     extract this archive.
  6.  
  7.  
  8.     The DAUTOSTART program and associated utilities is a system designed to
  9.     allow completely modular booting for your Amiga.  Specifically, the
  10.     idea is for nothing in the SYS: directory hierarchy to depend on
  11.     various programs installed on your system.    This includes getting
  12.     rid of absolute path specifications in your S:SHELL-STARTUP.
  13.  
  14.     The basic idea is to bundle the installation scripts along with
  15.     the things being installed and have the scripts (that set up
  16.     assignments, path elements, and run programs in the background on
  17.     boot) automatically found by the DAUTOSTART program.  Moving,
  18.     modifying, deleting, or adding PD & commercial software to your
  19.     system becomes trivial and also allows you to 'plug-and-play'
  20.     without having to modify your S:USER-STARTUP.
  21.  
  22.               OVERVIEW OF OPERATION
  23.  
  24.     Operation is simple.  Your S:USER-STARTUP consists of a few simple
  25.     lines as shown in the USER-STARTUP file included with this
  26.     distribution.  Basically the script does nothing more then run
  27.     DAUTOSTART.
  28.  
  29.     DAUTOSTART will run through all mounted filesystems (the filesystems
  30.     that show up with INFO) looking for files named 'boot-sequence.1'.
  31.     If such a file exists in some directory DAUTOSTART will also scan
  32.     for additional files in that directory 'boot-sequence.2', etc...
  33.     up to 'boot-sequence.9'.  All are incorporated into a master
  34.     script.
  35.  
  36.     The boot-sequence.N files may be prioritized by specifying a
  37.     PRI=<priority> string on the FIRST LINE of any given boot-sequence.N
  38.     file.  Refer to the example boot-sequence files in this distribution.
  39.     Priorities may range from -128 (lowest) to +127 (highest).
  40.  
  41.     DAUTOSTART will take all the script files it finds, sort them by
  42.     priority, and output them to stdout.  S:USER-STARTUP redirects stdout
  43.     to a ram file and then Execute's it.  DAUTOSTART automatically inserts
  44.     CD commands so each script runs from its own directory, thereby
  45.     allowing completely relative path specifications for PATH and ASSIGN
  46.     commands.  This capability allows you to move installed commercial
  47.     software around with a simply COPY ALL CLONE or RENAME without having
  48.     to modify the associated boot scripts.
  49.  
  50.     These boot files will contain things such as assignments and PATH ADD
  51.     commands, as well as run various resident programs, etc, etc... After
  52.     execution of the master is complete, S:USER-STARTUP then calls a
  53.     DAUTOSTART utility called SAVEPATH which saves the current CLI path to
  54.     a public message port.
  55.  
  56.     Your S:SHELL-STARTUP, an example of which is included in the
  57.     distribution, would then use the LOADPATH program to setup its path
  58.     instead of hardwired PATH ADD commands.
  59.  
  60.                   DIRECTORY SEARCHING
  61.  
  62.     Since it is usually uneconomical to scan the entire directory tree for
  63.     each mounted filesystem, DAUTOSTART only scans ONE DIRECTORY DEEP for
  64.     each filesystem to start with.  DAUTOSTART will also scan all
  65.     subdirectories associated with a directory containing a previously
  66.     scanned boot-sequence.N file, meaning that you can embed
  67.     boot-sequence.N files at lower levels of the directory tree if they
  68.     exist at higher levels.
  69.  
  70.     Thus, DAUTOSTART normally does not take very long to find all
  71.     control scripts.
  72.  
  73.                 COMMAND ARGUMENTS
  74.  
  75.     dautostart [directory, ...]
  76.  
  77.     If no directories are specified, dautostart will scan all
  78.     mounted filesystems.  If one or more directories are specified,
  79.     dautostart will scan ONLY The specified directories.
  80.  
  81.     This allows dautostart to be used for purposes other then
  82.     booting.
  83.  
  84.     savepath
  85.  
  86.     saves the current CLI path to a special public message port.  If
  87.     the public message port already exists then paths associated with
  88.     it are first deleted.
  89.  
  90.     loadpath
  91.  
  92.     loads the paths from the public message port into the CLI.  Any
  93.     existing paths in the CLI are deleted.
  94.  
  95.  
  96.                 EXAMPLE CODE
  97.  
  98.     Example scripts exist in S/, EX1/, EX2/, and EX3/  ... to run the
  99.     example, place a blank formatted floppy in DF0: and run the MKEXAMPLE
  100.     script from this directory.  Then reboot the machine with the floppy.
  101.     This will work under both 1.3 and 2.0
  102.  
  103.     Note that the example, running from floppies with no optimizations,
  104.     will run slowly.
  105.  
  106.