[unix-history] / usr / man / man2 / link.2

.TH LINK 2 
.SH NAME
link \- link to a file
.SH SYNOPSIS
.B link(name1, name2)
.br
.B char *name1, *name2;
.SH DESCRIPTION
A link
to
.I name1
is created;
the link has the name
.IR name2 .
Either name may be an arbitrary path name.
.SH "SEE ALSO"
ln(1), unlink(2)
.SH DIAGNOSTICS
Zero is returned when a link is made;
\-1 is returned when
.I name1
cannot be found; when
.I name2
already exists; when the directory of
.I name2
cannot be written; when
an attempt is made to link to a directory by a user
other than the super-user;
when an attempt is made to link
to a file on another file system;
when a file has too many links.
.SH "ASSEMBLER (PDP-11)"
(link = 9.)
.br
.B sys link; name1; name2
Commit	Line	Data
e6817382 BJ	1	.TH LINK 2
	2	.SH NAME
	3	link \- link to a file
	4	.SH SYNOPSIS
	5	.B link(name1, name2)
	6	.br
	7	.B char name1, name2;
	8	.SH DESCRIPTION
	9	A link
	10	to
	11	.I name1
	12	is created;
	13	the link has the name
	14	.IR name2 .
	15	Either name may be an arbitrary path name.
	16	.SH "SEE ALSO"
	17	ln(1), unlink(2)
	18	.SH DIAGNOSTICS
	19	Zero is returned when a link is made;
	20	\-1 is returned when
	21	.I name1
	22	cannot be found; when
	23	.I name2
	24	already exists; when the directory of
	25	.I name2
	26	cannot be written; when
	27	an attempt is made to link to a directory by a user
	28	other than the super-user;
	29	when an attempt is made to link
	30	to a file on another file system;
	31	when a file has too many links.
	32	.SH "ASSEMBLER (PDP-11)"
	33	(link = 9.)
	34	.br
	35	.B sys link; name1; name2