LINK.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. ." @(#)link.2 6.3 (Berkeley) 8/26/85
  6. ."
  7. .TH LINK 2 "August 26, 1985"
  8. .UC 4
  9. .SH NAME
  10. link - make a hard link to a file
  11. .SH SYNOPSIS
  12. .nf
  13. .ft B
  14. #include <unistd.h>
  15. int link(const char *fIname1fP, const char *fIname2fP)
  16. .fi
  17. .ft R
  18. .SH DESCRIPTION
  19. A hard link
  20. to
  21. .I name1
  22. is created;
  23. the link has the name
  24. .IR name2 .
  25. .I Name1
  26. must exist.
  27. .PP
  28. With hard links,
  29. both
  30. .I name1
  31. and
  32. .I name2
  33. must be in the same file system.
  34. .I Name1
  35. must not be a directory.
  36. Both the old and the new
  37. .I link
  38. share equal access and rights to
  39. the underlying object.
  40. .SH "RETURN VALUE
  41. Upon successful completion, a value of 0 is returned.  Otherwise,
  42. a value of -1 is returned and
  43. .B errno
  44. is set to indicate the error.
  45. .SH "ERRORS
  46. .B Link
  47. will fail and no link will be created if one or more of the following
  48. are true:
  49. .TP 15
  50. [ENOTDIR]
  51. A component of either path prefix is not a directory.
  52. .TP 15
  53. [ENAMETOOLONG]
  54. A path name exceeds PATH_MAX characters.
  55. .TP 15
  56. [ENOENT]
  57. A component of either path prefix does not exist.
  58. .TP 15
  59. [EACCES]
  60. A component of either path prefix denies search permission.
  61. .TP 15
  62. [EACCES]
  63. The requested link requires writing in a directory with a mode
  64. that denies write permission.
  65. .TP 15
  66. [ELOOP]
  67. Too many symbolic links were encountered in translating one of the pathnames.
  68. (Minix-vmd)
  69. .TP 15
  70. [ENOENT]
  71. The file named by fIname1fP does not exist.
  72. .TP 15
  73. [EEXIST]
  74. The link named by fIname2fP does exist.
  75. .TP 15
  76. [EPERM]
  77. The file named by fIname1fP is a directory and the effective
  78. user ID is not super-user.
  79. .TP 15
  80. [EXDEV]
  81. The link named by fIname2fP and the file named by fIname1fP
  82. are on different file systems.
  83. .TP 15
  84. [ENOSPC]
  85. The directory in which the entry for the new link is being placed
  86. cannot be extended because there is no space left on the file
  87. system containing the directory.
  88. .ig
  89. .TP 15
  90. [EDQUOT]
  91. The directory in which the entry for the new link
  92. is being placed cannot be extended because the
  93. user's quota of disk blocks on the file system
  94. containing the directory has been exhausted.
  95. ..
  96. .TP 15
  97. [EIO]
  98. An I/O error occurred while reading from or writing to 
  99. the file system to make the directory entry.
  100. .TP 15
  101. [EROFS]
  102. The requested link requires writing in a directory on a read-only file
  103. system.
  104. .TP 15
  105. [EFAULT]
  106. One of the pathnames specified
  107. is outside the process's allocated address space.
  108. .SH "SEE ALSO"
  109. .BR symlink (2),
  110. .BR unlink (2).