X-Git-Url: https://git.saurik.com/apple/xnu.git/blobdiff_plain/9bccf70c0258c7cac2dcb80011b2a964d884c552..593a1d5fd87cdf5b46dd5fcb84467b432cea0f91:/bsd/man/man2/unlink.2?ds=sidebyside diff --git a/bsd/man/man2/unlink.2 b/bsd/man/man2/unlink.2 index 6dfd46035..3418f53fa 100644 --- a/bsd/man/man2/unlink.2 +++ b/bsd/man/man2/unlink.2 @@ -42,7 +42,9 @@ .Sh SYNOPSIS .Fd #include .Ft int -.Fn unlink "const char *path" +.Fo unlink +.Fa "const char *path" +.Fc .Sh DESCRIPTION The .Fn unlink @@ -66,48 +68,67 @@ is set to indicate the error. .Sh ERRORS The .Fn unlink -succeeds unless: +system call will fail if: .Bl -tag -width Er -.It Bq Er ENOTDIR -A component of the path prefix is not a directory. -.It Bq Er ENAMETOOLONG -A component of a pathname exceeded -.Dv {NAME_MAX} -characters, or an entire path name exceeded -.Dv {PATH_MAX} -characters. -.It Bq Er ENOENT -The named file does not exist. +.\" =========== .It Bq Er EACCES Search permission is denied for a component of the path prefix. +.\" =========== .It Bq Er EACCES Write permission is denied on the directory containing the link to be removed. +.\" =========== +.It Bq Er EBUSY +The entry to be unlinked is the mount point for a +mounted file system. +.\" =========== +.It Bq Er EBUSY +The file named by the +.Fa path +argument cannot be unlinked +because it is being used by the system or by another process. +.\" =========== +.It Bq Er EFAULT +.Fa Path +points outside the process's allocated address space. +.\" =========== +.It Bq Er EIO +An I/O error occurs while deleting the directory entry +or deallocating the inode. +.\" =========== .It Bq Er ELOOP -Too many symbolic links were encountered in translating the pathname. +Too many symbolic links are encountered in translating the pathname. +This is taken to be indicative of a looping symbolic link. +.\" =========== +.It Bq Er ENAMETOOLONG +A component of a pathname exceeds +.Dv {NAME_MAX} +characters, or an entire path name exceeds +.Dv {PATH_MAX} +characters (possibly as a result of expanding a symlink). +.\" =========== +.It Bq Er ENOENT +The named file does not exist. +.\" =========== +.It Bq Er ENOTDIR +A component of the path prefix is not a directory. +.\" =========== .It Bq Er EPERM The named file is a directory and the effective user ID of the process is not the super-user. +.\" =========== .It Bq Er EPERM The directory containing the file is marked sticky, and neither the containing directory nor the file to be removed are owned by the effective user ID. -.It Bq Er EBUSY -The entry to be unlinked is the mount point for a -mounted file system. -.It Bq Er EIO -An I/O error occurred while deleting the directory entry -or deallocating the inode. +.\" =========== .It Bq Er EROFS The named file resides on a read-only file system. -.It Bq Er EFAULT -.Fa Path -points outside the process's allocated address space. .El .Sh SEE ALSO .Xr close 2 , .Xr link 2 , -.Xr rmdir 2 +.Xr rmdir 2 , .Xr symlink 7 .Sh HISTORY An