git.infodrom.org Git - infodrom/manpages-de/blob - man8/catman.8

   1 .\" Man page for catman
   2 .\"
   3 .\" Copyright (C), 1994, Graeme W. Wilford. (Wilf.)
   4 .\" Deutsche Übersetzung von Anke Steuernagel und Nils Magnus
   5 .\"
   6 .\" You may distribute under the terms of the GNU General Public
   7 .\" License as specified in the file COPYING that comes with the man
   8 .\" distribution.
   9 .\"
  10 .\" Sat Dec 10 14:17:29 GMT 1994  Wilf. (G.Wilford@ee.surrey.ac.uk)
  11 .\"
  12 .TH catman 8 "12. Juli 1995" "2.3.10" "Dienstprogramme zur Systemverwaltung"
  13 .LO 1
  14 .SH NAME
  15 catman \- erzeugt oder aktualisiert die formatierten Manualseiten
  16 .SH SYNTAX
  17 .B catman
  18 .RB [\| \-dhV \|]
  19 .RB [\| \-M
  20 .IR Pfad \|]
  21 .RI [\| Abschnitt \|]
  22 \&.\|.\|.
  23 .SH BESCHREIBUNG
  24 .B catman
  25 wird benutzt, um einen aktuellen Satz von vorformatierten Manualseiten zu
  26 erzeugen, die als cat-Seiten bezeichnet werden. Die cat-Seiten werden
  27 wesentlich schneller angezeigt als die unformatierten Manualseiten, benötigen
  28 aber zusätzlichen Speicherplatz auf der Festplatte. Die Entscheidung zur
  29 Unterstützung von cat-Seiten liegt beim lokalen Administrator, der für diese
  30 Seiten passende Verzeichnisse anlegen muss.
  31
  32 Die Optionen für
  33 .B catman
  34 geben die Manualseiten und die Abschnitte an, die vorformatiert werden
  35 sollen. Im Normalfall werden die Manualseiten verwendet, die in der
  36 Manualkonfigurationsdatei beschrieben sind. Normalerweise werden die
  37 Abschnitte formatiert, die entweder in der Umgebungsvariable
  38 .RB $ MANSEC
  39 stehen oder fest in
  40 .BR man (1)
  41 einkompiliert sind, wenn
  42 .RB $ MANSEC
  43 undefiniert ist. Wird
  44 .B catman
  45 eine durch Whitespace abgetrennte Liste von Abschnitten übergeben, so werden
  46 nur die Manualseiten in den betreffenden Abschnitten bearbeitet.
  47
  48 Um festzustellen, welche Dateien formatiert werden müssen, macht
  49 .B catman
  50 Gebrauch von den
  51 .I Indexdatenbanken
  52 der jeweiligen Manualseiten.
  53 .SH OPTIONEN
  54 .TP
  55 .B \-d, \-\-debug
  56 Ausgeben von Fehlerinformationen.
  57 .TP
  58 .BI \-M\  Pfad ,\ \-\-manpath= Pfad
  59 Gibt einen alternativen Manualpfad an.
  60 Als Default sind dies alle Pfade, die in der Manualkonfigurationsdatei
  61 als global deklariert sind. Die Umgebungsvariable
  62 .RB $ MANPATH
  63 wird von
  64 .BR catman
  65 nicht benutzt.
  66 .TP
  67 .B \-h, \-\-help
  68 Zeigt einen Hilfstext an.
  69 .TP
  70 .B \-V, \-\-version
  71 Zeigt Programmversion und Autor an.
  72 .SH DATEIEN
  73 .TP
  74 .I /var/catman/\|.\|.\|.\|/index.(bt|db|dir|pag)
  75 Die
  76 .B FSSTND
  77 complianten globalen
  78 .I Indexdatenbanken.
  79 .TP
  80 .I /usr/man/\|.\|.\|.\|/whatis
  81 Traditionelle
  82 .I whatis
  83 Datenbank.
  84 .SH "SIEHE AUCH"
  85 .BR man (1),
  86 .BR manpath (5),
  87 .BR mandb (8).
  88 .SH FEHLER
  89 Auf Systemen mit kleinem (~4 kByte) Zwischenspeicher für Argumente von
  90 .BR execve (2)
  91 kann es nötig sein, dass
  92 .B catman
  93 mehrere kleine im Gegensatz zu wenigen großen Batchjobs ausführen muss.
  94 In diesem Fall ist es für
  95 .B man
  96 möglich, diesen Eintrag (korrekt) aus einer Datenbank zu löschen (vielleicht
  97 existiert er in Wirklichkeit gar nicht mehr), der vom aktuellen Aufruf von
  98 .B catman
  99 benötigt wird, um die nächste Seite zu bestimmen. Wenn die
 100 .I Indexdatenbank
 101 einen Hashtable-Lookup (ndbm, gdbm) benutzt, führt dies zu einem `sich am
 102 eigenen Schopf aus dem Sumpf ziehen'. Obgleich dies selten auftritt, führt es
 103 dazu, dass
 104 .B catman
 105 nicht mehr die weiteren Seiten des Abschnittes bearbeitet.
 106
 107 Hinweis:
 108 .B Linux
 109 hat einen Zwischenspeicher von 128 kByte für
 110 .B execve (2)
 111 Argumente.
 112 .SH AUTOR
 113 Wilf. (G.Wilford@ee.surrey.ac.uk),
 114 die deutsche Übersetzung ist von
 115 Anke Steuernagel (a_steuer@informatik.uni-kl.de) und
 116 Nils Magnus (magnus@informatik.uni-kl.de).
 117