git.infodrom.org Git - infodrom/manpages-de/blob - man2/chmod.2

   1 .\" Hey Emacs! This file is -*- nroff -*- source.
   2 .\"
   3 .\" Copyright (c) 1992 Drew Eckhardt (drew@cs.colorado.edu), March 28, 1992
   4 .\"
   5 .\" Permission is granted to make and distribute verbatim copies of this
   6 .\" manual provided the copyright notice and this permission notice are
   7 .\" preserved on all copies.
   8 .\"
   9 .\" Permission is granted to copy and distribute modified versions of this
  10 .\" manual under the conditions for verbatim copying, provided that the
  11 .\" entire resulting derived work is distributed under the terms of a
  12 .\" permission notice identical to this one
  13 .\"
  14 .\" Since the Linux kernel and libraries are constantly changing, this
  15 .\" manual page may be incorrect or out-of-date.  The author(s) assume no
  16 .\" responsibility for errors or omissions, or for damages resulting from
  17 .\" the use of the information contained herein.  The author(s) may not
  18 .\" have taken the same level of care in the production of this manual,
  19 .\" which is licensed free of charge, as they might when working
  20 .\" professionally.
  21 .\"
  22 .\" Formatted or processed versions of this manual, if unaccompanied by
  23 .\" the source, must acknowledge the copyright and authors of this work.
  24 .\"
  25 .\" Modified by Michael Haardt (michael@moria.de)
  26 .\" Modified Wed Jul 21 20:18:11 1993 by Rik Faith (faith@cs.unc.edu)
  27 .\" Modified Sun Jan 12 14:31:17 MET 1997 by Michael Haardt
  28 .\"   (michael@cantor.informatik.rwth-aachen.de): NFS details
  29 .\" Translated into german by Daniel Kobras (kobras@linux.de)
  30 .\"
  31 .TH CHMOD 2 "23. Januar 2001" "Linux 2.0.32" "Systemaufrufe"
  32 .SH BEZEICHNUNG
  33 chmod, fchmod \- Zugriffsrechte einer Datei ändern.
  34 .SH "ÜBERSICHT"
  35 .B #include <sys/types.h>
  36 .br
  37 .B #include <sys/stat.h>
  38 .sp
  39 .BI "int chmod(const char *" Pfad ", mode_t " Rechte );
  40 .br
  41 .BI "int fchmod(int " fd ", mode_t " Rechte );
  42 .SH BESCHREIBUNG
  43 Die Zugriffsrechte der durch
  44 .I Pfad
  45 beziehungsweise
  46 .I fd
  47 angegebenen Datei oder des Verzeichnisses werden geändert.  Die
  48 .I Rechte
  49 werden angegeben durch bitweises Oder der folgenden Werte:
  50 .RS
  51 .sp
  52 .TP 1.0i
  53 S_ISUID
  54 04000 Setze Benutzerkennung bei Ausführung;
  55 .TP
  56 S_ISGID
  57 02000 Setze Gruppenkennung bei Ausführung;
  58 .TP
  59 S_ISVTX
  60 01000 'Sticky-Bit' (Erklärung siehe unten);
  61 .TP
  62 S_IRUSR (S_IREAD)
  63 00400 Leserechte für Eigentümer;
  64 .TP
  65 S_IWUSR (S_IWRITE)
  66 00200 Schreibrechte für Eigentümer;
  67 .TP
  68 S_IXUSR (S_IEXEC)
  69 00100 Ausführrechte für Eigentümer, bei Verzeichnissen: Eigentümer darf
  70 Verzeichnis durchsuchen;
  71 .TP
  72 S_IRGRP
  73 00040 Leserechte für Gruppe;
  74 .TP
  75 S_IWGRP
  76 00020 Schreibrechte für Gruppe;
  77 .TP
  78 S_IXGRP
  79 00010 Ausführrechte für Gruppe, bei Verzeichnissen: Gruppe darf
  80 Verzeichnis durchsuchen;
  81 .TP
  82 S_IROTH
  83 00004 Leserechte für andere;
  84 .TP
  85 S_IWOTH
  86 00002 Schreibrechte für Gruppe;
  87 .TP
  88 S_IXOTH
  89 00001 Ausführrechte für andere, bei Verzeichnissen: andere dürfen
  90 Verzeichnis durchsuchen;
  91 .sp
  92 .RE
  93 Die effektive Benutzerkennung des Prozesses muss entweder null sein, oder sie
  94 muss mit der Kennung des Dateieigentümers übereinstimmen.
  95 .PP
  96 Ist die effektive Benutzerkennung des Prozesses nicht null und entspricht
  97 die Gruppenzugehörigkeit der Datei nicht einer der Gruppen des
  98 aufrufenden Prozesses, so wird das S_ISGID-Bit abgeschaltet, ohne dass ein
  99 Fehler zurückgeliefert wird.
 100 Abhängig vom verwendeten Dateisystem können die S_ISUID- und S_ISGID-Bits
 101 gelöscht werden, sobald die Datei beschrieben wird.
 102 .PP
 103 Auf manchen Dateisystemen
 104 darf lediglich der Administrator das Sticky-Bit setzen. Das Sticky-Bit kann
 105 verschiedene Bedeutungen haben, beispielsweise kann in Verzeichnissen
 106 mit gesetztem Sticky-Bit eine Datei nur vom Dateieigentümer oder dem
 107 Administrator (root) gelöscht werden.
 108 .PP
 109 Auf NFS-Dateisystemen findet die Zugriffskontrolle auf dem Server statt,
 110 während der Klient selbst seine offenen Dateien verwaltet. Verschärfte
 111 Zugriffsrechte treten somit augenblicklich in Kraft. Erweiterte Zugriffsrechte
 112 hingegen werden erst nach und nach an andere Klienten weitergegeben.
 113 .SH "RÜCKGABEWERT"
 114 Sind die Zugriffsrechte erfolgreich geändert, wird 0 zurückgegeben.
 115 Tritt ein Fehler auf, wird \-1 zurückgegeben und
 116 .I errno
 117 entsprechend der Fehlerursache gesetzt.
 118 .SH FEHLER
 119 Welche Fehler im einzelnen zurückgeliefert werden, hängt ab vom verwendeten
 120 Dateisystem. Die folgenden Auflistungen nennen lediglich die allgemein
 121 üblichen.
 122 .PP
 123 Zunächste die Fehler für
 124 .BR chmod :
 125 .TP
 126 .B EPERM
 127 Die effektive Benutzerkennung ist weder null, noch entspricht sie dem
 128 Eigentümer der Datei.
 129 .TP
 130 .B EROFS
 131 Die angegebene Datei befindet sich auf einem Dateisystem, das nur lesbar ist.
 132 .TP
 133 .B EFAULT
 134 .I Pfad
 135 zeigt auf einen Speicherbereich außerhalb des erlaubten Adressraums des
 136 Prozesses.
 137 .TP
 138 .B ENAMETOOLONG
 139 .I Pfad
 140 ist zu lang.
 141 .TP
 142 .B ENOENT
 143 Der angegebene Pfadname existiert nicht.
 144 .TP
 145 .B ENOMEM
 146 Das Betriebssystem verfügt nicht über ausreichend Speicher, um die Anweisung
 147 auszuführen.
 148 .TP
 149 .B ENOTDIR
 150 Eine Komponente von
 151 .I Pfad
 152 ist kein Verzeichnis.
 153 .TP
 154 .B EACCES
 155 Dem Prozess ist nicht erlaubt, eine Komponente von
 156 .I Pfad
 157 zu durchsuchen.
 158 .TP
 159 .B ELOOP
 160 .I Pfad
 161 enthält zu viele symbolische Verweise.
 162 .TP
 163 .B EIO
 164 Ein Ein-/Ausgabefehler ist aufgetreten.
 165 .PP
 166 Übliche Fehler bei
 167 .BR fchmod :
 168 .TP
 169 .B EBADF
 170 .I fd
 171 ist kein gültiger Dateideskriptor.
 172 .TP
 173 .B EROFS
 174 Siehe oben.
 175 .TP
 176 .B EPERM
 177 Siehe oben.
 178 .TP
 179 .B EIO
 180 Siehe oben.
 181 .SH "KONFORM ZU"
 182 Der
 183 .BR chmod -Aufruf
 184 ist vereinbar mit SVr4, SVID, POSIX, X/OPEN und 4.4BSD.
 185 SVr4 legt die zusätzlichen Fehler EINTR, ENOLINK und EMULTIHOP fest, jedoch
 186 kein ENOMEM.  In POSIX.1 fehlen die EFAULT, ENOMEM, ELOOP und EIO
 187 Fehlerbedingungen sowie die Makros
 188 \fBS_IREAD\fP, \fBS_IWRITE\fP und \fBS_IEXEC\fP.
 189 .PP
 190 Der
 191 .BR fchmod -Aufruf
 192 ist vereinbar mit 4.4BSD und SVr4.
 193 SVr4 legt die zusätzlichen Fehler EINTR und ENOLINK fest.
 194 POSIX verlangt die
 195 .BR fchmod -Funktion,
 196 sofern zumindest eines von
 197 .B _POSIX_MAPPED_FILES
 198 und
 199 .B _POSIX_SHARED_MEMORY_OBJECTS
 200 definiert ist. Zudem beschreibt es die zusätzlichen Fehler ENOSYS und
 201 EINVAL, nicht jedoch EIO.
 202 .PP
 203 Weder POSIX, noch X/OPEN dokumentieren das Sticky-Bit.
 204 .SH "SIEHE AUCH"
 205 .BR open (2),
 206 .BR chown (2),
 207 .BR execve (2),
 208 .BR stat (2),