Content-type: text/html Man page of getwd

getwd

Section: C Library Functions (3)
Index Return to Main Contents
 

NAME

getwd - Gets current directory pathname  

LIBRARY

Standard C Library (libc.so, libc.a)  

SYNOPSIS

#include <unistd.h>

char *getwd(
        char *path_name);  

STANDARDS

Interfaces documented on this reference page conform to industry standards as follows:

getwd():  XPG4-UNIX

Refer to the standards(5) reference page for more information about industry standards and associated tags.  

PARAMETERS

Points to the full pathname.  

DESCRIPTION

The getwd() function determines the absolute pathname of the current directory, then copies that pathname into the array pointed to by the path_name parameter.

The maximum pathname length, in characters, is set by the PATH_MAX definition, as specified in the limits.h file. If the length of the pathname of the current directory is greater than (PATH_MAX + 1), including the null byte, getwd() fails and returns a null pointer.  

RETURN VALUES

Upon successful completion, a pointer to the absolute pathname of the current directory is returned. If an error occurs, the getwd() function returns a null pointer. and places a message in the path_name parameter.  

RELATED INFORMATION

Functions: getcwd(3)

Standards: standards(5) delim off


 

Index

NAME
LIBRARY
SYNOPSIS
STANDARDS
PARAMETERS
DESCRIPTION
RETURN VALUES
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:40:45 GMT, October 02, 2010