pclose(3)pclose(3)NAMEpclose - Closes a pipe to a process
SYNOPSIS
#include <stdio.h>
int pclose(
FILE *stream );
LIBRARY
Standard C Library (libc)
STANDARDS
Interfaces documented on this reference page conform to industry stan‐
dards as follows:
pclose(): XPG4, XPG4-UNIX
Refer to the standards(5) reference page for more information about
industry standards and associated tags.
PARAMETERS
Points to a FILE structure for an open pipe returned by a previous call
to the popen() function.
DESCRIPTION
The pclose() function closes a pipe between the calling program and a
shell command to be executed. Use the pclose() function to close any
stream you have opened with the popen() function. The pclose() function
waits for the associated process to end, and then returns the exit sta‐
tus of the command.
Caution
If the original processes and the process started with the popen()
function concurrently read or write a common file, neither should use
buffered I/O. If they do, the results are unpredictable.
RETURN VALUES
Upon successful completion, the pclose() function returns the exit sta‐
tus of the command.
If an error is detected, pclose() sets errno to an appropriate value
and returns a value of -1.
ERRORS
If the pclose() function fails, errno may be set to the following
value: The status of the child process could not be obtained.
SEE ALSO
Functions: fclose(3), popen(3), wait(2)
Standards: standards(5)pclose(3)