*** UNIX MANUAL PAGE BROWSER ***

pclose(3) Library Functions Manual pclose(3) NAME pclose - Closes a pipe to a process LIBRARY Standard C Library (libc.so, libc.a) SYNOPSIS #include <stdio.h> int pclose ( FILE *stream ); 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 in- dustry 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. 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 unpre- dictable. 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. RELATED INFORMATION Functions: fclose(3), popen(3), wait(2) Standards: standards(5) delim off pclose(3)