SC12 / SC13 und SC23 IPC@CHIP

CGI und SSI - API

CGI API -Bemerkungen

Hinweise zum CGI-Interface

         Link: RTOS-Betriebssystem original, englisch

0xAB

ok

0xAB

0x01

CGI: Eine CGI-Funktion installieren

0xAB

0x02

CGI: Eine CGI-Funktion entfernen

0xAB

0x03

CGI: Setze den Namen einer neuen HTML-Startseite

0xAB

0x04

CGI: Setze den Namen des Wurzel-Verzeichnis

0xAB

0x05

CGI: Hole den Namen des Wurzel-Verzeichnis

0xAB

0x06

CGI: Hole den Namen der aktuellen HTML-Startseite

0xAB

0x07

CGI: URL-Parameter in Namen und Wert zerlegen

0xAB

0x08

CGI: URL-Parameter, nächste Adresse suchen

0xAB

0x09

CGI: Eine TurboPascal CGI Funktion installieren

0xAB

0x0A

CGI: Eine Benutzerfunktion für HTTP-Fehler installieren

0xAB

0x0B

CGI: Benutzerdefinierte MIME-Tabelle installieren

0xAB

0x0C

CGI: Benutzerdefinierte MIME-Tabelle entfernen

0xAB

0x0D

CGI: Installiere eine benutzerdefinierte encoding Tabelle

0xAB

0x0E

CGI: setze eine neue Startseite für die POST-Methode

0xAB

0x0F

CGI: hole den Namen der Startseite der POST-Methode

0xAB

0x10

CGI: setze das Laufwerk mit dem Wurzel-Verzeichnis

0xAB

0x11

CGI: hole die Kennummer des Laufwerks mit Wurzel-Verz

Bei allen Aufrufen eines Softwareinterrupts stellt die mit INT gekennzeichnete hexadezimale Zahl die Nummer des Softwareinterrupts dar, der aufgerufen werden muss.

Die mit AH gekennzeichnete Zahl muss vor dem Aufruf des Interrupts in das AH-Register der CPU-geladen werden. Sie kennzeichnet ein Unterprogramm des Programms, das durch den Softwareinterrupt aufgerufen wird

[siehe z.B. die C-Funktion: int86()]

---

nach oben

  CGI API -Bemerkungen

Der HTTP-Netzwerkserver des SC12 IPC@CHIP besitzt eine Schnittstelle für das Common-Gateway-Interface (CGI). Mit diesem ist es möglich, dynamische HTML-Seiten durch C- oder Pascal-Programmierung zu erstellen und diese einem nachfragenden Client zu senden.

Da dynamisch erstellte Hypertextseiten zum Zeitpunkt der Nachfrage erstellt werden, können sie aktuelle Parameter des Web-Servers enthalten, bzw, der Web-Server kann durch übermittelte Datenstrings (Parameter) des Browser in seiner Arbeit gesteuert werden.

Das Common-Gateway-Interface (CGI) des IPC@CHIP

Normalerweise versendet ein HTTP Server fest vorbereitete HTML-Seiten. Diese liegen bei ihm in einem Ordner, der normalerweise als WEB-ROOT-Verzeichnis angesprochen wird. Die HTML-Seiten aus diesem Ordner können von außen durch einen zweiten Computer, einen Client, auf dem ein Browser arbeitet, abgerufen werden.

Fordert der Client vom Server eine Seite an, sagt dabei aber nicht welche HTML-Seite er erhalten möchte, reagiert der Server durch das Versenden seiner START-Seite. Der Name der Startseite in dem WEB-ROOT-Verzeichnis lautet typischerweise INDEX.HTM. Von ihr aus kann durch LINKS auf weitere Seiten mit beliebigem Namen.htm verzweigt werden. Die Startseite und die gelinkten Seiten sollten zusammen mit den eingebundenen Grafiken und Bildern alle in dem Ordner des WEB-ROOT-Verzeichnisses oder einem seiner Unterverzeichnisse liegen.

Besitzt der Server ein Common-Gateway-Interface kann er dynamisch, von ihm selber erzeugte HTML-Seiten erstellen und diese versenden. Interessant wird eine solche Möglichkeit, wenn der Server über aktuelle Daten verfügt, die bei der normalen Anfertigung einer HTML-Seite noch nicht vorliegen können. Ein Beispiel sind die Besucherzähler (Counter), über die viele Homepages verfügen. Wer wollte so schnell fest vorbereitete HTML-Seiten erstellen, wie sich der Zähler verändert. Unter einem CGI werden diese HTML-Seite per Programm erstellt und dieses fügt die aktuellen Werte des Zählers in der Seite ein.

Aber auch in umgekehrter Richtung funktioniert das CGI. Werden in fixe HTML-Seiten Abfragefelder wie RADIO-BUTTONs, CHECK-BUTTONs oder TEXT-FIELDs usw. eingebaut, so können die hier eingegebenen Daten zum Server gesendet werden, und dieser kann sie empfangen und per Programm auswerten. Das oben gezeigt Bild verdeutlicht diese Möglichkeit.