git: 9front

ref: 519199e66b454b80c951911d9f80eeb890c8f40d
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.