Next: 6.2.4 Atomic Operations with Up: 6.2 Half-duplex UNIX Pipes Previous: 6.2.2 Creating Pipes in

## 6.2.3 Pipes the Easy Way!

If all of the above ramblings seem like a very round-about way of creating and utilizing pipes, there is an alternative.

      LIBRARY FUNCTION: popen();

       PROTOTYPE: FILE *popen ( char *command, char *type);
         RETURNS: new file stream on success
                  NULL on unsuccessful fork() or pipe() call

       NOTES: creates a pipe, and performs fork/exec operations using "command"

This standard library function creates a half-duplex pipeline by calling pipe() internally. It then forks a child process, execs the Bourne shell, and executes the "command" argument within the shell. Direction of data flow is determined by the second argument, "type". It can be "r" or "w", for "read" or "write". It cannot be both! Under Linux, the pipe will be opened up in the mode specified by the first character of the "type" argument. So, if you try to pass "rw", it will only open it up in "read" mode.

While this library function performs quite a bit of the dirty work for you, there is a substantial tradeoff. You lose the fine control you once had by using the pipe() system call, and handling the fork/exec yourself. However, since the Bourne shell is used directly, shell metacharacter expansion (including wildcards) is permissible within the "command" argument.

Pipes which are created with popen() must be closed with pclose(). By now, you have probably realized that popen/pclose share a striking resemblance to the standard file stream I/O functions fopen() and fclose().

      LIBRARY FUNCTION: pclose();

       PROTOTYPE: int pclose( FILE *stream );
         RETURNS: exit status of wait4() call
                  -1 if "stream" is not valid, or if wait4() fails

       NOTES: waits on the pipe process to terminate, then closes the stream.

The pclose() function performs a wait4() on the process forked by popen(). When it returns, it destroys the pipe and the file stream. Once again, it is synonymous with the fclose() function for normal stream-based file I/O.

Consider this example, which opens up a pipe to the sort command, and proceeds to sort an array of strings:

    /*****************************************************************************
      Excerpt from "Linux Programmer's Guide - Chapter 6"
      (C)opyright 1994-1995, Scott Burkett
      *****************************************************************************
      MODULE: popen1.c
      *****************************************************************************/

     #include <stdio.h>

     #define MAXSTRS 5

     int main(void)
     {
             int  cntr;
             FILE *pipe_fp;
             char *strings[MAXSTRS] = { "echo", "bravo", "alpha",
                                       "charlie", "delta"};

             /* Create one way pipe line with call to popen() */
             if (( pipe_fp = popen("sort", "w")) == NULL)
             {
                     perror("popen");
                     exit(1);
             }

             /* Processing loop */
             for(cntr=0; cntr<MAXSTRS; cntr++) {
                     fputs(strings[cntr], pipe_fp);
                     fputc('\n', pipe_fp);
             }

             /* Close the pipe */
             pclose(pipe_fp);

             return(0);
     }

Since `popen()` uses the shell to do its bidding, all shell expansion characters and metacharacters are available for use! In addition, more advanced techniques such as redirection, and even output piping, can be utilized with `popen()`. Consider the following sample calls:

            popen("ls ~scottb", "r");
             popen("sort > /tmp/foo", "w");
             popen("sort | uniq | more", "w");

As another example of popen(), consider this small program, which opens up two pipes (one to the ls command, the other to sort):

    /*****************************************************************************
      Excerpt from "Linux Programmer's Guide - Chapter 6"
      (C)opyright 1994-1995, Scott Burkett
      *****************************************************************************
      MODULE: popen2.c
      *****************************************************************************/

     #include <stdio.h>

     int main(void)
     {
             FILE *pipein_fp, *pipeout_fp;
             char readbuf[80];

             /* Create one way pipe line with call to popen() */
             if (( pipein_fp = popen("ls", "r")) == NULL)
             {
                     perror("popen");
                     exit(1);
             }

             /* Create one way pipe line with call to popen() */
             if (( pipeout_fp = popen("sort", "w")) == NULL)
             {
                     perror("popen");
                     exit(1);
             }

             /* Processing loop */
             while(fgets(readbuf, 80, pipein_fp))
                     fputs(readbuf, pipeout_fp);

             /* Close the pipes */
             pclose(pipein_fp);
             pclose(pipeout_fp);

             return(0);
     }

For our final demonstration of popen(), let's create a generic program that opens up a pipeline between a passed command and filename:

    /*****************************************************************************
      Excerpt from "Linux Programmer's Guide - Chapter 6"
      (C)opyright 1994-1995, Scott Burkett
      *****************************************************************************
      MODULE: popen3.c
      *****************************************************************************/

     #include <stdio.h>

     int main(int argc, char *argv[])
     {
             FILE *pipe_fp, *infile;
             char readbuf[80];

             if( argc != 3) {
                     fprintf(stderr, "USAGE:  popen3 [command] [filename]\n");
                     exit(1);
             }

             /* Open up input file */
             if (( infile = fopen(argv[2], "rt")) == NULL)
             {
                     perror("fopen");
                     exit(1);
             }

             /* Create one way pipe line with call to popen() */
             if (( pipe_fp = popen(argv[1], "w")) == NULL)
             {
                     perror("popen");
                     exit(1);
             }

             /* Processing loop */
             do {
                     fgets(readbuf, 80, infile);
                     if(feof(infile)) break;

                     fputs(readbuf, pipe_fp);
             } while(!feof(infile));

             fclose(infile);
             pclose(pipe_fp);

             return(0);
     }

Try this program out, with the following invocations:

            popen3 sort popen3.c
             popen3 cat popen3.c
             popen3 more popen3.c
             popen3 cat popen3.c | grep main

Next: 6.2.4 Atomic Operations with Up: 6.2 Half-duplex UNIX Pipes Previous: 6.2.2 Creating Pipes in