MUPFTOOL(1)                Benutzerkommandos                MUPFTOOL(1)

NAME
     mupftool - Eine Sammlung von Tools fr Commandline-Shells

VERSION
     Release 14

BESCHREIBUNG
     Achtung: dies ist NICHT `Public-Domain' oder `Freeware'. Nheres 
     dazu unter `COPYRIGHT'!!!!

     Diese Sammlung von Utilities wendet sich an alle Benutzer von 
     Kommandoshells.

     Auch wenn die Tools speziell fr die Shell `Mupfel' (Copyright 
     Stefan Eissing, Stefan_Eissing@ac.maus.de) entwickelt worden sind 
     und ihre speziellen Fhigkeiten gezielt nutzen, knnen die Pro-
     gramme auch mit jeder anderen `vernnftigen' Shell wie beispiels-
     weise der `CoSHy' in `Connect' eingesetzt werden. Wer mag, kann es 
     sogar mit einer DOS-hnlichen Shell oder gar dem Atari-Desktop 
     versuchen...

     Erluterungen zu den einzelnen Kommandos finden Sie in den jewei-
     ligen Manual-Pages.

     Fr Hinweise (Bugs, Vorschlge, Inkompatibilitten, Tippfehler, 
     fehlende Dinge in den Manual-Pages) wre ich natrlich sehr dank-
     bar. Auch etwaige Differenzen zu den langen Optionsnamen bei 
     entsprechenden GNU-Programmen wren interessant.

     Manual-Pages

     Zur Anzeige der Manual-Pages wird das Mupfel-Script `man.mup' sowie   
     ein `more', das von der Standardeingabe lesen kann, bentigt (siehe 
     Gemini-2-Distribution). Auerdem sollte es mglich sein, die 
     Dateien so, wie sie sind, direkt auf einem Drucker auszugeben 
     (zumindest Unterstreichungen mten dabei erhalten bleiben).

     Alternative: das Shareware-Programm `Manview' (manview.zoo) von 
     Ulrich Khn (kuehn@math.uni-muenster.de). Es zeigt die Manual-Pages 
     im GEM-Fenster an und erlaubt es auch, komfortabel den Querverwei-
     sen zu folgen.

     "Statisch" vs. "dynamisch" gelinkt

     Alle Tools liegen in einer "statisch" und in einer "dynamisch" 
     gelinkten Version vor. Die statisch gelinkte Version luft jeweils 
     ohne weitere Vorbedingungen als einzelne Programmdatei, die 
     dynamisch gelinkte Version erfordert ein Betriebssystem, das Shared 
     Libraries im MagiC-6-Format untersttzt (das sind zur Zeit 
     beispielsweise MagiC 6.x oder TOS + MetaDOS 2.76 + "Slbload"). Die 
     mitgelieferte SLB-Datei ("MUPFTL*.SLB") sollte weit vorne in der 
     Pfadliste fr Shared Libraries stehen, also zum Beispiel in 
     \GEMSYS\MAGIC\XTENSION. Wenn von einem der Programme die Shared 
     Library nicht gefunden wird, dann erscheint nur eine knappe 
     Fehlermeldung (und das Programm liefert den Fehlercode -32 zurck). 
     Bei Verwendung einer Shell bietet es sich an, den Pfad "SLBBIN" nur 
     dann in den Standardsuchpfad aufzunehmen, wenn das Betriebssystem 
     Shared Libraries untersttzt. Eine Abfrage dafr knnte zum 
     Beispiel wie folgt aussehen:

     c:\usr\slbbin\sleep.ttp 0 && export PATH="c:\usr\slbbin;"${PATH}

INSTALLATION
     Da Sie diesen Text lesen, haben Sie offenbar bereits das Archiv     
     ausgepackt. Dabei sollte folgende Ordnerstruktur entstanden sein:

     <ziel>\bin\*.ttp         ausfhrbare Programme (statisch gelinkt)
           \slbbin\*.ttp      ausfhrbare Programme (dynamisch gelinkt)
           \etc\*             Infodateien
           \scripts\*.mup     Mupfel-Scripts
           \man\cat1\*.1      Manual-Pages zu externen Kommandos
           \man\cat4\*.4      Manual-Pages zu Gertetreibern
           \man\cat5\*.5      Manual-Pages zu Dateiformaten
           \options\*.opl     Option-Library fr Mupfel (fr die Mupfel 
                              mu die Environmentvariable OPTIONPATH auf 
                              das entsprechende Verzeichnis gesetzt 
                              sein).

     Eine entsprechende Ordnerstruktur findet sich nicht von ungefhr in     
     der Standard-Gemini-Distribution. Fortgeschrittene Benutzer knnen     
     natrlich gerne die Verzeichnisse anders sortieren (dann mu     
     allerdings auf die richtigen Werte einiger Environmentvariablen wie     
     PATH, MANPATH und OPTIONPATH geachtet werden).

     In den Verzeichnissen man\man*\ kann man brigens auch Manual-Pages 
     im nroff-Format verstecken (wenn man denn einen nroff installiert 
     hat). Beispiel: die MiNT-Manualpages sollten in man\man2\*.2 stehen 
     (Kapitel 2: System-Calls!)

     Das Versionsdatum der einzelnen Tools lt sich normalerweise mit 
     der Option `--version' ermitteln! Eine Kurzhilfe gibt es in den 
     meisten Fllen durch `--help'.

PROGRAMME
     absname(1)     expandiert Dateinamen zu absoluten Pfaden.

     banner(1)      zeigt Worte in groen Lettern an.

     cal(1)         zeigt einen Kalender an und sucht nach Eintrgen in 
                    einer Termindatei.

     calendar(1)    zeigt aktuelle Termine an.

     cat(1)         verkettet Dateien und gibt sie auf der Standardaus-
                    gabe aus.

     chmod(1)       ndert Zugriffsrechte und Attribute von Dateien.

     cksum(1)       berechnet CRC-Prfsummen von Dateien (POSIX-Varian-
                    te).

     cmp(1)         vergleicht Binrdateien byteweise.

     crc(1)         berechnet CRC-Prfsummen von Dateien.

     date(1)        zeigt das aktuelle Datum an oder setzt es.

     df(1)          zeigt den freien Speicherplatz auf Massenspeichern 
                    an.

     du(1)          zeigt den von Dateien bzw. Verzeichnissen belegten 
                    Speicherplatz an.

     eject(1)       wirft wechselbare Medien aus bzw. zieht sie wieder 
                    ein.

     env(1)         gibt das Environment aus bzw. startet Programme mit 
                    einem speziellen Environment.

     error(1)       zeigt die Bedeutung von Fehlernummern an.

     file(1)        ermittelt den Typ von Dateien.

     find(1)        sucht Dateien nach verschiedenen Kriterien.

     hushictl(1)    stellt HuSHI-Einstellungen fr BIOS-Schreibschutz 
                    ein.

     line(1)        extrahiert Zeilen aus der Standardeingabe.

     locate(1)      sucht nach Dateien anhand eines Namensteils.

     od(1)          gibt Dumps von Dateien aus; nicht nur oktal, sondern 
                    in vielen verschiedenen Formaten.

     one-of(1)      gibt einen zufllig unter den bergebenen Parametern 
                    ausgewhlten Wert aus.

     printenv(1)    zeigt gezielt Environmentvariablen an.

     printf(1)      gibt seine Parameter formatiert auf der Standard-
                    ausgabe aus.

     runopts(1)     ndert Programmflags bzw. zeigt sie an.

     sleep(1)       wartet fr eine whlbare Zeit.

     strings(1)     sucht in beliebigen Dateien nach druckbaren Zei-
                    chenketten.

     sum(1)         berechnet Prfsummen von Dateien.

     tee(1)         kopiert den Datenstrom in einer Pipe zustzlich in 
                    Dateien.

     time(1)        fhrt ein Kommando aus und mit seinen Zeitbedarf.

     touch(1)       verndert den Datumseintrag einer Datei.

     uname(1)       gibt Informationen ber Betriebssystem und Hardware 
                    aus.

     what(1)        durchsucht beliebige Dateien nach SCCS-Kennungen 
                    ('Source Code Control System').

AUTOR
     Julian F. Reschke
     Hensenstrae 142
     D-48161 Mnster

     Maus MS, Telefon 0251/77261, Benutzername "Julian Reschke"

     mailto:jr@ms.maus.de
     http://www.muenster.de/~reschke


WICHTIGER HINWEIS
     Ich, Julian F. Reschke, bernehme keine Haftung fr irgendwelche     
     direkten oder indirekten Schden -- einschlielich aber nicht     
     beschrnkt auf materielle oder finanzielle -- die durch die Benut-
     zung dieser Programme oder die Untauglichkeit dieser Programme fr 
     einen bestimmten Zweck entstehen.

COPYRIGHT
     Sofern nicht an anderer Stelle genauer oder anderslautend spezifi-
     ziert gilt fr alle Programme und Texte:

     Copyright (c) 1999 Julian F. Reschke
     Alle Rechte vorbehalten

     Diese Programme sind NICHT Public Domain, drfen aber (ausschlie-
     lich frei) weitergegeben werden. Dabei MUSS das Original-Archiv in 
     unvernderter Form weitergegeben werden.

     Ich behalte mir das Recht vor, diese Genehmigung jederzeit und ohne     
     Angabe von Grnden zurckzuziehen.

     Eine Verbreitung auf PD-Sammeldisketten und hnlichen Medien     
     (gebhrenpflichtige Mailboxsysteme, `Channel Videodat', etc.) ist 
     nur mit meiner ausdrcklichen schriftlichen Genehmigung gestattet. 
     Fr CD-ROMs gilt folgende Regelung:

     -    Das Original-Archiv MUSS in unvernderter Form weitergegeben 
          werden. Zustzlich kann das Archiv auch in extrahierter Form 
          verbreitet werden.

     -    Es mu an geeigneter Stelle (Verpackung, README-Datei etc..) 
          darauf hingewiesen werden, da mit dem Kauf der CD keinerlei 
          Zahlungen an die einzelnen Programmautoren verbunden sind.

     -    Rechtzeitig vor Verffentlichung der CD mu abgeklrt werden, 
          ob tatschlich die neueste Version der Toolsammlung vorliegt.

     -    Unmittelbar nach Verffentlichung wird ein kostenloses Bele-
          gexemplar der CD an mich geschickt.

     Die Installation und die Weitergabe der Programme oder von Teilen 
     der Programme gilt als Anerkennung dieser Bestimmungen.

     Eine Weiterentwicklung dieser Programme wird definitiv nur dann     
     stattfinden, wenn sie durch entsprechende Spenden ausreichend     
     motiviert wird. Wer also fr diese Programmsammlung Verwendung hat 
     und sich wnscht, da sie weiterhin gepflegt und erweitert wird, 
     benutze folgende Kontoverbindung:

          Kontonummer 2542 39-465
          Postgiroamt Dortmund (BLZ 440 100 46)

     Es ist durchaus mglich, da knftige Versionen nicht mehr frei 
     erhltlich sein werden. Daher ist es wichtig, da Sie auf der 
     berweisung neben dem Namen auch eine Adresse und gegebenenfalls 
     auch eine Email-Adresse angeben. Und da der Kontoauszug in der 
     Regel nicht alle Informationen vom berweisungsschein wiedergibt, 
     ist es auf jeden Fall klug, nebenher die berweisung per eMail 
     anzukndigen...

     Wer bereits ltere Versionen benutzt hat und noch keine Spende 
     berwiesen hat, sollte diese Version sofort wieder lschen oder 
     aber sich nunmehr zur Spende durchringen. Alles andere empfinde ich 
     als Schmarotzerei.

     Bei eventuellen Problemen oder Verbesserungsvorschlgen wenden Sie     
     sich bitte an die oben genannte Email-Adresse.

SIEHE AUCH
     absname(1), banner(1), cal(1), calendar(1), cat(1), chmod(1), 
     cksum(1), cmp(1), crc(1), date(1), df(1), du(1), eject(1), env(1), 
     error(1), file(1), find(1), hushictl(1), line(1), locate(1), 
     magic(5), minttool(1), od(1), one-of(1), printenv(1), printf(1), 
     progtool(1), runopts(1), sleep(1), strings(1), sum(1), tee(1), 
     time(1), texttool(1), touch(1), uname(1), what(1)

BERSICHT BER (knftige) TOOLSAMMLUNGEN

     Mupfel-Tools, Release 15 (MUPFTL15.TOS)

     absname - Dateinamen zu absoluten Pfaden expandieren
     banner - Worte in groen Lettern ausgeben
     cal - Kalender anzeigen
     calendar - Termine anzeigen
     chmod - Zugriffsrechte setzen
     cksum - Prfsummen von Dateien bilden
     cmp - Binrdateien vergleichen
     crc - Prfsummen von Dateien bilden
     date - Datum ausgeben
     df - freien Plattenplatz anzeigen
     du - durch Dateien belegten Platz ermitteln
     eject - Medien auswerfen bzw. wieder einziehen
     env - Environment ausgeben bzw. Programme mit spez. Environment starten
     error - Text zu Fehlernummern anzeigen
     file - Dateityp ermitteln
     find - Dateien suchen
     hushictl - HuSHI-Einstellungen fr Schreibschutz kontrollieren
     line - Zeile aus Standardeingabe extrahieren
     locate - Dateien suchen (Einfachversion)
     od - Dateiinhalte dumpen
     one-of - ein zuflliges Argument ausgeben
     printenv - Environmentvariablen anzeigen
     printf - formatierte Bildschirmausgabe
     runopts - Programmflags setzen
     sleep - bestimmte Zeit warten
     strings - Binrdateien nach Zeichenketten durchsuchen
     sum - Prfsummen von Dateien bilden
     tee - T-Stck fr Pipes
     time - Zeitbedarf eines Kommandos messen
     touch - Dateidatum setzen
     uname - Systemdaten ausgeben
     what - SCCS-Kennungen suchen

     Programming-Tools, Release 05 (PROGTL05.TOS)

     cc - Frontend fr Pure-C-TTPs (Posix mit Unix-Erweiterungen)
     c89 - Frontend fr Pure-C-TTPs (Posix)
     ident - RCS-Kennungen suchen
     listopen - Informationen ber geffnete Dateien/Verzeichnisse
     nm - Symboltabellen anzeigen (DR, Gnu, Pure)
     rsccrc - CRC-Prfsummengenerator fr Resource-Dateien
     rscsplit - Resource-Header fr einzelne Objektbume splitten
     size - Gre der Programmsegmente anzeigen (DR, Gnu, Pure)
     strip - Debugging-Informationen aus Binaries und CPXen entfernen

     Text-Tools, Release 11 (TEXTTL11.TOS)

     bs2esc - Backspacing-Sequenzen wandeln
     cut - Teile aus Textzeilen herausschneiden
     fold - zu lange Zeilen umbrechen
     head - Beginn einer oder mehrerer Dateien anzeigen
     pr - Texte zur Druckausgabe vorbereiten
     split - Dateien in kleinere Teile zerlegen
     tr - Zeichen konvertieren bzw. lschen
     uniq - Identische Zeilen finden/zhlen
     uuencode - Binrdateien in ASCII-Dateien wandeln
     vdiprint - Texte per GDOS drucken
     wc - Zeichen, Worte und Zeilen zhlen
     wpcat - Wordplus-Dateien wandeln

     MiNT-Tools, Release 05 (MINTTL05.TOS)

     chgrp - Gruppenzugehrigkeit von Dateien ndern
     chmac - Mac-Finderinformationen setzen
     chown - Besitzer von Dateien ndern
     fsinfo - Informationen ber Dateisysteme ausgeben
     id - Benutzer- und Gruppenkennungen ausgeben
     kill - Signale an Programme schicken
     leave - einfacher Terminwarner
     ln - Verweise (Links) auf Dateien anlegen
     logname - Namen des Benutzers ausgeben
     mknod - Gerte fr Linux/68K auf MFS-Partitionen anlegen
     newgrp - Shell mit neuer Gruppenkennung starten
     nice - Proze mit genderter Prioritt starten
     ps - Prozestatus anzeigen
     renice - Prioritt eines laufenden Prozesses ndern
     su - Shell mit neuer Userkennung starten
     sync - Dateisysteme synchronisieren
     tty - Namen des TTYs ausgeben
     uptime - Systemauslastung ausgeben
