Skip site navigation (1)Skip section navigation (2)

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
SYMLINK(2)		  FreeBSD System Calls Manual		    SYMLINK(2)

NAME
     symlink --	make symbolic link to a	file

SYNOPSIS
     #include <unistd.h>

     int
     symlink(const char	*name1,	const char *name2);

DESCRIPTION
     A symbolic	link name2 is created to name1 (name2 is the name of the file
     created, name1 is the string used in creating the symbolic	link).	Either
     name may be an arbitrary path name; the files need	not be on the same
     file system.

RETURN VALUES
     Upon successful completion, a zero	value is returned.  If an error
     occurs, the error code is stored in errno and a -1	value is returned.

ERRORS
     The symbolic link succeeds	unless:

     [ENOTDIR]
	       A component of the name2	prefix is not a	directory.

     [ENAMETOOLONG]
	       A component of either pathname exceeded 255 characters, or the
	       entire length of	either path name exceeded 1023 characters.

     [ENOENT]  The named file does not exist.

     [EACCES]  A component of the name2	path prefix denies search permission.

     [ELOOP]   Too many	symbolic links were encountered	in translating the
	       pathname.

     [EEXIST]  Name2 already exists.

     [EIO]     An I/O error occurred while making the directory	entry for
	       name2, or allocating the	inode for name2, or writing out	the
	       link contents of	name2.

     [EROFS]   The file	name2 would reside on a	read-only file system.

     [ENOSPC]  The directory in	which the entry	for the	new symbolic link is
	       being placed cannot be extended because there is	no space left
	       on the file system containing the directory.

     [ENOSPC]  The new symbolic	link cannot be created because there there is
	       no space	left on	the file system	that will contain the symbolic
	       link.

     [ENOSPC]  There are no free inodes	on the file system on which the	sym-
	       bolic link is being created.

     [EDQUOT]  The directory in	which the entry	for the	new symbolic link is
	       being placed cannot be extended because the user's quota	of
	       disk blocks on the file system containing the directory has
	       been exhausted.

     [EDQUOT]  The new symbolic	link cannot be created because the user's
	       quota of	disk blocks on the file	system that will contain the
	       symbolic	link has been exhausted.

     [EDQUOT]  The user's quota	of inodes on the file system on	which the sym-
	       bolic link is being created has been exhausted.

     [EIO]     An I/O error occurred while making the directory	entry or allo-
	       cating the inode.

     [EFAULT]  Name1 or	name2 points outside the process's allocated address
	       space.

SEE ALSO
     ln(1), link(2), lstat(2), readlink(2), unlink(2), symlink(7)

HISTORY
     The symlink() function call appeared in 4.2BSD.

4.2 Berkeley Distribution	 June 4, 1993	     4.2 Berkeley Distribution

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | SEE ALSO | HISTORY

Want to link to this manual page? Use this URL:
<http://www.freebsd.org/cgi/man.cgi?query=symlink&sektion=2&manpath=FreeBSD+3.2-RELEASE>

home | help