GETCWD(3C)                                             GETCWD(3C)



     NAME
          getcwd - get path-name of current working directory

     SYNOPSIS
          char *getcwd (buf, size)
          char *buf;
          int size;

     DESCRIPTION
          getcwd returns a pointer to the current directory path name.
          The value of size must be at least two greater than the
          length of the path-name to be returned.

          If buf is a NULL pointer, getcwd will obtain size bytes of
          space using malloc(3C).  In this case, the pointer returned
          by getcwd may be used as the argument in a subsequent call
          to free.

          The function is implemented by using popen(3S) to pipe the
          output of the pwd(1) command into the specified string
          space.

     EXAMPLE
               void exit(), perror();
               .
               .
               .
               if ((cwd = getcwd((char *)NULL, 64)) == NULL) {
                    perror("pwd");
                     exit(2);
               }
               printf("%s\n", cwd);

     SEE ALSO
          malloc(3C), popen(3S).
          pwd(1) in the User's Reference Manual.

     DIAGNOSTICS
          Returns NULL with errno set if size is not large enough, or
          if an error occurs in a lower-level function.

     ORIGIN
          AT&T V.3












     Page 1                                        (last mod. 8/20/87)