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.

     [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 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.




Printed 5/12/88                                                 1

SYMLINK(2)              COMMAND REFERENCE              SYMLINK(2)



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

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), and unlink(2).













































Printed 5/12/88                                                 2

%%index%%
na:312,90;
sy:402,523;
de:925,412;
di:1337,1532;3253,97;
rv:3350,280;
se:3630,187;
%%index%%000000000116