git: 9front

ref: 7f8c46e27f55c89bef41f7e089d1f6f276c1696c
dir: /sys/man/2/getwd/

View raw version
.TH GETWD 2
.SH NAME
getwd \- get current directory
.SH SYNOPSIS
.B #include <u.h>
.br
.B #include <libc.h>
.PP
.B
char* getwd(char *buf, int size)
.SH DESCRIPTION
.I Getwd
fills
.I buf
with a null-terminated string representing the current directory
and returns
.IR buf .
.PP
.I Getwd
places no more than
.I size
bytes in the buffer provided.
.SH SOURCE
.B /sys/src/libc/9sys/getwd.c
.SH "SEE ALSO"
.IR pwd (1),
.IR getwd (2),
.IR fd2path (2)
.SH DIAGNOSTICS
On error, zero is returned.
.IR Errstr (2)
may be consulted for more information.
.SH BUGS
Although the name returned by
.I getwd
is guaranteed to be the path used to reach the directory,
if the name space has changed underfoot, the name may be
incorrect.