git.infodrom.org Git - infodrom/manpages-de/blob - man3/popen.3

   1 .\" Copyright 1991 The Regents of the University of California.
   2 .\" All rights reserved.
   3 .\"
   4 .\" Redistribution and use in source and binary forms, with or without
   5 .\" modification, are permitted provided that the following conditions
   6 .\" are met:
   7 .\" 1. Redistributions of source code must retain the above copyright
   8 .\"    notice, this list of conditions and the following disclaimer.
   9 .\" 2. Redistributions in binary form must reproduce the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer in the
  11 .\"    documentation and/or other materials provided with the distribution.
  12 .\" 3. All advertising materials mentioning features or use of this software
  13 .\"    must display the following acknowledgement:
  14 .\"     This product includes software developed by the University of
  15 .\"     California, Berkeley and its contributors.
  16 .\" 4. Neither the name of the University nor the names of its contributors
  17 .\"    may be used to endorse or promote products derived from this software
  18 .\"    without specific prior written permission.
  19 .\"
  20 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  21 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  22 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  23 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  24 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  25 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  26 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  27 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  28 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  29 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  30 .\" SUCH DAMAGE.
  31 .\"
  32 .\"     @(#)popen.3     6.4 (Berkeley) 4/30/91
  33 .\"
  34 .\" Converted for Linux, Mon Nov 29 14:45:38 1993, faith@cs.unc.edu
  35 .\" Translated into German Sat May 18 13:45:00 1996 by Patrick Rother <krd@gulu.net>
  36 .\" Modified Mon Jun 10 01:05:39 1996 by Martin Schulze (joey@linux.de)
  37 .\"
  38 .TH POPEN 3  "17. Mai 1996" "BSD" "Bibliotheksfunktionen"
  39 .SH BEZEICHNUNG
  40 popen, pclose \- bearbeite E/A
  41 .SH ÜBERSICHT
  42 .B #include <stdio.h>
  43 .sp
  44 .BI "FILE *popen(const char *" command ", const char *" type );
  45 .sp
  46 .BI "int pclose(FILE *" stream );
  47 .SH BESCHREIBUNG
  48 Die Funktion
  49 .B popen()
  50 öffnet einen Prozess dadurch, dass sie sich nach Erzeugen einer Pipe
  51 aufteilt und eine Shell öffnet.  Da eine Pipe nach Definition
  52 unidirektional ist, darf das Argument
  53 .I type
  54 nur Lesen oder Schreiben angeben, nicht beides; der resultierende Datenkanal
  55 ist demzufolge nur-lesend oder nur-schreibend.
  56 .PP
  57 Das Argument
  58 .I command
  59 ist ein Zeiger auf einen mit NULL beendeten String, der ein Shell-Kommandozeile
  60 enthält.  Dieses Kommando wird an
  61 .B \-c
  62 -Flag an
  63 .I /bin/sh
  64 übergeben; Interpretation, falls nötig, wird von der Shell durchgeführt.
  65 Das Argument
  66 .I mode
  67 ist ein Zeiger auf einen mit NULL beendeten String, der entweder `r' für Lesen
  68 oder `w' für Schreiben sein muss.
  69 .PP
  70 Der Rückgabewert von
  71 .B popen()
  72 ist ein normaler Standard-E/A-Datenkanal in jeder Hinsicht, trotzdem muss er
  73 mit
  74 .B pclose() ,
  75 nicht mit
  76 .B fclose()
  77 geschlossen werden.
  78 Schreiben in solch einen Datenkanal bewirkt Schreiben in die Standardeingabe
  79 des Kommandos; die Standardausgabe der Kommandos ist die des Prozesses, der
  80 .BR popen() ,
  81 aufgerufen hat, wenn dies nicht vom Programm selbst geändert wird.  Umgekehrt
  82 lesen mit popen geöffnete Kanäle von der Standardausgabe des Programms während
  83 die die Standardeingabe dieselbe des aufrufenden Programms ist.
  84 .PP
  85 Beachten Sie, dass Ausgabe-
  86 .BR popen() \-Kanäle
  87 nach Voreinstellung voll gepuffert sind.
  88 .PP
  89 Die Funktion
  90 .B pclose()
  91 wartet bis der zugehörige Prozess beendet ist und gibt den Rückgabewert des
  92 Kommandos wie von
  93 .B wait4()
  94 geliefert, zurück.
  95 .SH "RÜCKGABEWERT"
  96 Die Funktion
  97 .B popen()
  98 gibt
  99 .B NULL
 100 zurück wenn die Aufrufe
 101 .BR fork (2)
 102 oder
 103 .BR pipe (2)
 104 fehlschlagen, oder wenn kein Speicher belegt werden kann.
 105 .PP
 106 Die Funktion
 107 .B pclose()
 108 gibt \-1 zurück wenn
 109 .I stream
 110 nicht mit einem durch ``popen'' erzeugten Datenkanal verbunden werden
 111 kann, wenn
 112 .I stream
 113 bereits mit ``pclose'' geschlossen wurde, oder wenn
 114 .B wait4 ()
 115 einen Fehler zurückliefert.
 116 .SH FEHLER
 117 Die Funktion
 118 .B popen()
 119 setzt
 120 .I errno
 121 nicht zuverlässig.
 122 (Gilt das unter Linux?)
 123 .SH BUGS
 124 Da die zum Lesen geöffnete Standardeingabe eines Programms ihren Suchindex
 125 mit dem Prozess teilt, der
 126 .B popen()
 127 aufgerufen hat, kann es vorkommen, dass die Leseposition des Programms nicht
 128 wie erwartet ist, wenn der Originalprozess gepuffertes Schreiben durchgeführt
 129 hat.  Genauso kann die Ausgabe eines zum Schreiben geöffneten Kommandos
 130 durcheinandergeraten mit dem Originalprozess.
 131 Letzteres kann vermieden werden durch Aufruf von
 132 .BR fflush (3)
 133 vor
 134 .BR popen() .
 135 .PP
 136 Fehler, die Shell aufzurufen, kann nicht unterschieden werden von Fehler
 137 der Shell, das Programm aufzurufen, oder einem sofortigen Ende des Programms.
 138 Einziger Hinweis ist ein Rückgabewert von 127.  (Gilt das unter Linux?)
 139 .PP
 140 Die Funktion
 141 .B popen()
 142 ruft immer
 143 .BR sh ,
 144 nicht
 145 .BR csh
 146 auf.
 147 .SH GESCHICHTE
 148 Funktionen()
 149 .B popen
 150 und
 151 .B pclose()
 152 erschienen in Version 7 AT&T UNIX.
 153 .SH "SIEHE AUCH"
 154 .BR fork (2),
 155 .BR sh (1),
 156 .BR pipe (2),
 157 .BR wait4 (2),
 158 .BR fflush "(3),
 159 .BR fclose (3),
 160 .BR fopen (3),
 161 .BR stdio (3),
 162 .BR system (3).