git.infodrom.org Git - infodrom/manpages-de/blob - man1/g77.1

   1 .\" Copyright (c) 1995-1997 Free Software Foundation              -*-Text-*-
   2 .\" See section COPYING for conditions for redistribution
   3 .\" 2002-04-26 Translated into German by
   4 .\"            Heinz-Eckhard Habermehl <hehabermehl@de.bnsmc.com>
   5 .TH G77 1 "1999-02-14" "GNU Werkzeuge" "GNU Werkzeuge"
   6 .SH BEZEICHNUNG
   7 g77 \- GNU Projekt Fortran Compiler (v0.5.24)
   8 .SH SYNTAX
   9 .RB g77 " [ " \c
  10 .IR Option " | " "Dateiname " ].\|.\|.
  11 .SH WARNUNG
  12
  13 Die Information auf dieser man-Seite ist ein Auszug aus der vollständigen
  14 Dokumentation des GNU Fortran Compilers (Version 0.5.24).  Sie ist beschränkt
  15 auf die Beschreibung einiger der einstellbaren Optionen des g77.
  16 .PP
  17 Diese man-Seite ist nicht aktuell, da sich niemand mehr bereit erklärt, sie
  18 zu pflegen. Falls Unterschiede zwischen den Angaben dieser Seite und der
  19 Software erkennbar werden, sollte die Info-Datei des g77 zu Rate gezogen
  20 werden, die die offizielle Dokumentation des Projektes darstellt.  Die
  21 Info-Datei des g77 ist lediglich in Englisch verfügbar.
  22 .PP
  23 Falls die Autoren feststellen sollten, dass die Angaben auf dieser man-Seite
  24 nicht mehr aktuell sind oder zu großer Verwirrung und Ärger führen, so wird
  25 die Ausgabe der Seite eingestellt.  Die Alternative, diese Seite immer mit
  26 der Info-Seite zu aktualisieren, ist nicht praktikabel, weil die Arbeit an
  27 der Entwicklung von GNU-Fortran dafür keine Zeit lässt.  Das GNU-Projekt sieht
  28 die man-Seiten als überflüssig an, sie sollten daher keine Zeit
  29 beanspruchen, die für andere Dinge dringender benötigt wird.
  30 .PP
  31 Für eine komplette und aktuelle Dokumentation sei entweder wieder auf die
  32 Infodatei von `\|\c
  33 .B g77\c
  34 \&\|' oder das Manual
  35 .I
  36 Using and Porting GNU Fortran (für Version 0.5.24)\c
  37 \&.  verwiesen.  Beide lassen sich aus der Textinfo-Quelldatei
  38 .B g77.texi
  39 erzeugen, die dem g77 beigefügt ist.
  40 .PP
  41 Wenn auf Ihrem System das `\|\c
  42 .B info\c
  43 \&\|'-Kommando installiert ist, sollte der Befehl
  44 `\|\c
  45 .B info g77\c
  46 \&\|' funktionieren, es sei denn, dass g77 nicht richtig installiert
  47 wurde. Fehlt  `\|\c
  48 .B info\c
  49 \&\|' auf dem System oder wollen Sie das Kommando nicht
  50 einsetzen, dann sollte der Befehl `\|\c
  51 .B more /usr/info/g77\c
  52 \&\|' funktionieren,
  53 sofern auch er sauber installiert ist.
  54 .PP
  55 Falls der
  56 .B g77
  57 nicht vollständig
  58 installiert sein sollte, so dass ein Zugriff auf die Info-Datei unmöglich ist,
  59 bitten Sie den Systemadministrator oder den Verantwortlichen für den g77
  60 (falls er/sie bekannt ist), das Problem zu beseitigen.
  61 .PP
  62 .SH BESCHREIBUNG
  63 Der C- und der F77-Compiler sind miteinander verbunden.
  64 .B g77
  65 ist ein Programm,
  66 das den
  67 .B gcc
  68 mit den entsprechenden Optionen aufruft, um Fortran-Programme
  69 (ANSI FORTRAN 77, auch als F77 bezeichnet) zu verarbeiten.
  70 .B gcc
  71 bearbeitet Eingabedateien in bis zu vier Stufen: Präprozessieren,
  72 Übersetzen, Assemblieren
  73 und Linken.  Diese man-Seite enthält
  74 vollständige Beschreibungen
  75 .I ausschließlich
  76 von
  77 F77-spezifischen Aspekten des Compilers.  Allgemeine Optionen sind in
  78 kurzen Zusammenfassungen enthalten.  Eine detailliertere Beschreibung
  79 des C-Compilers findet sich unter
  80 .BR gcc ( 1 ).
  81 .PP
  82 Für eine vollständige Dokumentation
  83 über GNU-Fortran geben Sie den Befehl `\|\c
  84 .B info g77\c
  85 \&\|' auf der Kommandozeile ein.
  86 .PP
  87 F77-Quelldateien besitzen die Endungen
  88 .B .f\c
  89 \&\|', `\|\c
  90 .B .for\c
  91 \&\|', oder `\|\c
  92 .B .FOR\c
  93 \&\|';
  94 F77-Dateien, die vor der eigentlichen Übersetzung durch den Präprozessor
  95 .BR cpp ( 1 )
  96 laufen sollen, verwenden die Endungen
  97 .B .F\c
  98 \&\|', `\|\c
  99 .B .fpp\c
 100 \&\|', oder `\|\c
 101 .B .FPP\c
 102 \&\|';
 103 .BR Ratfor \-Quelldateien
 104 enden auf `\|\c
 105 .B .r\c
 106 \&\|'
 107 .RB ( ratfor
 108 selbst ist kein Bestandteil von
 109 .B g77\c
 110 \&).
 111 .PP
 112 .SH OPTIONEN
 113 Es gibt eine Reihe von Kommandozeilen-Optionen zur Steuerung der
 114 Optimierung, Ausgabe von Fehlermeldungen und der Codeerzeugung, die für die
 115 Compiler
 116 .B gcc
 117 und
 118 .B g77\c
 119 \&identisch sind.  Eine vollständige Dokumentation aller Optionen
 120 findet sich unter
 121 .BR gcc ( 1 ).
 122 .PP
 123 Die Optionsangaben werden durch ein
 124 .B \-
 125 eingeleitet und meist durch einen Buchstaben oder Ausdruck repräsentiert.
 126 Hierbei ist zwischen  Groß- und Kleinschreibung zu unterscheiden.
 127 Die Optionen müssen durch Leerzeichen getrennt sein.  Dabei ist zu beachten:
 128 Die Angabe von
 129 .B \-dr
 130 hat eine andere Bedeutung als der Ausdruck
 131 .BR "\-d \-r" .
 132 .PP
 133 Viele der
 134 .BR \-f \-
 135 und
 136 .BR \-W \-Optionen
 137 gibt es in einer bejahenden und einer verneinenden Form:
 138 .BI \-f name
 139 und
 140 .BI \-fno\- name\c
 141 \& (oder
 142 .BI \-W name
 143 und
 144 .BI \-Wno\- name\c
 145 \&),
 146 wobei
 147 .I name
 148 für den jeweiligen Optionsausdruck steht.
 149 Im Folgenden ist nur die Form beschrieben, die nicht der Voreinstellung
 150 entspricht.
 151 .TP
 152 .B \-c
 153
 154 Kompiliert die Quelldateien, führt aber anschließend kein Linken durch.
 155 Die Compilerausgabe ist eine Objektdatei mit dem entsprechenden Namen der
 156 Quelldatei und der Endung
 157 .BR \.o .
 158 .TP
 159 .BI \-D macro
 160 Definiert das Makro
 161 .I macro
 162 mit dem String `\|\c
 163 .B 1\c
 164 \&\|' als Wert.
 165 .TP
 166 .BI \-D macro = defn
 167 Definiert das Makro
 168 .I macro
 169 mit Wert
 170 .IR defn .
 171 .TP
 172 .B \-E
 173 Der g77 hält nach dem Präprozessieren an, startet also nicht den
 174 Übersetzer.  Die Ausgabe, der vorübersetzte Quellcode, wird auf die
 175 Standardausgabe geschickt.
 176 .TP
 177 .B \-g
 178 Erzeugt Debuginformation im Betriebssystem-spezifischen Format (für DBX, SDB
 179 oder DWARF).  Auch der GDB kann ebenfalls diese Debuginformation verarbeiten.
 180 Auf den meisten Systemen, die das DBX-Format verwenden, erlaubt
 181 .B \-g
 182 den Einsatz von speziellen Debug-Informationen, die nur GDB versteht.
 183
 184 Im Gegensatz zu den meisten anderen Fortran-Compilern erlaubt es GNU Fortran,
 185 gleichzeitig sowohl
 186 .BR \-g ,
 187 als auch
 188 .B \-O
 189 zu verwenden.  Die Betrachtung von optimiertem Code kann teilweise
 190 überraschende Ergebnisse liefern: Einige der deklarierten Variablen existieren
 191 gar nicht; der Programmablauf durchläuft unerwartete Wege; einige
 192 Befehlsstrukturen werden nicht ausgeführt, weil sie konstante Ergebnisse
 193 liefern oder die Werte schon vorhanden sind; einige Befehlsstrukturen werden an
 194 verschiedenen Stellen ausgeführt, da sie außerhalb von Schleifen positioniert
 195 wurden.
 196
 197 Dennoch ist es möglich, optimierten Code zu debuggen.  Dies
 198 erlaubt es, den Optimierer auch in Programmen mit Bugs einzusetzen.
 199 .TP
 200 .BI \-I dir
 201 Fügt das Verzeichnis
 202 .I dir
 203 der Liste der Verzeichnisse hinzu, die
 204 nach include-Dateien durchsucht werden sollen.
 205 .TP
 206 .BI \-L dir
 207 Fügt das Verzeichnis
 208 .I dir
 209 der Liste der Verzeichnisse hinzu, die
 210 nach Link-Bibliotheken durchsucht werden sollen, welche über die Option
 211 .B \-l
 212 gesetzt sind.
 213 .TP
 214 .BI -l library
 215 Verwendet die Bibliothek mit dem Namen
 216 .I library
 217 beim Linken.
 218 .TP
 219 .B \-nostdinc
 220 Es werden nicht die Standardverzeichnisse des Systems nach
 221 Header-Dateien durchsucht, sondern nur die Verzeichnisse,
 222 die über die
 223 .BR -I -Option
 224 spezifiziert sind (sowie der aktuelle Ordner, falls passend).
 225 .TP
 226 .B \-O
 227 Optimierte Übersetzung.  Sie dauert etwas länger und benötigt auch mehr
 228 Speicherplatz.  Weitere Optimierungsoptionen sind in der GCC-Dokumentation
 229 beschrieben.  Bei typischen numerischen Anwendungen in Fortran-Programmen
 230 kann vor allem das Optimieren von Schleifen sinnvoll sein.
 231 .TP
 232 .BI "\-o " Dateiname
 233 Gibt die Ausgabe in die Datei mit Namen
 234 .I Dateiname
 235 aus.
 236 .TP
 237 .B \-S
 238 .B g77
 239 hält nach dem Übersetzen an und linkt nicht.  Die Ausgabe sind
 240 Assemblercode-Dateien, mit denselben Namen wie die zugehörigen Eingabedateien,
 241 aber mit der entsprechenden Endung für Assemblercode.
 242 .TP
 243 .BI \-U macro
 244 Löscht die Definition des Makros
 245 .IR macro .
 246 .TP
 247 .B \-v
 248
 249 Gibt die Befehle, die während der einzelnen Stufen der Kompilierung ausgeführt
 250 werden, auf die Standard-Fehlerausgabe aus.  Gibt außerdem die Versionsnummer
 251 des Compiler-Treiberprogramms,  des  Präprozessors und des Übersetzers selbst
 252 aus.  Die Versionsnummer des g77 unterscheidet sich von derjenigen der
 253 GCC-Distribution, auf der er aufbaut.
 254 .TP
 255 .B \-Wall
 256 Es werden Warnungen bei Zuständen ausgegeben, die es zu vermeiden gilt und die
 257 sich leicht vermeiden lassen, sogar in Verbindung mit Makros.
 258 .PP
 259 .SH BEISPIELE
 260 .TP
 261 .B g77 quelle.for
 262 Übersetzt die Fortran-Quelldatei
 263 .BR quelle.for ,
 264 linkt und erzeugt eine ausführbare Datei
 265 .B a.out
 266 im aktuellen Ordner.
 267 .B a.out
 268 wird  immer dann erzeugt, wenn kein Zieldateiname angegeben ist (mit der
 269 .BR \-o \-Option).
 270 .TP
 271 .B g77 -o ziel.bin quelle.for
 272 Übersetzt die Fortran-Quelldatei
 273 .BR quelle.for ,
 274 linkt und erzeugt die ausführbare Datei mit dem Namen
 275 .BR ziel.bin .
 276 .TP
 277 .B g77 -O2 -o ziel.bin quelle.for
 278 Übersetzt die Fortran-Quelldatei
 279 .B quelle.for
 280 mit Optimierung, linkt und erzeugt eine ausführbare Datei
 281 .BR ziel.bin .
 282 .TP
 283 .B g77 -c mysub.f
 284 Übersetzt die Fortran-Quelldatei
 285 .BR mysub.f ,
 286 in der z. B. nur Subroutinen enthalten sind, und erzeugt eine Objektdatei
 287 .B mysub.o
 288 im aktuellen Ordner.
 289 .TP
 290 .B g77 -o myprogexe myprog.f mysub.o
 291 Linkt die Objektdatei
 292 .B mysub.o
 293 zum Programm mit der Quelldatei
 294 .B myprog.f
 295 und erzeugt eine ausführbare Datei
 296 .BR myprogexe .
 297 .TP
 298 .B g77 -o myprogexe myprog.f -ldummylib
 299 Linkt eine externe Bibliothek mit Namen
 300 .B dummylib
 301 an das Programm mit Quelldatei
 302 .B myprog.f
 303 und erzeugt eine ausführbare Datei
 304 .BR myprogexe .
 305 .PP
 306 .SH DATEIEN
 307 .ta \w'LIBDIR/g77\-include 'u
 308 file.h    C-Header-Datei (Präprozessor)
 309 .br
 310 file.f    Fortran-Quellcodedatei
 311 .br
 312 file.for  Fortran-Quellcodedatei
 313 .br
 314 file.FOR  Fortran-Quellcodedatei
 315 .br
 316 file.F    vorprozessierte Fortran-Quellcodedatei
 317 .br
 318 file.fpp  vorprozessierte Fortran-Quellcodedatei
 319 .br
 320 file.FPP  vorprozessierte Fortran-Quellcodedatei
 321 .br
 322 file.r    Ratfor Quellcodedatei (ratfor nicht enthalten)
 323 .br
 324 file.s    Assemblercode-Datei
 325 .br
 326 file.o    Objektdatei
 327 .br
 328 a.out     gelinkte Ausgabe
 329 .br
 330 \fITMPDIR\fR/cc\(**      temporäre Dateien
 331 .br
 332 \fILIBDIR\fR/cpp      Präprozessor
 333 .br
 334 \fILIBDIR\fR/f771     Übersetzer
 335 .br
 336 \fILIBDIR\fR/libg2c.a Fortran Laufzeit-Bibliothek
 337 .br
 338 \fILIBDIR\fR/libgcc.a GCC Unterroutinen-Bibliothek
 339 .br
 340 /lib/crt[01n].o Start-up-Routine
 341 .br
 342 /lib/libc.a     Standard-C-Bibliothek, siehe
 343 .IR intro ( 3 )
 344 .br
 345 /usr/include    Standardverzeichnis für
 346 .BR #include \-Dateien
 347 .br
 348 \fILIBDIR\fR/include  Standard-gcc-Verzeichnis für
 349 .BR #include \-Dateien
 350 .sp
 351 \fILIBDIR\fR ist gewöhnlich
 352 .B /usr/local/lib/\c
 353 .IR maschine / version .
 354
 355 .sp
 356 \fITMPDIR\fR kommt von der Umgebungsvariable \fBTMPDIR\fR.  (Die
 357 Voreinstellung ist \fB/usr/tmp\fR falls verfügbar, sonst \fB/tmp\fR).
 358 .SH "SIEHE AUCH"
 359 .BR gcc (1), cpp (1), as (1), ld (1), gdb (1), adb (1), dbx (1), sdb (1).
 360 Die Infoseiten zu
 361 .RB "`\|" g77 "\|', `\|" gcc "\|', `\|" cpp "\|',"
 362 .RB "`\|" as "\|', `\|" ld "\|',"
 363 und
 364 .RB "`\|" gdb "\|'".
 365 .br
 366 .I
 367 Using and Porting GNU Fortran (for version 0.5.24)\c
 368 , James Craig Burley;
 369 .I
 370 Using and Porting GNU CC (for version 2.0)\c
 371 , Richard M. Stallman;
 372 .I
 373 The C Preprocessor\c
 374 , Richard M. Stallman;
 375 .I
 376 Debugging with GDB: the GNU Source-Level Debugger\c
 377 , Richard M. Stallman and Roland H. Pesch;
 378 .I
 379 Using as: the GNU Assembler\c
 380 , Dean Elsner, Jay Fenlason & friends;
 381 .I
 382 gld: the GNU linker\c
 383 , Steve Chamberlain and Roland Pesch.
 384 .PP
 385 Die GNU Fortran 77 Seite steht im Internet unter:
 386
 387 http://gcc.gnu.org/onlinedocs/g77_news.html
 388 .br
 389 http://world.std.com/~burley/g77.html
 390 .PP
 391 Infos zum Projekt des geplanten Fortran-95 Compilers (g95)
 392 stehen unter:
 393
 394 http://g95.sourceforge.net/
 395 .PP
 396 Eine deutschsprachige Internetseite mit vielen
 397 Informationen zum Thema Fortran findet sich unter:
 398
 399 http://www.unics.uni-hannover.de/rrzn/gehrke/frei.html
 400 .PP
 401 .SH BUGS
 402 Nähere Informationen zum Thema 'Melden von Bugs' erhalten
 403 Sie nach Eingabe von
 404 .B info g77 -n Bugs\c
 405 \&\|in der Shell.
 406 .SH LIZENZBESTIMMUNGEN
 407 Copyright (c) 1991-1998 Free Software Foundation, Inc.
 408
 409 Sofern der Copyright-Vermerk und dieser Erlaubnisvermerk auf allen Kopien
 410 vorhanden sind, ist es erlaubt, wortgetreue Kopien von diesem Manual zu
 411 machen und diese weiterzugeben.
 412
 413 Unter den Bedingungen für wortgetreues Kopieren ist es erlaubt, Kopien von
 414 modifizierten Versionen dieses Manuals zu machen und diese weiterzugeben.  Das
 415 gesamte Ergebnis der abgeleiteten Arbeit darf wiederum nur mit einem
 416 Erlaubnisvermerk versehen verteilt werden, der mit diesem identisch ist.
 417
 418 Unter den obigen Bedingungen für modifizierte Versionen ist es erlaubt,
 419 Kopien von Übersetzungen dieses Manuals in andere Sprachen zu machen und
 420 diese weiterzugeben.  Dieser Erlaubnisvermerk muss in übersetzter und durch
 421 die Free Software Foundation geprüfter Form in den Übersetzungen an Stelle
 422 der Orginalvermerke in englischer Sprache enthalten sein.
 423 .SH AUTOREN
 424 Wenn Sie sich über die Mitarbeiter an GNU CC informieren wollen, schauen Sie
 425 in das GNU CC Manual.  Die Personen, die zum GNU Fortran-Projekt beitragen,
 426 stehen im Handbuch von GNU Fortran.