symlink man page on HP-UX

Man page or keyword search:  
man Server   10987 pages
apropos Keyword Search (all sections)
Output format
HP-UX logo
[printable version]

symlink(2)							    symlink(2)

NAME
       symlink - make symbolic link to a file

SYNOPSIS
DESCRIPTION
       The  function creates a symbolic link. Its name is the pathname pointed
       to by path2, which must be a pathname that does not  name  an  existing
       file or symbolic link. The contents of the symbolic link are the string
       pointed to by path1.

RETURN VALUE
       Upon successful completion, returns 0. Otherwise,  it  returns  −1  and
       sets to indicate the error.

ERRORS
       If fails, is set to one of the following values:

	      [EACCES]		       Write   permission  is  denied  in  the
				       directory where the  symbolic  link  is
				       being  created, or search permission is
				       denied for a component of the path pre‐
				       fix of path2.

	      [EEXIST]		       The  path2  argument  names an existing
				       file or symbolic link.

	      [EFAULT]		       path1  or  path2	 points	 outside   the
				       process's allocated address space.  The
				       reliable detection  of  this  error  is
				       implementation-dependent.

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

	      [ELOOP]		       Too  many  symbolic  links were encoun‐
				       tered in resolving path2.

	      [ENAMETOOLONG]	       The  length  of	the   path2   argument
				       exceeds	or  pathname  resolution  of a
				       symbolic link produced an  intermediate
				       result  that exceeds or a pathname com‐
				       ponent is longer than

	      [ENOENT]		       A component of path2 does not  name  an
				       existing	 file  or  path2  is  an empty
				       string.

	      [ENOSPC]		       The directory in which  the  entry  for
				       the  new	 symbolic link is being placed
				       cannot be extended because no space  is
				       left  on the file system containing the
				       directory, or  the  new	symbolic  link
				       cannot  be  created because no space is
				       left on the file system which will con‐
				       tain  the  link,	 or the file system is
				       out of file-allocation resources.

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

	      [EROFS]		       The new symbolic link would reside on a
				       read-only file system.

APPLICATION USAGE
       Like a hard link, a symbolic link allows a file	to have multiple logi‐
       cal  names.  The	 presence of a hard link guarantees the existence of a
       file, even after the original name has been removed.  A	symbolic  link
       provides	 no such assurance; in fact, the file named by the path1 argu‐
       ment need not exist when the link is created. A symbolic link can cross
       file  system boundaries.

       Normal  permission  checks  are	made on each component of the symbolic
       link pathname during its resolution.

AUTHOR
       was developed by the University of California, Berkeley.

SEE ALSO
       cp(1), chown(2), link(2), lstat(2),  open(2),  readlink(2),  unlink(2),
       symlink(4), <unistd.h>.

STANDARDS CONFORMANCE
CHANGE HISTORY
       First released in Issue 4, Version 2.

								    symlink(2)
[top]

List of man pages available for HP-UX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net