


      GETCWD(3C)                  (UNIX 5.0)                 GETCWD(3C)



      NAME
           getcwd - get path-name of current working directory

      SYNTAX
           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.

      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).

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




















      Page 1                                         (73 A2 02MTA REV1)



