1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
|
.\" Hey Emacs! This file is -*- nroff -*- source.
.\"
.\" Copyright (c) 1992 Drew Eckhardt (drew@cs.colorado.edu), March 28, 1992
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one
.\"
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date. The author(s) assume no
.\" responsibility for errors or omissions, or for damages resulting from
.\" the use of the information contained herein. The author(s) may not
.\" have taken the same level of care in the production of this manual,
.\" which is licensed free of charge, as they might when working
.\" professionally.
.\"
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.\" Modified by Michael Haardt <michael@moria.de>
.\" Modified Wed Jul 21 22:10:52 1993 by Rik Faith <faith@cs.unc.edu>
.\" Modified 15 April 1995 by Michael Chastain <mec@shell.portal.com>:
.\" Added 'fchdir'.
.\" Fix bugs in error section.
.\" Modified Mon Oct 21 23:05:29 EDT 1996 by Eric S. Raymond <esr@thyrsus.com>
.\" Modified by Joseph S. Myers <jsm28@cam.ac.uk>, 970821
.\" Translated into german by Daniel Kobras (kobras@linux.de)
.\"
.TH CHDIR 2 "23. Januar 2001" "Linux 2.0.30" "Systemaufrufe"
.SH BEZEICHNUNG
chdir, fchdir \- Aktuelles Arbeitsverzeichnis wechseln.
.SH "BERSICHT"
.B #include <unistd.h>
.sp
.BI "int chdir(const char *" Pfad );
.br
.BI "int fchdir(int " fd ");"
.SH BESCHREIBUNG
.B chdir
ndert das aktuelle Verzeichnis in das durch
.I Pfad
angegebene Verzeichnis.
.PP
.B fchdir
ist identisch zu
.BR chdir ,
jedoch wird der Verzeichnispfad als geffneter Dateideskriptor bergeben.
.SH "RCKGABEWERT"
Ist das Arbeitsverzeichnis erfolgreich gendert, wird 0 zurckgegeben.
Tritt ein Fehler auf, wird \-1 zurckgegeben und
.I errno
entsprechend der Fehlerursache gesetzt.
.SH FEHLER
Welche Fehler im einzelnen zurckgeliefert werden, hngt ab vom verwendeten
Dateisystem. Die folgenden Auflistungen nennen lediglich die allgemein
blichen.
.PP
Zunchst die Fehler fr
.BR chdir :
.TP
.B EFAULT
.I Pfad
zeigt auf einen Speicherbereich auerhalb des erlaubten Adreraums des
Prozesses.
.TP
.B ENAMETOOLONG
.I Pfad
ist zu lang.
.TP
.B ENOENT
Der angegebene Pfadname existiert nicht.
.TP
.B ENOMEM
Das Betriebssystem verfgt nicht ber ausreichend Speicher, um die Anweisung
auszufhren.
.TP
.B ENOTDIR
Eine Komponente von
.I Pfad
ist kein Verzeichnis.
.TP
.B EACCES
Dem Proze ist nicht erlaubt, eine Komponente von
.I Pfad
zu durchsuchen.
.TP
.B ELOOP
.I Pfad
enthlt zu viele symbolische Verweise.
.TP
.B EIO
Ein Ein-/Ausgabefehler ist aufgetreten.
.PP
bliche Fehler bei
.BR fchdir :
.TP
.B EBADF
.I fd
ist kein gltiger Dateideskriptor.
.TP
.B EACCES
Es ist nicht erlaubt, das durch
.I fd
angegebene Verzeichnis zu durchsuchen.
.SH "KONFORM ZU"
Der
.BR chdir -Aufruf
ist vereinbar mit SVr4, SVID, POSIX, X/OPEN und 4.4BSD. SVr4 legt die
zustzlichen Fehler EINTR, ENOLINK und EMULTIHOP fest, besitzt jedoch kein
ENOMEM. In POSIX.1 treten weder ENOMEM noch ELOOP auf.
X/OPEN erwhnt nicht die Fehler EFAULT, ENOMEM und EIO.
.PP
Der
.BR fchdir -Aufruf
ist vereinbar mit SVr4, 4.4BSD und X/OPEN.
SVr4 legt die zustzlichen Fehler EIO, EINTR und ENOLINK fest.
X/OPEN definiert zustzlich EINTR und EIO.
.SH "SIEHE AUCH"
.BR getcwd (3),
.BR chroot (2).
|
