getcwd(3c)                 DG/UX 4.30                  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 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
               char *cwd, *getcwd();
               .
               .
               .
               if ((cwd = getcwd((char *)NULL, 64)) == NULL) {
                    perror(``pwd'');
                    exit(1);
               }
               printf(``%s\n'', cwd);

     SEE ALSO
          malloc(3C), popen(3S).
          pwd(1) in the User's Reference for the DG/UX System

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















     Licensed material--property of copyright holder(s)         Page 1