HP-UX Reference (11i v2 03/08) - 3 Library Functions A-M (vol 6)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

491

492

493

494

495

496

497

498

499

500

getwd(3C) getwd(3C)

NAME

getwd( ) - get pathname of current working directory

SYNOPSIS

#include <unistd.h>

char *getwd(char *buf);

DESCRIPTION

getwd() places the absolute pathname of the current working directory in the array pointed to by buf,

and returns buf.

If the length of the pathname of the current working directory is greater than

PATH_MAX+1

bytes,

getwd() fails and returns a null pointer.

RETURN VALUE

Upon successful completion,

getwd() returns a pointer to the current directory pathname. Otherwise,

it returns NULL with errno set.

ERRORS

getwd() fails if the following condition is encountered:

[ENAMETOOLONG] The length of the speciﬁed path name exceeds

PATH_MAX+1 bytes, or the

length of a component of the path name exceeds

NAME_MAX bytes while

_POSIX_NO_TRUNC is in effect.

getwd() may fail if any of the following conditions are encountered:

[EACCES] Read or search permission is denied for a component of pathname.

[EFAULT] buf points outside the allocated address space of the process.

getwd() may

not always detect this error.

EXAMPLES

#include <stdio.h>

#include <unistd.h>

char *cwd;

char buf[PATH_MAX+1];

...

if ((cwd = getwd(buf)) == NULL) {

perror("getwd");

exit(1);

}

puts(cwd);

WARNINGS

For portability, getcwd() is preferred over this function.

AUTHOR

getwd() was developed by HP and the University of California, Berkeley.