SYMLINK(2) — HP-UX

Series 300 Only

NAME

symlink − make symbolic link to a file

SYNOPSIS

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

DESCRIPTION

Symlink creates a file name2, which is a symbolic link to name1. Either name may be an arbitrary path name. The files need not be on the same file system.

RETURN VALUE

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 is made unless one or more of the following are true:

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

[ENAMETOOLONG]
A component of either path name exceeded MAXNAMLEN characters, or the entire length of either path name exceeded MAXPATHLEN-1 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 path name.

[EEXIST] Name2 already exists.

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

[EROFS] The file name2 resides 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 symbolic link is being created.

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

[EFAULT] Name1 or name2 points outside the process’ allocated address space. The reliable detection of this error is implementation dependent.

AUTHOR

Symlink was developed by the University of California, Berkeley California, Computer Science Division, Department of Electrical Engineering and Computer Science.

Museum

Related Articles