home *** CD-ROM | disk | FTP | other *** search
/ Vectronix 2 / VECTRONIX2.iso / FILES_09 / GENEVA4B.LZH / MINT / 1.12 / MINTCNF.TXT < prev    next >
Encoding:
Text File  |  1995-10-18  |  4.4 KB  |  116 lines
  1. Appendix C: The MiNT Configuration File
  2.  
  3. If MiNT finds a file called MINT.CNF, it will read some configuration
  4. information from it. MiNT searches for this file first in the
  5. current directory (the root directory, if MiNT was started from
  6. the AUTO folder), then in a \MINT directory, and then in \MULTITOS.
  7. The configuration file is an ordinary ASCII text file; it can be edited
  8. with any editor that will produce plain ASCII files (if you're using a
  9. word processor, make sure you save the file as "plain ASCII text").
  10.  
  11.  
  12. Variables
  13.  
  14.  
  15. Commands of the form name=value set system parameters of
  16. some kind.  Here they are, in roughly increasing order of obscurity:
  17.  
  18. INIT=file
  19. GEM=file 
  20. This specifies the command you want MiNT to run at boot up time. "File"
  21. should be a full path name. The default is for the MultiTOS MiNT kernel
  22. is "\multitos\gem.sys". Both INIT= and GEM= specify an initial program
  23. to run, but the way the program is launched is different depending on
  24. whether you say "GEM=" or "INIT=". With the "GEM=" form, the application
  25. is launched via the exec_os vector (see the Hitchiker's Guide to the Bios).
  26. With the "INIT=" form, the application is launched directly via Pexec.
  27. Only one GEM= or INIT= line is permitted in the configuration file.
  28.  
  29. MAXMEM=n
  30. Specifies the maximum amount of memory that may be used by any one
  31. process. "n" is measured in kilobytes.
  32.  
  33. CON=file
  34. This specifies the file or device you want MiNT to use by default for all
  35. console output, including debugging output. It should be a full path
  36. name, and is usually a device in U:\DEV. The obvious choice is
  37. U:\DEV\CONSOLE (the default).
  38.  
  39. PRN=file 
  40. Specifies a file that should be used for all printer output. Initially, all
  41. Bconout() calls to device 0 will refer to this device. Again, a full path
  42. name, usually in U:\DEV, is expected.  (The default is U:\DEV\CENTR,
  43. which is the device corresponding to the centronics port.)
  44.  
  45. BIOSBUF=no or yes
  46. If BIOSBUF=yes appears in your configuration file, then certain optimizations
  47. in MiNT concerning BIOS input and output are used. These optimizations
  48. should normally be transparent to user programs, but can be turned off
  49. with BIOSBUF=no. The default is "yes" (optimizations on).
  50.  
  51. SLICES=n
  52. Controls the number of 20ms time slices to give to processes before
  53. they will be preempted. The default (2) is usually the best value;
  54. a higher value (e.g. 3) will cause CPU intensive tasks to receive more
  55. time, while a lower one (e.g. 1) will favor interactive tasks slightly.
  56.  
  57.  
  58. Commands
  59.  
  60.  
  61. The following commands can also be in the mint.cnf file. Spaces
  62. separate commands from arguments:
  63.  
  64. # Comment
  65. A line beginning with a number sign (`#') is a comment. The entire line is
  66. ignored. Blank lines are also allowed (and ignored).
  67.  
  68. alias drive path
  69. Creates a new "drive" which is actually an alias for a path.
  70. For example, old versions of MiNT used drive X: instead of
  71. the directory U:\PROC. If you have an old program which
  72. requires drive X:, you could put:
  73.  
  74.     alias x: u:\\proc
  75.  
  76. in your mint.cnf file.
  77.  
  78. cd dir
  79. Change the current drive and directory. This isn't terribly
  80. useful, unless your initial program (see above) expects to run
  81. in some particular directory.
  82.  
  83. echo string
  84. Displays "string" on the screen.
  85.  
  86. exec program args ...
  87. Execute a program, with some arguments. The full path name and
  88. extension (.prg, .tos, .ttp, or whatever) of the program to
  89. execute must be given.  Initialization of MiNT does not continue until
  90. this program terminates.
  91.  
  92. ren oldname newname
  93. Rename a file or directory.
  94.  
  95. setenv var value
  96. Set the environment variable "var" to "value". NOTE: If any
  97. setenv commands are given in MINT.CNF, an entirely new environment
  98. is constructed; otherwise, the INIT program MiNT runs will inherit
  99. the environment that MiNT got.
  100.  
  101. sln oldfile newlink
  102. Create a symbolic link called "newlink" for the file (or directory)
  103. "oldfile". At this time, only drive U: supports symbolic links, so the
  104. second name must be on drive U:; the first name can be anything. A
  105. symbolic link is just an alias or nickname for a file. For example,
  106. if your MINT.CNF file contains this line:
  107.  
  108.     sln d:\foo\bar u:\baz
  109.  
  110. then references to u:\baz would automatically be translated by the kernel so
  111. that they really referred to d:\foo\bar. If d:\foo\bar is actually a
  112. subdirectory, with the file "frob.txt" in it, then that file can be
  113. accessed either through the name "d:\foo\bar\frob.txt" or
  114. "u:\baz\frob.txt."
  115.  
  116.