Topic       : TOS - das Betriebssystem
Author      : 
Version     : tos.hyp (5. März 2013)
Subject     : Programmieren/Atari
Nodes       : 3001
Index Size  : 93602
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Titel
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File5.9.21  Fpipe                                                      TOS

 Name:         »Fpipe« - erzeugt eine Pipe.

 Gemdosnummer: 256

 Deklaration:  int16_t Fpipe ( int16_t usrh[2] );

 Beschreibung: Die Funktion erzeugt eine Pipe, die für Interprozeß- 
               Kommunikation (IPC) benutzt werden kann. Sie wird 
               normalerweise von Shells benutzt, die den Input und 
               Output ihres Childs umleiten möchten. Vor dem Start des 
               Childs leitet die Shell ihren input und output (falls 
               nötig) auf das Leseende und Schreibende der neu 
               erzeugten Datei um. Bei erfolgreichem Aufruf werden in 
               usrh zwei GEMDOS-Handles geliefert.

               usrh[0] ist dabei das Handle für das Leseende der Pipe, 
               (Read-Only) während usrh[1] das Handle für das 
               Schreibende (Write-Only) der Pipe kennzeichnet.

               Die auf diese Weise erzeugte Pipe wird im Verzeichnis 
               U:\PIPE als Pseudo-Datei angelegt und mit dem Namen 
               'sys$pipe.xxx' versehen, wobei xxx als dreistellige 
               ganze Zahl aufzufassen ist.

 Ergebnis:     Die Funktion kann folgende Rückgabewerte liefern:

                E_OK :    kein Fehler aufgetreten.
                ENHNDL :  keine 2 Handles mehr frei.
                EACCDN :  keine Pipeline mehr frei (max. 999 
                          verfügbar).
                ENSMEM :  nicht genug Speicher vorhanden, um die Pipe 
                          zu erzeugen.

 Verfügbar:    Verfügbar, wenn ein 'MiNT' Cookie mit einer 
               Versionsnummer von mindestens 0.90 existiert und in 
               MagiC ab Version 3.0.

 Gruppe:       Dateifunktionen

 Querverweis:  Binding   Fmidipipe   Test auf Pipes