getcwd(3C)                                             getcwd(3C)



     NAME
          getcwd - get pathname of current working directory

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

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

          If buf is a NULL pointer, getcwd obtains 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
          char *cwd, *getcwd();
          .
          .
          .
          if ((cwd = getcwd((char *)NULL, 64)) == NULL) {
               perror(``pwd'');
               exit(1);
          }
          printf(``%s\n'', cwd);

     SEE ALSO
          pwd(1), malloc(3C), popen(3S).

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
















     Page 1                                        (last mod. 1/14/87)