Open System Services Library Calls Reference Manual (G06.28+, H06.05+)

OSS Library Calls (g - h) getwd(3)
NAME
getwd - Gets the pathname of the current working directory
LIBRARY
G-series native OSS processes: /G/system/sysnn/zosshsrl
H-series OSS processes: /G/system/zdllnnn/zosshdll
SYNOPSIS
#include <unistd.h>
char *getwd(char *path_name);
PARAMETERS
path_name Is a pointer to an array, which can contain a pathname.
DESCRIPTION
The getwd() function copies the absolute pathname of the calling process’s current working
directory to the array pointed to by the path_name parameter.
If the length of this pathname (including the null terminator) is greater than PATH_MAX +1
(including the null byte), the getwd() function fails and returns a null pointer.
NOTES
The getwd() function can be called by native processes only.
For portability to implementations conforming to earlier versions of the XPG4 specifications,
getcwd() is preferred over this function.
RETURN VALUES
On successful completion, the getwd() function returns path_name. Otherwise, it returns a null
pointer, and the array pointed to by path_name has undefined contents.
ERRORS
None. This function does not set errno.
RELATED INFORMATION
Functions: getcwd(3).
527187-007 Hewlett-Packard Company 3−85