GETCWD(3C) (C Programming Language Utilities) 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.
Page 1 May 1989