Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

link(2)

symlink(2)

unlink(2)

SOFT_LINK(2)

NAME

soft_link, soft_unlink − create or delete soft links

USAGE

int soft_link(linktext, pathname)
char *linktext, *pathname;

in soft_unlink(pathname)
char *pathname;

DESCRIPTION

The DOMAIN/IX system call soft_link creates a “soft" link to a specified file.  A soft link points to an object’s pathname, rather than directly to the object, as a “hard" link does.  The system call soft_unlink deletes the soft link. 

The pathname argument is the pathname of the link to be created or deleted.  The linktext argument is the pathname of the file to which the link points.  The file named by linktext need not exist. 

Soft_unlink deletes only the link; the file to which the link points remains intact.  To delete a file, use unlink(2). 

DIAGNOSTICS

Both functions return zero upon successful completion, and −1 upon failure.  Errno is set. 

RELATED INFORMATION

link(2), symlink(2), unlink(2)

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