CHDIR.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. ." @(#)chdir.2 6.3 (Berkeley) 8/26/85
  6. ."
  7. .TH CHDIR 2 "August 26, 1985"
  8. .UC 4
  9. .SH NAME
  10. chdir - change current working directory
  11. .SH SYNOPSIS
  12. .nf
  13. .ft B
  14. #include <unistd.h>
  15. int chdir(const char *fIpathfP)
  16. .ft R
  17. .fi
  18. .SH DESCRIPTION
  19. .I Path
  20. is the pathname of a directory.
  21. .B Chdir
  22. causes this directory
  23. to become the current working directory,
  24. the starting point for path names not beginning with ``/''.
  25. .PP
  26. In order for a directory to become the current directory,
  27. a process must have execute (search) access to the directory.
  28. .SH "RETURN VALUE
  29. Upon successful completion, a value of 0 is returned.
  30. Otherwise, a value of -1 is returned and fBerrnofP is set to indicate
  31. the error.
  32. .SH ERRORS
  33. .B Chdir
  34. will fail and the current working directory will be unchanged if
  35. one or more of the following are true:
  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 directory does not exist.
  45. .TP 15
  46. [ELOOP]
  47. Too many symbolic links were encountered in translating the pathname.
  48. (Minix-vmd)
  49. .TP 15
  50. [EACCES]
  51. Search permission is denied for any component of
  52. the path name.
  53. .TP 15
  54. [EFAULT]
  55. .I Path
  56. points outside the process's allocated address space.
  57. .TP 15
  58. [EIO]
  59. An I/O error occurred while reading from or writing to the file system.
  60. .SH "SEE ALSO"
  61. .BR chroot (2).