GETCWD(S) UNIX System V GETCWD(S)
Name
getcwd - get path name of current working directory
Syntax
char *getcwd (buf, size)
char *buf;
int size;
Description
The getcwd function 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(S). 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(S) to pipe the
output of the pwd(C) command into the specified string
space.
Example
void exit(), perror();
.
.
.
if ((cwd = getcwd((char *)NULL, 64)) == NULL) {
perror("pwd");
exit(S);
}
printf("%s\n", cwd);
See Also
malloc(S), popen(S), pwd(C)
Diagnostics
Returns NULL with errno set if size is not large enough, or
if an error occurs in a lower-level function.
[EINVAL] If size is zero or not large enough to hold
the path name.
Standards Conformance
getcwd is conformant with:
AT&T SVID Issue 2, Select Code 307-127;
The X/Open Portability Guide II of January 1987;
IEEE POSIX Std 1003.1-1988 with C Standard Language-
Dependent System Support;
and NIST FIPS 151-1.
(printed 6/20/89)