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

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