[Previous] [Contents] [Index] [Next]

Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

getwd()

Get current working directory pathname

Synopsis:

#include <unistd.h>

char* getwd( char *path_name );

Arguments:

path_name
A buffer where the function can store the current working directory.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.


Note: This function is in libc.a, but not in libc.so (in order to save space).

Description:

The getwd() function determines the absolute pathname of the current working directory of the calling process, and copies that pathname into the array pointed to by the path_name argument.

If the length of the pathname of the current working directory is greater than ({PATH_MAX} + 1) including the null byte, getwd() fails and returns a null pointer.


Note: For portability, use getcwd() instead of getwd().

Returns:

A pointer to the string containing the absolute pathname of the current working directory. On error, getwd() returns a null pointer and the contents of the array pointed to by path_name are undefined.

Classification:

POSIX 1003.1 XSI

Safety:
Cancellation point Yes
Interrupt handler No
Signal handler Yes
Thread Yes

See also:

getcwd()


[Previous] [Contents] [Index] [Next]