home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / mint / mntutl93 / readme.utl < prev    next >
Encoding:
Text File  |  1993-08-03  |  7.8 KB  |  182 lines
  1. Here are some utilities for use with MiNT. All of these utilities may be
  2. distributed without restriction. All were built with the MiNT library,
  3. patchlevel 19. Using a different library, or an earlier version of the
  4. MiNT library, may or may not cause problems; in particular, various constants
  5. #defined in signal.h and ioctl.h will probably be wrong if you are not
  6. using the MiNT library.
  7.  
  8. bg.ttp: used to start programs in the background.
  9.     bg [-o file] command [args...]
  10. If "-o file" is given as an argument, then the standard output and standard
  11. error output of the command are redirected to the indicated file.
  12. "bg" exits with -1 if an error occured, or the process id of the newly started
  13. process if everything is all right.
  14.  
  15. gem.prg: start the GEM desktop
  16.     gem
  17. This is provided so that the GEM desktop may be started under MiNT. IT MAY
  18. ONLY BE USED IF NO DESKTOP HAS STARTED YET, i.e. if MiNT ran from an AUTO
  19. folder and if "gem" hasn't been started before.
  20.  
  21. kill.ttp: send a signal to one or more processes
  22.     kill [-sig] pid [pid ...]
  23. Kill sends the signal number "sig" to the processes which have the given
  24. process id's (the process id is given as its extension on a listing of drive
  25. X:). Usually this results in the death of the process. If "sig" is omitted,
  26. 15 (SIGTERM) is assumed. Some useful signal numbers are:
  27.        9: SIGKILL: this cannot be caught or ignored, so it is certain death
  28.         for the process
  29.       17: SIGSTOP: stops the process
  30.       19: SIGCONT: forces a stopped process to continue.
  31.  
  32. limit.ttp: run a program, restricting its resources
  33.     limit [-m maxalloc][-M maxmem][-t maxtime] program [args ... ]
  34.     limit -v
  35. Runs a subprogram with limited memory and time resources. "maxalloc"
  36. is the maximum amount of heap + malloc'd memory permitted to the program.
  37. "maxmem" is the maximum total amount of memory allotted to the program.
  38. If both allocation and total memory limits are in effect, a program is
  39. limited to the lesser of the two values. "maxtime" is the maximum amount
  40. of CPU time a process may consume; note that this is *not* the same
  41. as the real time the process has been executing, since processes that are
  42. waiting for input/output consume very little (if any) CPU time.
  43.    "maxalloc" and "maxmem" are numbers (optionally followed by "K" or "k"),
  44. denoting the memory size in bytes. "maxtime" has the form
  45. [[hh:]mm:]ss[.xxx], giving the number of hours, minutes, seconds, and
  46. milliseconds permitted; the hours, minutes, and milliseconds are all optional.
  47. e.g.:
  48.     limit -m 100K -M 200512 -t 12:22.15 foo
  49. runs command "foo" with a maximum memory allocation of 102400 bytes,
  50. a total memory limit of 200512 bytes, and a CPU time limit of
  51. 12 minutes, 22.15 seconds.
  52.    If any of the limits are 0, then the corresponding limit is removed;
  53. otherwise, the default limits are whatever the limits were on the
  54. "limit" program itself. These may be printed with the "-v" flag.
  55.  
  56. lpd.ttp: line printer daemon
  57.     bg lpd [printfile]
  58. This is a (very simple) MiNT based print spooler. It opens the file
  59. Q:\LPD.MSG and accepts print requests written to that file. The request
  60. should consist of the full pathname of a file, padded with zeros to 128
  61. bytes. The file is copied to the directory specified in the environment
  62. variable TEMP (default is the current directory), and is then printed as
  63. time allows. A 128 byte ASCII string is written back to Q:\LPD.MSG as a
  64. reply; this string describes the error that occured (if any).
  65.    If an argument is supplied to lpd, this is taken to be the name of the
  66. file for printer output, instead of V:\PRN.
  67.    lpd.ttp and lpr.ttp are provided as examples of how to use named FIFOs
  68. for interprocess communication.
  69.  
  70. lpr.ttp: line printer
  71.     lpr filename
  72. This is an interface to lpd.ttp. It finds the full pathname of the
  73. name given to it and sends a message to lpd requesting that the
  74. file be printed, then waits for a reply and prints it.
  75.  
  76. mintvers.tos: print the MiNT version number
  77.     mintvers [-n]
  78. Prints the MiNT version number, and exits with the corresponding exit
  79. status. If an argument is given, nothing is printed. Shells can test
  80. the exit value to see if MiNT is active.
  81.  
  82. nice.ttp: run a program with a different priority
  83.     nice [-#] command [args]
  84. This runs the given command at a changed priority. '#', if given, is
  85. a new "niceness". The higher the number, the nicer the program is, i.e.
  86. the lower the priority given to it. Negative niceness values correspond
  87. to higher priorities. The default niceness is +10.
  88.  
  89. Examples: bg nice -20 make foo
  90.         runs "make foo" in the background at a much lower priority
  91.     nice --5 gulam
  92.         runs "gulam" at a higher priority
  93.  
  94. pipe.ttp: run programs in a pipe
  95.     pipe cmd1 cmd2
  96. This runs the program "cmd1" with its output redirected to a pipe, and
  97. at the same time "cmd2" with its output redirected from the pipe. If arguments
  98. are given to cmd1 and cmd2, the whole commands must be enclosed in quotes,
  99. and "pipe" must be run from a shell that supports the MWC or Atari standard
  100. extended argument scheme.
  101. Example: pipe 'ls -l' 'cat -v'
  102.  
  103. ps.ttp: print process status information
  104.     ps
  105. This just outputs the information available from looking at drive X: in a
  106. somewhat more human-readable form.
  107.  
  108. stty.ttp: set terminal state
  109.     stty [options...][keys...]
  110. With no arguments, stty prints the terminal status of the current control
  111. terminal (normally the console). With arguments, stty changes the state of
  112. the terminal. Arguments may be either options (which set or clear terminal
  113. modes) or keyword-key pairs (which change various control keys).
  114.  
  115. The following options are available:
  116.  
  117. crmode:    convert carriage return to line feed on input
  118. cbreak:    return from a read as soon as any character is available,
  119.     rather than waiting for a whole line to be input
  120. echo:    echo characters as they are input
  121. raw:    do not interpret any control characters, and do not wait
  122.     for end of line before returning from a read
  123. tostop:    send a SIGTTOU signal to any background process that tries to
  124.     output to the terminal
  125. xkey:    translate cursor and function key presses into escape sequences
  126.     when read by Fread()
  127. Preceding any of the above by a '-' will turn the option off.
  128. Doing "stty -raw -cbreak echo crmod tostop xkey" should reset the terminal
  129. to its default state.
  130. Note that only MiNT aware programs will be affected by most flags (except
  131. for "tostop").
  132.  
  133. The following keys may be reprogrammed by giving the key name, a space, and
  134. the new key (to get a control character as the new key, prefix a ^ to the
  135. letter):
  136. intr:    interrupt key    (default: ^C)
  137. quit:    quit key    (default: ^\)
  138. start:    re-start output    (default: ^Q)
  139. stop:    suspend output    (default: ^S)
  140. eof:    mark end of file (default: ^D)
  141. brk:    alternate end of line character (default: ^M)
  142. susp:    suspend process    (default: ^Z)
  143. dsusp:    delayed suspension of process (default: ^Y)
  144. rprnt:    reprint line    (default: ^R)
  145.  
  146.  
  147. top.ttp: show process status
  148.     See top.doc
  149.  
  150. xkey.ttp: re-program function and cursor keys
  151.     xkey [key def ...]
  152. With no arguments, xkey prints the current definitions for all the function
  153. and cursor keys affected by the "xkey" option to stty (q.v.).
  154.  
  155. With arguments, xkey will re-define the keys, so that future Fread() calls
  156. on this terminal will return the new strings (providing that the terminal
  157. status is set so that "xkey" is on). In the definition strings, the
  158. characters ^ and \ have special meanings: ^ introduces a control character,
  159. and \ quotes the next character (so that e.g. \^ is a caret).
  160.  
  161. The default mapping is as follows:
  162.  
  163. key                definition
  164. --------------------------------------------------------
  165. f1-f10                ESC P, ESC Q, ..., ESC Y
  166. F1-F10 (shifted function keys)    ESC p, ESC q, ..., ESC y
  167. help                ESC H
  168. undo                ESC K
  169. insert                ESC I
  170. home                ESC E
  171.  
  172. cursor keys:
  173. up                ESC A
  174. down                ESC B
  175. right                ESC C
  176. left                ESC D
  177. shifted cursor keys:
  178. UP                ESC a
  179. DOWN                ESC b
  180. RIGHT                ESC c
  181. LEFT                ESC d
  182.