home *** CD-ROM | disk | FTP | other *** search
/ SPACE 2 / SPACE - Library 2 - Volume 1.iso / program / 575 / okami13b / readme < prev    next >
Encoding:
Text File  |  1991-12-15  |  7.9 KB  |  228 lines
  1.  
  2.     ===============================================
  3.  
  4. @(#)      OKAMI SHELL VERSION 1.3 - KURZEINFÜHRUNG
  5.  
  6.     ===============================================
  7.             Stand: 29.6.91
  8.  
  9.  
  10.  
  11. Okami-Shell ist eine Unix-ähnliche Kommandoshell für alle Atari ST-Rechner.
  12. Vorbild war die AIX-Shell des IBM RT PC 6150, deren Vorbild wiederum die
  13. Unix-Bourne-Shell war.
  14.  
  15. Sie arbeitet:
  16.     * mit jeder Speicherkonfiguration (auch mit 512K)
  17.     * mit jeder Bildauflösung
  18.     * mit Diskette, Ramdisk und Festplatte
  19.     
  20. Beschränkungen:
  21.     * Der Start der Shell von Diskette ist möglich, aber wegen der
  22.       geringen Geschwindigkeit wird Ramdisk oder Festplatte empfohlen.
  23.     * Zur Benutzung der Pipe muß mindestens ein Laufwerk beschreibbar
  24.       sein. Dies muß nicht notwendig das Laufwerk sein, von dem die
  25.       Shell gestartet wurde.
  26.  
  27. Zum Starten der Shell:
  28.     * sh.ttp anklicken und als Parameter ein Minuszeichen angeben.
  29. oder:    * msh.prg anklicken.
  30. Für Hilfe:
  31.     * "help" oder "cmds -C" eingeben.
  32.     * Die Help-Taste liefert eine Anleitung zu jedem internen Kommando.
  33. Zum Beenden der Shell:
  34.     * "exit" eingeben.
  35. oder:    * Ctrl-D drücken.
  36.  
  37.     
  38. Das wichtigste in Kürze:
  39.     * Standard-Unix-Kommandos: cat, ls, cd, pwd, cp, mv, rm, rmdir,
  40.        df, pg, echo, grep, find, chmod, touch, date, mkdir, basename,
  41.        dirname, time, xargs, backup, if, while, shutdown,...
  42.     * ca. 100 eingebaute Kommandos
  43.     * eingebauter UPN-Rechner mit über 80 Funktionen
  44.     * Shell-Variablen setzen in der Form NAME=WERT
  45.     * Ausführung von der Shell als TTP-Parameterzeile übergebenen
  46.       Kommandos mit darauffolgender Beendigung der Shell möglich
  47.     * Aufruf über den _shell_p-Zeiger möglich, incl. Quellcode der
  48.       system()-Funktion
  49.     * Konfiguration der Shell durch eine nach Programmstart auszu-
  50.       führende Kommandodatei (Profile)
  51.     * Eingabe, Ausgabe und Fehlerausgabe aller interner Kommandos
  52.       umleitbar mit <, >, >>, 2>, 2>> für alle Programme, die
  53.       Ein- und Ausgabe auf Gemdos-Basis benutzen
  54.     * Simulation von Pipelining: Die Ausgabe eines Kommandos wird
  55.       zur Eingabe eines anderen; beliebig schachtelbar
  56.     * Command Substitution: z.B.
  57.       echo Der Basisname von $FILE ist `basename $FILE`
  58.     * Unix-Wildcards, z.B. a[bcd-f]*e?.[xy]? etc.
  59.     * Ausführung von Shellscripts (Batch-Files) mit Parameterübergabe
  60.     * Shellfunktionen = speicherresidente Shellscripts möglich; Shell-
  61.       funktionen können interne Kommandos umdefinieren (die ursprüng-
  62.       lichen Kommandos können trotzdem noch aufgerufen werden
  63.     * Shellfunktionen können auch mit der Tastatur eingegeben werden
  64.     * Binärprogramme können resident gehalten und über Shellfunktionen
  65.       gestartet werden
  66.     * Hash-Tabelle: die Pfade von aufgerufenen Programmen werden gespei-
  67.       chert und beim nächsten Aufruf ohne Suchen gefunden
  68.     * Tastatureingabe mit History (Zurückholen vorheriger Eingaben
  69.       per Tastendruck)
  70.     * Filename Completion und Substitution auf Tastendruck
  71.     * Alle Tasten inkl. F-Tasten frei mit Kommandos belegbar
  72.     * Suchen von Programmen auf konfigurierbaren Pfaden, mit
  73.       konfigurierbaren Extendern zur Erkennung ausführbarer
  74.       Programme
  75.     * Pfadangaben können wie in TOS (z.B. d:\shell\sh.ttp, getrennt mit
  76.       Backslash) oder Unix (z.B. d:/shell/sh.ttp, getrennt mit Slash)
  77.       angegeben werden
  78.     * Programmierung mit if und while, schachtelbar
  79.     * Terminal Server: der Rechner kann über eine beliebige Schnitt-
  80.       stelle ferngesteuert werden
  81.     * Eingebauter Terminal-Emulator
  82.     * Alle GEM-Programme sind von der Shell aus ausführbar
  83.     * Online-Help mit Syntaxerklärung aus einer editierbaren Datei
  84.     * Help-Taste liefert Anleitung zu jedem Kommando aus der Anleitungs-
  85.       Datei der Dokumentation (commands.doc, ca. 170 KB)
  86.     * Auswertung und Einstellung der Environment-Variablen
  87.     * Parameterübergabe per xArg möglich
  88.     * ausführliche deutsche Dokumentation (>300 KB) mit vielen Beispielen
  89.     * Software-Support bei Fehlern und Fragen, nicht gebunden an
  90.       die Zahlung von Anerkennungsbeiträgen etc.
  91.     * Quellcode erhältlich
  92.     und vieles mehr......
  93.  
  94. Das wichtigste in Beispielen:
  95.  
  96.     rm test.o        (Löschen einer Datei)
  97.  
  98.     cat test.txt        (Anzeige einer Datei)
  99.  
  100.     cd d:\shell\bin     (Wechsel des aktuellen Laufwerks und des
  101.                  aktuellen Directories)
  102.  
  103.     cd ..            (Wechsel ins Parent-Directory des aktuellen
  104.                  Directories)
  105.  
  106.     ls -ls d:\*.*        (Ausführliche Dateiliste mit Attributen,
  107.                  Dateigröße und -Datum, sortiert nach der
  108.                  Dateigröße)
  109.  
  110.     ls -l d:\*.* >dir.txt    (Umleitung der Ausgabe)
  111.  
  112.     hd test.prg | pg    (Seitenweise Ausgabe eines Hexdump)
  113.  
  114.     date >>datum.log    (Anfügen des Datums an das Ende einer Datei)
  115.  
  116.     echo Bitte Name eingeben
  117.     read NAME        (Benutzung von Shellvariablen)
  118.     echo Der Name ist $NAME
  119.  
  120.     TMPNAME=dat$$.tmp    (Erzeugen eines eindeutigen Dateinamens
  121.                  durch die System-Shellvariable $, deren
  122.                  Wert sich ständig ändert [in Unix:
  123.                  Prozessnummer])
  124.  
  125.     PS1='Eingabe >'     (Ändern des Shell-Prompts)      
  126.  
  127.     a=`date`        (Einlesen des Datums in die Variable a)
  128.     echo Das Datum ist $a
  129.  
  130.     grep printf *.c     (Suchen von "printf" in allen C-Dateien)
  131.  
  132.     df C: E: F:        (Ausgabe der Plattenbelegungen)
  133.  
  134.     chmod +hr secret.dat    (Verstecken und Schreibschützen einer Datei)
  135.  
  136.     help | grep chmod    (Ausgabe der Syntax des Kommandos chmod)
  137.  
  138.     find d:\ test.*        (Ausgabe des Pfades aller Dateien namens
  139.                  test.* auf Laufwerk D:)
  140.  
  141.     pg $HOME\profile    (Seitenweise Ausgabe der Konfigurationsdatei)
  142.  
  143.     cursor 12        (Setzen der Cursor-Geschwindigkeit)
  144.  
  145.     mouse x y        (Abfrage der Maus-Koordinaten, Speichern der
  146.                  Werte in den Variablen x und y)
  147.  
  148.     fsel *.c test.c     (Auswahl einer Datei mit der Fileselect-Box)
  149.  
  150.     touch sh.c        (Erneuern des Dateidatums von sh.c)
  151.  
  152.     cls            (Bildschirm löschen)
  153.  
  154.     time test.tos        (Messen der Ausführungszeit eines Programmes
  155.                  auf 1/100 Sekunden genau)
  156.  
  157.     export TERM        (Übernahme der Variablen TERM ins Environment)
  158.  
  159.     find d:\ *.bak | xargs rm     (Löschen aller *.bak-Dateien auf 
  160.                        Partition D:)
  161.  
  162.     find d:\ *.* | backup    (Sichern aller Dateien von Partition D:
  163.                  auf Diskette)
  164.  
  165.     find e:\ *.* | xargs wc | pg  (Seitenweise Ausgabe der Anzahlen der
  166.                  Zeilen, Zeichen und Worte aller Dateien
  167.                  auf Partition E:)
  168.  
  169.     df -mn | xargs find {}\ *.* | wc -l
  170.                 (Zählen aller Dateien auf allen Laufwerken)
  171.  
  172.     upn 17 sqr pi *     (Berechnen der Oberfläche eines Kreises mit
  173.                  Radius 17)
  174.  
  175.     keydef F4 "dir *.c"    (Tastendefiniton: "dir *.c" wird auf die Taste
  176.                  F4 gelegt)
  177.  
  178.     rm test.dat ; echo test.dat ist gelöscht
  179.                 (Verkettung von Anweisungen)
  180.  
  181.     format            (Formatieren der Diskette in Laufwerk A:)
  182.  
  183.     format -t40 -s10 B:    (Formatieren von Diskette B: mit 40 Tracks
  184.                  und 10 Sektoren/Track)
  185.  
  186.     df(e:/newdf.sh)     (Laden der Datei e:/newdf.sh und Abspeichern
  187.                  als Shellfunktion, die anstelle des Komman-
  188.                  dos df benutzt werden kann; in der Datei
  189.                  kann das ursprüngliche Kommando df unter
  190.                  dem Namen !df benutzt werden)
  191.  
  192.         signum(e:signum2.prg)    (Laden und residenthalten von signum2.prg,
  193.                  Aufruf über die Shellfunktion "signum")
  194.  
  195.     while [...]        (Schleifenbildung und Programmierung)
  196.     do
  197.       ....
  198.       if [...]
  199.       then
  200.         ...
  201.       fi
  202.       break         (Abbruch der while-Schleife)
  203.       continue        (Neuer Schleifendurchlauf)
  204.     done
  205.  
  206.  
  207. Weitere Beispiele: siehe commands.doc und tricks.doc
  208.  
  209.  
  210. Dokumentation:
  211.  
  212.     readme            Kurzeinführung
  213.     release         Versions-Identifikation der Shell
  214.     okami.doc        Bedienung der Shell
  215.     commands.doc        Bedienung der internen/externen Kommandos
  216.     tricks.doc        Tips&Tricks zur Benutzung der Shell
  217.     changes.doc        Änderungen der Shell
  218.     kompat.doc        Kompatibilität zu älteren Shell-Versionen
  219.     copying            Regelung des Kopierens der Shell
  220.     system.doc        Benutzung der "system"-Funktion
  221.     msh.doc         Benutzung der Micro-Shell
  222.     autor.doc        Anschrift des Programmautors
  223.  
  224. Hinweis: die Dokumentation wurde mit Tempus Word erstellt und als Ascii-
  225. text abgespeichert. Evtl. Formatierungsfehler sind darauf zurückzuführen.
  226. Eine gedruckte Version der Anleitung ist zum Selbstkostenpreis von 10 DM
  227. beim Autor erhältlich. (Adresse siehe autor.doc)
  228.