Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ getcwd(3C) — Stardent 3.0 System Software

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

malloc(3C)

popen(3S)

pwd(1)

GETCWD(3C)  —  Stardent Computer Inc. (C Programming Language Utilities)

NAME

getcwd − get path-name of current working directory

SYNOPSIS

char ∗getcwd (buf, size)
char ∗buf;
int size;

DESCRIPTION

getcwd returns a pointer to the current directory path name.  The value of size must be at least two greater than the length of the path-name to be returned. 

If buf is a NULL pointer, getcwd obtains size bytes of space using malloc(3C). In this case, the pointer returned by getcwd may be used as the argument in a subsequent call to free. 

The function is implemented by using popen(3S) to pipe the output of the pwd(1) command into the specified string space.

EXAMPLE

void exit(), perror();
.
.
.
if ((cwd = getcwd((char ∗)NULL, 64)) == NULL) {

perror("pwd");
exit(2);

}
printf("%s\n", cwd);

SEE ALSO

malloc(3C), popen(3S), pwd(1)

DIAGNOSTICS

Returns NULL with errno set if size is not large enough, or if an error occurs in a lower-level function. 

September 29, 2021

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026