date and time created 89/05/17 22:49:21 by bostic
[unix-history] / usr / src / lib / libc / gen / getcwd.3
.\" Copyright (c) 1983 Regents of the University of California.
.\" All rights reserved. The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
.\" @(#)getcwd.3 6.2 (Berkeley) %G%
.\"
.TH GETWD 3 ""
.UC 5
.SH NAME
getwd \- get current working directory pathname
.SH SYNOPSIS
.nf
.B char *getwd(pathname)
.B char *pathname;
.fi
.SH DESCRIPTION
.I Getwd
copies the absolute pathname of the current working directory to
.I pathname
and returns a pointer to the result.
.SH LIMITATIONS
Maximum pathname length is MAXPATHLEN characters (1024),
as defined in
.I <sys/param.h>.
.SH DIAGNOSTICS
.I Getwd
returns zero and places a message in
.I pathname
if an error occurs.