UNLINK.2
上传用户:datang2001
上传日期:2007-02-01
资源大小:53269k
文件大小:2k
源码类别:

操作系统开发

开发平台:

C/C++

  1. ." Copyright (c) 1980 Regents of the University of California.
  2. ." All rights reserved.  The Berkeley software License Agreement
  3. ." specifies the terms and conditions for redistribution.
  4. ."
  5. ." @(#)unlink.2 6.2 (Berkeley) 5/22/85
  6. ."
  7. .TH UNLINK 2 "May 22, 1985"
  8. .UC 4
  9. .SH NAME
  10. unlink - remove directory entry
  11. .SH SYNOPSIS
  12. .nf
  13. .ft B
  14. #include <unistd.h>
  15. int unlink(const char *path)
  16. .fi
  17. .ft R
  18. .SH DESCRIPTION
  19. .B Unlink
  20. removes the entry for the file
  21. .I path
  22. from its directory.
  23. If this entry was the last link to the file,
  24. and no process has the file open, then
  25. all resources associated with the file are reclaimed.
  26. If, however, the file was open in any process, the actual
  27. resource reclamation is delayed until it is closed,
  28. even though the directory entry has disappeared.
  29. .SH "RETURN VALUE
  30. Upon successful completion, a value of 0 is returned.
  31. Otherwise, a value of -1 is returned and
  32. .B errno
  33. is set to indicate the error.
  34. .SH "ERRORS
  35. The fIunlinkfP succeeds unless:
  36. .TP 15
  37. [ENOTDIR]
  38. A component of the path prefix is not a directory.
  39. .TP 15
  40. [ENAMETOOLONG]
  41. The path name exceeds PATH_MAX characters.
  42. .TP 15
  43. [ENOENT]
  44. The named file does not exist.
  45. .TP 15
  46. [EACCES]
  47. Search permission is denied for a component of the path prefix.
  48. .TP 15
  49. [EACCES]
  50. Write permission is denied on the directory containing the link
  51. to be removed.
  52. .TP 15
  53. [ELOOP]
  54. Too many symbolic links were encountered in translating the pathname.
  55. (Minix-vmd)
  56. .TP 15
  57. [EPERM]
  58. The named file is a directory.
  59. .TP 15
  60. [EPERM]
  61. The directory containing the file is marked sticky,
  62. and neither the containing directory nor the file to be removed
  63. are owned by the effective user ID.
  64. (Minix-vmd)
  65. .TP 15
  66. [EBUSY]
  67. The entry to be unlinked is the mount point for a
  68. mounted file system.
  69. .TP 15
  70. [EIO]
  71. An I/O error occurred while deleting the directory entry
  72. or deallocating the inode.
  73. .TP 15
  74. [EROFS]
  75. The named file resides on a read-only file system.
  76. .TP 15
  77. [EFAULT]
  78. .I Path
  79. points outside the process's allocated address space.
  80. .SH "SEE ALSO"
  81. .BR close (2),
  82. .BR link (2),
  83. .BR rmdir (2).