SYMLINK(2)              COMMAND REFERENCE              SYMLINK(2)



NAME
     symlink - make symbolic link to a file

SYNOPSIS
     symlink(path1, path2)
     char *path1, *path2;

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

DIAGNOSTICS
     The symbolic link is made unless on or more of the following
     are true:

     [ENOASCII]
         Path2 contain a character with the high-order bit set.

     [ENAMETOOLONG]
         One of the pathnames specified is too long.

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

     [EEXIST]
         Name2 already exists.

     [EACCES]
         A component of the path2 path prefix denies search
         permission.  If the file is located on a remote host,
         this error code will be returned if the local host name
         and local user name does not appear in
         /usr/lib/dfs/access on the remote machine.  See
         access(dfs)(5n).

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

     [ENOSPC]
         The file system is out of inodes.

     [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 ecreated because there
         is no space left on the file system which will contain



Printed 10/17/86                                                1

SYMLINK(2)              COMMAND REFERENCE              SYMLINK(2)



         the link.

     [ENFILE]
         The system inode table is full.

     [EFAULT]
         Path1 or path2 points outside the process's allocated
         address space.

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

     [EIO]
         An I/O error occurred while writing to the file system.

     [EDFSNOSUCHHOST]
         Path2 referenced a remote host, but when we broadcast a
         request for its address, no host responded.

RETURN VALUE
     Upon successful completion, a value of 0 is returned.
     Otherwise, a value of -1 is returned and errno is set to
     indicate the error.

SEE ALSO
     ln(1), link(2), unlink(2).




























Printed 10/17/86                                                2

%%index%%
na:72,74;
sy:146,339;
de:485,368;
di:853,1364;2361,527;
rv:2888,236;
se:3124,138;
%%index%%000000000115